1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef _FS_CEPH_SUPER_H
3 #define _FS_CEPH_SUPER_H
5 #include <linux/ceph/ceph_debug.h>
7 #include <asm/unaligned.h>
8 #include <linux/backing-dev.h>
9 #include <linux/completion.h>
10 #include <linux/exportfs.h>
12 #include <linux/mempool.h>
13 #include <linux/pagemap.h>
14 #include <linux/wait.h>
15 #include <linux/writeback.h>
16 #include <linux/slab.h>
17 #include <linux/posix_acl.h>
18 #include <linux/refcount.h>
20 #include <linux/ceph/libceph.h>
22 #ifdef CONFIG_CEPH_FSCACHE
23 #include <linux/fscache.h>
26 /* f_type in struct statfs */
27 #define CEPH_SUPER_MAGIC 0x00c36400
29 /* large granularity for statfs utilization stats to facilitate
30 * large volume sizes on 32-bit machines. */
31 #define CEPH_BLOCK_SHIFT 22 /* 4 MB */
32 #define CEPH_BLOCK (1 << CEPH_BLOCK_SHIFT)
34 #define CEPH_MOUNT_OPT_DIRSTAT (1<<4) /* `cat dirname` for stats */
35 #define CEPH_MOUNT_OPT_RBYTES (1<<5) /* dir st_bytes = rbytes */
36 #define CEPH_MOUNT_OPT_NOASYNCREADDIR (1<<7) /* no dcache readdir */
37 #define CEPH_MOUNT_OPT_INO32 (1<<8) /* 32 bit inos */
38 #define CEPH_MOUNT_OPT_DCACHE (1<<9) /* use dcache for readdir etc */
39 #define CEPH_MOUNT_OPT_FSCACHE (1<<10) /* use fscache */
40 #define CEPH_MOUNT_OPT_NOPOOLPERM (1<<11) /* no pool permission check */
41 #define CEPH_MOUNT_OPT_MOUNTWAIT (1<<12) /* mount waits if no mds is up */
42 #define CEPH_MOUNT_OPT_NOQUOTADF (1<<13) /* no root dir quota in statfs */
43 #define CEPH_MOUNT_OPT_NOCOPYFROM (1<<14) /* don't use RADOS 'copy-from' op */
45 #define CEPH_MOUNT_OPT_DEFAULT \
46 (CEPH_MOUNT_OPT_DCACHE | \
47 CEPH_MOUNT_OPT_NOCOPYFROM)
49 #define ceph_set_mount_opt(fsc, opt) \
50 (fsc)->mount_options->flags |= CEPH_MOUNT_OPT_##opt;
51 #define ceph_test_mount_opt(fsc, opt) \
52 (!!((fsc)->mount_options->flags & CEPH_MOUNT_OPT_##opt))
54 /* max size of osd read request, limited by libceph */
55 #define CEPH_MAX_READ_SIZE CEPH_MSG_MAX_DATA_LEN
56 /* osd has a configurable limitaion of max write size.
57 * CEPH_MSG_MAX_DATA_LEN should be small enough. */
58 #define CEPH_MAX_WRITE_SIZE CEPH_MSG_MAX_DATA_LEN
59 #define CEPH_RASIZE_DEFAULT (8192*1024) /* max readahead */
60 #define CEPH_MAX_READDIR_DEFAULT 1024
61 #define CEPH_MAX_READDIR_BYTES_DEFAULT (512*1024)
62 #define CEPH_SNAPDIRNAME_DEFAULT ".snap"
65 * Delay telling the MDS we no longer want caps, in case we reopen
66 * the file. Delay a minimum amount of time, even if we send a cap
67 * message for some other reason. Otherwise, take the oppotunity to
68 * update the mds to avoid sending another message later.
70 #define CEPH_CAPS_WANTED_DELAY_MIN_DEFAULT 5 /* cap release delay */
71 #define CEPH_CAPS_WANTED_DELAY_MAX_DEFAULT 60 /* cap release delay */
73 struct ceph_mount_options {
77 int wsize; /* max write size */
78 int rsize; /* max read size */
79 int rasize; /* max readahead */
80 int congestion_kb; /* max writeback in flight */
81 int caps_wanted_delay_min, caps_wanted_delay_max;
82 int max_readdir; /* max readdir result (entires) */
83 int max_readdir_bytes; /* max readdir result (bytes) */
86 * everything above this point can be memcmp'd; everything below
87 * is handled in compare_mount_options()
90 char *snapdir_name; /* default ".snap" */
91 char *mds_namespace; /* default NULL */
92 char *server_path; /* default "/" */
93 char *fscache_uniq; /* default NULL */
96 struct ceph_fs_client {
97 struct super_block *sb;
99 struct ceph_mount_options *mount_options;
100 struct ceph_client *client;
102 unsigned long mount_state;
103 int min_caps; /* min caps i added */
104 loff_t max_file_size;
106 struct ceph_mds_client *mdsc;
109 mempool_t *wb_pagevec_pool;
110 struct workqueue_struct *wb_wq;
111 struct workqueue_struct *pg_inv_wq;
112 struct workqueue_struct *trunc_wq;
113 atomic_long_t writeback_count;
115 #ifdef CONFIG_DEBUG_FS
116 struct dentry *debugfs_dentry_lru, *debugfs_caps;
117 struct dentry *debugfs_congestion_kb;
118 struct dentry *debugfs_bdi;
119 struct dentry *debugfs_mdsc, *debugfs_mdsmap;
120 struct dentry *debugfs_mds_sessions;
123 #ifdef CONFIG_CEPH_FSCACHE
124 struct fscache_cookie *fscache;
130 * File i/o capability. This tracks shared state with the metadata
131 * server that allows us to cache or writeback attributes or to read
132 * and write data. For any given inode, we should have one or more
133 * capabilities, one issued by each metadata server, and our
134 * cumulative access is the OR of all issued capabilities.
136 * Each cap is referenced by the inode's i_caps rbtree and by per-mds
137 * session capability lists.
140 struct ceph_inode_info *ci;
141 struct rb_node ci_node; /* per-ci cap tree */
142 struct ceph_mds_session *session;
143 struct list_head session_caps; /* per-session caplist */
144 u64 cap_id; /* unique cap id (mds provided) */
148 int issued; /* latest, from the mds */
149 int implemented; /* implemented superset of
150 issued (for revocation) */
153 /* caps to release */
159 u32 seq, issue_seq, mseq;
160 u32 cap_gen; /* active/stale cycle */
161 unsigned long last_used;
162 struct list_head caps_item;
165 #define CHECK_CAPS_NODELAY 1 /* do not delay any further */
166 #define CHECK_CAPS_AUTHONLY 2 /* only check auth cap */
167 #define CHECK_CAPS_FLUSH 4 /* flush any dirty caps */
169 struct ceph_cap_flush {
171 int caps; /* 0 means capsnap */
172 bool wake; /* wake up flush waiters when finish ? */
173 struct list_head g_list; // global
174 struct list_head i_list; // per inode
178 * Snapped cap state that is pending flush to mds. When a snapshot occurs,
179 * we first complete any in-process sync writes and writeback any dirty
180 * data before flushing the snapped state (tracked here) back to the MDS.
182 struct ceph_cap_snap {
184 struct list_head ci_item;
186 struct ceph_cap_flush cap_flush;
190 struct ceph_snap_context *context;
196 struct ceph_buffer *xattr_blob;
200 struct timespec64 mtime, atime, ctime;
204 int writing; /* a sync write is still in progress */
205 int dirty_pages; /* dirty pages awaiting writeback */
210 static inline void ceph_put_cap_snap(struct ceph_cap_snap *capsnap)
212 if (refcount_dec_and_test(&capsnap->nref)) {
213 if (capsnap->xattr_blob)
214 ceph_buffer_put(capsnap->xattr_blob);
220 * The frag tree describes how a directory is fragmented, potentially across
221 * multiple metadata servers. It is also used to indicate points where
222 * metadata authority is delegated, and whether/where metadata is replicated.
224 * A _leaf_ frag will be present in the i_fragtree IFF there is
225 * delegation info. That is, if mds >= 0 || ndist > 0.
227 #define CEPH_MAX_DIRFRAG_REP 4
229 struct ceph_inode_frag {
234 int split_by; /* i.e. 2^(split_by) children */
236 /* delegation and replication info */
237 int mds; /* -1 if same authority as parent */
238 int ndist; /* >0 if replicated */
239 int dist[CEPH_MAX_DIRFRAG_REP];
243 * We cache inode xattrs as an encoded blob until they are first used,
244 * at which point we parse them into an rbtree.
246 struct ceph_inode_xattr {
255 int should_free_name;
262 struct ceph_dentry_info {
263 struct ceph_mds_session *lease_session;
264 int lease_shared_gen;
267 unsigned long lease_renew_after, lease_renew_from;
268 struct list_head lru;
269 struct dentry *dentry;
274 struct ceph_inode_xattrs_info {
276 * (still encoded) xattr blob. we avoid the overhead of parsing
277 * this until someone actually calls getxattr, etc.
279 * blob->vec.iov_len == 4 implies there are no xattrs; blob ==
280 * NULL means we don't know.
282 struct ceph_buffer *blob, *prealloc_blob;
284 struct rb_root index;
289 u64 version, index_version;
295 struct ceph_inode_info {
296 struct ceph_vino i_vino; /* ceph ino + snap */
298 spinlock_t i_ceph_lock;
301 u64 i_inline_version;
304 unsigned i_ceph_flags;
305 atomic64_t i_release_count;
306 atomic64_t i_ordered_count;
307 atomic64_t i_complete_seq[2];
309 struct ceph_dir_layout i_dir_layout;
310 struct ceph_file_layout i_layout;
314 struct timespec64 i_rctime;
315 u64 i_rbytes, i_rfiles, i_rsubdirs;
316 u64 i_files, i_subdirs;
319 u64 i_max_bytes, i_max_files;
323 struct rb_root i_fragtree;
324 int i_fragtree_nsplits;
325 struct mutex i_fragtree_mutex;
327 struct ceph_inode_xattrs_info i_xattrs;
329 /* capabilities. protected _both_ by i_ceph_lock and cap->session's
331 struct rb_root i_caps; /* cap list */
332 struct ceph_cap *i_auth_cap; /* authoritative cap, if any */
333 unsigned i_dirty_caps, i_flushing_caps; /* mask of dirtied fields */
334 struct list_head i_dirty_item, i_flushing_item;
335 /* we need to track cap writeback on a per-cap-bit basis, to allow
336 * overlapping, pipelined cap flushes to the mds. we can probably
337 * reduce the tid to 8 bits if we're concerned about inode size. */
338 struct ceph_cap_flush *i_prealloc_cap_flush;
339 struct list_head i_cap_flush_list;
340 wait_queue_head_t i_cap_wq; /* threads waiting on a capability */
341 unsigned long i_hold_caps_min; /* jiffies */
342 unsigned long i_hold_caps_max; /* jiffies */
343 struct list_head i_cap_delay_list; /* for delayed cap release to mds */
344 struct ceph_cap_reservation i_cap_migration_resv;
345 struct list_head i_cap_snaps; /* snapped state pending flush to mds */
346 struct ceph_snap_context *i_head_snapc; /* set if wr_buffer_head > 0 or
347 dirty|flushing caps */
348 unsigned i_snap_caps; /* cap bits for snapped files */
350 int i_nr_by_mode[CEPH_FILE_MODE_BITS]; /* open file counts */
352 struct mutex i_truncate_mutex;
353 u32 i_truncate_seq; /* last truncate to smaller size */
354 u64 i_truncate_size; /* and the size we last truncated down to */
355 int i_truncate_pending; /* still need to call vmtruncate */
357 u64 i_max_size; /* max file size authorized by mds */
358 u64 i_reported_size; /* (max_)size reported to or requested of mds */
359 u64 i_wanted_max_size; /* offset we'd like to write too */
360 u64 i_requested_max_size; /* max_size we've requested */
362 /* held references to caps */
364 int i_rd_ref, i_rdcache_ref, i_wr_ref, i_wb_ref;
365 int i_wrbuffer_ref, i_wrbuffer_ref_head;
366 atomic_t i_filelock_ref;
367 atomic_t i_shared_gen; /* increment each time we get FILE_SHARED */
368 u32 i_rdcache_gen; /* incremented each time we get FILE_CACHE. */
369 u32 i_rdcache_revoking; /* RDCACHE gen to async invalidate, if any */
371 struct list_head i_unsafe_dirops; /* uncommitted mds dir ops */
372 struct list_head i_unsafe_iops; /* uncommitted mds inode ops */
373 spinlock_t i_unsafe_lock;
376 struct ceph_snap_realm *i_snap_realm; /* snap realm (if caps) */
377 struct ceph_snapid_map *i_snapid_map; /* snapid -> dev_t */
379 int i_snap_realm_counter; /* snap realm (if caps) */
380 struct list_head i_snap_realm_item;
381 struct list_head i_snap_flush_item;
383 struct work_struct i_wb_work; /* writeback work */
384 struct work_struct i_pg_inv_work; /* page invalidation work */
386 struct work_struct i_vmtruncate_work;
388 #ifdef CONFIG_CEPH_FSCACHE
389 struct fscache_cookie *fscache;
392 struct inode vfs_inode; /* at end */
395 static inline struct ceph_inode_info *ceph_inode(struct inode *inode)
397 return container_of(inode, struct ceph_inode_info, vfs_inode);
400 static inline struct ceph_fs_client *ceph_inode_to_client(struct inode *inode)
402 return (struct ceph_fs_client *)inode->i_sb->s_fs_info;
405 static inline struct ceph_fs_client *ceph_sb_to_client(struct super_block *sb)
407 return (struct ceph_fs_client *)sb->s_fs_info;
410 static inline struct ceph_vino ceph_vino(struct inode *inode)
412 return ceph_inode(inode)->i_vino;
416 * ino_t is <64 bits on many architectures, blech.
418 * i_ino (kernel inode) st_ino (userspace)
423 static inline u32 ceph_ino_to_ino32(__u64 vino)
425 u32 ino = vino & 0xffffffff;
435 static inline ino_t ceph_vino_to_ino(struct ceph_vino vino)
437 #if BITS_PER_LONG == 32
438 return ceph_ino_to_ino32(vino.ino);
440 return (ino_t)vino.ino;
445 * user-visible ino (stat, filldir)
447 #if BITS_PER_LONG == 32
448 static inline ino_t ceph_translate_ino(struct super_block *sb, ino_t ino)
453 static inline ino_t ceph_translate_ino(struct super_block *sb, ino_t ino)
455 if (ceph_test_mount_opt(ceph_sb_to_client(sb), INO32))
456 ino = ceph_ino_to_ino32(ino);
462 /* for printf-style formatting */
463 #define ceph_vinop(i) ceph_inode(i)->i_vino.ino, ceph_inode(i)->i_vino.snap
465 static inline u64 ceph_ino(struct inode *inode)
467 return ceph_inode(inode)->i_vino.ino;
469 static inline u64 ceph_snap(struct inode *inode)
471 return ceph_inode(inode)->i_vino.snap;
474 static inline int ceph_ino_compare(struct inode *inode, void *data)
476 struct ceph_vino *pvino = (struct ceph_vino *)data;
477 struct ceph_inode_info *ci = ceph_inode(inode);
478 return ci->i_vino.ino == pvino->ino &&
479 ci->i_vino.snap == pvino->snap;
482 static inline struct inode *ceph_find_inode(struct super_block *sb,
483 struct ceph_vino vino)
485 ino_t t = ceph_vino_to_ino(vino);
486 return ilookup5(sb, t, ceph_ino_compare, &vino);
493 #define CEPH_I_DIR_ORDERED (1 << 0) /* dentries in dir are ordered */
494 #define CEPH_I_NODELAY (1 << 1) /* do not delay cap release */
495 #define CEPH_I_FLUSH (1 << 2) /* do not delay flush of dirty metadata */
496 #define CEPH_I_NOFLUSH (1 << 3) /* do not flush dirty caps */
497 #define CEPH_I_POOL_PERM (1 << 4) /* pool rd/wr bits are valid */
498 #define CEPH_I_POOL_RD (1 << 5) /* can read from pool */
499 #define CEPH_I_POOL_WR (1 << 6) /* can write to pool */
500 #define CEPH_I_SEC_INITED (1 << 7) /* security initialized */
501 #define CEPH_I_CAP_DROPPED (1 << 8) /* caps were forcibly dropped */
502 #define CEPH_I_KICK_FLUSH (1 << 9) /* kick flushing caps */
503 #define CEPH_I_FLUSH_SNAPS (1 << 10) /* need flush snapss */
504 #define CEPH_I_ERROR_WRITE (1 << 11) /* have seen write errors */
505 #define CEPH_I_ERROR_FILELOCK (1 << 12) /* have seen file lock errors */
509 * We set the ERROR_WRITE bit when we start seeing write errors on an inode
510 * and then clear it when they start succeeding. Note that we do a lockless
511 * check first, and only take the lock if it looks like it needs to be changed.
512 * The write submission code just takes this as a hint, so we're not too
513 * worried if a few slip through in either direction.
515 static inline void ceph_set_error_write(struct ceph_inode_info *ci)
517 if (!(READ_ONCE(ci->i_ceph_flags) & CEPH_I_ERROR_WRITE)) {
518 spin_lock(&ci->i_ceph_lock);
519 ci->i_ceph_flags |= CEPH_I_ERROR_WRITE;
520 spin_unlock(&ci->i_ceph_lock);
524 static inline void ceph_clear_error_write(struct ceph_inode_info *ci)
526 if (READ_ONCE(ci->i_ceph_flags) & CEPH_I_ERROR_WRITE) {
527 spin_lock(&ci->i_ceph_lock);
528 ci->i_ceph_flags &= ~CEPH_I_ERROR_WRITE;
529 spin_unlock(&ci->i_ceph_lock);
533 static inline void __ceph_dir_set_complete(struct ceph_inode_info *ci,
534 long long release_count,
535 long long ordered_count)
537 smp_mb__before_atomic();
538 atomic64_set(&ci->i_complete_seq[0], release_count);
539 atomic64_set(&ci->i_complete_seq[1], ordered_count);
542 static inline void __ceph_dir_clear_complete(struct ceph_inode_info *ci)
544 atomic64_inc(&ci->i_release_count);
547 static inline void __ceph_dir_clear_ordered(struct ceph_inode_info *ci)
549 atomic64_inc(&ci->i_ordered_count);
552 static inline bool __ceph_dir_is_complete(struct ceph_inode_info *ci)
554 return atomic64_read(&ci->i_complete_seq[0]) ==
555 atomic64_read(&ci->i_release_count);
558 static inline bool __ceph_dir_is_complete_ordered(struct ceph_inode_info *ci)
560 return atomic64_read(&ci->i_complete_seq[0]) ==
561 atomic64_read(&ci->i_release_count) &&
562 atomic64_read(&ci->i_complete_seq[1]) ==
563 atomic64_read(&ci->i_ordered_count);
566 static inline void ceph_dir_clear_complete(struct inode *inode)
568 __ceph_dir_clear_complete(ceph_inode(inode));
571 static inline void ceph_dir_clear_ordered(struct inode *inode)
573 __ceph_dir_clear_ordered(ceph_inode(inode));
576 static inline bool ceph_dir_is_complete_ordered(struct inode *inode)
578 bool ret = __ceph_dir_is_complete_ordered(ceph_inode(inode));
583 /* find a specific frag @f */
584 extern struct ceph_inode_frag *__ceph_find_frag(struct ceph_inode_info *ci,
588 * choose fragment for value @v. copy frag content to pfrag, if leaf
591 extern u32 ceph_choose_frag(struct ceph_inode_info *ci, u32 v,
592 struct ceph_inode_frag *pfrag,
595 static inline struct ceph_dentry_info *ceph_dentry(struct dentry *dentry)
597 return (struct ceph_dentry_info *)dentry->d_fsdata;
603 static inline bool __ceph_is_any_real_caps(struct ceph_inode_info *ci)
605 return !RB_EMPTY_ROOT(&ci->i_caps);
608 extern int __ceph_caps_issued(struct ceph_inode_info *ci, int *implemented);
609 extern int __ceph_caps_issued_mask(struct ceph_inode_info *ci, int mask, int t);
610 extern int __ceph_caps_issued_other(struct ceph_inode_info *ci,
611 struct ceph_cap *cap);
613 static inline int ceph_caps_issued(struct ceph_inode_info *ci)
616 spin_lock(&ci->i_ceph_lock);
617 issued = __ceph_caps_issued(ci, NULL);
618 spin_unlock(&ci->i_ceph_lock);
622 static inline int ceph_caps_issued_mask(struct ceph_inode_info *ci, int mask,
626 spin_lock(&ci->i_ceph_lock);
627 r = __ceph_caps_issued_mask(ci, mask, touch);
628 spin_unlock(&ci->i_ceph_lock);
632 static inline int __ceph_caps_dirty(struct ceph_inode_info *ci)
634 return ci->i_dirty_caps | ci->i_flushing_caps;
636 extern struct ceph_cap_flush *ceph_alloc_cap_flush(void);
637 extern void ceph_free_cap_flush(struct ceph_cap_flush *cf);
638 extern int __ceph_mark_dirty_caps(struct ceph_inode_info *ci, int mask,
639 struct ceph_cap_flush **pcf);
641 extern int __ceph_caps_revoking_other(struct ceph_inode_info *ci,
642 struct ceph_cap *ocap, int mask);
643 extern int ceph_caps_revoking(struct ceph_inode_info *ci, int mask);
644 extern int __ceph_caps_used(struct ceph_inode_info *ci);
646 extern int __ceph_caps_file_wanted(struct ceph_inode_info *ci);
649 * wanted, by virtue of open file modes AND cap refs (buffered/cached data)
651 static inline int __ceph_caps_wanted(struct ceph_inode_info *ci)
653 int w = __ceph_caps_file_wanted(ci) | __ceph_caps_used(ci);
654 if (w & CEPH_CAP_FILE_BUFFER)
655 w |= CEPH_CAP_FILE_EXCL; /* we want EXCL if dirty data */
659 /* what the mds thinks we want */
660 extern int __ceph_caps_mds_wanted(struct ceph_inode_info *ci, bool check);
662 extern void ceph_caps_init(struct ceph_mds_client *mdsc);
663 extern void ceph_caps_finalize(struct ceph_mds_client *mdsc);
664 extern void ceph_adjust_min_caps(struct ceph_mds_client *mdsc, int delta);
665 extern int ceph_reserve_caps(struct ceph_mds_client *mdsc,
666 struct ceph_cap_reservation *ctx, int need);
667 extern void ceph_unreserve_caps(struct ceph_mds_client *mdsc,
668 struct ceph_cap_reservation *ctx);
669 extern void ceph_reservation_status(struct ceph_fs_client *client,
670 int *total, int *avail, int *used,
671 int *reserved, int *min);
676 * we keep buffered readdir results attached to file->private_data
678 #define CEPH_F_SYNC 1
679 #define CEPH_F_ATEND 2
681 struct ceph_file_info {
682 short fmode; /* initialized on open */
683 short flags; /* CEPH_F_* */
685 spinlock_t rw_contexts_lock;
686 struct list_head rw_contexts;
689 struct ceph_dir_file_info {
690 struct ceph_file_info file_info;
692 /* readdir: position within the dir */
694 struct ceph_mds_request *last_readdir;
696 /* readdir: position within a frag */
697 unsigned next_offset; /* offset of next chunk (last_name's + 1) */
698 char *last_name; /* last entry in previous chunk */
699 long long dir_release_count;
700 long long dir_ordered_count;
701 int readdir_cache_idx;
703 /* used for -o dirstat read() on directory thing */
708 struct ceph_rw_context {
709 struct list_head list;
710 struct task_struct *thread;
714 #define CEPH_DEFINE_RW_CONTEXT(_name, _caps) \
715 struct ceph_rw_context _name = { \
720 static inline void ceph_add_rw_context(struct ceph_file_info *cf,
721 struct ceph_rw_context *ctx)
723 spin_lock(&cf->rw_contexts_lock);
724 list_add(&ctx->list, &cf->rw_contexts);
725 spin_unlock(&cf->rw_contexts_lock);
728 static inline void ceph_del_rw_context(struct ceph_file_info *cf,
729 struct ceph_rw_context *ctx)
731 spin_lock(&cf->rw_contexts_lock);
732 list_del(&ctx->list);
733 spin_unlock(&cf->rw_contexts_lock);
736 static inline struct ceph_rw_context*
737 ceph_find_rw_context(struct ceph_file_info *cf)
739 struct ceph_rw_context *ctx, *found = NULL;
740 spin_lock(&cf->rw_contexts_lock);
741 list_for_each_entry(ctx, &cf->rw_contexts, list) {
742 if (ctx->thread == current) {
747 spin_unlock(&cf->rw_contexts_lock);
751 struct ceph_readdir_cache_control {
753 struct dentry **dentries;
758 * A "snap realm" describes a subset of the file hierarchy sharing
759 * the same set of snapshots that apply to it. The realms themselves
760 * are organized into a hierarchy, such that children inherit (some of)
761 * the snapshots of their parents.
763 * All inodes within the realm that have capabilities are linked into a
766 struct ceph_snap_realm {
774 u64 parent_since; /* snapid when our current parent became so */
776 u64 *prior_parent_snaps; /* snaps inherited from any parents we */
777 u32 num_prior_parent_snaps; /* had prior to parent_since */
778 u64 *snaps; /* snaps specific to this realm */
781 struct ceph_snap_realm *parent;
782 struct list_head children; /* list of child realms */
783 struct list_head child_item;
785 struct list_head empty_item; /* if i have ref==0 */
787 struct list_head dirty_item; /* if realm needs new context */
789 /* the current set of snaps for this realm */
790 struct ceph_snap_context *cached_context;
792 struct list_head inodes_with_caps;
793 spinlock_t inodes_with_caps_lock;
796 static inline int default_congestion_kb(void)
803 * congestion size, scale with available memory.
815 * This allows larger machines to have larger/more transfers.
816 * Limit the default to 256M
818 congestion_kb = (16*int_sqrt(totalram_pages())) << (PAGE_SHIFT-10);
819 if (congestion_kb > 256*1024)
820 congestion_kb = 256*1024;
822 return congestion_kb;
828 struct ceph_snap_realm *ceph_lookup_snap_realm(struct ceph_mds_client *mdsc,
830 extern void ceph_get_snap_realm(struct ceph_mds_client *mdsc,
831 struct ceph_snap_realm *realm);
832 extern void ceph_put_snap_realm(struct ceph_mds_client *mdsc,
833 struct ceph_snap_realm *realm);
834 extern int ceph_update_snap_trace(struct ceph_mds_client *m,
835 void *p, void *e, bool deletion,
836 struct ceph_snap_realm **realm_ret);
837 extern void ceph_handle_snap(struct ceph_mds_client *mdsc,
838 struct ceph_mds_session *session,
839 struct ceph_msg *msg);
840 extern void ceph_queue_cap_snap(struct ceph_inode_info *ci);
841 extern int __ceph_finish_cap_snap(struct ceph_inode_info *ci,
842 struct ceph_cap_snap *capsnap);
843 extern void ceph_cleanup_empty_realms(struct ceph_mds_client *mdsc);
845 extern struct ceph_snapid_map *ceph_get_snapid_map(struct ceph_mds_client *mdsc,
847 extern void ceph_put_snapid_map(struct ceph_mds_client* mdsc,
848 struct ceph_snapid_map *sm);
849 extern void ceph_trim_snapid_map(struct ceph_mds_client *mdsc);
850 extern void ceph_cleanup_snapid_map(struct ceph_mds_client *mdsc);
854 * a cap_snap is "pending" if it is still awaiting an in-progress
855 * sync write (that may/may not still update size, mtime, etc.).
857 static inline bool __ceph_have_pending_cap_snap(struct ceph_inode_info *ci)
859 return !list_empty(&ci->i_cap_snaps) &&
860 list_last_entry(&ci->i_cap_snaps, struct ceph_cap_snap,
865 extern const struct inode_operations ceph_file_iops;
867 extern struct inode *ceph_alloc_inode(struct super_block *sb);
868 extern void ceph_destroy_inode(struct inode *inode);
869 extern int ceph_drop_inode(struct inode *inode);
871 extern struct inode *ceph_get_inode(struct super_block *sb,
872 struct ceph_vino vino);
873 extern struct inode *ceph_get_snapdir(struct inode *parent);
874 extern int ceph_fill_file_size(struct inode *inode, int issued,
875 u32 truncate_seq, u64 truncate_size, u64 size);
876 extern void ceph_fill_file_time(struct inode *inode, int issued,
877 u64 time_warp_seq, struct timespec64 *ctime,
878 struct timespec64 *mtime,
879 struct timespec64 *atime);
880 extern int ceph_fill_trace(struct super_block *sb,
881 struct ceph_mds_request *req);
882 extern int ceph_readdir_prepopulate(struct ceph_mds_request *req,
883 struct ceph_mds_session *session);
885 extern int ceph_inode_holds_cap(struct inode *inode, int mask);
887 extern bool ceph_inode_set_size(struct inode *inode, loff_t size);
888 extern void __ceph_do_pending_vmtruncate(struct inode *inode);
889 extern void ceph_queue_vmtruncate(struct inode *inode);
891 extern void ceph_queue_invalidate(struct inode *inode);
892 extern void ceph_queue_writeback(struct inode *inode);
894 extern int __ceph_do_getattr(struct inode *inode, struct page *locked_page,
895 int mask, bool force);
896 static inline int ceph_do_getattr(struct inode *inode, int mask, bool force)
898 return __ceph_do_getattr(inode, NULL, mask, force);
900 extern int ceph_permission(struct inode *inode, int mask);
901 extern int __ceph_setattr(struct inode *inode, struct iattr *attr);
902 extern int ceph_setattr(struct dentry *dentry, struct iattr *attr);
903 extern int ceph_getattr(const struct path *path, struct kstat *stat,
904 u32 request_mask, unsigned int flags);
907 int __ceph_setxattr(struct inode *, const char *, const void *, size_t, int);
908 ssize_t __ceph_getxattr(struct inode *, const char *, void *, size_t);
909 extern ssize_t ceph_listxattr(struct dentry *, char *, size_t);
910 extern void __ceph_build_xattrs_blob(struct ceph_inode_info *ci);
911 extern void __ceph_destroy_xattrs(struct ceph_inode_info *ci);
912 extern void __init ceph_xattr_init(void);
913 extern void ceph_xattr_exit(void);
914 extern const struct xattr_handler *ceph_xattr_handlers[];
916 #ifdef CONFIG_SECURITY
917 extern bool ceph_security_xattr_deadlock(struct inode *in);
918 extern bool ceph_security_xattr_wanted(struct inode *in);
920 static inline bool ceph_security_xattr_deadlock(struct inode *in)
924 static inline bool ceph_security_xattr_wanted(struct inode *in)
931 struct ceph_acls_info {
934 struct ceph_pagelist *pagelist;
937 #ifdef CONFIG_CEPH_FS_POSIX_ACL
939 struct posix_acl *ceph_get_acl(struct inode *, int);
940 int ceph_set_acl(struct inode *inode, struct posix_acl *acl, int type);
941 int ceph_pre_init_acls(struct inode *dir, umode_t *mode,
942 struct ceph_acls_info *info);
943 void ceph_init_inode_acls(struct inode *inode, struct ceph_acls_info *info);
944 void ceph_release_acls_info(struct ceph_acls_info *info);
946 static inline void ceph_forget_all_cached_acls(struct inode *inode)
948 forget_all_cached_acls(inode);
953 #define ceph_get_acl NULL
954 #define ceph_set_acl NULL
956 static inline int ceph_pre_init_acls(struct inode *dir, umode_t *mode,
957 struct ceph_acls_info *info)
961 static inline void ceph_init_inode_acls(struct inode *inode,
962 struct ceph_acls_info *info)
965 static inline void ceph_release_acls_info(struct ceph_acls_info *info)
968 static inline int ceph_acl_chmod(struct dentry *dentry, struct inode *inode)
973 static inline void ceph_forget_all_cached_acls(struct inode *inode)
980 extern const char *ceph_cap_string(int c);
981 extern void ceph_handle_caps(struct ceph_mds_session *session,
982 struct ceph_msg *msg);
983 extern struct ceph_cap *ceph_get_cap(struct ceph_mds_client *mdsc,
984 struct ceph_cap_reservation *ctx);
985 extern void ceph_add_cap(struct inode *inode,
986 struct ceph_mds_session *session, u64 cap_id,
987 int fmode, unsigned issued, unsigned wanted,
988 unsigned cap, unsigned seq, u64 realmino, int flags,
989 struct ceph_cap **new_cap);
990 extern void __ceph_remove_cap(struct ceph_cap *cap, bool queue_release);
991 extern void ceph_put_cap(struct ceph_mds_client *mdsc,
992 struct ceph_cap *cap);
993 extern int ceph_is_any_caps(struct inode *inode);
995 extern void ceph_queue_caps_release(struct inode *inode);
996 extern int ceph_write_inode(struct inode *inode, struct writeback_control *wbc);
997 extern int ceph_fsync(struct file *file, loff_t start, loff_t end,
999 extern void ceph_early_kick_flushing_caps(struct ceph_mds_client *mdsc,
1000 struct ceph_mds_session *session);
1001 extern void ceph_kick_flushing_caps(struct ceph_mds_client *mdsc,
1002 struct ceph_mds_session *session);
1003 extern struct ceph_cap *ceph_get_cap_for_mds(struct ceph_inode_info *ci,
1005 extern int ceph_get_cap_mds(struct inode *inode);
1006 extern void ceph_get_cap_refs(struct ceph_inode_info *ci, int caps);
1007 extern void ceph_put_cap_refs(struct ceph_inode_info *ci, int had);
1008 extern void ceph_put_wrbuffer_cap_refs(struct ceph_inode_info *ci, int nr,
1009 struct ceph_snap_context *snapc);
1010 extern void ceph_flush_snaps(struct ceph_inode_info *ci,
1011 struct ceph_mds_session **psession);
1012 extern bool __ceph_should_report_size(struct ceph_inode_info *ci);
1013 extern void ceph_check_caps(struct ceph_inode_info *ci, int flags,
1014 struct ceph_mds_session *session);
1015 extern void ceph_check_delayed_caps(struct ceph_mds_client *mdsc);
1016 extern void ceph_flush_dirty_caps(struct ceph_mds_client *mdsc);
1017 extern int ceph_drop_caps_for_unlink(struct inode *inode);
1018 extern int ceph_encode_inode_release(void **p, struct inode *inode,
1019 int mds, int drop, int unless, int force);
1020 extern int ceph_encode_dentry_release(void **p, struct dentry *dn,
1022 int mds, int drop, int unless);
1024 extern int ceph_get_caps(struct ceph_inode_info *ci, int need, int want,
1025 loff_t endoff, int *got, struct page **pinned_page);
1026 extern int ceph_try_get_caps(struct ceph_inode_info *ci,
1027 int need, int want, bool nonblock, int *got);
1029 /* for counting open files by mode */
1030 extern void __ceph_get_fmode(struct ceph_inode_info *ci, int mode);
1031 extern void ceph_put_fmode(struct ceph_inode_info *ci, int mode);
1034 extern const struct address_space_operations ceph_aops;
1035 extern int ceph_mmap(struct file *file, struct vm_area_struct *vma);
1036 extern int ceph_uninline_data(struct file *filp, struct page *locked_page);
1037 extern int ceph_pool_perm_check(struct ceph_inode_info *ci, int need);
1038 extern void ceph_pool_perm_destroy(struct ceph_mds_client* mdsc);
1041 extern const struct file_operations ceph_file_fops;
1043 extern int ceph_renew_caps(struct inode *inode);
1044 extern int ceph_open(struct inode *inode, struct file *file);
1045 extern int ceph_atomic_open(struct inode *dir, struct dentry *dentry,
1046 struct file *file, unsigned flags, umode_t mode);
1047 extern int ceph_release(struct inode *inode, struct file *filp);
1048 extern void ceph_fill_inline_data(struct inode *inode, struct page *locked_page,
1049 char *data, size_t len);
1052 extern const struct file_operations ceph_dir_fops;
1053 extern const struct file_operations ceph_snapdir_fops;
1054 extern const struct inode_operations ceph_dir_iops;
1055 extern const struct inode_operations ceph_snapdir_iops;
1056 extern const struct dentry_operations ceph_dentry_ops;
1058 extern loff_t ceph_make_fpos(unsigned high, unsigned off, bool hash_order);
1059 extern int ceph_handle_notrace_create(struct inode *dir, struct dentry *dentry);
1060 extern int ceph_handle_snapdir(struct ceph_mds_request *req,
1061 struct dentry *dentry, int err);
1062 extern struct dentry *ceph_finish_lookup(struct ceph_mds_request *req,
1063 struct dentry *dentry, int err);
1065 extern void ceph_dentry_lru_add(struct dentry *dn);
1066 extern void ceph_dentry_lru_touch(struct dentry *dn);
1067 extern void ceph_dentry_lru_del(struct dentry *dn);
1068 extern void ceph_invalidate_dentry_lease(struct dentry *dentry);
1069 extern unsigned ceph_dentry_hash(struct inode *dir, struct dentry *dn);
1070 extern void ceph_readdir_cache_release(struct ceph_readdir_cache_control *ctl);
1073 extern long ceph_ioctl(struct file *file, unsigned int cmd, unsigned long arg);
1076 extern const struct export_operations ceph_export_ops;
1079 extern __init void ceph_flock_init(void);
1080 extern int ceph_lock(struct file *file, int cmd, struct file_lock *fl);
1081 extern int ceph_flock(struct file *file, int cmd, struct file_lock *fl);
1082 extern void ceph_count_locks(struct inode *inode, int *p_num, int *f_num);
1083 extern int ceph_encode_locks_to_buffer(struct inode *inode,
1084 struct ceph_filelock *flocks,
1085 int num_fcntl_locks,
1086 int num_flock_locks);
1087 extern int ceph_locks_to_pagelist(struct ceph_filelock *flocks,
1088 struct ceph_pagelist *pagelist,
1089 int num_fcntl_locks, int num_flock_locks);
1092 extern int ceph_fs_debugfs_init(struct ceph_fs_client *client);
1093 extern void ceph_fs_debugfs_cleanup(struct ceph_fs_client *client);
1096 static inline bool __ceph_has_any_quota(struct ceph_inode_info *ci)
1098 return ci->i_max_files || ci->i_max_bytes;
1101 extern void ceph_adjust_quota_realms_count(struct inode *inode, bool inc);
1103 static inline void __ceph_update_quota(struct ceph_inode_info *ci,
1104 u64 max_bytes, u64 max_files)
1106 bool had_quota, has_quota;
1107 had_quota = __ceph_has_any_quota(ci);
1108 ci->i_max_bytes = max_bytes;
1109 ci->i_max_files = max_files;
1110 has_quota = __ceph_has_any_quota(ci);
1112 if (had_quota != has_quota)
1113 ceph_adjust_quota_realms_count(&ci->vfs_inode, has_quota);
1116 extern void ceph_handle_quota(struct ceph_mds_client *mdsc,
1117 struct ceph_mds_session *session,
1118 struct ceph_msg *msg);
1119 extern bool ceph_quota_is_max_files_exceeded(struct inode *inode);
1120 extern bool ceph_quota_is_same_realm(struct inode *old, struct inode *new);
1121 extern bool ceph_quota_is_max_bytes_exceeded(struct inode *inode,
1123 extern bool ceph_quota_is_max_bytes_approaching(struct inode *inode,
1125 extern bool ceph_quota_update_statfs(struct ceph_fs_client *fsc,
1126 struct kstatfs *buf);
1128 #endif /* _FS_CEPH_SUPER_H */