4 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
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.
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).
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
23 * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
24 * Use is subject to license terms.
26 * Copyright (c) 2011, 2016, Intel Corporation.
29 * This file is part of Lustre, http://www.lustre.org/
30 * Lustre is a trademark of Sun Microsystems, Inc.
32 * lustre/include/lustre_disk.h
34 * Lustre disk format definitions.
36 * Author: Nathan Rutman <nathan@clusterfs.com>
39 #ifndef _LUSTRE_DISK_H
40 #define _LUSTRE_DISK_H
42 /** \defgroup disk disk
46 #include <asm/byteorder.h>
47 #include <linux/types.h>
48 #include <linux/backing-dev.h>
49 #include <linux/list.h>
50 #include <libcfs/libcfs.h>
51 #include <uapi/linux/lustre/lustre_disk.h>
52 #include <uapi/linux/lustre/lustre_idl.h>
54 #define IS_MDT(data) ((data)->lsi_flags & LDD_F_SV_TYPE_MDT)
55 #define IS_OST(data) ((data)->lsi_flags & LDD_F_SV_TYPE_OST)
56 #define IS_MGS(data) ((data)->lsi_flags & LDD_F_SV_TYPE_MGS)
57 #define IS_SERVER(data) ((data)->lsi_flags & (LDD_F_SV_TYPE_MGS | \
60 #define MT_STR(data) mt_str((data)->ldd_mount_type)
62 /****************** mount command *********************/
64 /* The lmd is only used internally by Lustre; mount simply passes
65 * everything as string options
67 #define LMD_MAGIC 0xbdacbd03
68 #define LMD_PARAMS_MAXLEN 4096
70 /* gleaned from the mount command - no persistent info here */
71 struct lustre_mount_data {
73 u32 lmd_flags; /* lustre mount flags */
74 int lmd_mgs_failnodes; /* mgs failover node count */
75 int lmd_exclude_count;
76 int lmd_recovery_time_soft;
77 int lmd_recovery_time_hard;
78 char *lmd_dev; /* device name */
79 char *lmd_profile; /* client only */
80 char *lmd_fileset; /* mount fileset */
81 char *lmd_mgssec; /* sptlrpc flavor to mgs */
82 char *lmd_opts; /* lustre mount options (as opposed to
83 * device_ mount options) */
84 char *lmd_params; /* lustre params */
85 u32 *lmd_exclude; /* array of OSTs to ignore */
86 char *lmd_mgs; /* MGS nid */
87 char *lmd_osd_type; /* OSD type */
88 char *lmd_nidnet; /* network to restrict this client to */
91 #define LMD_FLG_SERVER 0x0001 /* Mounting a server */
92 #define LMD_FLG_CLIENT 0x0002 /* Mounting a client */
93 #define LMD_FLG_SKIP_LFSCK 0x0004 /* NOT auto resume LFSCK when mount */
94 #define LMD_FLG_ABORT_RECOV 0x0008 /* Abort recovery */
95 #define LMD_FLG_NOSVC 0x0010 /* Only start MGS/MGC for servers,
97 #define LMD_FLG_NOMGS 0x0020 /* Only start target for servers, reusing
98 existing MGS services */
99 #define LMD_FLG_WRITECONF 0x0040 /* Rewrite config log */
100 #define LMD_FLG_NOIR 0x0080 /* NO imperative recovery */
101 #define LMD_FLG_NOSCRUB 0x0100 /* Do not trigger scrub automatically */
102 #define LMD_FLG_MGS 0x0200 /* Also start MGS along with server */
103 #define LMD_FLG_IAM 0x0400 /* IAM dir */
104 #define LMD_FLG_NO_PRIMNODE 0x0800 /* all nodes are service nodes */
105 #define LMD_FLG_VIRGIN 0x1000 /* the service registers first time */
106 #define LMD_FLG_UPDATE 0x2000 /* update parameters */
107 #define LMD_FLG_HSM 0x4000 /* Start coordinator */
108 #define LMD_FLG_DEV_RDONLY 0x8000 /* discard modification quitely */
110 #define lmd_is_client(x) ((x)->lmd_flags & LMD_FLG_CLIENT)
112 /****************** superblock additional info *********************/
115 struct lustre_sb_info {
117 struct obd_device *lsi_mgc; /* mgc obd */
118 struct lustre_mount_data *lsi_lmd; /* mount command info */
119 struct ll_sb_info *lsi_llsbi; /* add'l client sbi info */
120 struct dt_device *lsi_dt_dev; /* dt device to access disk fs*/
121 atomic_t lsi_mounts; /* references to the srv_mnt */
122 char lsi_svname[MTI_NAME_MAXLEN];
123 char lsi_osd_obdname[64];
124 char lsi_osd_uuid[64];
125 struct obd_export *lsi_osd_exp;
126 char lsi_osd_type[16];
128 struct backing_dev_info lsi_bdi; /* each client mountpoint needs
129 own backing_dev_info */
130 struct list_head lsi_lwp_list;
131 spinlock_t lsi_lwp_lock;
132 unsigned long lsi_lwp_started:1;
135 #define LSI_UMOUNT_FAILOVER 0x00200000
137 #define s2lsi(sb) ((struct lustre_sb_info *)((sb)->s_fs_info))
138 #define s2lsi_nocast(sb) ((sb)->s_fs_info)
140 #define get_profile_name(sb) (s2lsi(sb)->lsi_lmd->lmd_profile)
141 #define get_mount_fileset(sb) (s2lsi(sb)->lsi_lmd->lmd_fileset)
143 # ifdef HAVE_SERVER_SUPPORT
144 /* opc for target register */
145 #define LDD_F_OPC_REG 0x10000000
146 #define LDD_F_OPC_UNREG 0x20000000
147 #define LDD_F_OPC_READY 0x40000000
148 #define LDD_F_OPC_MASK 0xf0000000
150 #define LDD_F_MASK 0xFFFF
153 * This limit is arbitrary (131072 clients on x86), but it is convenient to use
154 * 2^n * PAGE_SIZE * 8 for the number of bits that fit an order-n allocation.
155 * If we need more than 131072 clients (order-2 allocation on x86) then this
156 * should become an array of single-page pointers that are allocated on demand.
158 #if (128 * 1024UL) > (PAGE_SIZE * 8)
159 #define LR_MAX_CLIENTS (128 * 1024UL)
161 #define LR_MAX_CLIENTS (PAGE_SIZE * 8)
164 /** COMPAT_146: this is an OST (temporary) */
165 #define OBD_COMPAT_OST 0x00000002
166 /** COMPAT_146: this is an MDT (temporary) */
167 #define OBD_COMPAT_MDT 0x00000004
168 /** 2.0 server, interop flag to show server version is changed */
169 #define OBD_COMPAT_20 0x00000008
171 /** MDS handles LOV_OBJID file */
172 #define OBD_ROCOMPAT_LOVOBJID 0x00000001
173 /** store OST index in the IDIF */
174 #define OBD_ROCOMPAT_IDX_IN_IDIF 0x00000002
176 /** OST handles group subdirs */
177 #define OBD_INCOMPAT_GROUPS 0x00000001
178 /** this is an OST */
179 #define OBD_INCOMPAT_OST 0x00000002
180 /** this is an MDT */
181 #define OBD_INCOMPAT_MDT 0x00000004
182 /** common last_rvcd format */
183 #define OBD_INCOMPAT_COMMON_LR 0x00000008
184 /** FID is enabled */
185 #define OBD_INCOMPAT_FID 0x00000010
186 /** Size-on-MDS is enabled */
187 #define OBD_INCOMPAT_SOM 0x00000020
188 /** filesystem using iam format to store directory entries */
189 #define OBD_INCOMPAT_IAM_DIR 0x00000040
190 /** LMA attribute contains per-inode incompatible flags */
191 #define OBD_INCOMPAT_LMA 0x00000080
192 /** lmm_stripe_count has been shrunk from u32 to u16 and the remaining 16
193 * bits are now used to store a generation. Once we start changing the layout
194 * and bumping the generation, old versions expecting a 32-bit lmm_stripe_count
195 * will be confused by interpreting stripe_count | gen << 16 as the actual
197 #define OBD_INCOMPAT_LMM_VER 0x00000100
198 /** multiple OI files for MDT */
199 #define OBD_INCOMPAT_MULTI_OI 0x00000200
200 /** multiple RPCs in flight */
201 #define OBD_INCOMPAT_MULTI_RPCS 0x00000400
203 /* last_rcvd handling */
204 static inline void lsd_le_to_cpu(struct lr_server_data *buf,
205 struct lr_server_data *lsd)
209 memcpy(lsd->lsd_uuid, buf->lsd_uuid, sizeof(lsd->lsd_uuid));
210 lsd->lsd_last_transno = le64_to_cpu(buf->lsd_last_transno);
211 lsd->lsd_compat14 = le64_to_cpu(buf->lsd_compat14);
212 lsd->lsd_mount_count = le64_to_cpu(buf->lsd_mount_count);
213 lsd->lsd_feature_compat = le32_to_cpu(buf->lsd_feature_compat);
214 lsd->lsd_feature_rocompat = le32_to_cpu(buf->lsd_feature_rocompat);
215 lsd->lsd_feature_incompat = le32_to_cpu(buf->lsd_feature_incompat);
216 lsd->lsd_server_size = le32_to_cpu(buf->lsd_server_size);
217 lsd->lsd_client_start = le32_to_cpu(buf->lsd_client_start);
218 lsd->lsd_client_size = le16_to_cpu(buf->lsd_client_size);
219 lsd->lsd_subdir_count = le16_to_cpu(buf->lsd_subdir_count);
220 lsd->lsd_catalog_oid = le64_to_cpu(buf->lsd_catalog_oid);
221 lsd->lsd_catalog_ogen = le32_to_cpu(buf->lsd_catalog_ogen);
222 memcpy(lsd->lsd_peeruuid, buf->lsd_peeruuid, sizeof(lsd->lsd_peeruuid));
223 lsd->lsd_osd_index = le32_to_cpu(buf->lsd_osd_index);
224 lsd->lsd_padding1 = le32_to_cpu(buf->lsd_padding1);
225 lsd->lsd_start_epoch = le32_to_cpu(buf->lsd_start_epoch);
226 for (i = 0; i < LR_EXPIRE_INTERVALS; i++)
227 lsd->lsd_trans_table[i] = le64_to_cpu(buf->lsd_trans_table[i]);
228 lsd->lsd_trans_table_time = le32_to_cpu(buf->lsd_trans_table_time);
229 lsd->lsd_expire_intervals = le32_to_cpu(buf->lsd_expire_intervals);
232 static inline void lsd_cpu_to_le(struct lr_server_data *lsd,
233 struct lr_server_data *buf)
237 memcpy(buf->lsd_uuid, lsd->lsd_uuid, sizeof(buf->lsd_uuid));
238 buf->lsd_last_transno = cpu_to_le64(lsd->lsd_last_transno);
239 buf->lsd_compat14 = cpu_to_le64(lsd->lsd_compat14);
240 buf->lsd_mount_count = cpu_to_le64(lsd->lsd_mount_count);
241 buf->lsd_feature_compat = cpu_to_le32(lsd->lsd_feature_compat);
242 buf->lsd_feature_rocompat = cpu_to_le32(lsd->lsd_feature_rocompat);
243 buf->lsd_feature_incompat = cpu_to_le32(lsd->lsd_feature_incompat);
244 buf->lsd_server_size = cpu_to_le32(lsd->lsd_server_size);
245 buf->lsd_client_start = cpu_to_le32(lsd->lsd_client_start);
246 buf->lsd_client_size = cpu_to_le16(lsd->lsd_client_size);
247 buf->lsd_subdir_count = cpu_to_le16(lsd->lsd_subdir_count);
248 buf->lsd_catalog_oid = cpu_to_le64(lsd->lsd_catalog_oid);
249 buf->lsd_catalog_ogen = cpu_to_le32(lsd->lsd_catalog_ogen);
250 memcpy(buf->lsd_peeruuid, lsd->lsd_peeruuid, sizeof(buf->lsd_peeruuid));
251 buf->lsd_osd_index = cpu_to_le32(lsd->lsd_osd_index);
252 buf->lsd_padding1 = cpu_to_le32(lsd->lsd_padding1);
253 buf->lsd_start_epoch = cpu_to_le32(lsd->lsd_start_epoch);
254 for (i = 0; i < LR_EXPIRE_INTERVALS; i++)
255 buf->lsd_trans_table[i] = cpu_to_le64(lsd->lsd_trans_table[i]);
256 buf->lsd_trans_table_time = cpu_to_le32(lsd->lsd_trans_table_time);
257 buf->lsd_expire_intervals = cpu_to_le32(lsd->lsd_expire_intervals);
260 static inline void lcd_le_to_cpu(struct lsd_client_data *buf,
261 struct lsd_client_data *lcd)
263 memcpy(lcd->lcd_uuid, buf->lcd_uuid, sizeof (lcd->lcd_uuid));
264 lcd->lcd_last_transno = le64_to_cpu(buf->lcd_last_transno);
265 lcd->lcd_last_xid = le64_to_cpu(buf->lcd_last_xid);
266 lcd->lcd_last_result = le32_to_cpu(buf->lcd_last_result);
267 lcd->lcd_last_data = le32_to_cpu(buf->lcd_last_data);
268 lcd->lcd_last_close_transno = le64_to_cpu(buf->lcd_last_close_transno);
269 lcd->lcd_last_close_xid = le64_to_cpu(buf->lcd_last_close_xid);
270 lcd->lcd_last_close_result = le32_to_cpu(buf->lcd_last_close_result);
271 lcd->lcd_last_close_data = le32_to_cpu(buf->lcd_last_close_data);
272 lcd->lcd_pre_versions[0] = le64_to_cpu(buf->lcd_pre_versions[0]);
273 lcd->lcd_pre_versions[1] = le64_to_cpu(buf->lcd_pre_versions[1]);
274 lcd->lcd_pre_versions[2] = le64_to_cpu(buf->lcd_pre_versions[2]);
275 lcd->lcd_pre_versions[3] = le64_to_cpu(buf->lcd_pre_versions[3]);
276 lcd->lcd_last_epoch = le32_to_cpu(buf->lcd_last_epoch);
277 lcd->lcd_generation = le32_to_cpu(buf->lcd_generation);
280 static inline void lcd_cpu_to_le(struct lsd_client_data *lcd,
281 struct lsd_client_data *buf)
283 memcpy(buf->lcd_uuid, lcd->lcd_uuid, sizeof (lcd->lcd_uuid));
284 buf->lcd_last_transno = cpu_to_le64(lcd->lcd_last_transno);
285 buf->lcd_last_xid = cpu_to_le64(lcd->lcd_last_xid);
286 buf->lcd_last_result = cpu_to_le32(lcd->lcd_last_result);
287 buf->lcd_last_data = cpu_to_le32(lcd->lcd_last_data);
288 buf->lcd_last_close_transno = cpu_to_le64(lcd->lcd_last_close_transno);
289 buf->lcd_last_close_xid = cpu_to_le64(lcd->lcd_last_close_xid);
290 buf->lcd_last_close_result = cpu_to_le32(lcd->lcd_last_close_result);
291 buf->lcd_last_close_data = cpu_to_le32(lcd->lcd_last_close_data);
292 buf->lcd_pre_versions[0] = cpu_to_le64(lcd->lcd_pre_versions[0]);
293 buf->lcd_pre_versions[1] = cpu_to_le64(lcd->lcd_pre_versions[1]);
294 buf->lcd_pre_versions[2] = cpu_to_le64(lcd->lcd_pre_versions[2]);
295 buf->lcd_pre_versions[3] = cpu_to_le64(lcd->lcd_pre_versions[3]);
296 buf->lcd_last_epoch = cpu_to_le32(lcd->lcd_last_epoch);
297 buf->lcd_generation = cpu_to_le32(lcd->lcd_generation);
300 static inline u64 lcd_last_transno(struct lsd_client_data *lcd)
302 return (lcd->lcd_last_transno > lcd->lcd_last_close_transno ?
303 lcd->lcd_last_transno : lcd->lcd_last_close_transno);
306 static inline u64 lcd_last_xid(struct lsd_client_data *lcd)
308 return (lcd->lcd_last_xid > lcd->lcd_last_close_xid ?
309 lcd->lcd_last_xid : lcd->lcd_last_close_xid);
312 /****************** mount lookup info *********************/
314 struct lustre_mount_info {
316 struct super_block *lmi_sb;
317 struct list_head lmi_list_chain;
320 /****************** prototypes *********************/
323 int server_name2fsname(const char *svname, char *fsname, const char **endptr);
324 #endif /* HAVE_SERVER_SUPPORT */
326 int server_name2svname(const char *label, char *svname, const char **endptr,
329 #ifdef HAVE_SERVER_SUPPORT
330 int server_name_is_ost(const char *svname);
331 int target_name2index(const char *svname, u32 *idx, const char **endptr);
333 int lustre_put_lsi(struct super_block *sb);
334 int lustre_start_simple(char *obdname, char *type, char *uuid,
335 char *s1, char *s2, char *s3, char *s4);
336 int lustre_start_mgc(struct super_block *sb);
337 #endif /* HAVE_SERVER_SUPPORT */
338 void lustre_register_client_fill_super(int (*cfs)(struct super_block *sb,
339 struct vfsmount *mnt));
340 void lustre_register_kill_super_cb(void (*cfs)(struct super_block *sb));
341 int lustre_common_put_super(struct super_block *sb);
343 # ifdef HAVE_SERVER_SUPPORT
344 /* obd_mount_server.c */
345 int server_fill_super(struct super_block *sb);
346 struct lustre_mount_info *server_get_mount(const char *name);
347 int server_put_mount(const char *name, bool dereg_mnt);
348 struct mgs_target_info;
349 int server_mti_print(const char *title, struct mgs_target_info *mti);
350 void server_calc_timeout(struct lustre_sb_info *lsi, struct obd_device *obd);
353 int mgc_fsname2resid(char *fsname, struct ldlm_res_id *res_id, int type);
354 int mgc_logname2resid(char *fsname, struct ldlm_res_id *res_id, int type);
358 #endif /* _LUSTRE_DISK_H */