1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
2 * vim:expandtab:shiftwidth=8:tabstop=8:
6 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 only,
10 * as published by the Free Software Foundation.
12 * This program is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * General Public License version 2 for more details (a copy is included
16 * in the LICENSE file that accompanied this code).
18 * You should have received a copy of the GNU General Public License
19 * version 2 along with this program; If not, see
20 * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
22 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
23 * CA 95054 USA or visit www.sun.com if you need additional information or
29 * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
30 * Use is subject to license terms.
33 * This file is part of Lustre, http://www.lustre.org/
34 * Lustre is a trademark of Sun Microsystems, Inc.
37 #ifndef __LUSTRE_HANDLES_H_
38 #define __LUSTRE_HANDLES_H_
40 /** \defgroup handles handles
45 #if defined(__linux__)
46 #include <linux/lustre_handles.h>
47 #elif defined(__APPLE__)
48 #include <darwin/lustre_handles.h>
49 #elif defined(__WINNT__)
50 #include <winnt/lustre_handles.h>
52 #error Unsupported operating system.
55 #include <libcfs/libcfs.h>
57 #if !defined(HAVE_RCU) || !defined(__KERNEL__)
63 typedef void (*portals_handle_addref_cb)(void *object);
65 /* These handles are most easily used by having them appear at the very top of
66 * whatever object that you want to make handles for. ie:
69 * struct portals_handle handle;
73 * Now you're able to assign the results of cookie2handle directly to an
74 * ldlm_lock. If it's not at the top, you'll want to hack up a macro that
75 * uses some offsetof() magic. */
77 struct portals_handle {
80 portals_handle_addref_cb h_addref;
82 /* newly added fields to handle the RCU issue. -jxiong */
83 cfs_spinlock_t h_lock;
85 void (*h_free_cb)(void *, size_t);
91 #define RCU2HANDLE(rcu) container_of(rcu, struct portals_handle, h_rcu)
95 /* Add a handle to the hash table */
96 void class_handle_hash(struct portals_handle *, portals_handle_addref_cb);
97 void class_handle_unhash(struct portals_handle *);
98 void class_handle_hash_back(struct portals_handle *);
99 void *class_handle2object(__u64 cookie);
100 void class_handle_free_cb(cfs_rcu_head_t *);
101 int class_handle_init(void);
102 void class_handle_cleanup(void);