Whamcloud - gitweb
LU-14868 llite: revert 'simplify callback handling for async getattr'
[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.gnu.org/licenses/gpl-2.0.html
19  *
20  * GPL HEADER END
21  */
22 /*
23  * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
24  * Use is subject to license terms.
25  *
26  * Copyright (c) 2012, 2014, Intel Corporation.
27  */
28 /*
29  * This file is part of Lustre, http://www.lustre.org/
30  *
31  * lustre/fid/fid_lib.c
32  *
33  * Miscellaneous fid functions.
34  *
35  * Author: Nikita Danilov <nikita@clusterfs.com>
36  * Author: Yury Umanets <umka@clusterfs.com>
37  */
38
39 #define DEBUG_SUBSYSTEM S_FID
40
41 #include <libcfs/libcfs.h>
42 #include <linux/module.h>
43 #include <lustre_fid.h>
44
45 /**
46  * A cluster-wide range from which fid-sequences are granted to servers and
47  * then clients.
48  *
49  * Fid namespace:
50  * <pre>
51  * Normal FID:        seq:64 [2^33,2^64-1]      oid:32          ver:32
52  * IGIF      :        0:32, ino:32              gen:32          0:32
53  * IDIF      :        0:31, 1:1, ost-index:16,  objd:48         0:32
54  * </pre>
55  *
56  * The first 0x400 sequences of normal FID are reserved for special purpose.
57  * FID_SEQ_START + 1 is for local file id generation.
58  * FID_SEQ_START + 2 is for .lustre directory and its objects
59  */
60 const struct lu_seq_range LUSTRE_SEQ_SPACE_RANGE = {
61         .lsr_start      = FID_SEQ_NORMAL,
62         .lsr_end        = (__u64)~0ULL,
63 };
64
65 /* Zero range, used for init and other purposes. */
66 const struct lu_seq_range LUSTRE_SEQ_ZERO_RANGE = {
67         .lsr_start = 0,
68 };
69
70 /* Lustre Big Fs Lock fid. */
71 const struct lu_fid LUSTRE_BFL_FID = { .f_seq = FID_SEQ_SPECIAL,
72                                        .f_oid = FID_OID_SPECIAL_BFL,
73                                        .f_ver = 0x0000000000000000 };
74 EXPORT_SYMBOL(LUSTRE_BFL_FID);
75
76 /** Special fid for ".lustre" directory */
77 const struct lu_fid LU_DOT_LUSTRE_FID = { .f_seq = FID_SEQ_DOT_LUSTRE,
78                                           .f_oid = FID_OID_DOT_LUSTRE,
79                                           .f_ver = 0x0000000000000000 };
80 EXPORT_SYMBOL(LU_DOT_LUSTRE_FID);
81
82 /** Special fid for "fid" special object in .lustre */
83 const struct lu_fid LU_OBF_FID = { .f_seq = FID_SEQ_DOT_LUSTRE,
84                                    .f_oid = FID_OID_DOT_LUSTRE_OBF,
85                                    .f_ver = 0x0000000000000000 };
86 EXPORT_SYMBOL(LU_OBF_FID);
87
88 /** Special fid for "lost+found" special object in .lustre */
89 const struct lu_fid LU_LPF_FID = { .f_seq = FID_SEQ_DOT_LUSTRE,
90                                    .f_oid = FID_OID_DOT_LUSTRE_LPF,
91                                    .f_ver = 0x0000000000000000 };
92 EXPORT_SYMBOL(LU_LPF_FID);
93
94 /** "/lost+found" - special FID for ldiskfs backend, invislbe to client. */
95 const struct lu_fid LU_BACKEND_LPF_FID = { .f_seq = FID_SEQ_LOCAL_FILE,
96                                            .f_oid = OSD_LPF_OID,
97                                            .f_ver = 0x0000000000000000 };
98 EXPORT_SYMBOL(LU_BACKEND_LPF_FID);