25793559a2e5ceb2026257fc8ac8dcbfd313d482
[linux-3.10.git] / fs / ceph / super.h
1 #ifndef _FS_CEPH_SUPER_H
2 #define _FS_CEPH_SUPER_H
3
4 #include "ceph_debug.h"
5
6 #include <asm/unaligned.h>
7 #include <linux/backing-dev.h>
8 #include <linux/completion.h>
9 #include <linux/exportfs.h>
10 #include <linux/fs.h>
11 #include <linux/mempool.h>
12 #include <linux/pagemap.h>
13 #include <linux/wait.h>
14
15 #include "types.h"
16 #include "messenger.h"
17 #include "msgpool.h"
18 #include "mon_client.h"
19 #include "mds_client.h"
20 #include "osd_client.h"
21 #include "ceph_fs.h"
22
23 /* f_type in struct statfs */
24 #define CEPH_SUPER_MAGIC 0x00c36400
25
26 /* large granularity for statfs utilization stats to facilitate
27  * large volume sizes on 32-bit machines. */
28 #define CEPH_BLOCK_SHIFT   20  /* 1 MB */
29 #define CEPH_BLOCK         (1 << CEPH_BLOCK_SHIFT)
30
31 /*
32  * mount options
33  */
34 #define CEPH_OPT_FSID             (1<<0)
35 #define CEPH_OPT_NOSHARE          (1<<1) /* don't share client with other sbs */
36 #define CEPH_OPT_MYIP             (1<<2) /* specified my ip */
37 #define CEPH_OPT_DIRSTAT          (1<<4) /* funky `cat dirname` for stats */
38 #define CEPH_OPT_RBYTES           (1<<5) /* dir st_bytes = rbytes */
39 #define CEPH_OPT_NOCRC            (1<<6) /* no data crc on writes */
40 #define CEPH_OPT_NOASYNCREADDIR   (1<<7) /* no dcache readdir */
41
42 #define CEPH_OPT_DEFAULT   (CEPH_OPT_RBYTES)
43
44 #define ceph_set_opt(client, opt) \
45         (client)->mount_args->flags |= CEPH_OPT_##opt;
46 #define ceph_test_opt(client, opt) \
47         (!!((client)->mount_args->flags & CEPH_OPT_##opt))
48
49
50 struct ceph_mount_args {
51         int sb_flags;
52         int num_mon;
53         struct ceph_entity_addr *mon_addr;
54         int flags;
55         int mount_timeout;
56         int caps_wanted_delay_min, caps_wanted_delay_max;
57         struct ceph_fsid fsid;
58         struct ceph_entity_addr my_addr;
59         int wsize;
60         int rsize;            /* max readahead */
61         int max_readdir;      /* max readdir size */
62         int osd_timeout;
63         char *snapdir_name;   /* default ".snap" */
64         char *secret;
65         int cap_release_safety;
66 };
67
68 /*
69  * defaults
70  */
71 #define CEPH_MOUNT_TIMEOUT_DEFAULT  60
72 #define CEPH_MOUNT_RSIZE_DEFAULT    (512*1024) /* readahead */
73
74 #define CEPH_MSG_MAX_FRONT_LEN  (16*1024*1024)
75 #define CEPH_MSG_MAX_DATA_LEN   (16*1024*1024)
76
77 #define CEPH_SNAPDIRNAME_DEFAULT ".snap"
78
79 /*
80  * Delay telling the MDS we no longer want caps, in case we reopen
81  * the file.  Delay a minimum amount of time, even if we send a cap
82  * message for some other reason.  Otherwise, take the oppotunity to
83  * update the mds to avoid sending another message later.
84  */
85 #define CEPH_CAPS_WANTED_DELAY_MIN_DEFAULT      5  /* cap release delay */
86 #define CEPH_CAPS_WANTED_DELAY_MAX_DEFAULT     60  /* cap release delay */
87
88
89 /* mount state */
90 enum {
91         CEPH_MOUNT_MOUNTING,
92         CEPH_MOUNT_MOUNTED,
93         CEPH_MOUNT_UNMOUNTING,
94         CEPH_MOUNT_UNMOUNTED,
95         CEPH_MOUNT_SHUTDOWN,
96 };
97
98 /*
99  * subtract jiffies
100  */
101 static inline unsigned long time_sub(unsigned long a, unsigned long b)
102 {
103         BUG_ON(time_after(b, a));
104         return (long)a - (long)b;
105 }
106
107 /*
108  * per-filesystem client state
109  *
110  * possibly shared by multiple mount points, if they are
111  * mounting the same ceph filesystem/cluster.
112  */
113 struct ceph_client {
114         __s64 whoami;                   /* my client number */
115         struct dentry *debugfs_monmap;
116         struct dentry *debugfs_mdsmap, *debugfs_osdmap;
117         struct dentry *debugfs_dir, *debugfs_dentry_lru, *debugfs_caps;
118
119         struct mutex mount_mutex;       /* serialize mount attempts */
120         struct ceph_mount_args *mount_args;
121         struct ceph_fsid fsid;
122
123         struct super_block *sb;
124
125         unsigned long mount_state;
126         wait_queue_head_t mount_wq;
127
128         int mount_err;
129         void *signed_ticket;           /* our keys to the kingdom */
130         int signed_ticket_len;
131
132         struct ceph_messenger *msgr;   /* messenger instance */
133         struct ceph_mon_client monc;
134         struct ceph_mds_client mdsc;
135         struct ceph_osd_client osdc;
136
137         /* writeback */
138         mempool_t *wb_pagevec_pool;
139         struct workqueue_struct *wb_wq;
140         struct workqueue_struct *pg_inv_wq;
141         struct workqueue_struct *trunc_wq;
142
143         struct backing_dev_info backing_dev_info;
144 };
145
146 static inline struct ceph_client *ceph_client(struct super_block *sb)
147 {
148         return sb->s_fs_info;
149 }
150
151
152 /*
153  * File i/o capability.  This tracks shared state with the metadata
154  * server that allows us to cache or writeback attributes or to read
155  * and write data.  For any given inode, we should have one or more
156  * capabilities, one issued by each metadata server, and our
157  * cumulative access is the OR of all issued capabilities.
158  *
159  * Each cap is referenced by the inode's i_caps rbtree and by per-mds
160  * session capability lists.
161  */
162 struct ceph_cap {
163         struct ceph_inode_info *ci;
164         struct rb_node ci_node;          /* per-ci cap tree */
165         struct ceph_mds_session *session;
166         struct list_head session_caps;   /* per-session caplist */
167         int mds;
168         u64 cap_id;       /* unique cap id (mds provided) */
169         int issued;       /* latest, from the mds */
170         int implemented;  /* implemented superset of issued (for revocation) */
171         int mds_wanted;
172         u32 seq, issue_seq, mseq;
173         u32 cap_gen;      /* active/stale cycle */
174         u32 recon_gen;    /* mds restart reconnect cycle */
175         unsigned long last_used;
176         struct list_head caps_item;
177 };
178
179 #define CHECK_CAPS_NODELAY    1  /* do not delay any further */
180 #define CHECK_CAPS_AUTHONLY   2  /* only check auth cap */
181 #define CHECK_CAPS_FLUSH      4  /* flush any dirty caps */
182
183 /*
184  * Snapped cap state that is pending flush to mds.  When a snapshot occurs,
185  * we first complete any in-process sync writes and writeback any dirty
186  * data before flushing the snapped state (tracked here) back to the MDS.
187  */
188 struct ceph_cap_snap {
189         atomic_t nref;
190         struct ceph_inode_info *ci;
191         struct list_head ci_item, flushing_item;
192
193         u64 follows, flush_tid;
194         int issued, dirty;
195         struct ceph_snap_context *context;
196
197         mode_t mode;
198         uid_t uid;
199         gid_t gid;
200
201         void *xattr_blob;
202         int xattr_len;
203         u64 xattr_version;
204
205         u64 size;
206         struct timespec mtime, atime, ctime;
207         u64 time_warp_seq;
208         int writing;   /* a sync write is still in progress */
209         int dirty_pages;     /* dirty pages awaiting writeback */
210 };
211
212 static inline void ceph_put_cap_snap(struct ceph_cap_snap *capsnap)
213 {
214         if (atomic_dec_and_test(&capsnap->nref))
215                 kfree(capsnap);
216 }
217
218 /*
219  * The frag tree describes how a directory is fragmented, potentially across
220  * multiple metadata servers.  It is also used to indicate points where
221  * metadata authority is delegated, and whether/where metadata is replicated.
222  *
223  * A _leaf_ frag will be present in the i_fragtree IFF there is
224  * delegation info.  That is, if mds >= 0 || ndist > 0.
225  */
226 #define CEPH_MAX_DIRFRAG_REP 4
227
228 struct ceph_inode_frag {
229         struct rb_node node;
230
231         /* fragtree state */
232         u32 frag;
233         int split_by;         /* i.e. 2^(split_by) children */
234
235         /* delegation and replication info */
236         int mds;              /* -1 if same authority as parent */
237         int ndist;            /* >0 if replicated */
238         int dist[CEPH_MAX_DIRFRAG_REP];
239 };
240
241 /*
242  * We cache inode xattrs as an encoded blob until they are first used,
243  * at which point we parse them into an rbtree.
244  */
245 struct ceph_inode_xattr {
246         struct rb_node node;
247
248         const char *name;
249         int name_len;
250         const char *val;
251         int val_len;
252         int dirty;
253
254         int should_free_name;
255         int should_free_val;
256 };
257
258 struct ceph_inode_xattrs_info {
259         /*
260          * (still encoded) xattr blob. we avoid the overhead of parsing
261          * this until someone actually calls getxattr, etc.
262          *
263          * blob->vec.iov_len == 4 implies there are no xattrs; blob ==
264          * NULL means we don't know.
265         */
266         struct ceph_buffer *blob, *prealloc_blob;
267
268         struct rb_root index;
269         bool dirty;
270         int count;
271         int names_size;
272         int vals_size;
273         u64 version, index_version;
274 };
275
276 /*
277  * Ceph inode.
278  */
279 #define CEPH_I_COMPLETE  1  /* we have complete directory cached */
280 #define CEPH_I_NODELAY   4  /* do not delay cap release */
281 #define CEPH_I_FLUSH     8  /* do not delay flush of dirty metadata */
282
283 struct ceph_inode_info {
284         struct ceph_vino i_vino;   /* ceph ino + snap */
285
286         u64 i_version;
287         u32 i_time_warp_seq;
288
289         unsigned i_ceph_flags;
290         unsigned long i_release_count;
291
292         struct ceph_file_layout i_layout;
293         char *i_symlink;
294
295         /* for dirs */
296         struct timespec i_rctime;
297         u64 i_rbytes, i_rfiles, i_rsubdirs;
298         u64 i_files, i_subdirs;
299         u64 i_max_offset;  /* largest readdir offset, set with I_COMPLETE */
300
301         struct rb_root i_fragtree;
302         struct mutex i_fragtree_mutex;
303
304         struct ceph_inode_xattrs_info i_xattrs;
305
306         /* capabilities.  protected _both_ by i_lock and cap->session's
307          * s_mutex. */
308         struct rb_root i_caps;           /* cap list */
309         struct ceph_cap *i_auth_cap;     /* authoritative cap, if any */
310         unsigned i_dirty_caps, i_flushing_caps;     /* mask of dirtied fields */
311         struct list_head i_dirty_item, i_flushing_item;
312         u64 i_cap_flush_seq;
313         /* we need to track cap writeback on a per-cap-bit basis, to allow
314          * overlapping, pipelined cap flushes to the mds.  we can probably
315          * reduce the tid to 8 bits if we're concerned about inode size. */
316         u16 i_cap_flush_last_tid, i_cap_flush_tid[CEPH_CAP_BITS];
317         wait_queue_head_t i_cap_wq;      /* threads waiting on a capability */
318         unsigned long i_hold_caps_min; /* jiffies */
319         unsigned long i_hold_caps_max; /* jiffies */
320         struct list_head i_cap_delay_list;  /* for delayed cap release to mds */
321         int i_cap_exporting_mds;         /* to handle cap migration between */
322         unsigned i_cap_exporting_mseq;   /*  mds's. */
323         unsigned i_cap_exporting_issued;
324         struct ceph_cap_reservation i_cap_migration_resv;
325         struct list_head i_cap_snaps;   /* snapped state pending flush to mds */
326         struct ceph_snap_context *i_head_snapc;  /* set if wr_buffer_head > 0 */
327         unsigned i_snap_caps;           /* cap bits for snapped files */
328
329         int i_nr_by_mode[CEPH_FILE_MODE_NUM];  /* open file counts */
330
331         u32 i_truncate_seq;        /* last truncate to smaller size */
332         u64 i_truncate_size;       /*  and the size we last truncated down to */
333         int i_truncate_pending;    /*  still need to call vmtruncate */
334
335         u64 i_max_size;            /* max file size authorized by mds */
336         u64 i_reported_size; /* (max_)size reported to or requested of mds */
337         u64 i_wanted_max_size;     /* offset we'd like to write too */
338         u64 i_requested_max_size;  /* max_size we've requested */
339
340         /* held references to caps */
341         int i_pin_ref;
342         int i_rd_ref, i_rdcache_ref, i_wr_ref;
343         int i_wrbuffer_ref, i_wrbuffer_ref_head;
344         u32 i_shared_gen;       /* increment each time we get FILE_SHARED */
345         u32 i_rdcache_gen;      /* we increment this each time we get
346                                    FILE_CACHE.  If it's non-zero, we
347                                    _may_ have cached pages. */
348         u32 i_rdcache_revoking; /* RDCACHE gen to async invalidate, if any */
349
350         struct list_head i_unsafe_writes; /* uncommitted sync writes */
351         struct list_head i_unsafe_dirops; /* uncommitted mds dir ops */
352         spinlock_t i_unsafe_lock;
353
354         struct ceph_snap_realm *i_snap_realm; /* snap realm (if caps) */
355         int i_snap_realm_counter; /* snap realm (if caps) */
356         struct list_head i_snap_realm_item;
357         struct list_head i_snap_flush_item;
358
359         struct work_struct i_wb_work;  /* writeback work */
360         struct work_struct i_pg_inv_work;  /* page invalidation work */
361
362         struct work_struct i_vmtruncate_work;
363
364         struct inode vfs_inode; /* at end */
365 };
366
367 static inline struct ceph_inode_info *ceph_inode(struct inode *inode)
368 {
369         return container_of(inode, struct ceph_inode_info, vfs_inode);
370 }
371
372 static inline void ceph_i_clear(struct inode *inode, unsigned mask)
373 {
374         struct ceph_inode_info *ci = ceph_inode(inode);
375
376         spin_lock(&inode->i_lock);
377         ci->i_ceph_flags &= ~mask;
378         spin_unlock(&inode->i_lock);
379 }
380
381 static inline void ceph_i_set(struct inode *inode, unsigned mask)
382 {
383         struct ceph_inode_info *ci = ceph_inode(inode);
384
385         spin_lock(&inode->i_lock);
386         ci->i_ceph_flags |= mask;
387         spin_unlock(&inode->i_lock);
388 }
389
390 static inline bool ceph_i_test(struct inode *inode, unsigned mask)
391 {
392         struct ceph_inode_info *ci = ceph_inode(inode);
393         bool r;
394
395         smp_mb();
396         r = (ci->i_ceph_flags & mask) == mask;
397         return r;
398 }
399
400
401 /* find a specific frag @f */
402 extern struct ceph_inode_frag *__ceph_find_frag(struct ceph_inode_info *ci,
403                                                 u32 f);
404
405 /*
406  * choose fragment for value @v.  copy frag content to pfrag, if leaf
407  * exists
408  */
409 extern u32 ceph_choose_frag(struct ceph_inode_info *ci, u32 v,
410                             struct ceph_inode_frag *pfrag,
411                             int *found);
412
413 /*
414  * Ceph dentry state
415  */
416 struct ceph_dentry_info {
417         struct ceph_mds_session *lease_session;
418         u32 lease_gen, lease_shared_gen;
419         u32 lease_seq;
420         unsigned long lease_renew_after, lease_renew_from;
421         struct list_head lru;
422         struct dentry *dentry;
423         u64 time;
424         u64 offset;
425 };
426
427 static inline struct ceph_dentry_info *ceph_dentry(struct dentry *dentry)
428 {
429         return (struct ceph_dentry_info *)dentry->d_fsdata;
430 }
431
432 static inline loff_t ceph_make_fpos(unsigned frag, unsigned off)
433 {
434         return ((loff_t)frag << 32) | (loff_t)off;
435 }
436
437 /*
438  * ino_t is <64 bits on many architectures, blech.
439  *
440  * don't include snap in ino hash, at least for now.
441  */
442 static inline ino_t ceph_vino_to_ino(struct ceph_vino vino)
443 {
444         ino_t ino = (ino_t)vino.ino;  /* ^ (vino.snap << 20); */
445 #if BITS_PER_LONG == 32
446         ino ^= vino.ino >> (sizeof(u64)-sizeof(ino_t)) * 8;
447         if (!ino)
448                 ino = 1;
449 #endif
450         return ino;
451 }
452
453 static inline int ceph_set_ino_cb(struct inode *inode, void *data)
454 {
455         ceph_inode(inode)->i_vino = *(struct ceph_vino *)data;
456         inode->i_ino = ceph_vino_to_ino(*(struct ceph_vino *)data);
457         return 0;
458 }
459
460 static inline struct ceph_vino ceph_vino(struct inode *inode)
461 {
462         return ceph_inode(inode)->i_vino;
463 }
464
465 /* for printf-style formatting */
466 #define ceph_vinop(i) ceph_inode(i)->i_vino.ino, ceph_inode(i)->i_vino.snap
467
468 static inline u64 ceph_ino(struct inode *inode)
469 {
470         return ceph_inode(inode)->i_vino.ino;
471 }
472 static inline u64 ceph_snap(struct inode *inode)
473 {
474         return ceph_inode(inode)->i_vino.snap;
475 }
476
477 static inline int ceph_ino_compare(struct inode *inode, void *data)
478 {
479         struct ceph_vino *pvino = (struct ceph_vino *)data;
480         struct ceph_inode_info *ci = ceph_inode(inode);
481         return ci->i_vino.ino == pvino->ino &&
482                 ci->i_vino.snap == pvino->snap;
483 }
484
485 static inline struct inode *ceph_find_inode(struct super_block *sb,
486                                             struct ceph_vino vino)
487 {
488         ino_t t = ceph_vino_to_ino(vino);
489         return ilookup5(sb, t, ceph_ino_compare, &vino);
490 }
491
492
493 /*
494  * caps helpers
495  */
496 static inline bool __ceph_is_any_real_caps(struct ceph_inode_info *ci)
497 {
498         return !RB_EMPTY_ROOT(&ci->i_caps);
499 }
500
501 extern int __ceph_caps_issued(struct ceph_inode_info *ci, int *implemented);
502 extern int __ceph_caps_issued_mask(struct ceph_inode_info *ci, int mask, int t);
503 extern int __ceph_caps_issued_other(struct ceph_inode_info *ci,
504                                     struct ceph_cap *cap);
505
506 static inline int ceph_caps_issued(struct ceph_inode_info *ci)
507 {
508         int issued;
509         spin_lock(&ci->vfs_inode.i_lock);
510         issued = __ceph_caps_issued(ci, NULL);
511         spin_unlock(&ci->vfs_inode.i_lock);
512         return issued;
513 }
514
515 static inline int ceph_caps_issued_mask(struct ceph_inode_info *ci, int mask,
516                                         int touch)
517 {
518         int r;
519         spin_lock(&ci->vfs_inode.i_lock);
520         r = __ceph_caps_issued_mask(ci, mask, touch);
521         spin_unlock(&ci->vfs_inode.i_lock);
522         return r;
523 }
524
525 static inline int __ceph_caps_dirty(struct ceph_inode_info *ci)
526 {
527         return ci->i_dirty_caps | ci->i_flushing_caps;
528 }
529 extern void __ceph_mark_dirty_caps(struct ceph_inode_info *ci, int mask);
530
531 extern int ceph_caps_revoking(struct ceph_inode_info *ci, int mask);
532 extern int __ceph_caps_used(struct ceph_inode_info *ci);
533
534 extern int __ceph_caps_file_wanted(struct ceph_inode_info *ci);
535
536 /*
537  * wanted, by virtue of open file modes AND cap refs (buffered/cached data)
538  */
539 static inline int __ceph_caps_wanted(struct ceph_inode_info *ci)
540 {
541         int w = __ceph_caps_file_wanted(ci) | __ceph_caps_used(ci);
542         if (w & CEPH_CAP_FILE_BUFFER)
543                 w |= CEPH_CAP_FILE_EXCL;  /* we want EXCL if dirty data */
544         return w;
545 }
546
547 /* what the mds thinks we want */
548 extern int __ceph_caps_mds_wanted(struct ceph_inode_info *ci);
549
550 extern void ceph_caps_init(void);
551 extern void ceph_caps_finalize(void);
552 extern int ceph_reserve_caps(struct ceph_cap_reservation *ctx, int need);
553 extern int ceph_unreserve_caps(struct ceph_cap_reservation *ctx);
554 extern void ceph_reservation_status(struct ceph_client *client,
555                                     int *total, int *avail, int *used,
556                                     int *reserved);
557
558 static inline struct ceph_client *ceph_inode_to_client(struct inode *inode)
559 {
560         return (struct ceph_client *)inode->i_sb->s_fs_info;
561 }
562
563 static inline struct ceph_client *ceph_sb_to_client(struct super_block *sb)
564 {
565         return (struct ceph_client *)sb->s_fs_info;
566 }
567
568 static inline int ceph_queue_writeback(struct inode *inode)
569 {
570         return queue_work(ceph_inode_to_client(inode)->wb_wq,
571                    &ceph_inode(inode)->i_wb_work);
572 }
573
574 static inline int ceph_queue_page_invalidation(struct inode *inode)
575 {
576         return queue_work(ceph_inode_to_client(inode)->pg_inv_wq,
577                    &ceph_inode(inode)->i_pg_inv_work);
578 }
579
580
581 /*
582  * we keep buffered readdir results attached to file->private_data
583  */
584 struct ceph_file_info {
585         int fmode;     /* initialized on open */
586
587         /* readdir: position within the dir */
588         u32 frag;
589         struct ceph_mds_request *last_readdir;
590         int at_end;
591
592         /* readdir: position within a frag */
593         unsigned offset;       /* offset of last chunk, adjusted for . and .. */
594         u64 next_offset;       /* offset of next chunk (last_name's + 1) */
595         char *last_name;       /* last entry in previous chunk */
596         struct dentry *dentry; /* next dentry (for dcache readdir) */
597         unsigned long dir_release_count;
598
599         /* used for -o dirstat read() on directory thing */
600         char *dir_info;
601         int dir_info_len;
602 };
603
604
605
606 /*
607  * snapshots
608  */
609
610 /*
611  * A "snap context" is the set of existing snapshots when we
612  * write data.  It is used by the OSD to guide its COW behavior.
613  *
614  * The ceph_snap_context is refcounted, and attached to each dirty
615  * page, indicating which context the dirty data belonged when it was
616  * dirtied.
617  */
618 struct ceph_snap_context {
619         atomic_t nref;
620         u64 seq;
621         int num_snaps;
622         u64 snaps[];
623 };
624
625 static inline struct ceph_snap_context *
626 ceph_get_snap_context(struct ceph_snap_context *sc)
627 {
628         /*
629         printk("get_snap_context %p %d -> %d\n", sc, atomic_read(&sc->nref),
630                atomic_read(&sc->nref)+1);
631         */
632         if (sc)
633                 atomic_inc(&sc->nref);
634         return sc;
635 }
636
637 static inline void ceph_put_snap_context(struct ceph_snap_context *sc)
638 {
639         if (!sc)
640                 return;
641         /*
642         printk("put_snap_context %p %d -> %d\n", sc, atomic_read(&sc->nref),
643                atomic_read(&sc->nref)-1);
644         */
645         if (atomic_dec_and_test(&sc->nref)) {
646                 /*printk(" deleting snap_context %p\n", sc);*/
647                 kfree(sc);
648         }
649 }
650
651 /*
652  * A "snap realm" describes a subset of the file hierarchy sharing
653  * the same set of snapshots that apply to it.  The realms themselves
654  * are organized into a hierarchy, such that children inherit (some of)
655  * the snapshots of their parents.
656  *
657  * All inodes within the realm that have capabilities are linked into a
658  * per-realm list.
659  */
660 struct ceph_snap_realm {
661         u64 ino;
662         atomic_t nref;
663         u64 created, seq;
664         u64 parent_ino;
665         u64 parent_since;   /* snapid when our current parent became so */
666
667         u64 *prior_parent_snaps;      /* snaps inherited from any parents we */
668         int num_prior_parent_snaps;   /*  had prior to parent_since */
669         u64 *snaps;                   /* snaps specific to this realm */
670         int num_snaps;
671
672         struct ceph_snap_realm *parent;
673         struct list_head children;       /* list of child realms */
674         struct list_head child_item;
675
676         struct list_head empty_item;     /* if i have ref==0 */
677
678         /* the current set of snaps for this realm */
679         struct ceph_snap_context *cached_context;
680
681         struct list_head inodes_with_caps;
682         spinlock_t inodes_with_caps_lock;
683 };
684
685
686
687 /*
688  * calculate the number of pages a given length and offset map onto,
689  * if we align the data.
690  */
691 static inline int calc_pages_for(u64 off, u64 len)
692 {
693         return ((off+len+PAGE_CACHE_SIZE-1) >> PAGE_CACHE_SHIFT) -
694                 (off >> PAGE_CACHE_SHIFT);
695 }
696
697
698
699 /* snap.c */
700 struct ceph_snap_realm *ceph_lookup_snap_realm(struct ceph_mds_client *mdsc,
701                                                u64 ino);
702 extern void ceph_get_snap_realm(struct ceph_mds_client *mdsc,
703                                 struct ceph_snap_realm *realm);
704 extern void ceph_put_snap_realm(struct ceph_mds_client *mdsc,
705                                 struct ceph_snap_realm *realm);
706 extern int ceph_update_snap_trace(struct ceph_mds_client *m,
707                                   void *p, void *e, bool deletion);
708 extern void ceph_handle_snap(struct ceph_mds_client *mdsc,
709                              struct ceph_msg *msg);
710 extern void ceph_queue_cap_snap(struct ceph_inode_info *ci,
711                                 struct ceph_snap_context *snapc);
712 extern int __ceph_finish_cap_snap(struct ceph_inode_info *ci,
713                                   struct ceph_cap_snap *capsnap);
714 extern void ceph_cleanup_empty_realms(struct ceph_mds_client *mdsc);
715
716 /*
717  * a cap_snap is "pending" if it is still awaiting an in-progress
718  * sync write (that may/may not still update size, mtime, etc.).
719  */
720 static inline bool __ceph_have_pending_cap_snap(struct ceph_inode_info *ci)
721 {
722         return !list_empty(&ci->i_cap_snaps) &&
723                 list_entry(ci->i_cap_snaps.prev, struct ceph_cap_snap,
724                            ci_item)->writing;
725 }
726
727
728 /* super.c */
729 extern struct kmem_cache *ceph_inode_cachep;
730 extern struct kmem_cache *ceph_cap_cachep;
731 extern struct kmem_cache *ceph_dentry_cachep;
732 extern struct kmem_cache *ceph_file_cachep;
733
734 extern const char *ceph_msg_type_name(int type);
735
736 #define FSID_FORMAT "%02x%02x%02x%02x-%02x%02x-%02x%02x-%02x%02x-" \
737         "%02x%02x%02x%02x%02x%02x"
738 #define PR_FSID(f) (f)->fsid[0], (f)->fsid[1], (f)->fsid[2], (f)->fsid[3], \
739                 (f)->fsid[4], (f)->fsid[5], (f)->fsid[6], (f)->fsid[7],    \
740                 (f)->fsid[8], (f)->fsid[9], (f)->fsid[10], (f)->fsid[11],  \
741                 (f)->fsid[12], (f)->fsid[13], (f)->fsid[14], (f)->fsid[15]
742
743 /* inode.c */
744 extern const struct inode_operations ceph_file_iops;
745
746 extern struct inode *ceph_alloc_inode(struct super_block *sb);
747 extern void ceph_destroy_inode(struct inode *inode);
748
749 extern struct inode *ceph_get_inode(struct super_block *sb,
750                                     struct ceph_vino vino);
751 extern struct inode *ceph_get_snapdir(struct inode *parent);
752 extern int ceph_fill_file_size(struct inode *inode, int issued,
753                                u32 truncate_seq, u64 truncate_size, u64 size);
754 extern void ceph_fill_file_time(struct inode *inode, int issued,
755                                 u64 time_warp_seq, struct timespec *ctime,
756                                 struct timespec *mtime, struct timespec *atime);
757 extern int ceph_fill_trace(struct super_block *sb,
758                            struct ceph_mds_request *req,
759                            struct ceph_mds_session *session);
760 extern int ceph_readdir_prepopulate(struct ceph_mds_request *req,
761                                     struct ceph_mds_session *session);
762
763 extern int ceph_inode_holds_cap(struct inode *inode, int mask);
764
765 extern int ceph_inode_set_size(struct inode *inode, loff_t size);
766 extern void ceph_inode_writeback(struct work_struct *work);
767 extern void ceph_vmtruncate_work(struct work_struct *work);
768 extern void __ceph_do_pending_vmtruncate(struct inode *inode);
769 extern void __ceph_queue_vmtruncate(struct inode *inode);
770
771 extern int ceph_do_getattr(struct inode *inode, int mask);
772 extern int ceph_permission(struct inode *inode, int mask);
773 extern int ceph_setattr(struct dentry *dentry, struct iattr *attr);
774 extern int ceph_getattr(struct vfsmount *mnt, struct dentry *dentry,
775                         struct kstat *stat);
776
777 /* xattr.c */
778 extern int ceph_setxattr(struct dentry *, const char *, const void *,
779                          size_t, int);
780 extern ssize_t ceph_getxattr(struct dentry *, const char *, void *, size_t);
781 extern ssize_t ceph_listxattr(struct dentry *, char *, size_t);
782 extern int ceph_removexattr(struct dentry *, const char *);
783 extern void __ceph_build_xattrs_blob(struct ceph_inode_info *ci);
784 extern void __ceph_destroy_xattrs(struct ceph_inode_info *ci);
785
786 /* caps.c */
787 extern const char *ceph_cap_string(int c);
788 extern void ceph_handle_caps(struct ceph_mds_session *session,
789                              struct ceph_msg *msg);
790 extern int ceph_add_cap(struct inode *inode,
791                         struct ceph_mds_session *session, u64 cap_id,
792                         int fmode, unsigned issued, unsigned wanted,
793                         unsigned cap, unsigned seq, u64 realmino, int flags,
794                         struct ceph_cap_reservation *caps_reservation);
795 extern void __ceph_remove_cap(struct ceph_cap *cap,
796                               struct ceph_cap_reservation *ctx);
797 static inline void ceph_remove_cap(struct ceph_cap *cap)
798 {
799         struct inode *inode = &cap->ci->vfs_inode;
800         spin_lock(&inode->i_lock);
801         __ceph_remove_cap(cap, NULL);
802         spin_unlock(&inode->i_lock);
803 }
804
805 extern void ceph_queue_caps_release(struct inode *inode);
806 extern int ceph_write_inode(struct inode *inode, int unused);
807 extern int ceph_fsync(struct file *file, struct dentry *dentry, int datasync);
808 extern void ceph_kick_flushing_caps(struct ceph_mds_client *mdsc,
809                                     struct ceph_mds_session *session);
810 extern int ceph_get_cap_mds(struct inode *inode);
811 extern void ceph_get_cap_refs(struct ceph_inode_info *ci, int caps);
812 extern void ceph_put_cap_refs(struct ceph_inode_info *ci, int had);
813 extern void ceph_put_wrbuffer_cap_refs(struct ceph_inode_info *ci, int nr,
814                                        struct ceph_snap_context *snapc);
815 extern void __ceph_flush_snaps(struct ceph_inode_info *ci,
816                                struct ceph_mds_session **psession);
817 extern void ceph_check_caps(struct ceph_inode_info *ci, int flags,
818                             struct ceph_mds_session *session);
819 extern void ceph_check_delayed_caps(struct ceph_mds_client *mdsc);
820 extern void ceph_flush_dirty_caps(struct ceph_mds_client *mdsc);
821
822 extern int ceph_encode_inode_release(void **p, struct inode *inode,
823                                      int mds, int drop, int unless, int force);
824 extern int ceph_encode_dentry_release(void **p, struct dentry *dn,
825                                       int mds, int drop, int unless);
826
827 extern int ceph_get_caps(struct ceph_inode_info *ci, int need, int want,
828                          int *got, loff_t endoff);
829
830 /* for counting open files by mode */
831 static inline void __ceph_get_fmode(struct ceph_inode_info *ci, int mode)
832 {
833         ci->i_nr_by_mode[mode]++;
834 }
835 extern void ceph_put_fmode(struct ceph_inode_info *ci, int mode);
836
837 /* addr.c */
838 extern const struct address_space_operations ceph_aops;
839 extern int ceph_mmap(struct file *file, struct vm_area_struct *vma);
840
841 /* file.c */
842 extern const struct file_operations ceph_file_fops;
843 extern const struct address_space_operations ceph_aops;
844 extern int ceph_open(struct inode *inode, struct file *file);
845 extern struct dentry *ceph_lookup_open(struct inode *dir, struct dentry *dentry,
846                                        struct nameidata *nd, int mode,
847                                        int locked_dir);
848 extern int ceph_release(struct inode *inode, struct file *filp);
849 extern void ceph_release_page_vector(struct page **pages, int num_pages);
850
851 /* dir.c */
852 extern const struct file_operations ceph_dir_fops;
853 extern const struct inode_operations ceph_dir_iops;
854 extern struct dentry_operations ceph_dentry_ops, ceph_snap_dentry_ops,
855         ceph_snapdir_dentry_ops;
856
857 extern int ceph_handle_notrace_create(struct inode *dir, struct dentry *dentry);
858 extern struct dentry *ceph_finish_lookup(struct ceph_mds_request *req,
859                                          struct dentry *dentry, int err);
860
861 extern void ceph_dentry_lru_add(struct dentry *dn);
862 extern void ceph_dentry_lru_touch(struct dentry *dn);
863 extern void ceph_dentry_lru_del(struct dentry *dn);
864
865 /*
866  * our d_ops vary depending on whether the inode is live,
867  * snapshotted (read-only), or a virtual ".snap" directory.
868  */
869 int ceph_init_dentry(struct dentry *dentry);
870
871
872 /* ioctl.c */
873 extern long ceph_ioctl(struct file *file, unsigned int cmd, unsigned long arg);
874
875 /* export.c */
876 extern const struct export_operations ceph_export_ops;
877
878 /* debugfs.c */
879 extern int ceph_debugfs_init(void);
880 extern void ceph_debugfs_cleanup(void);
881 extern int ceph_debugfs_client_init(struct ceph_client *client);
882 extern void ceph_debugfs_client_cleanup(struct ceph_client *client);
883
884 static inline struct inode *get_dentry_parent_inode(struct dentry *dentry)
885 {
886         if (dentry && dentry->d_parent)
887                 return dentry->d_parent->d_inode;
888
889         return NULL;
890 }
891
892 #endif /* _FS_CEPH_SUPER_H */