]> git.proxmox.com Git - mirror_ubuntu-jammy-kernel.git/blame - fs/ceph/super.h
ceph: fix root quota realm check
[mirror_ubuntu-jammy-kernel.git] / fs / ceph / super.h
CommitLineData
b2441318 1/* SPDX-License-Identifier: GPL-2.0 */
de57606c
SW
2#ifndef _FS_CEPH_SUPER_H
3#define _FS_CEPH_SUPER_H
4
3d14c5d2 5#include <linux/ceph/ceph_debug.h>
de57606c
SW
6
7#include <asm/unaligned.h>
8#include <linux/backing-dev.h>
9#include <linux/completion.h>
10#include <linux/exportfs.h>
11#include <linux/fs.h>
12#include <linux/mempool.h>
13#include <linux/pagemap.h>
14#include <linux/wait.h>
f1a3d572 15#include <linux/writeback.h>
5a0e3ad6 16#include <linux/slab.h>
c969d9bf 17#include <linux/posix_acl.h>
805692d0 18#include <linux/refcount.h>
de57606c 19
3d14c5d2 20#include <linux/ceph/libceph.h>
de57606c 21
99ccbd22
MT
22#ifdef CONFIG_CEPH_FSCACHE
23#include <linux/fscache.h>
24#endif
25
de57606c
SW
26/* f_type in struct statfs */
27#define CEPH_SUPER_MAGIC 0x00c36400
28
29/* large granularity for statfs utilization stats to facilitate
30 * large volume sizes on 32-bit machines. */
92a49fb0 31#define CEPH_BLOCK_SHIFT 22 /* 4 MB */
de57606c
SW
32#define CEPH_BLOCK (1 << CEPH_BLOCK_SHIFT)
33
3d14c5d2
YS
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 */
ad1fee96 37#define CEPH_MOUNT_OPT_INO32 (1<<8) /* 32 bit inos */
a40dc6cc 38#define CEPH_MOUNT_OPT_DCACHE (1<<9) /* use dcache for readdir etc */
99ccbd22 39#define CEPH_MOUNT_OPT_FSCACHE (1<<10) /* use fscache */
10183a69 40#define CEPH_MOUNT_OPT_NOPOOLPERM (1<<11) /* no pool permission check */
e9e427f0 41#define CEPH_MOUNT_OPT_MOUNTWAIT (1<<12) /* mount waits if no mds is up */
6a259382 42
133e9156 43#define CEPH_MOUNT_OPT_DEFAULT CEPH_MOUNT_OPT_DCACHE
de57606c 44
3d14c5d2
YS
45#define ceph_set_mount_opt(fsc, opt) \
46 (fsc)->mount_options->flags |= CEPH_MOUNT_OPT_##opt;
47#define ceph_test_mount_opt(fsc, opt) \
48 (!!((fsc)->mount_options->flags & CEPH_MOUNT_OPT_##opt))
de57606c 49
aa187926
YZ
50/* max size of osd read request, limited by libceph */
51#define CEPH_MAX_READ_SIZE CEPH_MSG_MAX_DATA_LEN
95cca2b4
YZ
52/* osd has a configurable limitaion of max write size.
53 * CEPH_MSG_MAX_DATA_LEN should be small enough. */
54#define CEPH_MAX_WRITE_SIZE CEPH_MSG_MAX_DATA_LEN
7c94ba27 55#define CEPH_RASIZE_DEFAULT (8192*1024) /* max readahead */
3d14c5d2
YS
56#define CEPH_MAX_READDIR_DEFAULT 1024
57#define CEPH_MAX_READDIR_BYTES_DEFAULT (512*1024)
58#define CEPH_SNAPDIRNAME_DEFAULT ".snap"
de57606c 59
4214fb15
YZ
60/*
61 * Delay telling the MDS we no longer want caps, in case we reopen
62 * the file. Delay a minimum amount of time, even if we send a cap
63 * message for some other reason. Otherwise, take the oppotunity to
64 * update the mds to avoid sending another message later.
65 */
66#define CEPH_CAPS_WANTED_DELAY_MIN_DEFAULT 5 /* cap release delay */
67#define CEPH_CAPS_WANTED_DELAY_MAX_DEFAULT 60 /* cap release delay */
68
3d14c5d2 69struct ceph_mount_options {
6e19a16e 70 int flags;
3d14c5d2
YS
71 int sb_flags;
72
83817e35
SW
73 int wsize; /* max write size */
74 int rsize; /* max read size */
75 int rasize; /* max readahead */
6e19a16e
SW
76 int congestion_kb; /* max writeback in flight */
77 int caps_wanted_delay_min, caps_wanted_delay_max;
23804d91
SW
78 int max_readdir; /* max readdir result (entires) */
79 int max_readdir_bytes; /* max readdir result (bytes) */
de57606c 80
3d14c5d2
YS
81 /*
82 * everything above this point can be memcmp'd; everything below
83 * is handled in compare_mount_options()
84 */
de57606c 85
3d14c5d2 86 char *snapdir_name; /* default ".snap" */
430afbad 87 char *mds_namespace; /* default NULL */
3f384954 88 char *server_path; /* default "/" */
1d8f8360 89 char *fscache_uniq; /* default NULL */
3d14c5d2 90};
de57606c 91
3d14c5d2 92struct ceph_fs_client {
de57606c
SW
93 struct super_block *sb;
94
3d14c5d2
YS
95 struct ceph_mount_options *mount_options;
96 struct ceph_client *client;
de57606c 97
3d14c5d2 98 unsigned long mount_state;
85ccce43
SW
99 int min_caps; /* min caps i added */
100
3d14c5d2 101 struct ceph_mds_client *mdsc;
de57606c
SW
102
103 /* writeback */
104 mempool_t *wb_pagevec_pool;
105 struct workqueue_struct *wb_wq;
106 struct workqueue_struct *pg_inv_wq;
107 struct workqueue_struct *trunc_wq;
2baba250 108 atomic_long_t writeback_count;
de57606c 109
0743304d 110#ifdef CONFIG_DEBUG_FS
3d14c5d2 111 struct dentry *debugfs_dentry_lru, *debugfs_caps;
2baba250 112 struct dentry *debugfs_congestion_kb;
06edf046 113 struct dentry *debugfs_bdi;
3d14c5d2 114 struct dentry *debugfs_mdsc, *debugfs_mdsmap;
14ed9703 115 struct dentry *debugfs_mds_sessions;
0743304d 116#endif
99ccbd22
MT
117
118#ifdef CONFIG_CEPH_FSCACHE
119 struct fscache_cookie *fscache;
99ccbd22 120#endif
de57606c
SW
121};
122
3d14c5d2 123
de57606c
SW
124/*
125 * File i/o capability. This tracks shared state with the metadata
126 * server that allows us to cache or writeback attributes or to read
127 * and write data. For any given inode, we should have one or more
128 * capabilities, one issued by each metadata server, and our
129 * cumulative access is the OR of all issued capabilities.
130 *
131 * Each cap is referenced by the inode's i_caps rbtree and by per-mds
132 * session capability lists.
133 */
134struct ceph_cap {
135 struct ceph_inode_info *ci;
136 struct rb_node ci_node; /* per-ci cap tree */
137 struct ceph_mds_session *session;
138 struct list_head session_caps; /* per-session caplist */
de57606c 139 u64 cap_id; /* unique cap id (mds provided) */
745a8e3b
YZ
140 union {
141 /* in-use caps */
142 struct {
143 int issued; /* latest, from the mds */
144 int implemented; /* implemented superset of
145 issued (for revocation) */
146 int mds, mds_wanted;
147 };
148 /* caps to release */
149 struct {
150 u64 cap_ino;
151 int queue_release;
152 };
153 };
685f9a5d
SW
154 u32 seq, issue_seq, mseq;
155 u32 cap_gen; /* active/stale cycle */
de57606c
SW
156 unsigned long last_used;
157 struct list_head caps_item;
158};
159
160#define CHECK_CAPS_NODELAY 1 /* do not delay any further */
161#define CHECK_CAPS_AUTHONLY 2 /* only check auth cap */
162#define CHECK_CAPS_FLUSH 4 /* flush any dirty caps */
163
0e294387
YZ
164struct ceph_cap_flush {
165 u64 tid;
166 int caps; /* 0 means capsnap */
c8799fc4 167 bool wake; /* wake up flush waiters when finish ? */
0e294387
YZ
168 struct list_head g_list; // global
169 struct list_head i_list; // per inode
170};
171
de57606c
SW
172/*
173 * Snapped cap state that is pending flush to mds. When a snapshot occurs,
174 * we first complete any in-process sync writes and writeback any dirty
175 * data before flushing the snapped state (tracked here) back to the MDS.
176 */
177struct ceph_cap_snap {
805692d0 178 refcount_t nref;
0e294387 179 struct list_head ci_item;
de57606c 180
0e294387
YZ
181 struct ceph_cap_flush cap_flush;
182
183 u64 follows;
de57606c
SW
184 int issued, dirty;
185 struct ceph_snap_context *context;
186
5706b27d 187 umode_t mode;
05cb11c1
EB
188 kuid_t uid;
189 kgid_t gid;
de57606c 190
4a625be4 191 struct ceph_buffer *xattr_blob;
de57606c
SW
192 u64 xattr_version;
193
194 u64 size;
195 struct timespec mtime, atime, ctime;
196 u64 time_warp_seq;
5f743e45
YZ
197 u64 truncate_size;
198 u32 truncate_seq;
de57606c
SW
199 int writing; /* a sync write is still in progress */
200 int dirty_pages; /* dirty pages awaiting writeback */
e20d258d 201 bool inline_data;
86056090 202 bool need_flush;
de57606c
SW
203};
204
205static inline void ceph_put_cap_snap(struct ceph_cap_snap *capsnap)
206{
805692d0 207 if (refcount_dec_and_test(&capsnap->nref)) {
4a625be4
SW
208 if (capsnap->xattr_blob)
209 ceph_buffer_put(capsnap->xattr_blob);
de57606c 210 kfree(capsnap);
4a625be4 211 }
de57606c
SW
212}
213
214/*
215 * The frag tree describes how a directory is fragmented, potentially across
216 * multiple metadata servers. It is also used to indicate points where
217 * metadata authority is delegated, and whether/where metadata is replicated.
218 *
219 * A _leaf_ frag will be present in the i_fragtree IFF there is
220 * delegation info. That is, if mds >= 0 || ndist > 0.
221 */
222#define CEPH_MAX_DIRFRAG_REP 4
223
224struct ceph_inode_frag {
225 struct rb_node node;
226
227 /* fragtree state */
228 u32 frag;
229 int split_by; /* i.e. 2^(split_by) children */
230
231 /* delegation and replication info */
232 int mds; /* -1 if same authority as parent */
233 int ndist; /* >0 if replicated */
234 int dist[CEPH_MAX_DIRFRAG_REP];
235};
236
237/*
238 * We cache inode xattrs as an encoded blob until they are first used,
239 * at which point we parse them into an rbtree.
240 */
241struct ceph_inode_xattr {
242 struct rb_node node;
243
244 const char *name;
245 int name_len;
246 const char *val;
247 int val_len;
248 int dirty;
249
250 int should_free_name;
251 int should_free_val;
252};
253
3d14c5d2
YS
254/*
255 * Ceph dentry state
256 */
257struct ceph_dentry_info {
258 struct ceph_mds_session *lease_session;
97aeb6bf
YZ
259 int lease_shared_gen;
260 u32 lease_gen;
3d14c5d2
YS
261 u32 lease_seq;
262 unsigned long lease_renew_after, lease_renew_from;
263 struct list_head lru;
264 struct dentry *dentry;
9b16f03c 265 unsigned long time;
3d14c5d2
YS
266 u64 offset;
267};
268
de57606c
SW
269struct ceph_inode_xattrs_info {
270 /*
271 * (still encoded) xattr blob. we avoid the overhead of parsing
272 * this until someone actually calls getxattr, etc.
273 *
274 * blob->vec.iov_len == 4 implies there are no xattrs; blob ==
275 * NULL means we don't know.
276 */
277 struct ceph_buffer *blob, *prealloc_blob;
278
279 struct rb_root index;
280 bool dirty;
281 int count;
282 int names_size;
283 int vals_size;
284 u64 version, index_version;
285};
286
287/*
288 * Ceph inode.
289 */
de57606c
SW
290struct ceph_inode_info {
291 struct ceph_vino i_vino; /* ceph ino + snap */
292
be655596
SW
293 spinlock_t i_ceph_lock;
294
de57606c 295 u64 i_version;
31c542a1 296 u64 i_inline_version;
de57606c
SW
297 u32 i_time_warp_seq;
298
299 unsigned i_ceph_flags;
fdd4e158
YZ
300 atomic64_t i_release_count;
301 atomic64_t i_ordered_count;
302 atomic64_t i_complete_seq[2];
de57606c 303
6c0f3af7 304 struct ceph_dir_layout i_dir_layout;
de57606c
SW
305 struct ceph_file_layout i_layout;
306 char *i_symlink;
307
308 /* for dirs */
309 struct timespec i_rctime;
310 u64 i_rbytes, i_rfiles, i_rsubdirs;
311 u64 i_files, i_subdirs;
de57606c 312
fb18a575
LH
313 /* quotas */
314 u64 i_max_bytes, i_max_files;
315
de57606c 316 struct rb_root i_fragtree;
1b1bc16d 317 int i_fragtree_nsplits;
de57606c
SW
318 struct mutex i_fragtree_mutex;
319
320 struct ceph_inode_xattrs_info i_xattrs;
321
be655596 322 /* capabilities. protected _both_ by i_ceph_lock and cap->session's
de57606c
SW
323 * s_mutex. */
324 struct rb_root i_caps; /* cap list */
325 struct ceph_cap *i_auth_cap; /* authoritative cap, if any */
326 unsigned i_dirty_caps, i_flushing_caps; /* mask of dirtied fields */
327 struct list_head i_dirty_item, i_flushing_item;
de57606c
SW
328 /* we need to track cap writeback on a per-cap-bit basis, to allow
329 * overlapping, pipelined cap flushes to the mds. we can probably
330 * reduce the tid to 8 bits if we're concerned about inode size. */
f66fd9f0 331 struct ceph_cap_flush *i_prealloc_cap_flush;
e4500b5e 332 struct list_head i_cap_flush_list;
de57606c
SW
333 wait_queue_head_t i_cap_wq; /* threads waiting on a capability */
334 unsigned long i_hold_caps_min; /* jiffies */
335 unsigned long i_hold_caps_max; /* jiffies */
336 struct list_head i_cap_delay_list; /* for delayed cap release to mds */
de57606c
SW
337 struct ceph_cap_reservation i_cap_migration_resv;
338 struct list_head i_cap_snaps; /* snapped state pending flush to mds */
7d8cb26d
SW
339 struct ceph_snap_context *i_head_snapc; /* set if wr_buffer_head > 0 or
340 dirty|flushing caps */
de57606c
SW
341 unsigned i_snap_caps; /* cap bits for snapped files */
342
774a6a11 343 int i_nr_by_mode[CEPH_FILE_MODE_BITS]; /* open file counts */
de57606c 344
b0d7c223 345 struct mutex i_truncate_mutex;
de57606c
SW
346 u32 i_truncate_seq; /* last truncate to smaller size */
347 u64 i_truncate_size; /* and the size we last truncated down to */
348 int i_truncate_pending; /* still need to call vmtruncate */
349
350 u64 i_max_size; /* max file size authorized by mds */
351 u64 i_reported_size; /* (max_)size reported to or requested of mds */
352 u64 i_wanted_max_size; /* offset we'd like to write too */
353 u64 i_requested_max_size; /* max_size we've requested */
354
355 /* held references to caps */
356 int i_pin_ref;
d3d0720d 357 int i_rd_ref, i_rdcache_ref, i_wr_ref, i_wb_ref;
de57606c 358 int i_wrbuffer_ref, i_wrbuffer_ref_head;
89aa5930 359 atomic_t i_filelock_ref;
97aeb6bf 360 atomic_t i_shared_gen; /* increment each time we get FILE_SHARED */
cd045cb4 361 u32 i_rdcache_gen; /* incremented each time we get FILE_CACHE. */
de57606c
SW
362 u32 i_rdcache_revoking; /* RDCACHE gen to async invalidate, if any */
363
de57606c 364 struct list_head i_unsafe_dirops; /* uncommitted mds dir ops */
68cd5b4b 365 struct list_head i_unsafe_iops; /* uncommitted mds inode ops */
de57606c
SW
366 spinlock_t i_unsafe_lock;
367
368 struct ceph_snap_realm *i_snap_realm; /* snap realm (if caps) */
369 int i_snap_realm_counter; /* snap realm (if caps) */
370 struct list_head i_snap_realm_item;
371 struct list_head i_snap_flush_item;
372
373 struct work_struct i_wb_work; /* writeback work */
374 struct work_struct i_pg_inv_work; /* page invalidation work */
375
376 struct work_struct i_vmtruncate_work;
377
99ccbd22
MT
378#ifdef CONFIG_CEPH_FSCACHE
379 struct fscache_cookie *fscache;
f7f7e7a0 380 u32 i_fscache_gen;
99ccbd22 381#endif
de57606c
SW
382 struct inode vfs_inode; /* at end */
383};
384
385static inline struct ceph_inode_info *ceph_inode(struct inode *inode)
386{
fbbccec9 387 return container_of(inode, struct ceph_inode_info, vfs_inode);
de57606c
SW
388}
389
ad1fee96
YS
390static inline struct ceph_fs_client *ceph_inode_to_client(struct inode *inode)
391{
392 return (struct ceph_fs_client *)inode->i_sb->s_fs_info;
393}
394
395static inline struct ceph_fs_client *ceph_sb_to_client(struct super_block *sb)
396{
397 return (struct ceph_fs_client *)sb->s_fs_info;
398}
399
3d14c5d2
YS
400static inline struct ceph_vino ceph_vino(struct inode *inode)
401{
402 return ceph_inode(inode)->i_vino;
403}
404
405/*
406 * ino_t is <64 bits on many architectures, blech.
407 *
ad1fee96
YS
408 * i_ino (kernel inode) st_ino (userspace)
409 * i386 32 32
410 * x86_64+ino32 64 32
411 * x86_64 64 64
412 */
3310f754 413static inline u32 ceph_ino_to_ino32(__u64 vino)
ad1fee96 414{
3310f754
AO
415 u32 ino = vino & 0xffffffff;
416 ino ^= vino >> 32;
ad1fee96 417 if (!ino)
a661fc56 418 ino = 2;
ad1fee96
YS
419 return ino;
420}
421
422/*
423 * kernel i_ino value
3d14c5d2
YS
424 */
425static inline ino_t ceph_vino_to_ino(struct ceph_vino vino)
426{
3d14c5d2 427#if BITS_PER_LONG == 32
3310f754
AO
428 return ceph_ino_to_ino32(vino.ino);
429#else
430 return (ino_t)vino.ino;
3d14c5d2 431#endif
3d14c5d2
YS
432}
433
ad1fee96
YS
434/*
435 * user-visible ino (stat, filldir)
436 */
437#if BITS_PER_LONG == 32
438static inline ino_t ceph_translate_ino(struct super_block *sb, ino_t ino)
439{
440 return ino;
441}
442#else
443static inline ino_t ceph_translate_ino(struct super_block *sb, ino_t ino)
444{
445 if (ceph_test_mount_opt(ceph_sb_to_client(sb), INO32))
446 ino = ceph_ino_to_ino32(ino);
447 return ino;
448}
449#endif
450
451
3d14c5d2
YS
452/* for printf-style formatting */
453#define ceph_vinop(i) ceph_inode(i)->i_vino.ino, ceph_inode(i)->i_vino.snap
454
455static inline u64 ceph_ino(struct inode *inode)
456{
457 return ceph_inode(inode)->i_vino.ino;
458}
459static inline u64 ceph_snap(struct inode *inode)
460{
461 return ceph_inode(inode)->i_vino.snap;
462}
463
464static inline int ceph_ino_compare(struct inode *inode, void *data)
465{
466 struct ceph_vino *pvino = (struct ceph_vino *)data;
467 struct ceph_inode_info *ci = ceph_inode(inode);
468 return ci->i_vino.ino == pvino->ino &&
469 ci->i_vino.snap == pvino->snap;
470}
471
472static inline struct inode *ceph_find_inode(struct super_block *sb,
473 struct ceph_vino vino)
474{
475 ino_t t = ceph_vino_to_ino(vino);
476 return ilookup5(sb, t, ceph_ino_compare, &vino);
477}
478
479
480/*
481 * Ceph inode.
482 */
10183a69
YZ
483#define CEPH_I_DIR_ORDERED (1 << 0) /* dentries in dir are ordered */
484#define CEPH_I_NODELAY (1 << 1) /* do not delay cap release */
485#define CEPH_I_FLUSH (1 << 2) /* do not delay flush of dirty metadata */
486#define CEPH_I_NOFLUSH (1 << 3) /* do not flush dirty caps */
487#define CEPH_I_POOL_PERM (1 << 4) /* pool rd/wr bits are valid */
488#define CEPH_I_POOL_RD (1 << 5) /* can read from pool */
489#define CEPH_I_POOL_WR (1 << 6) /* can write to pool */
315f2408 490#define CEPH_I_SEC_INITED (1 << 7) /* security initialized */
77310320 491#define CEPH_I_CAP_DROPPED (1 << 8) /* caps were forcibly dropped */
13c2b57d 492#define CEPH_I_KICK_FLUSH (1 << 9) /* kick flushing caps */
70220ac8 493#define CEPH_I_FLUSH_SNAPS (1 << 10) /* need flush snapss */
26544c62 494#define CEPH_I_ERROR_WRITE (1 << 11) /* have seen write errors */
b3f8d68f
YZ
495#define CEPH_I_ERROR_FILELOCK (1 << 12) /* have seen file lock errors */
496
26544c62
JL
497
498/*
499 * We set the ERROR_WRITE bit when we start seeing write errors on an inode
500 * and then clear it when they start succeeding. Note that we do a lockless
501 * check first, and only take the lock if it looks like it needs to be changed.
502 * The write submission code just takes this as a hint, so we're not too
503 * worried if a few slip through in either direction.
504 */
505static inline void ceph_set_error_write(struct ceph_inode_info *ci)
506{
507 if (!(READ_ONCE(ci->i_ceph_flags) & CEPH_I_ERROR_WRITE)) {
508 spin_lock(&ci->i_ceph_lock);
509 ci->i_ceph_flags |= CEPH_I_ERROR_WRITE;
510 spin_unlock(&ci->i_ceph_lock);
511 }
512}
513
514static inline void ceph_clear_error_write(struct ceph_inode_info *ci)
515{
516 if (READ_ONCE(ci->i_ceph_flags) & CEPH_I_ERROR_WRITE) {
517 spin_lock(&ci->i_ceph_lock);
518 ci->i_ceph_flags &= ~CEPH_I_ERROR_WRITE;
519 spin_unlock(&ci->i_ceph_lock);
520 }
521}
3d14c5d2 522
2f276c51 523static inline void __ceph_dir_set_complete(struct ceph_inode_info *ci,
fdd4e158
YZ
524 long long release_count,
525 long long ordered_count)
de57606c 526{
fdd4e158
YZ
527 smp_mb__before_atomic();
528 atomic64_set(&ci->i_complete_seq[0], release_count);
529 atomic64_set(&ci->i_complete_seq[1], ordered_count);
de57606c
SW
530}
531
2f276c51 532static inline void __ceph_dir_clear_complete(struct ceph_inode_info *ci)
de57606c 533{
fdd4e158
YZ
534 atomic64_inc(&ci->i_release_count);
535}
536
537static inline void __ceph_dir_clear_ordered(struct ceph_inode_info *ci)
538{
539 atomic64_inc(&ci->i_ordered_count);
2f276c51 540}
de57606c 541
2f276c51
YZ
542static inline bool __ceph_dir_is_complete(struct ceph_inode_info *ci)
543{
fdd4e158
YZ
544 return atomic64_read(&ci->i_complete_seq[0]) ==
545 atomic64_read(&ci->i_release_count);
de57606c
SW
546}
547
70db4f36
YZ
548static inline bool __ceph_dir_is_complete_ordered(struct ceph_inode_info *ci)
549{
fdd4e158
YZ
550 return atomic64_read(&ci->i_complete_seq[0]) ==
551 atomic64_read(&ci->i_release_count) &&
552 atomic64_read(&ci->i_complete_seq[1]) ==
553 atomic64_read(&ci->i_ordered_count);
70db4f36
YZ
554}
555
2f276c51 556static inline void ceph_dir_clear_complete(struct inode *inode)
de57606c 557{
2f276c51
YZ
558 __ceph_dir_clear_complete(ceph_inode(inode));
559}
de57606c 560
70db4f36 561static inline void ceph_dir_clear_ordered(struct inode *inode)
2f276c51 562{
fdd4e158 563 __ceph_dir_clear_ordered(ceph_inode(inode));
de57606c
SW
564}
565
70db4f36
YZ
566static inline bool ceph_dir_is_complete_ordered(struct inode *inode)
567{
fdd4e158
YZ
568 bool ret = __ceph_dir_is_complete_ordered(ceph_inode(inode));
569 smp_rmb();
70db4f36
YZ
570 return ret;
571}
de57606c
SW
572
573/* find a specific frag @f */
574extern struct ceph_inode_frag *__ceph_find_frag(struct ceph_inode_info *ci,
575 u32 f);
576
577/*
578 * choose fragment for value @v. copy frag content to pfrag, if leaf
579 * exists
580 */
581extern u32 ceph_choose_frag(struct ceph_inode_info *ci, u32 v,
582 struct ceph_inode_frag *pfrag,
583 int *found);
584
de57606c
SW
585static inline struct ceph_dentry_info *ceph_dentry(struct dentry *dentry)
586{
587 return (struct ceph_dentry_info *)dentry->d_fsdata;
588}
589
de57606c
SW
590/*
591 * caps helpers
592 */
593static inline bool __ceph_is_any_real_caps(struct ceph_inode_info *ci)
594{
595 return !RB_EMPTY_ROOT(&ci->i_caps);
596}
597
598extern int __ceph_caps_issued(struct ceph_inode_info *ci, int *implemented);
599extern int __ceph_caps_issued_mask(struct ceph_inode_info *ci, int mask, int t);
600extern int __ceph_caps_issued_other(struct ceph_inode_info *ci,
601 struct ceph_cap *cap);
602
603static inline int ceph_caps_issued(struct ceph_inode_info *ci)
604{
605 int issued;
be655596 606 spin_lock(&ci->i_ceph_lock);
de57606c 607 issued = __ceph_caps_issued(ci, NULL);
be655596 608 spin_unlock(&ci->i_ceph_lock);
de57606c
SW
609 return issued;
610}
611
612static inline int ceph_caps_issued_mask(struct ceph_inode_info *ci, int mask,
613 int touch)
614{
615 int r;
be655596 616 spin_lock(&ci->i_ceph_lock);
de57606c 617 r = __ceph_caps_issued_mask(ci, mask, touch);
be655596 618 spin_unlock(&ci->i_ceph_lock);
de57606c
SW
619 return r;
620}
621
622static inline int __ceph_caps_dirty(struct ceph_inode_info *ci)
623{
624 return ci->i_dirty_caps | ci->i_flushing_caps;
625}
f66fd9f0
YZ
626extern struct ceph_cap_flush *ceph_alloc_cap_flush(void);
627extern void ceph_free_cap_flush(struct ceph_cap_flush *cf);
628extern int __ceph_mark_dirty_caps(struct ceph_inode_info *ci, int mask,
629 struct ceph_cap_flush **pcf);
de57606c 630
9563f88c
YZ
631extern int __ceph_caps_revoking_other(struct ceph_inode_info *ci,
632 struct ceph_cap *ocap, int mask);
de57606c
SW
633extern int ceph_caps_revoking(struct ceph_inode_info *ci, int mask);
634extern int __ceph_caps_used(struct ceph_inode_info *ci);
635
636extern int __ceph_caps_file_wanted(struct ceph_inode_info *ci);
637
638/*
639 * wanted, by virtue of open file modes AND cap refs (buffered/cached data)
640 */
641static inline int __ceph_caps_wanted(struct ceph_inode_info *ci)
642{
643 int w = __ceph_caps_file_wanted(ci) | __ceph_caps_used(ci);
644 if (w & CEPH_CAP_FILE_BUFFER)
645 w |= CEPH_CAP_FILE_EXCL; /* we want EXCL if dirty data */
646 return w;
647}
648
649/* what the mds thinks we want */
c1944fed 650extern int __ceph_caps_mds_wanted(struct ceph_inode_info *ci, bool check);
de57606c 651
37151668
YS
652extern void ceph_caps_init(struct ceph_mds_client *mdsc);
653extern void ceph_caps_finalize(struct ceph_mds_client *mdsc);
654extern void ceph_adjust_min_caps(struct ceph_mds_client *mdsc, int delta);
e30ee581 655extern int ceph_reserve_caps(struct ceph_mds_client *mdsc,
37151668
YS
656 struct ceph_cap_reservation *ctx, int need);
657extern int ceph_unreserve_caps(struct ceph_mds_client *mdsc,
658 struct ceph_cap_reservation *ctx);
3d14c5d2 659extern void ceph_reservation_status(struct ceph_fs_client *client,
de57606c 660 int *total, int *avail, int *used,
85ccce43 661 int *reserved, int *min);
de57606c 662
de57606c 663
de57606c
SW
664
665/*
666 * we keep buffered readdir results attached to file->private_data
667 */
4918b6d1 668#define CEPH_F_SYNC 1
9cfa1098 669#define CEPH_F_ATEND 2
4918b6d1 670
de57606c 671struct ceph_file_info {
252c6728
SW
672 short fmode; /* initialized on open */
673 short flags; /* CEPH_F_* */
de57606c 674
5d988308
YZ
675 spinlock_t rw_contexts_lock;
676 struct list_head rw_contexts;
bb48bd4d
CX
677};
678
679struct ceph_dir_file_info {
680 struct ceph_file_info file_info;
5d988308 681
de57606c
SW
682 /* readdir: position within the dir */
683 u32 frag;
684 struct ceph_mds_request *last_readdir;
de57606c
SW
685
686 /* readdir: position within a frag */
f0494206 687 unsigned next_offset; /* offset of next chunk (last_name's + 1) */
de57606c 688 char *last_name; /* last entry in previous chunk */
fdd4e158
YZ
689 long long dir_release_count;
690 long long dir_ordered_count;
691 int readdir_cache_idx;
de57606c
SW
692
693 /* used for -o dirstat read() on directory thing */
694 char *dir_info;
695 int dir_info_len;
696};
697
5d988308
YZ
698struct ceph_rw_context {
699 struct list_head list;
700 struct task_struct *thread;
701 int caps;
702};
703
704#define CEPH_DEFINE_RW_CONTEXT(_name, _caps) \
705 struct ceph_rw_context _name = { \
706 .thread = current, \
707 .caps = _caps, \
708 }
709
710static inline void ceph_add_rw_context(struct ceph_file_info *cf,
711 struct ceph_rw_context *ctx)
712{
713 spin_lock(&cf->rw_contexts_lock);
714 list_add(&ctx->list, &cf->rw_contexts);
715 spin_unlock(&cf->rw_contexts_lock);
716}
717
718static inline void ceph_del_rw_context(struct ceph_file_info *cf,
719 struct ceph_rw_context *ctx)
720{
721 spin_lock(&cf->rw_contexts_lock);
722 list_del(&ctx->list);
723 spin_unlock(&cf->rw_contexts_lock);
724}
725
726static inline struct ceph_rw_context*
727ceph_find_rw_context(struct ceph_file_info *cf)
728{
729 struct ceph_rw_context *ctx, *found = NULL;
730 spin_lock(&cf->rw_contexts_lock);
731 list_for_each_entry(ctx, &cf->rw_contexts, list) {
732 if (ctx->thread == current) {
733 found = ctx;
734 break;
735 }
736 }
737 spin_unlock(&cf->rw_contexts_lock);
738 return found;
739}
740
fdd4e158
YZ
741struct ceph_readdir_cache_control {
742 struct page *page;
743 struct dentry **dentries;
744 int index;
745};
de57606c 746
de57606c
SW
747/*
748 * A "snap realm" describes a subset of the file hierarchy sharing
749 * the same set of snapshots that apply to it. The realms themselves
750 * are organized into a hierarchy, such that children inherit (some of)
751 * the snapshots of their parents.
752 *
753 * All inodes within the realm that have capabilities are linked into a
754 * per-realm list.
755 */
756struct ceph_snap_realm {
757 u64 ino;
758 atomic_t nref;
a105f00c
SW
759 struct rb_node node;
760
de57606c
SW
761 u64 created, seq;
762 u64 parent_ino;
763 u64 parent_since; /* snapid when our current parent became so */
764
765 u64 *prior_parent_snaps; /* snaps inherited from any parents we */
aa711ee3 766 u32 num_prior_parent_snaps; /* had prior to parent_since */
de57606c 767 u64 *snaps; /* snaps specific to this realm */
aa711ee3 768 u32 num_snaps;
de57606c
SW
769
770 struct ceph_snap_realm *parent;
771 struct list_head children; /* list of child realms */
772 struct list_head child_item;
773
774 struct list_head empty_item; /* if i have ref==0 */
775
ae00d4f3
SW
776 struct list_head dirty_item; /* if realm needs new context */
777
de57606c
SW
778 /* the current set of snaps for this realm */
779 struct ceph_snap_context *cached_context;
780
781 struct list_head inodes_with_caps;
782 spinlock_t inodes_with_caps_lock;
783};
784
3d14c5d2 785static inline int default_congestion_kb(void)
de57606c 786{
3d14c5d2
YS
787 int congestion_kb;
788
789 /*
790 * Copied from NFS
791 *
792 * congestion size, scale with available memory.
793 *
794 * 64MB: 8192k
795 * 128MB: 11585k
796 * 256MB: 16384k
797 * 512MB: 23170k
798 * 1GB: 32768k
799 * 2GB: 46340k
800 * 4GB: 65536k
801 * 8GB: 92681k
802 * 16GB: 131072k
803 *
804 * This allows larger machines to have larger/more transfers.
805 * Limit the default to 256M
806 */
807 congestion_kb = (16*int_sqrt(totalram_pages)) << (PAGE_SHIFT-10);
808 if (congestion_kb > 256*1024)
809 congestion_kb = 256*1024;
810
811 return congestion_kb;
de57606c
SW
812}
813
814
815
816/* snap.c */
817struct ceph_snap_realm *ceph_lookup_snap_realm(struct ceph_mds_client *mdsc,
818 u64 ino);
819extern void ceph_get_snap_realm(struct ceph_mds_client *mdsc,
820 struct ceph_snap_realm *realm);
821extern void ceph_put_snap_realm(struct ceph_mds_client *mdsc,
822 struct ceph_snap_realm *realm);
823extern int ceph_update_snap_trace(struct ceph_mds_client *m,
982d6011
YZ
824 void *p, void *e, bool deletion,
825 struct ceph_snap_realm **realm_ret);
de57606c 826extern void ceph_handle_snap(struct ceph_mds_client *mdsc,
2600d2dd 827 struct ceph_mds_session *session,
de57606c 828 struct ceph_msg *msg);
fc837c8f 829extern void ceph_queue_cap_snap(struct ceph_inode_info *ci);
de57606c
SW
830extern int __ceph_finish_cap_snap(struct ceph_inode_info *ci,
831 struct ceph_cap_snap *capsnap);
832extern void ceph_cleanup_empty_realms(struct ceph_mds_client *mdsc);
833
834/*
835 * a cap_snap is "pending" if it is still awaiting an in-progress
836 * sync write (that may/may not still update size, mtime, etc.).
837 */
838static inline bool __ceph_have_pending_cap_snap(struct ceph_inode_info *ci)
839{
840 return !list_empty(&ci->i_cap_snaps) &&
86056090
YZ
841 list_last_entry(&ci->i_cap_snaps, struct ceph_cap_snap,
842 ci_item)->writing;
de57606c
SW
843}
844
de57606c
SW
845/* inode.c */
846extern const struct inode_operations ceph_file_iops;
847
848extern struct inode *ceph_alloc_inode(struct super_block *sb);
849extern void ceph_destroy_inode(struct inode *inode);
9f12bd11 850extern int ceph_drop_inode(struct inode *inode);
de57606c
SW
851
852extern struct inode *ceph_get_inode(struct super_block *sb,
853 struct ceph_vino vino);
854extern struct inode *ceph_get_snapdir(struct inode *parent);
855extern int ceph_fill_file_size(struct inode *inode, int issued,
856 u32 truncate_seq, u64 truncate_size, u64 size);
857extern void ceph_fill_file_time(struct inode *inode, int issued,
858 u64 time_warp_seq, struct timespec *ctime,
859 struct timespec *mtime, struct timespec *atime);
860extern int ceph_fill_trace(struct super_block *sb,
f5a03b08 861 struct ceph_mds_request *req);
de57606c
SW
862extern int ceph_readdir_prepopulate(struct ceph_mds_request *req,
863 struct ceph_mds_session *session);
864
865extern int ceph_inode_holds_cap(struct inode *inode, int mask);
866
efb0ca76 867extern bool ceph_inode_set_size(struct inode *inode, loff_t size);
b415bf4f 868extern void __ceph_do_pending_vmtruncate(struct inode *inode);
3c6f6b79
SW
869extern void ceph_queue_vmtruncate(struct inode *inode);
870
871extern void ceph_queue_invalidate(struct inode *inode);
872extern void ceph_queue_writeback(struct inode *inode);
de57606c 873
01deead0
YZ
874extern int __ceph_do_getattr(struct inode *inode, struct page *locked_page,
875 int mask, bool force);
876static inline int ceph_do_getattr(struct inode *inode, int mask, bool force)
877{
878 return __ceph_do_getattr(inode, NULL, mask, force);
879}
10556cb2 880extern int ceph_permission(struct inode *inode, int mask);
a26fecca 881extern int __ceph_setattr(struct inode *inode, struct iattr *attr);
de57606c 882extern int ceph_setattr(struct dentry *dentry, struct iattr *attr);
a528d35e
DH
883extern int ceph_getattr(const struct path *path, struct kstat *stat,
884 u32 request_mask, unsigned int flags);
de57606c
SW
885
886/* xattr.c */
a26fecca 887int __ceph_setxattr(struct inode *, const char *, const void *, size_t, int);
7221fe4c 888ssize_t __ceph_getxattr(struct inode *, const char *, void *, size_t);
de57606c 889extern ssize_t ceph_listxattr(struct dentry *, char *, size_t);
de57606c
SW
890extern void __ceph_build_xattrs_blob(struct ceph_inode_info *ci);
891extern void __ceph_destroy_xattrs(struct ceph_inode_info *ci);
3ce6cd12
AE
892extern void __init ceph_xattr_init(void);
893extern void ceph_xattr_exit(void);
b1ee94aa 894extern const struct xattr_handler *ceph_xattr_handlers[];
de57606c 895
315f2408
YZ
896#ifdef CONFIG_SECURITY
897extern bool ceph_security_xattr_deadlock(struct inode *in);
898extern bool ceph_security_xattr_wanted(struct inode *in);
899#else
900static inline bool ceph_security_xattr_deadlock(struct inode *in)
901{
902 return false;
903}
904static inline bool ceph_security_xattr_wanted(struct inode *in)
905{
906 return false;
907}
908#endif
909
7221fe4c 910/* acl.c */
b1ee94aa
YZ
911struct ceph_acls_info {
912 void *default_acl;
913 void *acl;
914 struct ceph_pagelist *pagelist;
915};
7221fe4c
GZ
916
917#ifdef CONFIG_CEPH_FS_POSIX_ACL
918
919struct posix_acl *ceph_get_acl(struct inode *, int);
72466d0b 920int ceph_set_acl(struct inode *inode, struct posix_acl *acl, int type);
b1ee94aa
YZ
921int ceph_pre_init_acls(struct inode *dir, umode_t *mode,
922 struct ceph_acls_info *info);
923void ceph_init_inode_acls(struct inode *inode, struct ceph_acls_info *info);
924void ceph_release_acls_info(struct ceph_acls_info *info);
c969d9bf
GZ
925
926static inline void ceph_forget_all_cached_acls(struct inode *inode)
927{
928 forget_all_cached_acls(inode);
929}
7221fe4c
GZ
930
931#else
932
933#define ceph_get_acl NULL
72466d0b 934#define ceph_set_acl NULL
7221fe4c 935
b1ee94aa
YZ
936static inline int ceph_pre_init_acls(struct inode *dir, umode_t *mode,
937 struct ceph_acls_info *info)
7221fe4c
GZ
938{
939 return 0;
940}
b1ee94aa
YZ
941static inline void ceph_init_inode_acls(struct inode *inode,
942 struct ceph_acls_info *info)
943{
944}
945static inline void ceph_release_acls_info(struct ceph_acls_info *info)
946{
947}
7221fe4c
GZ
948static inline int ceph_acl_chmod(struct dentry *dentry, struct inode *inode)
949{
950 return 0;
951}
952
953static inline void ceph_forget_all_cached_acls(struct inode *inode)
954{
955}
956
957#endif
958
de57606c
SW
959/* caps.c */
960extern const char *ceph_cap_string(int c);
961extern void ceph_handle_caps(struct ceph_mds_session *session,
962 struct ceph_msg *msg);
d9df2783
YZ
963extern struct ceph_cap *ceph_get_cap(struct ceph_mds_client *mdsc,
964 struct ceph_cap_reservation *ctx);
965extern void ceph_add_cap(struct inode *inode,
966 struct ceph_mds_session *session, u64 cap_id,
967 int fmode, unsigned issued, unsigned wanted,
968 unsigned cap, unsigned seq, u64 realmino, int flags,
969 struct ceph_cap **new_cap);
a096b09a 970extern void __ceph_remove_cap(struct ceph_cap *cap, bool queue_release);
37151668
YS
971extern void ceph_put_cap(struct ceph_mds_client *mdsc,
972 struct ceph_cap *cap);
9215aeea 973extern int ceph_is_any_caps(struct inode *inode);
de57606c
SW
974
975extern void ceph_queue_caps_release(struct inode *inode);
f1a3d572 976extern int ceph_write_inode(struct inode *inode, struct writeback_control *wbc);
02c24a82
JB
977extern int ceph_fsync(struct file *file, loff_t start, loff_t end,
978 int datasync);
e548e9b9
YZ
979extern void ceph_early_kick_flushing_caps(struct ceph_mds_client *mdsc,
980 struct ceph_mds_session *session);
de57606c
SW
981extern void ceph_kick_flushing_caps(struct ceph_mds_client *mdsc,
982 struct ceph_mds_session *session);
2bc50259
GF
983extern struct ceph_cap *ceph_get_cap_for_mds(struct ceph_inode_info *ci,
984 int mds);
de57606c
SW
985extern int ceph_get_cap_mds(struct inode *inode);
986extern void ceph_get_cap_refs(struct ceph_inode_info *ci, int caps);
987extern void ceph_put_cap_refs(struct ceph_inode_info *ci, int had);
988extern void ceph_put_wrbuffer_cap_refs(struct ceph_inode_info *ci, int nr,
989 struct ceph_snap_context *snapc);
ed9b430c
YZ
990extern void ceph_flush_snaps(struct ceph_inode_info *ci,
991 struct ceph_mds_session **psession);
efb0ca76 992extern bool __ceph_should_report_size(struct ceph_inode_info *ci);
de57606c
SW
993extern void ceph_check_caps(struct ceph_inode_info *ci, int flags,
994 struct ceph_mds_session *session);
afcdaea3
SW
995extern void ceph_check_delayed_caps(struct ceph_mds_client *mdsc);
996extern void ceph_flush_dirty_caps(struct ceph_mds_client *mdsc);
6ef0bc6d 997extern int ceph_drop_caps_for_unlink(struct inode *inode);
de57606c
SW
998extern int ceph_encode_inode_release(void **p, struct inode *inode,
999 int mds, int drop, int unless, int force);
1000extern int ceph_encode_dentry_release(void **p, struct dentry *dn,
ca6c8ae0 1001 struct inode *dir,
de57606c
SW
1002 int mds, int drop, int unless);
1003
1004extern int ceph_get_caps(struct ceph_inode_info *ci, int need, int want,
31c542a1 1005 loff_t endoff, int *got, struct page **pinned_page);
2b1ac852
YZ
1006extern int ceph_try_get_caps(struct ceph_inode_info *ci,
1007 int need, int want, int *got);
de57606c
SW
1008
1009/* for counting open files by mode */
774a6a11 1010extern void __ceph_get_fmode(struct ceph_inode_info *ci, int mode);
de57606c
SW
1011extern void ceph_put_fmode(struct ceph_inode_info *ci, int mode);
1012
1013/* addr.c */
1014extern const struct address_space_operations ceph_aops;
1015extern int ceph_mmap(struct file *file, struct vm_area_struct *vma);
10183a69
YZ
1016extern int ceph_uninline_data(struct file *filp, struct page *locked_page);
1017extern int ceph_pool_perm_check(struct ceph_inode_info *ci, int need);
1018extern void ceph_pool_perm_destroy(struct ceph_mds_client* mdsc);
de57606c
SW
1019
1020/* file.c */
1021extern const struct file_operations ceph_file_fops;
9e0eb85d 1022
77310320 1023extern int ceph_renew_caps(struct inode *inode);
de57606c 1024extern int ceph_open(struct inode *inode, struct file *file);
5ef50c3b
SW
1025extern int ceph_atomic_open(struct inode *dir, struct dentry *dentry,
1026 struct file *file, unsigned flags, umode_t mode,
1027 int *opened);
de57606c 1028extern int ceph_release(struct inode *inode, struct file *filp);
31c542a1
YZ
1029extern void ceph_fill_inline_data(struct inode *inode, struct page *locked_page,
1030 char *data, size_t len);
55f2a045 1031
de57606c
SW
1032/* dir.c */
1033extern const struct file_operations ceph_dir_fops;
38c48b5f 1034extern const struct file_operations ceph_snapdir_fops;
de57606c 1035extern const struct inode_operations ceph_dir_iops;
38c48b5f 1036extern const struct inode_operations ceph_snapdir_iops;
18fc8abd 1037extern const struct dentry_operations ceph_dentry_ops;
de57606c 1038
f3c4ebe6 1039extern loff_t ceph_make_fpos(unsigned high, unsigned off, bool hash_order);
de57606c 1040extern int ceph_handle_notrace_create(struct inode *dir, struct dentry *dentry);
468640e3
SW
1041extern int ceph_handle_snapdir(struct ceph_mds_request *req,
1042 struct dentry *dentry, int err);
de57606c
SW
1043extern struct dentry *ceph_finish_lookup(struct ceph_mds_request *req,
1044 struct dentry *dentry, int err);
1045
1046extern void ceph_dentry_lru_add(struct dentry *dn);
1047extern void ceph_dentry_lru_touch(struct dentry *dn);
1048extern void ceph_dentry_lru_del(struct dentry *dn);
81a6cf2d 1049extern void ceph_invalidate_dentry_lease(struct dentry *dentry);
e5f86dc3 1050extern unsigned ceph_dentry_hash(struct inode *dir, struct dentry *dn);
fdd4e158 1051extern void ceph_readdir_cache_release(struct ceph_readdir_cache_control *ctl);
de57606c 1052
de57606c
SW
1053/* ioctl.c */
1054extern long ceph_ioctl(struct file *file, unsigned int cmd, unsigned long arg);
1055
1056/* export.c */
1057extern const struct export_operations ceph_export_ops;
1058
40819f6f 1059/* locks.c */
eb13e832 1060extern __init void ceph_flock_init(void);
40819f6f
GF
1061extern int ceph_lock(struct file *file, int cmd, struct file_lock *fl);
1062extern int ceph_flock(struct file *file, int cmd, struct file_lock *fl);
1063extern void ceph_count_locks(struct inode *inode, int *p_num, int *f_num);
39be95e9
JS
1064extern int ceph_encode_locks_to_buffer(struct inode *inode,
1065 struct ceph_filelock *flocks,
1066 int num_fcntl_locks,
1067 int num_flock_locks);
1068extern int ceph_locks_to_pagelist(struct ceph_filelock *flocks,
1069 struct ceph_pagelist *pagelist,
1070 int num_fcntl_locks, int num_flock_locks);
40819f6f 1071
3d14c5d2
YS
1072/* debugfs.c */
1073extern int ceph_fs_debugfs_init(struct ceph_fs_client *client);
1074extern void ceph_fs_debugfs_cleanup(struct ceph_fs_client *client);
1075
fb18a575
LH
1076/* quota.c */
1077extern void ceph_handle_quota(struct ceph_mds_client *mdsc,
1078 struct ceph_mds_session *session,
1079 struct ceph_msg *msg);
b7a29217 1080extern bool ceph_quota_is_max_files_exceeded(struct inode *inode);
cafe21a4 1081extern bool ceph_quota_is_same_realm(struct inode *old, struct inode *new);
2b83845f
LH
1082extern bool ceph_quota_is_max_bytes_exceeded(struct inode *inode,
1083 loff_t newlen);
1ab302a0
LH
1084extern bool ceph_quota_is_max_bytes_approaching(struct inode *inode,
1085 loff_t newlen);
fb18a575 1086
de57606c 1087#endif /* _FS_CEPH_SUPER_H */