1 #ifndef __LINUX_CLASS_OBD_H
2 #define __LINUX_CLASS_OBD_H
4 * Copyright (C) 2001 Cluster File Systems, Inc.
6 * This code is issued under the GNU General Public License.
7 * See the file COPYING in this distribution
11 #include <linux/time.h>
12 #include <linux/obd.h>
14 #include <linux/obd_ext2.h>
15 #include <linux/obd_snap.h>
16 #include <linux/obd_trace.h>
17 /* #include <linux/obd_fc.h> */
18 #include <linux/obd_raid1.h>
19 #include <linux/obd_rpc.h>
23 * ======== OBD type Declarations ===========
26 typedef uint64_t obd_id;
27 typedef uint64_t obd_gr;
28 typedef uint64_t obd_time;
29 typedef uint64_t obd_size;
30 typedef uint64_t obd_off;
31 typedef uint64_t obd_blocks;
32 typedef uint32_t obd_blksize;
33 typedef uint32_t obd_mode;
34 typedef uint32_t obd_uid;
35 typedef uint32_t obd_gid;
36 typedef uint16_t obd_rdev;
37 typedef uint32_t obd_flag;
38 typedef uint32_t obd_count;
40 #define OBD_FL_INLINEDATA (0x00000001UL)
41 #define OBD_FL_OBDMDEXISTS (0x00000002UL)
43 #define OBD_INLINESZ 60
44 #define OBD_OBDMDSZ 60
45 /* Note: 64-bit types are 64-bit aligned in structure */
54 obd_blksize o_blksize;
62 obd_count o_generation;
63 obd_flag o_valid; /* hot fields in this obdo */
64 char o_inline[OBD_INLINESZ];
65 char o_obdmd[OBD_OBDMDSZ];
66 struct list_head o_list;
70 #define OBD_MD_FLALL (~0UL)
71 #define OBD_MD_FLID (0x00000001UL)
72 #define OBD_MD_FLATIME (0x00000002UL)
73 #define OBD_MD_FLMTIME (0x00000004UL)
74 #define OBD_MD_FLCTIME (0x00000008UL)
75 #define OBD_MD_FLSIZE (0x00000010UL)
76 #define OBD_MD_FLBLOCKS (0x00000020UL)
77 #define OBD_MD_FLBLKSZ (0x00000040UL)
78 #define OBD_MD_FLMODE (0x00000080UL)
79 #define OBD_MD_FLUID (0x00000100UL)
80 #define OBD_MD_FLGID (0x00000200UL)
81 #define OBD_MD_FLFLAGS (0x00000400UL)
82 #define OBD_MD_FLOBDFLG (0x00000800UL)
83 #define OBD_MD_FLNLINK (0x00001000UL)
84 #define OBD_MD_FLGENER (0x00002000UL)
85 #define OBD_MD_FLINLINE (0x00004000UL)
86 #define OBD_MD_FLOBDMD (0x00008000UL)
87 #define OBD_MD_FLRDEV (0x00010000UL)
88 #define OBD_MD_FLNOTOBD (~(OBD_MD_FLOBDMD | OBD_MD_FLOBDFLG | OBD_MD_FLBLOCKS))
91 * ======== OBD Device Declarations ===========
95 #define OBD_PSDEV_MAJOR 186
96 #define MAX_OBD_DEVICES 8
100 extern struct obd_device obd_dev[MAX_OBD_DEVICES];
103 #define OBD_ATTACHED 0x1
104 #define OBD_SET_UP 0x2
107 struct obd_device *oc_dev;
114 struct dentry *dentry; /* file system obd device names */
115 __u8 _uuid[16]; /* uuid obd device names */
118 /* corresponds to one of the obdx */
120 struct obd_type *obd_type;
124 obd_devicename obd_fsname;
125 struct proc_dir_entry *obd_proc_entry;
127 struct obd_conn obd_multi_conn[MAX_MULTI];
128 unsigned int obd_gen_last_id;
129 unsigned long obd_gen_prealloc_quota;
130 struct list_head obd_gen_clients;
132 struct ext2_obd ext2;
133 struct raid1_obd raid1;
134 struct snap_obd snap;
135 struct trace_obd trace;
136 /* struct fc_obd fc; */
140 extern struct proc_dir_entry *proc_lustre_register_obd_device(struct obd_device *obd);
141 extern void proc_lustre_release_obd_device(struct obd_device *obd);
142 extern void proc_lustre_remove_obd_entry(const char* name, struct obd_device *obd);
146 * ======== OBD Operations Declarations ===========
149 #define OBD_BRW_READ (READ)
150 #define OBD_BRW_WRITE (WRITE)
151 #define OBD_BRW_RWMASK (READ | WRITE)
152 #define OBD_BRW_CREATE (0x00000010UL)
155 int (*o_iocontrol)(int cmd, struct obd_conn *, int len, void *karg,
157 int (*o_get_info)(struct obd_conn *, obd_count keylen, void *key,
158 obd_count *vallen, void **val);
159 int (*o_set_info)(struct obd_conn *, obd_count keylen, void *key,
160 obd_count vallen, void *val);
161 int (*o_attach)(struct obd_device *dev, obd_count len, void *data);
162 int (*o_detach)(struct obd_device *dev);
163 int (*o_setup) (struct obd_device *dev, obd_count len, void *data);
164 int (*o_cleanup)(struct obd_device *dev);
165 int (*o_connect)(struct obd_conn *conn);
166 int (*o_disconnect)(struct obd_conn *conn);
167 int (*o_statfs)(struct obd_conn *conn, struct statfs *statfs);
168 int (*o_preallocate)(struct obd_conn *, obd_count *req, obd_id *ids);
169 int (*o_create)(struct obd_conn *conn, struct obdo *oa);
170 int (*o_destroy)(struct obd_conn *conn, struct obdo *oa);
171 int (*o_setattr)(struct obd_conn *conn, struct obdo *oa);
172 int (*o_getattr)(struct obd_conn *conn, struct obdo *oa);
173 int (*o_read)(struct obd_conn *conn, struct obdo *oa, char *buf,
174 obd_size *count, obd_off offset);
175 int (*o_write)(struct obd_conn *conn, struct obdo *oa, char *buf,
176 obd_size *count, obd_off offset);
177 int (*o_brw)(int rw, struct obd_conn *conn, obd_count num_oa,
178 struct obdo **oa, obd_count *oa_bufs, struct page **buf,
179 obd_size *count, obd_off *offset, obd_flag *flags);
180 int (*o_punch)(struct obd_conn *conn, struct obdo *tgt, obd_size count,
182 int (*o_sync)(struct obd_conn *conn, struct obdo *tgt, obd_size count,
184 int (*o_migrate)(struct obd_conn *conn, struct obdo *dst,
185 struct obdo *src, obd_size count, obd_off offset);
186 int (*o_copy)(struct obd_conn *dstconn, struct obdo *dst,
187 struct obd_conn *srconn, struct obdo *src,
188 obd_size count, obd_off offset);
189 int (*o_iterate)(struct obd_conn *conn, int (*)(obd_id, obd_gr, void *),
190 obd_id *startid, obd_gr group, void *data);
193 #define OBT(dev) dev->obd_type->typ_ops
194 #define OBP(dev,op) dev->obd_type->typ_ops->o_ ## op
196 /* This value is not arbitrarily chosen. KIO_STATIC_PAGES from linux/iobuf.h */
197 #define MAX_IOVEC (KIO_STATIC_PAGES - 1)
201 * ======== OBD Metadata Support ===========
204 extern int obd_init_obdo_cache(void);
205 extern void obd_cleanup_obdo_cache(void);
208 static inline int obdo_has_inline(struct obdo *obdo)
210 return (obdo->o_valid & OBD_MD_FLINLINE &&
211 obdo->o_obdflags & OBD_FL_INLINEDATA);
214 static inline int obdo_has_obdmd(struct obdo *obdo)
216 return (obdo->o_valid & OBD_MD_FLOBDMD &&
217 obdo->o_obdflags & OBD_FL_OBDMDEXISTS);
220 /* support routines */
221 extern kmem_cache_t *obdo_cachep;
223 static __inline__ struct obdo *obdo_alloc(void)
225 struct obdo *oa = NULL;
227 oa = kmem_cache_alloc(obdo_cachep, SLAB_KERNEL);
228 memset(oa, 0, sizeof (*oa));
233 static __inline__ void obdo_free(struct obdo *oa)
237 kmem_cache_free(obdo_cachep, oa);
242 static __inline__ struct obdo *obdo_fromid(struct obd_conn *conn, obd_id id,
252 return ERR_PTR(-ENOMEM);
254 memset(oa, 0, sizeof(*oa));
257 if ((err = OBP(conn->oc_dev, getattr)(conn, oa))) {
266 static inline void obdo_from_iattr(struct obdo *oa, struct iattr *attr)
268 unsigned int ia_valid = attr->ia_valid;
270 if (ia_valid & ATTR_ATIME) {
271 oa->o_atime = attr->ia_atime;
272 oa->o_valid |= OBD_MD_FLATIME;
274 if (ia_valid & ATTR_MTIME) {
275 oa->o_mtime = attr->ia_mtime;
276 oa->o_valid |= OBD_MD_FLMTIME;
278 if (ia_valid & ATTR_CTIME) {
279 oa->o_ctime = attr->ia_ctime;
280 oa->o_valid |= OBD_MD_FLCTIME;
282 if (ia_valid & ATTR_SIZE) {
283 oa->o_size = attr->ia_size;
284 oa->o_valid |= OBD_MD_FLSIZE;
286 if (ia_valid & ATTR_MODE) {
287 oa->o_mode = attr->ia_mode;
288 oa->o_valid |= OBD_MD_FLMODE;
289 if (!in_group_p(oa->o_gid) && !capable(CAP_FSETID))
290 oa->o_mode &= ~S_ISGID;
292 if (ia_valid & ATTR_UID)
294 oa->o_uid = attr->ia_uid;
295 oa->o_valid |= OBD_MD_FLUID;
297 if (ia_valid & ATTR_GID) {
298 oa->o_gid = attr->ia_gid;
299 oa->o_valid |= OBD_MD_FLGID;
304 static __inline__ void obdo_cpy_md(struct obdo *dst, struct obdo *src)
306 CDEBUG(D_INODE, "src obdo %Ld valid 0x%x, dst obdo %Ld\n",
307 src->o_id, src->o_valid, dst->o_id);
308 if ( src->o_valid & OBD_MD_FLATIME )
309 dst->o_atime = src->o_atime;
310 if ( src->o_valid & OBD_MD_FLMTIME )
311 dst->o_mtime = src->o_mtime;
312 if ( src->o_valid & OBD_MD_FLCTIME )
313 dst->o_ctime = src->o_ctime;
314 if ( src->o_valid & OBD_MD_FLSIZE )
315 dst->o_size = src->o_size;
316 if ( src->o_valid & OBD_MD_FLBLOCKS ) /* allocation of space */
317 dst->o_blocks = src->o_blocks;
318 if ( src->o_valid & OBD_MD_FLBLKSZ )
319 dst->o_blksize = src->o_blksize;
320 if ( src->o_valid & OBD_MD_FLMODE )
321 dst->o_mode = src->o_mode;
322 if ( src->o_valid & OBD_MD_FLUID )
323 dst->o_uid = src->o_uid;
324 if ( src->o_valid & OBD_MD_FLGID )
325 dst->o_gid = src->o_gid;
326 if ( src->o_valid & OBD_MD_FLFLAGS )
327 dst->o_flags = src->o_flags;
328 if ( src->o_valid & OBD_MD_FLRDEV )
329 dst->o_rdev = src->o_rdev;
331 if ( src->o_valid & OBD_MD_FLOBDFLG )
332 dst->o_obdflags = src->o_obdflags;
334 if ( src->o_valid & OBD_MD_FLNLINK )
335 dst->o_nlink = src->o_nlink;
336 if ( src->o_valid & OBD_MD_FLGENER )
337 dst->o_generation = src->o_generation;
338 if ( src->o_valid & OBD_MD_FLINLINE &&
339 src->o_obdflags & OBD_FL_INLINEDATA) {
340 memcpy(dst->o_inline, src->o_inline, sizeof(src->o_inline));
341 dst->o_obdflags |= OBD_FL_INLINEDATA;
343 if ( src->o_valid & OBD_MD_FLOBDMD &&
344 src->o_obdflags & OBD_FL_OBDMDEXISTS) {
345 memcpy(dst->o_obdmd, src->o_obdmd, sizeof(src->o_obdmd));
346 dst->o_obdflags |= OBD_FL_OBDMDEXISTS;
349 dst->o_valid |= src->o_valid;
352 static __inline__ void obdo_from_inode(struct obdo *dst, struct inode *src)
354 if ( dst->o_valid & OBD_MD_FLID )
355 dst->o_id = src->i_ino;
356 if ( dst->o_valid & OBD_MD_FLATIME )
357 dst->o_atime = src->i_atime;
358 if ( dst->o_valid & OBD_MD_FLMTIME )
359 dst->o_mtime = src->i_mtime;
360 if ( dst->o_valid & OBD_MD_FLCTIME )
361 dst->o_ctime = src->i_ctime;
362 if ( dst->o_valid & OBD_MD_FLSIZE )
363 dst->o_size = src->i_size;
364 if ( dst->o_valid & OBD_MD_FLBLOCKS ) /* allocation of space */
365 dst->o_blocks = src->i_blocks;
366 if ( dst->o_valid & OBD_MD_FLBLKSZ )
367 dst->o_blksize = src->i_blksize;
368 if ( dst->o_valid & OBD_MD_FLMODE )
369 dst->o_mode = src->i_mode;
370 if ( dst->o_valid & OBD_MD_FLUID )
371 dst->o_uid = src->i_uid;
372 if ( dst->o_valid & OBD_MD_FLGID )
373 dst->o_gid = src->i_gid;
374 if ( dst->o_valid & OBD_MD_FLRDEV )
375 dst->o_rdev = src->i_rdev;
376 if ( dst->o_valid & OBD_MD_FLFLAGS )
377 dst->o_flags = src->i_flags;
378 if ( dst->o_valid & OBD_MD_FLNLINK )
379 dst->o_nlink = src->i_nlink;
380 if ( dst->o_valid & OBD_MD_FLGENER )
381 dst->o_generation = src->i_generation;
384 static __inline__ void obdo_to_inode(struct inode *dst, struct obdo *src)
387 if ( src->o_valid & OBD_MD_FLID )
388 dst->i_ino = src->o_id;
389 if ( src->o_valid & OBD_MD_FLATIME )
390 dst->i_atime = src->o_atime;
391 if ( src->o_valid & OBD_MD_FLMTIME )
392 dst->i_mtime = src->o_mtime;
393 if ( src->o_valid & OBD_MD_FLCTIME )
394 dst->i_ctime = src->o_ctime;
395 if ( src->o_valid & OBD_MD_FLSIZE )
396 dst->i_size = src->o_size;
397 if ( src->o_valid & OBD_MD_FLBLOCKS ) /* allocation of space */
398 dst->i_blocks = src->o_blocks;
399 if ( src->o_valid & OBD_MD_FLBLKSZ )
400 dst->i_blksize = src->o_blksize;
401 if ( src->o_valid & OBD_MD_FLMODE )
402 dst->i_mode = src->o_mode;
403 if ( src->o_valid & OBD_MD_FLUID )
404 dst->i_uid = src->o_uid;
405 if ( src->o_valid & OBD_MD_FLGID )
406 dst->i_gid = src->o_gid;
407 if ( src->o_valid & OBD_MD_FLRDEV )
408 dst->i_rdev = src->o_rdev;
409 if ( src->o_valid & OBD_MD_FLFLAGS )
410 dst->i_flags = src->o_flags;
411 if ( src->o_valid & OBD_MD_FLNLINK )
412 dst->i_nlink = src->o_nlink;
413 if ( src->o_valid & OBD_MD_FLGENER )
414 dst->i_generation = src->o_generation;
417 /* returns FALSE if comparison (by flags) is same, TRUE if changed */
418 static __inline__ int obdo_cmp_md(struct obdo *dst, struct obdo *src,
423 if ( compare & OBD_MD_FLATIME )
424 res = (res || (dst->o_atime != src->o_atime));
425 if ( compare & OBD_MD_FLMTIME )
426 res = (res || (dst->o_mtime != src->o_mtime));
427 if ( compare & OBD_MD_FLCTIME )
428 res = (res || (dst->o_ctime != src->o_ctime));
429 if ( compare & OBD_MD_FLSIZE )
430 res = (res || (dst->o_size != src->o_size));
431 if ( compare & OBD_MD_FLBLOCKS ) /* allocation of space */
432 res = (res || (dst->o_blocks != src->o_blocks));
433 if ( compare & OBD_MD_FLBLKSZ )
434 res = (res || (dst->o_blksize != src->o_blksize));
435 if ( compare & OBD_MD_FLMODE )
436 res = (res || (dst->o_mode != src->o_mode));
437 if ( compare & OBD_MD_FLUID )
438 res = (res || (dst->o_uid != src->o_uid));
439 if ( compare & OBD_MD_FLGID )
440 res = (res || (dst->o_gid != src->o_gid));
441 if ( compare & OBD_MD_FLRDEV )
442 res = (res || (dst->o_rdev != src->o_rdev));
443 if ( compare & OBD_MD_FLFLAGS )
444 res = (res || (dst->o_flags != src->o_flags));
445 if ( compare & OBD_MD_FLNLINK )
446 res = (res || (dst->o_nlink != src->o_nlink));
447 if ( compare & OBD_MD_FLGENER )
448 res = (res || (dst->o_generation != src->o_generation));
449 /* XXX Don't know if thses should be included here - wasn't previously
450 if ( compare & OBD_MD_FLINLINE )
451 res = (res || memcmp(dst->o_inline, src->o_inline));
452 if ( compare & OBD_MD_FLOBDMD )
453 res = (res || memcmp(dst->o_obdmd, src->o_obdmd));
460 int obd_register_type(struct obd_ops *ops, char *nm);
461 int obd_unregister_type(char *nm);
464 struct list_head cli_chain;
465 struct obd_device *cli_obd;
467 unsigned long cli_prealloc_quota;
468 struct list_head cli_prealloc_inodes;
472 struct obd_prealloc_inode {
473 struct list_head obd_prealloc_chain;
477 /* generic operations shared by various OBD types */
478 int gen_multi_setup(struct obd_device *obddev, uint32_t len, void *data);
479 int gen_multi_cleanup(struct obd_device *obddev);
480 int gen_multi_attach(struct obd_device *obddev, uint32_t len, void *data);
481 int gen_multi_detach(struct obd_device *obddev);
482 int gen_connect (struct obd_conn *conn);
483 int gen_disconnect(struct obd_conn *conn);
484 struct obd_client *gen_client(const struct obd_conn *);
485 int gen_cleanup(struct obd_device *obddev);
486 int gen_copy_data(struct obd_conn *dst_conn, struct obdo *dst,
487 struct obd_conn *src_conn, struct obdo *src,
488 obd_size count, obd_off offset);
493 * ======== OBD IOCL Declarations ===========
504 /* for preallocation */
505 struct oic_prealloc_s {
507 uint32_t alloc; /* user sets it to the number of inodes
508 * requesting to be preallocated. kernel
509 * sets it to the actual number of
510 * succesfully preallocated inodes */
511 obd_id ids[32]; /* actual inode numbers */
514 /* for getattr, setattr, create, destroy */
520 /* for copy, migrate */
522 uint32_t src_conn_id;
524 uint32_t dst_conn_id;
537 /* for punch, sync */
546 #define OBD_IOC_CREATE _IOR ('f', 3, long)
547 #define OBD_IOC_SETUP _IOW ('f', 4, long)
548 #define OBD_IOC_CLEANUP _IO ('f', 5 )
549 #define OBD_IOC_DESTROY _IOW ('f', 6, long)
550 #define OBD_IOC_PREALLOCATE _IOWR('f', 7, long)
551 #define OBD_IOC_DEC_USE_COUNT _IO ('f', 8 )
552 #define OBD_IOC_SETATTR _IOW ('f', 9, long)
553 #define OBD_IOC_GETATTR _IOR ('f', 10, long)
554 #define OBD_IOC_READ _IOWR('f', 11, long)
555 #define OBD_IOC_WRITE _IOWR('f', 12, long)
556 #define OBD_IOC_CONNECT _IOR ('f', 13, long)
557 #define OBD_IOC_DISCONNECT _IOW ('f', 14, long)
558 #define OBD_IOC_STATFS _IOWR('f', 15, long)
559 #define OBD_IOC_SYNC _IOR ('f', 16, long)
560 #define OBD_IOC_READ2 _IOWR('f', 17, long)
561 #define OBD_IOC_FORMAT _IOWR('f', 18, long)
562 #define OBD_IOC_PARTITION _IOWR('f', 19, long)
563 #define OBD_IOC_ATTACH _IOWR('f', 20, long)
564 #define OBD_IOC_DETACH _IOWR('f', 21, long)
565 #define OBD_IOC_COPY _IOWR('f', 22, long)
566 #define OBD_IOC_MIGR _IOWR('f', 23, long)
567 #define OBD_IOC_PUNCH _IOWR('f', 24, long)
569 #define OBD_IOC_DEC_FS_USE_COUNT _IO ('f', 32 )
573 extern void obd_sysctl_init (void);
574 extern void obd_sysctl_clean (void);
576 #define CHKCONN(conn) do { if (!gen_client(conn)) {\
577 printk("%s %d invalid client %u\n", __FILE__, __LINE__, \
579 return -EINVAL; }} while (0)
583 #endif /* __LINUX_CLASS_OBD_H */