1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
2 * vim:expandtab:shiftwidth=8:tabstop=8:
4 * Copyright (C) 2001-2003 Cluster File Systems, Inc. <info@clusterfs.com>
6 * This file is part of Lustre, http://www.lustre.org.
8 * Lustre is free software; you can redistribute it and/or
9 * modify it under the terms of version 2 of the GNU General Public
10 * License as published by the Free Software Foundation.
12 * Lustre is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with Lustre; if not, write to the Free Software
19 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 * MDS data structures.
22 * See also lustre_idl.h for wire formats of requests.
30 # include <linux/fs.h>
31 # include <linux/dcache.h>
34 #include <linux/lustre_handles.h>
35 #include <libcfs/kp30.h>
36 #include <linux/lustre_idl.h>
37 #include <linux/lustre_lib.h>
38 #include <linux/lustre_dlm.h>
39 #include <linux/lustre_log.h>
40 #include <linux/lustre_export.h>
41 #include <linux/lustre_ucache.h>
43 struct ldlm_lock_desc;
45 struct ptlrpc_connection;
48 struct ptlrpc_request;
52 #define OBD_MDS_DEVICENAME "mds"
53 #define OBD_MDT_DEVICENAME "mdt"
54 #define OBD_MDC_DEVICENAME "mdc"
56 struct mds_update_record {
58 struct lustre_id *ur_id1;
59 struct lustre_id *ur_id2;
68 int ur_cookielen; /* obsolete? */
69 struct llog_cookie *ur_logcookies; /* obsolete? */
70 struct iattr ur_iattr;
71 struct lvfs_ucred ur_uc;
78 #define ur_fsuid ur_uc.luc_fsuid
79 #define ur_fsgid ur_uc.luc_fsgid
80 #define ur_cap ur_uc.luc_cap
81 #define ur_uid ur_uc.luc_uid
84 #define MDS_LR_SERVER_SIZE 512
86 #define MDS_LR_CLIENT_START 8192
87 #define MDS_LR_CLIENT_SIZE 128
88 #if MDS_LR_CLIENT_START < MDS_LR_SERVER_SIZE
89 #error "Can't have MDS_LR_CLIENT_START < MDS_LR_SERVER_SIZE"
92 #define MDS_CLIENT_SLOTS 17
94 #define MDS_ROCOMPAT_LOVOBJID 0x00000001
95 #define MDS_ROCOMPAT_SUPP (MDS_ROCOMPAT_LOVOBJID)
97 #define MDS_INCOMPAT_SUPP (0)
99 #define MDS_MASTER_OBD 1
100 #define MDS_CACHE_OBD 0
102 /*flags for indicate the record are come from cmobd reint or
104 #define REC_REINT_CREATE 0x0001
106 /* Data stored per server at the head of the last_rcvd file. In le32 order.
107 * Try to keep this the same as fsd_server_data so we might one day merge. */
108 struct mds_server_data {
109 __u8 msd_uuid[40]; /* server UUID */
110 __u64 msd_last_transno; /* last completed transaction ID */
111 __u64 msd_mount_count; /* MDS incarnation number */
113 __u32 msd_feature_compat; /* compatible feature flags */
114 __u32 msd_feature_rocompat;/* read-only compatible feature flags */
115 __u32 msd_feature_incompat;/* incompatible feature flags */
116 __u32 msd_server_size; /* size of server data area */
117 __u32 msd_client_start; /* start of per-client data area */
118 __u16 msd_client_size; /* size of per-client data area */
119 __u16 msd_subdir_count; /* number of subdirectories for objects */
120 __u64 msd_catalog_oid; /* recovery catalog object id */
121 __u32 msd_catalog_ogen; /* recovery catalog inode generation */
122 __u8 msd_peeruuid[40]; /* UUID of LOV/OSC associated with MDS */
123 __u8 msd_padding[MDS_LR_SERVER_SIZE - 140];
126 /* Data stored per client in the last_rcvd file. In le32 order. */
127 struct mds_client_data {
128 __u8 mcd_uuid[40]; /* client UUID */
129 __u64 mcd_last_transno; /* last completed transaction ID */
130 __u64 mcd_last_xid; /* xid for the last transaction */
131 __u32 mcd_last_result; /* result from last RPC */
132 __u32 mcd_last_data; /* per-op data (disposition for open &c.) */
133 /* for MDS_CLOSE requests */
134 __u64 mcd_last_close_transno; /* last completed transaction ID */
135 __u64 mcd_last_close_xid; /* xid for the last transaction */
136 __u32 mcd_last_close_result; /* result from last RPC */
137 __u32 mcd_last_close_data; /* per-op data (disposition for open &c.) */
138 __u8 mcd_padding[MDS_LR_CLIENT_SIZE - 88];
141 /* uid/gid mapping support for remote client, some of them
142 * probably consume too much space??
144 #define MDS_IDMAP_HASHSIZE (32)
145 #define MDS_IDMAP_HASHFUNC(id) ((id) & (MDS_IDMAP_HASHSIZE - 1))
147 #define MDS_RMT_UIDMAP_IDX (0)
148 #define MDS_LCL_UIDMAP_IDX (1)
149 #define MDS_RMT_GIDMAP_IDX (2)
150 #define MDS_LCL_GIDMAP_IDX (3)
151 #define MDS_IDMAP_N_HASHES (4)
153 #define MDS_IDMAP_NOTFOUND (-1)
155 struct mds_idmap_entry {
156 struct list_head rmt_hash; /* hashed as rmt_id; */
157 struct list_head lcl_hash; /* hashed as lcl_id; */
159 uid_t rmt_id; /* remote uid/gid */
160 uid_t lcl_id; /* local uid/gid */
163 struct mds_idmap_table {
165 struct list_head mit_idmaps[MDS_IDMAP_N_HASHES][MDS_IDMAP_HASHSIZE];
168 /* file data for open files on MDS */
169 struct mds_file_data {
170 struct portals_handle mfd_handle; /* must be first */
171 atomic_t mfd_refcount;
172 struct list_head mfd_list;
175 struct dentry *mfd_dentry;
178 /* group hash table */
179 struct mds_grp_hash_entry {
180 struct list_head ge_hash;
181 struct group_info *ge_group_info;
184 atomic_t ge_refcount;
185 wait_queue_head_t ge_waitq;
186 long ge_acquisition_time;
187 unsigned long ge_acquire_expire;
188 unsigned long ge_expire;
191 #define MDSGRP_HASH_SIZE (128)
192 #define MDSGRP_HASH_INDEX(id) ((id) & (MDSGRP_HASH_SIZE - 1))
193 #define MDSGRP_UPCALL_MAXPATH (1024)
195 struct mds_grp_hash {
196 struct list_head gh_table[MDSGRP_HASH_SIZE];
198 char gh_upcall[MDSGRP_UPCALL_MAXPATH];
200 int gh_acquire_expire;
201 unsigned int gh_allow_setgroups:1;
207 #define PTL_NETID_ANY ((ptl_netid_t) -1)
209 #define LSD_PERM_SETUID 0x00000001
210 #define LSD_PERM_SETGID 0x00000002
211 #define LSD_PERM_SETGRP 0x00000004
213 struct lsd_permission {
219 /* lustre security descriptor */
220 struct lustre_sec_desc {
221 unsigned int lsd_invalid:1;
224 struct group_info *lsd_ginfo;
226 struct lsd_permission *lsd_perms;
229 struct lsd_cache_entry {
230 struct upcall_cache_entry base;
231 struct lustre_sec_desc lsd;
234 struct lsd_downcall_args {
241 struct lsd_permission *perms;
244 /* remote acl upcall */
245 struct rmtacl_upcall_desc {
246 int status; /* helper execution status */
247 int upcall_status; /* error in upcall itself */
248 int get; /* is getfacl */
249 char *cmd; /* cmdline (up) */
250 __u32 cmdlen; /* cmdline length (up) */
251 char *res; /* output (down) */
252 __u32 reslen; /* output length (down) */
253 /* upcall internal use */
258 struct rmtacl_upcall_entry {
259 struct upcall_cache_entry base;
260 struct rmtacl_upcall_desc *desc;
263 struct rmtacl_downcall_args {
265 char *res; /* output text */
266 __u32 reslen; /* output text length */
267 int status; /* helper exit code */
270 /* mds/mds_reint.c */
271 int mds_reint_rec(struct mds_update_record *r, int offset,
272 struct ptlrpc_request *req, struct lustre_handle *);
275 __u32 mds_lsd_get_perms(struct lustre_sec_desc *lsd, __u32 is_remote,
276 ptl_netid_t netid, ptl_nid_t nid);
281 mds_id2dentry(struct obd_device *obd, struct lustre_id *id,
282 struct vfsmount **mnt);
285 mds_id2locked_dentry(struct obd_device *obd, struct lustre_id *id,
286 struct vfsmount **mnt, int lock_mode,
287 struct lustre_handle *lockh, int *pmode,
288 char *name, int namelen, __u64 lockpart);
289 int mds_update_server_data(struct obd_device *, int force_sync);
290 int mds_update_last_fid(struct obd_device *obd, void *handle,
294 int mds_fs_setup(struct obd_device *obddev, struct vfsmount *mnt);
295 int mds_fs_cleanup(struct obd_device *obddev, int failover);
300 /* mdc/mdc_locks.c */
301 int it_disposition(struct lookup_intent *it, int flag);
302 void it_set_disposition(struct lookup_intent *it, int flag);
303 int it_open_error(int phase, struct lookup_intent *it);
304 int mdc_set_lock_data(struct obd_export *exp, __u64 *lockh, void *data);
305 int mdc_change_cbdata(struct obd_export *exp, struct lustre_id *id,
306 ldlm_iterator_t it, void *data);
307 int mdc_intent_lock(struct obd_export *exp, struct lustre_id *parent,
308 const char *name, int len, void *lmm, int lmmsize,
309 struct lustre_id *child, struct lookup_intent *, int,
310 struct ptlrpc_request **reqp,
311 ldlm_blocking_callback cb_blocking);
312 int mdc_enqueue(struct obd_export *exp,
314 struct lookup_intent *it,
316 struct mdc_op_data *data,
317 struct lustre_handle *lockh,
320 ldlm_completion_callback cb_completion,
321 ldlm_blocking_callback cb_blocking,
324 /* mdc/mdc_request.c */
325 int mdc_req2lustre_md(struct obd_export *exp_lmv, struct ptlrpc_request *req,
326 unsigned int offset, struct obd_export *exp_lov,
327 struct lustre_md *md);
328 int mdc_getstatus(struct obd_export *exp, struct lustre_id *rootid);
329 int mdc_getattr(struct obd_export *exp, struct lustre_id *id,
330 __u64 valid, const char *xattr_name,
331 const void *xattr_data, unsigned int xattr_datalen,
332 unsigned int ea_size, struct ptlrpc_request **request);
333 int mdc_getattr_lock(struct obd_export *exp, struct lustre_id *id,
334 char *filename, int namelen, __u64 valid,
335 unsigned int ea_size, struct ptlrpc_request **request);
336 int mdc_setattr(struct obd_export *exp, struct mdc_op_data *data,
337 struct iattr *iattr, void *ea, int ealen, void *ea2, int ea2len,
338 struct ptlrpc_request **request);
339 int mdc_open(struct obd_export *exp, obd_id ino, int type, int flags,
340 struct lov_mds_md *lmm, int lmm_size, struct lustre_handle *fh,
341 struct ptlrpc_request **);
343 struct obd_client_handle;
345 int mdc_set_open_replay_data(struct obd_export *exp,
346 struct obd_client_handle *och,
347 struct ptlrpc_request *open_req);
348 int mdc_clear_open_replay_data(struct obd_export *exp,
349 struct obd_client_handle *och);
350 int mdc_close(struct obd_export *, struct obdo *, struct obd_client_handle *,
351 struct ptlrpc_request **);
352 int mdc_readpage(struct obd_export *exp, struct lustre_id *id,
353 __u64, struct page *, struct ptlrpc_request **);
354 int mdc_create(struct obd_export *exp, struct mdc_op_data *op_data,
355 const void *data, int datalen, int mode, __u32 uid, __u32 gid,
356 __u64 rdev, struct ptlrpc_request **request);
357 int mdc_unlink(struct obd_export *exp, struct mdc_op_data *data,
358 struct ptlrpc_request **request);
359 int mdc_link(struct obd_export *exp, struct mdc_op_data *data,
360 struct ptlrpc_request **);
361 int mdc_rename(struct obd_export *exp, struct mdc_op_data *data,
362 const char *old, int oldlen, const char *new, int newlen,
363 struct ptlrpc_request **request);
364 int mdc_sync(struct obd_export *exp, struct lustre_id *id,
365 struct ptlrpc_request **);
366 int mdc_create_client(struct obd_uuid uuid, struct ptlrpc_client *cl);
368 /* store the generation of a newly-created inode in |req| for replay. */
369 int mdc_store_inode_generation(struct obd_export *exp,
370 struct ptlrpc_request *req,
371 int reqoff, int repoff);
373 int mdc_llog_process(struct obd_export *, char *, llog_cb_t,
376 int mdc_done_writing(struct obd_export *, struct obdo *);
378 /* ioctls for trying requests */
379 #define IOC_REQUEST_TYPE 'f'
380 #define IOC_REQUEST_MIN_NR 30
382 #define IOC_REQUEST_GETATTR _IOWR('f', 30, long)
383 #define IOC_REQUEST_READPAGE _IOWR('f', 31, long)
384 #define IOC_REQUEST_SETATTR _IOWR('f', 32, long)
385 #define IOC_REQUEST_CREATE _IOWR('f', 33, long)
386 #define IOC_REQUEST_OPEN _IOWR('f', 34, long)
387 #define IOC_REQUEST_CLOSE _IOWR('f', 35, long)
388 #define IOC_REQUEST_MAX_NR 35
390 #define MDS_CHECK_RESENT(req, reconstruct) \
392 if (lustre_msg_get_flags(req->rq_reqmsg) & MSG_RESENT) { \
393 struct mds_client_data *mcd = \
394 req->rq_export->exp_mds_data.med_mcd; \
396 if (le64_to_cpu(mcd->mcd_last_xid) == req->rq_xid) { \
398 RETURN(le32_to_cpu(mcd->mcd_last_result)); \
400 if (le64_to_cpu(mcd->mcd_last_close_xid) == req->rq_xid) { \
402 RETURN(le32_to_cpu(mcd->mcd_last_close_result));\
404 DEBUG_REQ(D_HA, req, "no reply for RESENT req" \
405 "(have "LPD64", and "LPD64")", \
406 mcd->mcd_last_xid, mcd->mcd_last_close_xid); \