Debian Codegraph @

fs/fuse/fuse_i.h

raw
1 /*
2 FUSE: Filesystem in Userspace
3 Copyright (C) 2001-2008 Miklos Szeredi <[email protected]>
4
5 This program can be distributed under the terms of the GNU GPL.
6 See the file COPYING.
7 */
8
9 #ifndef _FS_FUSE_I_H
10 #define _FS_FUSE_I_H
11
12 #ifndef pr_fmt
13 # define pr_fmt(fmt) "fuse: " fmt
14 #endif
15
16 #include <linux/fuse.h>
17 #include <linux/fs.h>
18 #include <linux/mount.h>
19 #include <linux/wait.h>
20 #include <linux/list.h>
21 #include <linux/spinlock.h>
22 #include <linux/mm.h>
23 #include <linux/backing-dev.h>
24 #include <linux/mutex.h>
25 #include <linux/rwsem.h>
26 #include <linux/rbtree.h>
27 #include <linux/poll.h>
28 #include <linux/workqueue.h>
29 #include <linux/kref.h>
30 #include <linux/xattr.h>
31 #include <linux/pid_namespace.h>
32 #include <linux/refcount.h>
33 #include <linux/user_namespace.h>
34
35 /** Default max number of pages that can be used in a single read request */
36 #define FUSE_DEFAULT_MAX_PAGES_PER_REQ 32
37
38 /** Bias for fi->writectr, meaning new writepages must not be sent */
39 #define FUSE_NOWRITE INT_MIN
40
41 /** Maximum length of a filename, not including terminating null */
42
43 /* maximum, small enough for FUSE_MIN_READ_BUFFER*/
44 #define FUSE_NAME_LOW_MAX 1024
45 /* maximum, but needs a request buffer > FUSE_MIN_READ_BUFFER */
46 #define FUSE_NAME_MAX (PATH_MAX - 1)
47
48 /** Number of dentries for each connection in the control filesystem */
49 #define FUSE_CTL_NUM_DENTRIES 5
50
51 /* Frequency (in seconds) of request timeout checks, if opted into */
52 #define FUSE_TIMEOUT_TIMER_FREQ 15
53
54 /** Frequency (in jiffies) of request timeout checks, if opted into */
55 extern const unsigned long fuse_timeout_timer_freq;
56
57 /*
58 * Dentries invalidation workqueue period, in seconds. The value of this
59 * parameter shall be >= FUSE_DENTRY_INVAL_FREQ_MIN seconds, or 0 (zero), in
60 * which case no workqueue will be created.
61 */
62 extern unsigned inval_wq __read_mostly;
63
64 /** Maximum of max_pages received in init_out */
65 extern unsigned int fuse_max_pages_limit;
66 /*
67 * Default timeout (in seconds) for the server to reply to a request
68 * before the connection is aborted, if no timeout was specified on mount.
69 */
70 extern unsigned int fuse_default_req_timeout;
71 /*
72 * Max timeout (in seconds) for the server to reply to a request before
73 * the connection is aborted.
74 */
75 extern unsigned int fuse_max_req_timeout;
76
77 /** List of active connections */
78 extern struct list_head fuse_conn_list;
79
80 /** Global mutex protecting fuse_conn_list and the control filesystem */
81 extern struct mutex fuse_mutex;
82
83 /** Module parameters */
84 extern unsigned int max_user_bgreq;
85 extern unsigned int max_user_congthresh;
86
87 /* One forget request */
88 struct fuse_forget_link {
89 struct fuse_forget_one forget_one;
90 struct fuse_forget_link *next;
91 };
92
93 /* Submount lookup tracking */
94 struct fuse_submount_lookup {
95 /** Refcount */
96 refcount_t count;
97
98 /** Unique ID, which identifies the inode between userspace
99 * and kernel */
100 u64 nodeid;
101
102 /** The request used for sending the FORGET message */
103 struct fuse_forget_link *forget;
104 };
105
106 /** Container for data related to mapping to backing file */
107 struct fuse_backing {
108 struct file *file;
109 struct cred *cred;
110
111 /** refcount */
112 refcount_t count;
113 struct rcu_head rcu;
114 };
115
116 /** FUSE inode */
117 struct fuse_inode {
118 /** Inode data */
119 struct inode inode;
120
121 /** Unique ID, which identifies the inode between userspace
122 * and kernel */
123 u64 nodeid;
124
125 /** Number of lookups on this inode */
126 u64 nlookup;
127
128 /** The request used for sending the FORGET message */
129 struct fuse_forget_link *forget;
130
131 /** Time in jiffies until the file attributes are valid */
132 u64 i_time;
133
134 /* Which attributes are invalid */
135 u32 inval_mask;
136
137 /** The sticky bit in inode->i_mode may have been removed, so
138 preserve the original mode */
139 umode_t orig_i_mode;
140
141 /* Cache birthtime */
142 struct timespec64 i_btime;
143
144 /** 64 bit inode number */
145 u64 orig_ino;
146
147 /** Version of last attribute change */
148 u64 attr_version;
149
150 union {
151 /* read/write io cache (regular file only) */
152 struct {
153 /* Files usable in writepage. Protected by fi->lock */
154 struct list_head write_files;
155
156 /* Writepages pending on truncate or fsync */
157 struct list_head queued_writes;
158
159 /* Number of sent writes, a negative bias
160 * (FUSE_NOWRITE) means more writes are blocked */
161 int writectr;
162
163 /** Number of files/maps using page cache */
164 int iocachectr;
165
166 /* Waitq for writepage completion */
167 wait_queue_head_t page_waitq;
168
169 /* waitq for direct-io completion */
170 wait_queue_head_t direct_io_waitq;
171 };
172
173 /* readdir cache (directory only) */
174 struct {
175 /* true if fully cached */
176 bool cached;
177
178 /* size of cache */
179 loff_t size;
180
181 /* position at end of cache (position of next entry) */
182 loff_t pos;
183
184 /* version of the cache */
185 u64 version;
186
187 /* modification time of directory when cache was
188 * started */
189 struct timespec64 mtime;
190
191 /* iversion of directory when cache was started */
192 u64 iversion;
193
194 /* protects above fields */
195 spinlock_t lock;
196 } rdc;
197 };
198
199 /** Miscellaneous bits describing inode state */
200 unsigned long state;
201
202 /** Lock for serializing lookup and readdir for back compatibility*/
203 struct mutex mutex;
204
205 /** Lock to protect write related fields */
206 spinlock_t lock;
207
208 #ifdef CONFIG_FUSE_DAX
209 /*
210 * Dax specific inode data
211 */
212 struct fuse_inode_dax *dax;
213 #endif
214 /** Submount specific lookup tracking */
215 struct fuse_submount_lookup *submount_lookup;
216 #ifdef CONFIG_FUSE_PASSTHROUGH
217 /** Reference to backing file in passthrough mode */
218 struct fuse_backing *fb;
219 #endif
220
221 /*
222 * The underlying inode->i_blkbits value will not be modified,
223 * so preserve the blocksize specified by the server.
224 */
225 u8 cached_i_blkbits;
226 };
227
228 /** FUSE inode state bits */
229 enum {
230 /** Advise readdirplus */
231 FUSE_I_ADVISE_RDPLUS,
232 /** Initialized with readdirplus */
233 FUSE_I_INIT_RDPLUS,
234 /** An operation changing file size is in progress */
235 FUSE_I_SIZE_UNSTABLE,
236 /* Bad inode */
237 FUSE_I_BAD,
238 /* Has btime */
239 FUSE_I_BTIME,
240 /* Wants or already has page cache IO */
241 FUSE_I_CACHE_IO_MODE,
242 /*
243 * Client has exclusive access to the inode, either because fs is local
244 * or the fuse server has an exclusive "lease" on distributed fs
245 */
246 FUSE_I_EXCLUSIVE,
247 };
248
249 struct fuse_conn;
250 struct fuse_mount;
251 union fuse_file_args;
252
253 /** FUSE specific file data */
254 struct fuse_file {
255 /** Fuse connection for this file */
256 struct fuse_mount *fm;
257
258 /* Argument space reserved for open/release */
259 union fuse_file_args *args;
260
261 /** Kernel file handle guaranteed to be unique */
262 u64 kh;
263
264 /** File handle used by userspace */
265 u64 fh;
266
267 /** Node id of this file */
268 u64 nodeid;
269
270 /** Refcount */
271 refcount_t count;
272
273 /** FOPEN_* flags returned by open */
274 u32 open_flags;
275
276 /** Entry on inode's write_files list */
277 struct list_head write_entry;
278
279 /* Readdir related */
280 struct {
281 /* Dir stream position */
282 loff_t pos;
283
284 /* Offset in cache */
285 loff_t cache_off;
286
287 /* Version of cache we are reading */
288 u64 version;
289
290 } readdir;
291
292 /** RB node to be linked on fuse_conn->polled_files */
293 struct rb_node polled_node;
294
295 /** Wait queue head for poll */
296 wait_queue_head_t poll_wait;
297
298 /** Does file hold a fi->iocachectr refcount? */
299 enum { IOM_NONE, IOM_CACHED, IOM_UNCACHED } iomode;
300
301 #ifdef CONFIG_FUSE_PASSTHROUGH
302 /** Reference to backing file in passthrough mode */
303 struct file *passthrough;
304 const struct cred *cred;
305 #endif
306
307 /** Has flock been performed on this file? */
308 bool flock:1;
309 };
310
311 /** One input argument of a request */
312 struct fuse_in_arg {
313 unsigned size;
314 const void *value;
315 };
316
317 /** One output argument of a request */
318 struct fuse_arg {
319 unsigned size;
320 void *value;
321 };
322
323 /** FUSE folio descriptor */
324 struct fuse_folio_desc {
325 unsigned int length;
326 unsigned int offset;
327 };
328
329 struct fuse_args {
330 uint64_t nodeid;
331 uint32_t opcode;
332 uint8_t in_numargs;
333 uint8_t out_numargs;
334 uint8_t ext_idx;
335 bool force:1;
336 bool noreply:1;
337 bool nocreds:1;
338 bool in_pages:1;
339 bool out_pages:1;
340 bool user_pages:1;
341 bool out_argvar:1;
342 bool page_zeroing:1;
343 bool page_replace:1;
344 bool may_block:1;
345 bool is_ext:1;
346 bool is_pinned:1;
347 bool invalidate_vmap:1;
348 bool abort_on_kill:1;
349 struct fuse_in_arg in_args[4];
350 struct fuse_arg out_args[2];
351 void (*end)(struct fuse_mount *fm, struct fuse_args *args, int error);
352 /* Used for kvec iter backed by vmalloc address */
353 void *vmap_base;
354 };
355
356 struct fuse_args_pages {
357 struct fuse_args args;
358 struct folio **folios;
359 struct fuse_folio_desc *descs;
360 unsigned int num_folios;
361 };
362
363 struct fuse_release_args {
364 struct fuse_args args;
365 struct fuse_release_in inarg;
366 struct inode *inode;
367 };
368
369 union fuse_file_args {
370 /* Used during open() */
371 struct fuse_open_out open_outarg;
372 /* Used during release() */
373 struct fuse_release_args release_args;
374 };
375
376 #define FUSE_ARGS(args) struct fuse_args args = {}
377
378 /** The request IO state (for asynchronous processing) */
379 struct fuse_io_priv {
380 struct kref refcnt;
381 int async;
382 spinlock_t lock;
383 unsigned reqs;
384 ssize_t bytes;
385 size_t size;
386 __u64 offset;
387 bool write;
388 bool should_dirty;
389 int err;
390 struct kiocb *iocb;
391 struct completion *done;
392 bool blocking;
393 };
394
395 #define FUSE_IO_PRIV_SYNC(i) \
396 { \
397 .refcnt = KREF_INIT(1), \
398 .async = 0, \
399 .iocb = i, \
400 }
401
402 /**
403 * Request flags
404 *
405 * FR_ISREPLY: set if the request has reply
406 * FR_FORCE: force sending of the request even if interrupted
407 * FR_BACKGROUND: request is sent in the background
408 * FR_WAITING: request is counted as "waiting"
409 * FR_ABORTED: the request was aborted
410 * FR_INTERRUPTED: the request has been interrupted
411 * FR_LOCKED: data is being copied to/from the request
412 * FR_PENDING: request is not yet in userspace
413 * FR_SENT: request is in userspace, waiting for an answer
414 * FR_FINISHED: request is finished
415 * FR_PRIVATE: request is on private list
416 * FR_ASYNC: request is asynchronous
417 * FR_URING: request is handled through fuse-io-uring
418 */
419 enum fuse_req_flag {
420 FR_ISREPLY,
421 FR_FORCE,
422 FR_BACKGROUND,
423 FR_WAITING,
424 FR_ABORTED,
425 FR_INTERRUPTED,
426 FR_LOCKED,
427 FR_PENDING,
428 FR_SENT,
429 FR_FINISHED,
430 FR_PRIVATE,
431 FR_ASYNC,
432 FR_URING,
433 };
434
435 /**
436 * A request to the client
437 *
438 * .waitq.lock protects the following fields:
439 * - FR_ABORTED
440 * - FR_LOCKED (may also be modified under fc->lock, tested under both)
441 */
442 struct fuse_req {
443 /** This can be on either pending processing or io lists in
444 fuse_conn */
445 struct list_head list;
446
447 /** Entry on the interrupts list */
448 struct list_head intr_entry;
449
450 /* Input/output arguments */
451 struct fuse_args *args;
452
453 /** refcount */
454 refcount_t count;
455
456 /* Request flags, updated with test/set/clear_bit() */
457 unsigned long flags;
458
459 /* The request input header */
460 struct {
461 struct fuse_in_header h;
462 } in;
463
464 /* The request output header */
465 struct {
466 struct fuse_out_header h;
467 } out;
468
469 /** Used to wake up the task waiting for completion of request*/
470 wait_queue_head_t waitq;
471
472 #if IS_ENABLED(CONFIG_VIRTIO_FS)
473 /** virtio-fs's physically contiguous buffer for in and out args */
474 void *argbuf;
475 #endif
476
477 /** fuse_mount this request belongs to */
478 struct fuse_mount *fm;
479
480 #ifdef CONFIG_FUSE_IO_URING
481 void *ring_entry;
482 void *ring_queue;
483 #endif
484 /** When (in jiffies) the request was created */
485 unsigned long create_time;
486 };
487
488 struct fuse_iqueue;
489
490 /**
491 * Input queue callbacks
492 *
493 * Input queue signalling is device-specific. For example, the /dev/fuse file
494 * uses fiq->waitq and fasync to wake processes that are waiting on queue
495 * readiness. These callbacks allow other device types to respond to input
496 * queue activity.
497 */
498 struct fuse_iqueue_ops {
499 /**
500 * Send one forget
501 */
502 void (*send_forget)(struct fuse_iqueue *fiq, struct fuse_forget_link *link);
503
504 /**
505 * Send interrupt for request
506 */
507 void (*send_interrupt)(struct fuse_iqueue *fiq, struct fuse_req *req);
508
509 /**
510 * Send one request
511 */
512 void (*send_req)(struct fuse_iqueue *fiq, struct fuse_req *req);
513
514 /**
515 * Clean up when fuse_iqueue is destroyed
516 */
517 void (*release)(struct fuse_iqueue *fiq);
518 };
519
520 /** /dev/fuse input queue operations */
521 extern const struct fuse_iqueue_ops fuse_dev_fiq_ops;
522
523 struct fuse_iqueue {
524 /** Connection established */
525 unsigned connected;
526
527 /** Lock protecting accesses to members of this structure */
528 spinlock_t lock;
529
530 /** Readers of the connection are waiting on this */
531 wait_queue_head_t waitq;
532
533 /** The next unique request id */
534 u64 reqctr;
535
536 /** The list of pending requests */
537 struct list_head pending;
538
539 /** Pending interrupts */
540 struct list_head interrupts;
541
542 /** Queue of pending forgets */
543 struct fuse_forget_link forget_list_head;
544 struct fuse_forget_link *forget_list_tail;
545
546 /** Batching of FORGET requests (positive indicates FORGET batch) */
547 int forget_batch;
548
549 /** O_ASYNC requests */
550 struct fasync_struct *fasync;
551
552 /** Device-specific callbacks */
553 const struct fuse_iqueue_ops *ops;
554
555 /** Device-specific state */
556 void *priv;
557 };
558
559 #define FUSE_PQ_HASH_BITS 8
560 #define FUSE_PQ_HASH_SIZE (1 << FUSE_PQ_HASH_BITS)
561
562 struct fuse_pqueue {
563 /** Connection established */
564 unsigned connected;
565
566 /** Lock protecting accessess to members of this structure */
567 spinlock_t lock;
568
569 /** Hash table of requests being processed */
570 struct list_head *processing;
571
572 /** The list of requests under I/O */
573 struct list_head io;
574 };
575
576 /**
577 * Fuse device instance
578 */
579 struct fuse_dev {
580 /** Fuse connection for this device */
581 struct fuse_conn *fc;
582
583 /** Processing queue */
584 struct fuse_pqueue pq;
585
586 /** list entry on fc->devices */
587 struct list_head entry;
588 };
589
590 enum fuse_dax_mode {
591 FUSE_DAX_INODE_DEFAULT, /* default */
592 FUSE_DAX_ALWAYS, /* "-o dax=always" */
593 FUSE_DAX_NEVER, /* "-o dax=never" */
594 FUSE_DAX_INODE_USER, /* "-o dax=inode" */
595 };
596
597 static inline bool fuse_is_inode_dax_mode(enum fuse_dax_mode mode)
598 {
599 return mode == FUSE_DAX_INODE_DEFAULT || mode == FUSE_DAX_INODE_USER;
600 }
601
602 struct fuse_fs_context {
603 int fd;
604 struct file *file;
605 unsigned int rootmode;
606 kuid_t user_id;
607 kgid_t group_id;
608 bool is_bdev:1;
609 bool fd_present:1;
610 bool rootmode_present:1;
611 bool user_id_present:1;
612 bool group_id_present:1;
613 bool default_permissions:1;
614 bool allow_other:1;
615 bool destroy:1;
616 bool no_control:1;
617 bool no_force_umount:1;
618 bool legacy_opts_show:1;
619 enum fuse_dax_mode dax_mode;
620 unsigned int max_read;
621 unsigned int blksize;
622 const char *subtype;
623
624 /* DAX device, may be NULL */
625 struct dax_device *dax_dev;
626
627 /* fuse_dev pointer to fill in, should contain NULL on entry */
628 void **fudptr;
629 };
630
631 struct fuse_sync_bucket {
632 /* count is a possible scalability bottleneck */
633 atomic_t count;
634 wait_queue_head_t waitq;
635 struct rcu_head rcu;
636 };
637
638 /**
639 * A Fuse connection.
640 *
641 * This structure is created, when the root filesystem is mounted, and
642 * is destroyed, when the client device is closed and the last
643 * fuse_mount is destroyed.
644 */
645 struct fuse_conn {
646 /** Lock protecting accessess to members of this structure */
647 spinlock_t lock;
648
649 /** Refcount */
650 refcount_t count;
651
652 /** Number of fuse_dev's */
653 atomic_t dev_count;
654
655 /** Current epoch for up-to-date dentries */
656 atomic_t epoch;
657
658 struct work_struct epoch_work;
659
660 struct rcu_head rcu;
661
662 /** The user id for this mount */
663 kuid_t user_id;
664
665 /** The group id for this mount */
666 kgid_t group_id;
667
668 /** The pid namespace for this mount */
669 struct pid_namespace *pid_ns;
670
671 /** The user namespace for this mount */
672 struct user_namespace *user_ns;
673
674 /** Maximum read size */
675 unsigned max_read;
676
677 /** Maximum write size */
678 unsigned max_write;
679
680 /** Maximum number of pages that can be used in a single request */
681 unsigned int max_pages;
682
683 /** Constrain ->max_pages to this value during feature negotiation */
684 unsigned int max_pages_limit;
685
686 /** Input queue */
687 struct fuse_iqueue iq;
688
689 /** The next unique kernel file handle */
690 atomic64_t khctr;
691
692 /** rbtree of fuse_files waiting for poll events indexed by ph */
693 struct rb_root polled_files;
694
695 /** Maximum number of outstanding background requests */
696 unsigned max_background;
697
698 /** Number of background requests at which congestion starts */
699 unsigned congestion_threshold;
700
701 /** Number of requests currently in the background */
702 unsigned num_background;
703
704 /** Number of background requests currently queued for userspace */
705 unsigned active_background;
706
707 /** The list of background requests set aside for later queuing */
708 struct list_head bg_queue;
709
710 /** Protects: max_background, congestion_threshold, num_background,
711 * active_background, bg_queue, blocked */
712 spinlock_t bg_lock;
713
714 /** Flag indicating that INIT reply has been received. Allocating
715 * any fuse request will be suspended until the flag is set */
716 int initialized;
717
718 /** Flag indicating if connection is blocked. This will be
719 the case before the INIT reply is received, and if there
720 are too many outstading backgrounds requests */
721 int blocked;
722
723 /** waitq for blocked connection */
724 wait_queue_head_t blocked_waitq;
725
726 /** Connection established, cleared on umount, connection
727 abort and device release */
728 unsigned connected;
729
730 /** Connection aborted via sysfs */
731 bool aborted;
732
733 /** Connection failed (version mismatch). Cannot race with
734 setting other bitfields since it is only set once in INIT
735 reply, before any other request, and never cleared */
736 unsigned conn_error:1;
737
738 /** Connection successful. Only set in INIT */
739 unsigned conn_init:1;
740
741 /** Do readahead asynchronously? Only set in INIT */
742 unsigned async_read:1;
743
744 /** Return an unique read error after abort. Only set in INIT */
745 unsigned abort_err:1;
746
747 /** Do not send separate SETATTR request before open(O_TRUNC) */
748 unsigned atomic_o_trunc:1;
749
750 /** Filesystem supports NFS exporting. Only set in INIT */
751 unsigned export_support:1;
752
753 /** write-back cache policy (default is write-through) */
754 unsigned writeback_cache:1;
755
756 /** allow parallel lookups and readdir (default is serialized) */
757 unsigned parallel_dirops:1;
758
759 /** handle fs handles killing suid/sgid/cap on write/chown/trunc */
760 unsigned handle_killpriv:1;
761
762 /** cache READLINK responses in page cache */
763 unsigned cache_symlinks:1;
764
765 /* show legacy mount options */
766 unsigned int legacy_opts_show:1;
767
768 /*
769 * fs kills suid/sgid/cap on write/chown/trunc. suid is killed on
770 * write/trunc only if caller did not have CAP_FSETID. sgid is killed
771 * on write/truncate only if caller did not have CAP_FSETID as well as
772 * file has group execute permission.
773 */
774 unsigned handle_killpriv_v2:1;
775
776 /*
777 * The following bitfields are only for optimization purposes
778 * and hence races in setting them will not cause malfunction
779 */
780
781 /** Is open/release not implemented by fs? */
782 unsigned no_open:1;
783
784 /** Is opendir/releasedir not implemented by fs? */
785 unsigned no_opendir:1;
786
787 /** Is fsync not implemented by fs? */
788 unsigned no_fsync:1;
789
790 /** Is fsyncdir not implemented by fs? */
791 unsigned no_fsyncdir:1;
792
793 /** Is flush not implemented by fs? */
794 unsigned no_flush:1;
795
796 /** Is setxattr not implemented by fs? */
797 unsigned no_setxattr:1;
798
799 /** Does file server support extended setxattr */
800 unsigned setxattr_ext:1;
801
802 /** Is getxattr not implemented by fs? */
803 unsigned no_getxattr:1;
804
805 /** Is listxattr not implemented by fs? */
806 unsigned no_listxattr:1;
807
808 /** Is removexattr not implemented by fs? */
809 unsigned no_removexattr:1;
810
811 /** Are posix file locking primitives not implemented by fs? */
812 unsigned no_lock:1;
813
814 /** Is access not implemented by fs? */
815 unsigned no_access:1;
816
817 /** Is create not implemented by fs? */
818 unsigned no_create:1;
819
820 /** Is interrupt not implemented by fs? */
821 unsigned no_interrupt:1;
822
823 /** Is bmap not implemented by fs? */
824 unsigned no_bmap:1;
825
826 /** Is poll not implemented by fs? */
827 unsigned no_poll:1;
828
829 /** Do multi-page cached writes */
830 unsigned big_writes:1;
831
832 /** Don't apply umask to creation modes */
833 unsigned dont_mask:1;
834
835 /** Are BSD file locking primitives not implemented by fs? */
836 unsigned no_flock:1;
837
838 /** Is fallocate not implemented by fs? */
839 unsigned no_fallocate:1;
840
841 /** Is rename with flags implemented by fs? */
842 unsigned no_rename2:1;
843
844 /** Use enhanced/automatic page cache invalidation. */
845 unsigned auto_inval_data:1;
846
847 /** Filesystem is fully responsible for page cache invalidation. */
848 unsigned explicit_inval_data:1;
849
850 /** Does the filesystem support readdirplus? */
851 unsigned do_readdirplus:1;
852
853 /** Does the filesystem want adaptive readdirplus? */
854 unsigned readdirplus_auto:1;
855
856 /** Does the filesystem support asynchronous direct-IO submission? */
857 unsigned async_dio:1;
858
859 /** Is lseek not implemented by fs? */
860 unsigned no_lseek:1;
861
862 /** Does the filesystem support posix acls? */
863 unsigned posix_acl:1;
864
865 /** Check permissions based on the file mode or not? */
866 unsigned default_permissions:1;
867
868 /** Allow other than the mounter user to access the filesystem ? */
869 unsigned allow_other:1;
870
871 /** Does the filesystem support copy_file_range? */
872 unsigned no_copy_file_range:1;
873
874 /** Does the filesystem support copy_file_range_64? */
875 unsigned no_copy_file_range_64:1;
876
877 /* Send DESTROY request */
878 unsigned int destroy:1;
879
880 /* Delete dentries that have gone stale */
881 unsigned int delete_stale:1;
882
883 /** Do not create entry in fusectl fs */
884 unsigned int no_control:1;
885
886 /** Do not allow MNT_FORCE umount */
887 unsigned int no_force_umount:1;
888
889 /* Auto-mount submounts announced by the server */
890 unsigned int auto_submounts:1;
891
892 /* Propagate syncfs() to server */
893 unsigned int sync_fs:1;
894
895 /* Initialize security xattrs when creating a new inode */
896 unsigned int init_security:1;
897
898 /* Add supplementary group info when creating a new inode */
899 unsigned int create_supp_group:1;
900
901 /* Does the filesystem support per inode DAX? */
902 unsigned int inode_dax:1;
903
904 /* Is tmpfile not implemented by fs? */
905 unsigned int no_tmpfile:1;
906
907 /* Relax restrictions to allow shared mmap in FOPEN_DIRECT_IO mode */
908 unsigned int direct_io_allow_mmap:1;
909
910 /* Is statx not implemented by fs? */
911 unsigned int no_statx:1;
912
913 /** Passthrough support for read/write IO */
914 unsigned int passthrough:1;
915
916 /* Use pages instead of pointer for kernel I/O */
917 unsigned int use_pages_for_kvec_io:1;
918
919 /* Is link not implemented by fs? */
920 unsigned int no_link:1;
921
922 /* Is synchronous FUSE_INIT allowed? */
923 unsigned int sync_init:1;
924
925 /* Use io_uring for communication */
926 unsigned int io_uring;
927
928 /** Maximum stack depth for passthrough backing files */
929 int max_stack_depth;
930
931 /** The number of requests waiting for completion */
932 atomic_t num_waiting;
933
934 /** Negotiated minor version */
935 unsigned minor;
936
937 /** Entry on the fuse_conn_list */
938 struct list_head entry;
939
940 /** Device ID from the root super block */
941 dev_t dev;
942
943 /** Key for lock owner ID scrambling */
944 u32 scramble_key[4];
945
946 /** Version counter for attribute changes */
947 atomic64_t attr_version;
948
949 /** Version counter for evict inode */
950 atomic64_t evict_ctr;
951
952 /* maximum file name length */
953 u32 name_max;
954
955 /** Called on final put */
956 void (*release)(struct fuse_conn *);
957
958 /**
959 * Read/write semaphore to hold when accessing the sb of any
960 * fuse_mount belonging to this connection
961 */
962 struct rw_semaphore killsb;
963
964 /** List of device instances belonging to this connection */
965 struct list_head devices;
966
967 #ifdef CONFIG_FUSE_DAX
968 /* Dax mode */
969 enum fuse_dax_mode dax_mode;
970
971 /* Dax specific conn data, non-NULL if DAX is enabled */
972 struct fuse_conn_dax *dax;
973 #endif
974
975 /** List of filesystems using this connection */
976 struct list_head mounts;
977
978 /* New writepages go into this bucket */
979 struct fuse_sync_bucket __rcu *curr_bucket;
980
981 #ifdef CONFIG_FUSE_PASSTHROUGH
982 /** IDR for backing files ids */
983 struct idr backing_files_map;
984 #endif
985
986 #ifdef CONFIG_FUSE_IO_URING
987 /** uring connection information*/
988 struct fuse_ring *ring;
989 #endif
990
991 /** Only used if the connection opts into request timeouts */
992 struct {
993 /* Worker for checking if any requests have timed out */
994 struct delayed_work work;
995
996 /* Request timeout (in jiffies). 0 = no timeout */
997 unsigned int req_timeout;
998 } timeout;
999 };
1000
1001 /*
1002 * Represents a mounted filesystem, potentially a submount.
1003 *
1004 * This object allows sharing a fuse_conn between separate mounts to
1005 * allow submounts with dedicated superblocks and thus separate device
1006 * IDs.
1007 */
1008 struct fuse_mount {
1009 /* Underlying (potentially shared) connection to the FUSE server */
1010 struct fuse_conn *fc;
1011
1012 /*
1013 * Super block for this connection (fc->killsb must be held when
1014 * accessing this).
1015 */
1016 struct super_block *sb;
1017
1018 /* Entry on fc->mounts */
1019 struct list_head fc_entry;
1020 struct rcu_head rcu;
1021 };
1022
1023 /*
1024 * Empty header for FUSE opcodes without specific header needs.
1025 * Used as a placeholder in args->in_args[0] for consistency
1026 * across all FUSE operations, simplifying request handling.
1027 */
1028 struct fuse_zero_header {};
1029
1030 static inline void fuse_set_zero_arg0(struct fuse_args *args)
1031 {
1032 args->in_args[0].size = sizeof(struct fuse_zero_header);
1033 args->in_args[0].value = NULL;
1034 }
1035
1036 static inline struct fuse_mount *get_fuse_mount_super(struct super_block *sb)
1037 {
1038 return sb->s_fs_info;
1039 }
1040
1041 static inline struct fuse_conn *get_fuse_conn_super(struct super_block *sb)
1042 {
1043 return get_fuse_mount_super(sb)->fc;
1044 }
1045
1046 static inline struct fuse_mount *get_fuse_mount(struct inode *inode)
1047 {
1048 return get_fuse_mount_super(inode->i_sb);
1049 }
1050
1051 static inline struct fuse_conn *get_fuse_conn(struct inode *inode)
1052 {
1053 return get_fuse_mount_super(inode->i_sb)->fc;
1054 }
1055
1056 static inline struct fuse_inode *get_fuse_inode(const struct inode *inode)
1057 {
1058 return container_of(inode, struct fuse_inode, inode);
1059 }
1060
1061 static inline u64 get_node_id(struct inode *inode)
1062 {
1063 return get_fuse_inode(inode)->nodeid;
1064 }
1065
1066 static inline int invalid_nodeid(u64 nodeid)
1067 {
1068 return !nodeid || nodeid == FUSE_ROOT_ID;
1069 }
1070
1071 static inline u64 fuse_get_attr_version(struct fuse_conn *fc)
1072 {
1073 return atomic64_read(&fc->attr_version);
1074 }
1075
1076 static inline u64 fuse_get_evict_ctr(struct fuse_conn *fc)
1077 {
1078 return atomic64_read(&fc->evict_ctr);
1079 }
1080
1081 static inline bool fuse_stale_inode(const struct inode *inode, int generation,
1082 struct fuse_attr *attr)
1083 {
1084 return inode->i_generation != generation ||
1085 inode_wrong_type(inode, attr->mode);
1086 }
1087
1088 static inline void fuse_make_bad(struct inode *inode)
1089 {
1090 set_bit(FUSE_I_BAD, &get_fuse_inode(inode)->state);
1091 }
1092
1093 static inline bool fuse_is_bad(struct inode *inode)
1094 {
1095 return unlikely(test_bit(FUSE_I_BAD, &get_fuse_inode(inode)->state));
1096 }
1097
1098 static inline bool fuse_inode_is_exclusive(const struct inode *inode)
1099 {
1100 const struct fuse_inode *fi = get_fuse_inode(inode);
1101
1102 return test_bit(FUSE_I_EXCLUSIVE, &fi->state);
1103 }
1104
1105 static inline struct folio **fuse_folios_alloc(unsigned int nfolios, gfp_t flags,
1106 struct fuse_folio_desc **desc)
1107 {
1108 struct folio **folios;
1109
1110 folios = kzalloc(nfolios * (sizeof(struct folio *) +
1111 sizeof(struct fuse_folio_desc)), flags);
1112 *desc = (void *) (folios + nfolios);
1113
1114 return folios;
1115 }
1116
1117 static inline void fuse_folio_descs_length_init(struct fuse_folio_desc *descs,
1118 unsigned int index,
1119 unsigned int nr_folios)
1120 {
1121 int i;
1122
1123 for (i = index; i < index + nr_folios; i++)
1124 descs[i].length = PAGE_SIZE - descs[i].offset;
1125 }
1126
1127 static inline void fuse_sync_bucket_dec(struct fuse_sync_bucket *bucket)
1128 {
1129 /* Need RCU protection to prevent use after free after the decrement */
1130 rcu_read_lock();
1131 if (atomic_dec_and_test(&bucket->count))
1132 wake_up(&bucket->waitq);
1133 rcu_read_unlock();
1134 }
1135
1136 /** Device operations */
1137 extern const struct file_operations fuse_dev_operations;
1138
1139 extern const struct dentry_operations fuse_dentry_operations;
1140
1141 /**
1142 * Get a filled in inode
1143 */
1144 struct inode *fuse_iget(struct super_block *sb, u64 nodeid,
1145 int generation, struct fuse_attr *attr,
1146 u64 attr_valid, u64 attr_version,
1147 u64 evict_ctr);
1148
1149 int fuse_lookup_name(struct super_block *sb, u64 nodeid, const struct qstr *name,
1150 struct fuse_entry_out *outarg, struct inode **inode);
1151
1152 /**
1153 * Send FORGET command
1154 */
1155 void fuse_queue_forget(struct fuse_conn *fc, struct fuse_forget_link *forget,
1156 u64 nodeid, u64 nlookup);
1157
1158 struct fuse_forget_link *fuse_alloc_forget(void);
1159
1160 /*
1161 * Initialize READ or READDIR request
1162 */
1163 struct fuse_io_args {
1164 union {
1165 struct {
1166 struct fuse_read_in in;
1167 u64 attr_ver;
1168 } read;
1169 struct {
1170 struct fuse_write_in in;
1171 struct fuse_write_out out;
1172 bool folio_locked;
1173 } write;
1174 };
1175 struct fuse_args_pages ap;
1176 struct fuse_io_priv *io;
1177 struct fuse_file *ff;
1178 };
1179
1180 void fuse_read_args_fill(struct fuse_io_args *ia, struct file *file, loff_t pos,
1181 size_t count, int opcode);
1182
1183
1184 struct fuse_file *fuse_file_alloc(struct fuse_mount *fm, bool release);
1185 void fuse_file_free(struct fuse_file *ff);
1186 int fuse_finish_open(struct inode *inode, struct file *file);
1187
1188 void fuse_sync_release(struct fuse_inode *fi, struct fuse_file *ff,
1189 unsigned int flags);
1190
1191 /**
1192 * Send RELEASE or RELEASEDIR request
1193 */
1194 void fuse_release_common(struct file *file, bool isdir);
1195
1196 /**
1197 * Send FSYNC or FSYNCDIR request
1198 */
1199 int fuse_fsync_common(struct file *file, loff_t start, loff_t end,
1200 int datasync, int opcode);
1201
1202 /**
1203 * Notify poll wakeup
1204 */
1205 int fuse_notify_poll_wakeup(struct fuse_conn *fc,
1206 struct fuse_notify_poll_wakeup_out *outarg);
1207
1208 /**
1209 * Initialize file operations on a regular file
1210 */
1211 void fuse_init_file_inode(struct inode *inode, unsigned int flags);
1212
1213 /**
1214 * Initialize inode operations on regular files and special files
1215 */
1216 void fuse_init_common(struct inode *inode);
1217
1218 /**
1219 * Initialize inode and file operations on a directory
1220 */
1221 void fuse_init_dir(struct inode *inode);
1222
1223 /**
1224 * Initialize inode operations on a symlink
1225 */
1226 void fuse_init_symlink(struct inode *inode);
1227
1228 /**
1229 * Change attributes of an inode
1230 */
1231 void fuse_change_attributes(struct inode *inode, struct fuse_attr *attr,
1232 struct fuse_statx *sx,
1233 u64 attr_valid, u64 attr_version);
1234
1235 void fuse_change_attributes_common(struct inode *inode, struct fuse_attr *attr,
1236 struct fuse_statx *sx,
1237 u64 attr_valid, u32 cache_mask,
1238 u64 evict_ctr);
1239
1240 u32 fuse_get_cache_mask(struct inode *inode);
1241
1242 /**
1243 * Initialize the client device
1244 */
1245 int fuse_dev_init(void);
1246
1247 /**
1248 * Cleanup the client device
1249 */
1250 void fuse_dev_cleanup(void);
1251
1252 int fuse_ctl_init(void);
1253 void __exit fuse_ctl_cleanup(void);
1254
1255 /**
1256 * Simple request sending that does request allocation and freeing
1257 */
1258 ssize_t __fuse_simple_request(struct mnt_idmap *idmap,
1259 struct fuse_mount *fm,
1260 struct fuse_args *args);
1261
1262 static inline ssize_t fuse_simple_request(struct fuse_mount *fm, struct fuse_args *args)
1263 {
1264 return __fuse_simple_request(&invalid_mnt_idmap, fm, args);
1265 }
1266
1267 static inline ssize_t fuse_simple_idmap_request(struct mnt_idmap *idmap,
1268 struct fuse_mount *fm,
1269 struct fuse_args *args)
1270 {
1271 return __fuse_simple_request(idmap, fm, args);
1272 }
1273
1274 int fuse_simple_background(struct fuse_mount *fm, struct fuse_args *args,
1275 gfp_t gfp_flags);
1276
1277 /**
1278 * Assign a unique id to a fuse request
1279 */
1280 void fuse_request_assign_unique(struct fuse_iqueue *fiq, struct fuse_req *req);
1281
1282 /**
1283 * End a finished request
1284 */
1285 void fuse_request_end(struct fuse_req *req);
1286
1287 /* Abort all requests */
1288 void fuse_abort_conn(struct fuse_conn *fc);
1289 void fuse_wait_aborted(struct fuse_conn *fc);
1290
1291 /* Check if any requests timed out */
1292 void fuse_check_timeout(struct work_struct *work);
1293
1294 void fuse_dentry_tree_init(void);
1295 void fuse_dentry_tree_cleanup(void);
1296
1297 void fuse_epoch_work(struct work_struct *work);
1298
1299 /**
1300 * Invalidate inode attributes
1301 */
1302
1303 /* Attributes possibly changed on data modification */
1304 #define FUSE_STATX_MODIFY (STATX_MTIME | STATX_CTIME | STATX_BLOCKS)
1305
1306 /* Attributes possibly changed on data and/or size modification */
1307 #define FUSE_STATX_MODSIZE (FUSE_STATX_MODIFY | STATX_SIZE)
1308
1309 void fuse_invalidate_attr(struct inode *inode);
1310 void fuse_invalidate_attr_mask(struct inode *inode, u32 mask);
1311
1312 void fuse_invalidate_entry_cache(struct dentry *entry);
1313
1314 void fuse_invalidate_atime(struct inode *inode);
1315
1316 u64 fuse_time_to_jiffies(u64 sec, u32 nsec);
1317 #define ATTR_TIMEOUT(o) \
1318 fuse_time_to_jiffies((o)->attr_valid, (o)->attr_valid_nsec)
1319
1320 void fuse_change_entry_timeout(struct dentry *entry, struct fuse_entry_out *o);
1321
1322 /**
1323 * Acquire reference to fuse_conn
1324 */
1325 struct fuse_conn *fuse_conn_get(struct fuse_conn *fc);
1326
1327 /**
1328 * Initialize the fuse processing queue
1329 */
1330 void fuse_pqueue_init(struct fuse_pqueue *fpq);
1331
1332 /**
1333 * Initialize fuse_conn
1334 */
1335 void fuse_conn_init(struct fuse_conn *fc, struct fuse_mount *fm,
1336 struct user_namespace *user_ns,
1337 const struct fuse_iqueue_ops *fiq_ops, void *fiq_priv);
1338
1339 /**
1340 * Release reference to fuse_conn
1341 */
1342 void fuse_conn_put(struct fuse_conn *fc);
1343
1344 struct fuse_dev *fuse_dev_alloc_install(struct fuse_conn *fc);
1345 struct fuse_dev *fuse_dev_alloc(void);
1346 void fuse_dev_install(struct fuse_dev *fud, struct fuse_conn *fc);
1347 void fuse_dev_free(struct fuse_dev *fud);
1348 int fuse_send_init(struct fuse_mount *fm);
1349
1350 /**
1351 * Fill in superblock and initialize fuse connection
1352 * @sb: partially-initialized superblock to fill in
1353 * @ctx: mount context
1354 */
1355 int fuse_fill_super_common(struct super_block *sb, struct fuse_fs_context *ctx);
1356
1357 /*
1358 * Remove the mount from the connection
1359 *
1360 * Returns whether this was the last mount
1361 */
1362 bool fuse_mount_remove(struct fuse_mount *fm);
1363
1364 /*
1365 * Setup context ops for submounts
1366 */
1367 int fuse_init_fs_context_submount(struct fs_context *fsc);
1368
1369 /*
1370 * Shut down the connection (possibly sending DESTROY request).
1371 */
1372 void fuse_conn_destroy(struct fuse_mount *fm);
1373
1374 /* Drop the connection and free the fuse mount */
1375 void fuse_mount_destroy(struct fuse_mount *fm);
1376
1377 /**
1378 * Add connection to control filesystem
1379 */
1380 int fuse_ctl_add_conn(struct fuse_conn *fc);
1381
1382 /**
1383 * Remove connection from control filesystem
1384 */
1385 void fuse_ctl_remove_conn(struct fuse_conn *fc);
1386
1387 /**
1388 * Is file type valid?
1389 */
1390 int fuse_valid_type(int m);
1391
1392 bool fuse_invalid_attr(struct fuse_attr *attr);
1393
1394 /**
1395 * Is current process allowed to perform filesystem operation?
1396 */
1397 bool fuse_allow_current_process(struct fuse_conn *fc);
1398
1399 u64 fuse_lock_owner_id(struct fuse_conn *fc, fl_owner_t id);
1400
1401 void fuse_flush_time_update(struct inode *inode);
1402 void fuse_update_ctime(struct inode *inode);
1403
1404 int fuse_update_attributes(struct inode *inode, struct file *file, u32 mask);
1405
1406 void fuse_flush_writepages(struct inode *inode);
1407
1408 void fuse_set_nowrite(struct inode *inode);
1409 void fuse_release_nowrite(struct inode *inode);
1410
1411 /**
1412 * Scan all fuse_mounts belonging to fc to find the first where
1413 * ilookup5() returns a result. Return that result and the
1414 * respective fuse_mount in *fm (unless fm is NULL).
1415 *
1416 * The caller must hold fc->killsb.
1417 */
1418 struct inode *fuse_ilookup(struct fuse_conn *fc, u64 nodeid,
1419 struct fuse_mount **fm);
1420
1421 /**
1422 * File-system tells the kernel to invalidate cache for the given node id.
1423 */
1424 int fuse_reverse_inval_inode(struct fuse_conn *fc, u64 nodeid,
1425 loff_t offset, loff_t len);
1426
1427 /**
1428 * File-system tells the kernel to invalidate parent attributes and
1429 * the dentry matching parent/name.
1430 *
1431 * If the child_nodeid is non-zero and:
1432 * - matches the inode number for the dentry matching parent/name,
1433 * - is not a mount point
1434 * - is a file or oan empty directory
1435 * then the dentry is unhashed (d_delete()).
1436 */
1437 int fuse_reverse_inval_entry(struct fuse_conn *fc, u64 parent_nodeid,
1438 u64 child_nodeid, struct qstr *name, u32 flags);
1439
1440 /*
1441 * Try to prune this inode. If neither the inode itself nor dentries associated
1442 * with this inode have any external reference, then the inode can be freed.
1443 */
1444 void fuse_try_prune_one_inode(struct fuse_conn *fc, u64 nodeid);
1445
1446 int fuse_do_open(struct fuse_mount *fm, u64 nodeid, struct file *file,
1447 bool isdir);
1448
1449 /**
1450 * fuse_direct_io() flags
1451 */
1452
1453 /** If set, it is WRITE; otherwise - READ */
1454 #define FUSE_DIO_WRITE (1 << 0)
1455
1456 /** CUSE pass fuse_direct_io() a file which f_mapping->host is not from FUSE */
1457 #define FUSE_DIO_CUSE (1 << 1)
1458
1459 ssize_t fuse_direct_io(struct fuse_io_priv *io, struct iov_iter *iter,
1460 loff_t *ppos, int flags);
1461 long fuse_do_ioctl(struct file *file, unsigned int cmd, unsigned long arg,
1462 unsigned int flags);
1463 long fuse_ioctl_common(struct file *file, unsigned int cmd,
1464 unsigned long arg, unsigned int flags);
1465 __poll_t fuse_file_poll(struct file *file, poll_table *wait);
1466 int fuse_dev_release(struct inode *inode, struct file *file);
1467
1468 bool fuse_write_update_attr(struct inode *inode, loff_t pos, ssize_t written);
1469
1470 int fuse_flush_times(struct inode *inode, struct fuse_file *ff);
1471 int fuse_write_inode(struct inode *inode, struct writeback_control *wbc);
1472
1473 int fuse_do_setattr(struct mnt_idmap *idmap, struct dentry *dentry,
1474 struct iattr *attr, struct file *file);
1475
1476 void fuse_set_initialized(struct fuse_conn *fc);
1477
1478 void fuse_unlock_inode(struct inode *inode, bool locked);
1479 bool fuse_lock_inode(struct inode *inode);
1480
1481 int fuse_setxattr(struct inode *inode, const char *name, const void *value,
1482 size_t size, int flags, unsigned int extra_flags);
1483 ssize_t fuse_getxattr(struct inode *inode, const char *name, void *value,
1484 size_t size);
1485 ssize_t fuse_listxattr(struct dentry *entry, char *list, size_t size);
1486 int fuse_removexattr(struct inode *inode, const char *name);
1487 extern const struct xattr_handler * const fuse_xattr_handlers[];
1488
1489 struct posix_acl;
1490 struct posix_acl *fuse_get_inode_acl(struct inode *inode, int type, bool rcu);
1491 struct posix_acl *fuse_get_acl(struct mnt_idmap *idmap,
1492 struct dentry *dentry, int type);
1493 int fuse_set_acl(struct mnt_idmap *, struct dentry *dentry,
1494 struct posix_acl *acl, int type);
1495
1496 /* readdir.c */
1497 int fuse_readdir(struct file *file, struct dir_context *ctx);
1498
1499 /**
1500 * Return the number of bytes in an arguments list
1501 */
1502 unsigned int fuse_len_args(unsigned int numargs, struct fuse_arg *args);
1503
1504 /**
1505 * Get the next unique ID for a request
1506 */
1507 u64 fuse_get_unique(struct fuse_iqueue *fiq);
1508 void fuse_free_conn(struct fuse_conn *fc);
1509
1510 /* dax.c */
1511
1512 #define FUSE_IS_DAX(inode) (IS_ENABLED(CONFIG_FUSE_DAX) && IS_DAX(inode))
1513
1514 ssize_t fuse_dax_read_iter(struct kiocb *iocb, struct iov_iter *to);
1515 ssize_t fuse_dax_write_iter(struct kiocb *iocb, struct iov_iter *from);
1516 int fuse_dax_mmap(struct file *file, struct vm_area_struct *vma);
1517 int fuse_dax_break_layouts(struct inode *inode, u64 dmap_start, u64 dmap_end);
1518 int fuse_dax_conn_alloc(struct fuse_conn *fc, enum fuse_dax_mode mode,
1519 struct dax_device *dax_dev);
1520 void fuse_dax_conn_free(struct fuse_conn *fc);
1521 bool fuse_dax_inode_alloc(struct super_block *sb, struct fuse_inode *fi);
1522 void fuse_dax_inode_init(struct inode *inode, unsigned int flags);
1523 void fuse_dax_inode_cleanup(struct inode *inode);
1524 void fuse_dax_dontcache(struct inode *inode, unsigned int flags);
1525 bool fuse_dax_check_alignment(struct fuse_conn *fc, unsigned int map_alignment);
1526 void fuse_dax_cancel_work(struct fuse_conn *fc);
1527
1528 /* ioctl.c */
1529 long fuse_file_ioctl(struct file *file, unsigned int cmd, unsigned long arg);
1530 long fuse_file_compat_ioctl(struct file *file, unsigned int cmd,
1531 unsigned long arg);
1532 int fuse_fileattr_get(struct dentry *dentry, struct file_kattr *fa);
1533 int fuse_fileattr_set(struct mnt_idmap *idmap,
1534 struct dentry *dentry, struct file_kattr *fa);
1535
1536 /* iomode.c */
1537 int fuse_file_cached_io_open(struct inode *inode, struct fuse_file *ff);
1538 int fuse_inode_uncached_io_start(struct fuse_inode *fi,
1539 struct fuse_backing *fb);
1540 void fuse_inode_uncached_io_end(struct fuse_inode *fi);
1541
1542 int fuse_file_io_open(struct file *file, struct inode *inode);
1543 void fuse_file_io_release(struct fuse_file *ff, struct inode *inode);
1544
1545 /* file.c */
1546 struct fuse_file *fuse_file_open(struct fuse_mount *fm, u64 nodeid,
1547 unsigned int open_flags, bool isdir);
1548 void fuse_file_release(struct inode *inode, struct fuse_file *ff,
1549 unsigned int open_flags, fl_owner_t id, bool isdir);
1550
1551 /* backing.c */
1552 #ifdef CONFIG_FUSE_PASSTHROUGH
1553 struct fuse_backing *fuse_backing_get(struct fuse_backing *fb);
1554 void fuse_backing_put(struct fuse_backing *fb);
1555 struct fuse_backing *fuse_backing_lookup(struct fuse_conn *fc, int backing_id);
1556 #else
1557
1558 static inline struct fuse_backing *fuse_backing_get(struct fuse_backing *fb)
1559 {
1560 return NULL;
1561 }
1562
1563 static inline void fuse_backing_put(struct fuse_backing *fb)
1564 {
1565 }
1566 static inline struct fuse_backing *fuse_backing_lookup(struct fuse_conn *fc,
1567 int backing_id)
1568 {
1569 return NULL;
1570 }
1571 #endif
1572
1573 void fuse_backing_files_init(struct fuse_conn *fc);
1574 void fuse_backing_files_free(struct fuse_conn *fc);
1575 int fuse_backing_open(struct fuse_conn *fc, struct fuse_backing_map *map);
1576 int fuse_backing_close(struct fuse_conn *fc, int backing_id);
1577
1578 /* passthrough.c */
1579 static inline struct fuse_backing *fuse_inode_backing(struct fuse_inode *fi)
1580 {
1581 #ifdef CONFIG_FUSE_PASSTHROUGH
1582 return READ_ONCE(fi->fb);
1583 #else
1584 return NULL;
1585 #endif
1586 }
1587
1588 static inline struct fuse_backing *fuse_inode_backing_set(struct fuse_inode *fi,
1589 struct fuse_backing *fb)
1590 {
1591 #ifdef CONFIG_FUSE_PASSTHROUGH
1592 return xchg(&fi->fb, fb);
1593 #else
1594 return NULL;
1595 #endif
1596 }
1597
1598 struct fuse_backing *fuse_passthrough_open(struct file *file, int backing_id);
1599 void fuse_passthrough_release(struct fuse_file *ff, struct fuse_backing *fb);
1600
1601 static inline struct file *fuse_file_passthrough(struct fuse_file *ff)
1602 {
1603 #ifdef CONFIG_FUSE_PASSTHROUGH
1604 return ff->passthrough;
1605 #else
1606 return NULL;
1607 #endif
1608 }
1609
1610 ssize_t fuse_passthrough_read_iter(struct kiocb *iocb, struct iov_iter *iter);
1611 ssize_t fuse_passthrough_write_iter(struct kiocb *iocb, struct iov_iter *iter);
1612 ssize_t fuse_passthrough_splice_read(struct file *in, loff_t *ppos,
1613 struct pipe_inode_info *pipe,
1614 size_t len, unsigned int flags);
1615 ssize_t fuse_passthrough_splice_write(struct pipe_inode_info *pipe,
1616 struct file *out, loff_t *ppos,
1617 size_t len, unsigned int flags);
1618 ssize_t fuse_passthrough_mmap(struct file *file, struct vm_area_struct *vma);
1619
1620 #ifdef CONFIG_SYSCTL
1621 extern int fuse_sysctl_register(void);
1622 extern void fuse_sysctl_unregister(void);
1623 #else
1624 #define fuse_sysctl_register() (0)
1625 #define fuse_sysctl_unregister() do { } while (0)
1626 #endif /* CONFIG_SYSCTL */
1627
1628 #endif /* _FS_FUSE_I_H */