lustre/include/lustre_handles.h

   1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
   2  * vim:expandtab:shiftwidth=8:tabstop=8:
   3  *
   4  * GPL HEADER START
   5  *
   6  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   7  *
   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.
  11  *
  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).
  17  *
  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
  21  *
  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
  24  * have any questions.
  25  *
  26  * GPL HEADER END
  27  */
  28 /*
  29  * Copyright  2008 Sun Microsystems, Inc. All rights reserved
  30  * Use is subject to license terms.
  31  */
  32 /*
  33  * This file is part of Lustre, http://www.lustre.org/
  34  * Lustre is a trademark of Sun Microsystems, Inc.
  35  */
  36
  37 #ifndef __LUSTRE_HANDLES_H_
  38 #define __LUSTRE_HANDLES_H_
  39
  40 #if defined(__linux__)
  41 #include <linux/lustre_handles.h>
  42 #elif defined(__APPLE__)
  43 #include <darwin/lustre_handles.h>
  44 #elif defined(__WINNT__)
  45 #include <winnt/lustre_handles.h>
  46 #else
  47 #error Unsupported operating system.
  48 #endif
  49
  50 #include <libcfs/libcfs.h>
  51
  52 typedef void (*portals_handle_addref_cb)(void *object);
  53
  54 /* These handles are most easily used by having them appear at the very top of
  55  * whatever object that you want to make handles for.  ie:
  56  *
  57  * struct ldlm_lock {
  58  *         struct portals_handle handle;
  59  *         ...
  60  * };
  61  *
  62  * Now you're able to assign the results of cookie2handle directly to an
  63  * ldlm_lock.  If it's not at the top, you'll want to hack up a macro that
  64  * uses some offsetof() magic. */
  65
  66 struct portals_handle {
  67         cfs_list_t h_link;
  68         __u64 h_cookie;
  69         portals_handle_addref_cb h_addref;
  70
  71         /* newly added fields to handle the RCU issue. -jxiong */
  72         cfs_spinlock_t h_lock;
  73         void *h_ptr;
  74         void (*h_free_cb)(void *, size_t);
  75         cfs_rcu_head_t h_rcu;
  76         unsigned int h_size;
  77         __u8 h_in:1;
  78         __u8 h_unused[3];
  79 };
  80 #define RCU2HANDLE(rcu)    container_of(rcu, struct portals_handle, h_rcu)
  81
  82 /* handles.c */
  83
  84 /* Add a handle to the hash table */
  85 void class_handle_hash(struct portals_handle *, portals_handle_addref_cb);
  86 void class_handle_unhash(struct portals_handle *);
  87 void class_handle_hash_back(struct portals_handle *);
  88 void *class_handle2object(__u64 cookie);
  89 void class_handle_free_cb(cfs_rcu_head_t *);
  90 int class_handle_init(void);
  91 void class_handle_cleanup(void);
  92
  93 #endif