Whamcloud - gitweb
LU-1866 lfsck: enhance otable-based iteration
[fs/lustre-release.git] / lustre / fid / fid_lib.c
1 /*
2  * GPL HEADER START
3  *
4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 only,
8  * as published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope that it will be useful, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * General Public License version 2 for more details (a copy is included
14  * in the LICENSE file that accompanied this code).
15  *
16  * You should have received a copy of the GNU General Public License
17  * version 2 along with this program; If not, see
18  * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
19  *
20  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
21  * CA 95054 USA or visit www.sun.com if you need additional information or
22  * have any questions.
23  *
24  * GPL HEADER END
25  */
26 /*
27  * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
28  * Use is subject to license terms.
29  *
30  * Copyright (c) 2012, Intel Corporation.
31  */
32 /*
33  * This file is part of Lustre, http://www.lustre.org/
34  * Lustre is a trademark of Sun Microsystems, Inc.
35  *
36  * lustre/fid/fid_lib.c
37  *
38  * Miscellaneous fid functions.
39  *
40  * Author: Nikita Danilov <nikita@clusterfs.com>
41  * Author: Yury Umanets <umka@clusterfs.com>
42  */
43
44 #define DEBUG_SUBSYSTEM S_FID
45
46 #ifdef __KERNEL__
47 # include <libcfs/libcfs.h>
48 # include <linux/module.h>
49 #else /* __KERNEL__ */
50 # include <liblustre.h>
51 #endif
52
53 #include <obd.h>
54 #include <lu_object.h>
55 #include <lustre_fid.h>
56
57 /**
58  * A cluster-wide range from which fid-sequences are granted to servers and
59  * then clients.
60  *
61  * Fid namespace:
62  * <pre>
63  * Normal FID:        seq:64 [2^33,2^64-1]      oid:32          ver:32
64  * IGIF      :        0:32, ino:32              gen:32          0:32
65  * IDIF      :        0:31, 1:1, ost-index:16,  objd:48         0:32
66  * </pre>
67  *
68  * The first 0x400 sequences of normal FID are reserved for special purpose.
69  * FID_SEQ_START + 1 is for local file id generation.
70  * FID_SEQ_START + 2 is for .lustre directory and its objects
71  */
72 const struct lu_seq_range LUSTRE_SEQ_SPACE_RANGE = {
73         FID_SEQ_NORMAL,
74         (__u64)~0ULL
75 };
76 EXPORT_SYMBOL(LUSTRE_SEQ_SPACE_RANGE);
77
78 /* Zero range, used for init and other purposes. */
79 const struct lu_seq_range LUSTRE_SEQ_ZERO_RANGE = {
80         0,
81         0
82 };
83 EXPORT_SYMBOL(LUSTRE_SEQ_ZERO_RANGE);
84
85 /* Lustre Big Fs Lock fid. */
86 const struct lu_fid LUSTRE_BFL_FID = { .f_seq = FID_SEQ_SPECIAL,
87                                        .f_oid = FID_OID_SPECIAL_BFL,
88                                        .f_ver = 0x0000000000000000 };
89 EXPORT_SYMBOL(LUSTRE_BFL_FID);
90
91 /** Special fid for ".lustre" directory */
92 const struct lu_fid LU_DOT_LUSTRE_FID = { .f_seq = FID_SEQ_DOT_LUSTRE,
93                                           .f_oid = FID_OID_DOT_LUSTRE,
94                                           .f_ver = 0x0000000000000000 };
95 EXPORT_SYMBOL(LU_DOT_LUSTRE_FID);
96
97 /** Special fid for "fid" special object in .lustre */
98 const struct lu_fid LU_OBF_FID = { .f_seq = FID_SEQ_DOT_LUSTRE,
99                                    .f_oid = FID_OID_DOT_LUSTRE_OBF,
100                                    .f_ver = 0x0000000000000000 };
101 EXPORT_SYMBOL(LU_OBF_FID);