1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef _LINUX_NFS_XDR_H
3 #define _LINUX_NFS_XDR_H
5 #include <linux/nfsacl.h>
6 #include <linux/sunrpc/gss_api.h>
9 * To change the maximum rsize and wsize supported by the NFS client, adjust
10 * NFS_MAX_FILE_IO_SIZE. 64KB is a typical maximum, but some servers can
11 * support a megabyte or more. The default is left at 4096 bytes, which is
12 * reasonable for NFS over UDP.
14 #define NFS_MAX_FILE_IO_SIZE (1048576U)
15 #define NFS_DEF_FILE_IO_SIZE (4096U)
16 #define NFS_MIN_FILE_IO_SIZE (1024U)
18 #define NFS_BITMASK_SZ 3
31 * Helper for checking equality between 2 fsids.
33 static inline int nfs_fsid_equal(const struct nfs_fsid *a, const struct nfs_fsid *b)
35 return a->major == b->major && a->minor == b->minor;
38 struct nfs4_threshold {
48 unsigned int valid; /* which fields are valid */
66 __u64 mounted_on_fileid;
67 struct timespec64 atime;
68 struct timespec64 mtime;
69 struct timespec64 ctime;
70 __u64 change_attr; /* NFSv4 change attribute */
71 __u64 pre_change_attr;/* pre-op NFSv4 change attribute */
72 __u64 pre_size; /* pre_op_attr.size */
73 struct timespec64 pre_mtime; /* pre_op_attr.mtime */
74 struct timespec64 pre_ctime; /* pre_op_attr.ctime */
75 unsigned long time_start;
76 unsigned long gencount;
77 struct nfs4_string *owner_name;
78 struct nfs4_string *group_name;
79 struct nfs4_threshold *mdsthreshold; /* pNFS threshold hints */
80 struct nfs4_label *label;
83 #define NFS_ATTR_FATTR_TYPE (1U << 0)
84 #define NFS_ATTR_FATTR_MODE (1U << 1)
85 #define NFS_ATTR_FATTR_NLINK (1U << 2)
86 #define NFS_ATTR_FATTR_OWNER (1U << 3)
87 #define NFS_ATTR_FATTR_GROUP (1U << 4)
88 #define NFS_ATTR_FATTR_RDEV (1U << 5)
89 #define NFS_ATTR_FATTR_SIZE (1U << 6)
90 #define NFS_ATTR_FATTR_PRESIZE (1U << 7)
91 #define NFS_ATTR_FATTR_BLOCKS_USED (1U << 8)
92 #define NFS_ATTR_FATTR_SPACE_USED (1U << 9)
93 #define NFS_ATTR_FATTR_FSID (1U << 10)
94 #define NFS_ATTR_FATTR_FILEID (1U << 11)
95 #define NFS_ATTR_FATTR_ATIME (1U << 12)
96 #define NFS_ATTR_FATTR_MTIME (1U << 13)
97 #define NFS_ATTR_FATTR_CTIME (1U << 14)
98 #define NFS_ATTR_FATTR_PREMTIME (1U << 15)
99 #define NFS_ATTR_FATTR_PRECTIME (1U << 16)
100 #define NFS_ATTR_FATTR_CHANGE (1U << 17)
101 #define NFS_ATTR_FATTR_PRECHANGE (1U << 18)
102 #define NFS_ATTR_FATTR_V4_LOCATIONS (1U << 19)
103 #define NFS_ATTR_FATTR_V4_REFERRAL (1U << 20)
104 #define NFS_ATTR_FATTR_MOUNTPOINT (1U << 21)
105 #define NFS_ATTR_FATTR_MOUNTED_ON_FILEID (1U << 22)
106 #define NFS_ATTR_FATTR_OWNER_NAME (1U << 23)
107 #define NFS_ATTR_FATTR_GROUP_NAME (1U << 24)
108 #define NFS_ATTR_FATTR_V4_SECURITY_LABEL (1U << 25)
110 #define NFS_ATTR_FATTR (NFS_ATTR_FATTR_TYPE \
111 | NFS_ATTR_FATTR_MODE \
112 | NFS_ATTR_FATTR_NLINK \
113 | NFS_ATTR_FATTR_OWNER \
114 | NFS_ATTR_FATTR_GROUP \
115 | NFS_ATTR_FATTR_RDEV \
116 | NFS_ATTR_FATTR_SIZE \
117 | NFS_ATTR_FATTR_FSID \
118 | NFS_ATTR_FATTR_FILEID \
119 | NFS_ATTR_FATTR_ATIME \
120 | NFS_ATTR_FATTR_MTIME \
121 | NFS_ATTR_FATTR_CTIME \
122 | NFS_ATTR_FATTR_CHANGE)
123 #define NFS_ATTR_FATTR_V2 (NFS_ATTR_FATTR \
124 | NFS_ATTR_FATTR_BLOCKS_USED)
125 #define NFS_ATTR_FATTR_V3 (NFS_ATTR_FATTR \
126 | NFS_ATTR_FATTR_SPACE_USED)
127 #define NFS_ATTR_FATTR_V4 (NFS_ATTR_FATTR \
128 | NFS_ATTR_FATTR_SPACE_USED \
129 | NFS_ATTR_FATTR_V4_SECURITY_LABEL)
132 * Maximal number of supported layout drivers.
134 #define NFS_MAX_LAYOUT_TYPES 8
137 * Info on the file system
140 struct nfs_fattr *fattr; /* Post-op attributes */
141 __u32 rtmax; /* max. read transfer size */
142 __u32 rtpref; /* pref. read transfer size */
143 __u32 rtmult; /* reads should be multiple of this */
144 __u32 wtmax; /* max. write transfer size */
145 __u32 wtpref; /* pref. write transfer size */
146 __u32 wtmult; /* writes should be multiple of this */
147 __u32 dtpref; /* pref. readdir transfer size */
149 struct timespec64 time_delta; /* server time granularity */
150 __u32 lease_time; /* in seconds */
151 __u32 nlayouttypes; /* number of layouttypes */
152 __u32 layouttype[NFS_MAX_LAYOUT_TYPES]; /* supported pnfs layout driver */
153 __u32 blksize; /* preferred pnfs io block size */
154 __u32 clone_blksize; /* granularity of a CLONE operation */
155 enum nfs4_change_attr_type
156 change_attr_type; /* Info about change attr */
157 __u32 xattr_support; /* User xattrs supported */
161 struct nfs_fattr *fattr; /* Post-op attributes */
162 __u64 tbytes; /* total size in bytes */
163 __u64 fbytes; /* # of free bytes */
164 __u64 abytes; /* # of bytes available to user */
165 __u64 tfiles; /* # of files */
166 __u64 ffiles; /* # of free files */
167 __u64 afiles; /* # of files available to user */
171 __u32 tsize; /* Server transfer size */
172 __u32 bsize; /* Filesystem block size */
173 __u32 blocks; /* No. of "bsize" blocks on filesystem */
174 __u32 bfree; /* No. of free "bsize" blocks */
175 __u32 bavail; /* No. of available "bsize" blocks */
178 struct nfs_pathconf {
179 struct nfs_fattr *fattr; /* Post-op attributes */
180 __u32 max_link; /* max # of hard links */
181 __u32 max_namelen; /* max name length */
184 struct nfs4_change_info {
192 /* nfs41 sessions channel attributes */
193 struct nfs4_channel_attrs {
196 u32 max_resp_sz_cached;
202 struct nfs4_sequence_args {
203 struct nfs4_slot *sa_slot;
204 u8 sa_cache_this : 1,
208 struct nfs4_sequence_res {
209 struct nfs4_slot *sr_slot; /* slot used to send request */
210 unsigned long sr_timestamp;
211 int sr_status; /* sequence operation status */
213 u32 sr_highest_slotid;
214 u32 sr_target_highest_slotid;
217 struct nfs4_get_lease_time_args {
218 struct nfs4_sequence_args la_seq_args;
221 struct nfs4_get_lease_time_res {
222 struct nfs4_sequence_res lr_seq_res;
223 struct nfs_fsinfo *lr_fsinfo;
227 struct nfs4_xdr_opaque_data;
229 struct nfs4_xdr_opaque_ops {
230 void (*encode)(struct xdr_stream *, const void *args,
231 const struct nfs4_xdr_opaque_data *);
232 void (*free)(struct nfs4_xdr_opaque_data *);
235 struct nfs4_xdr_opaque_data {
236 const struct nfs4_xdr_opaque_ops *ops;
240 #define PNFS_LAYOUT_MAXSIZE 4096
242 struct nfs4_layoutdriver_data {
248 struct pnfs_layout_range {
254 struct nfs4_layoutget_args {
255 struct nfs4_sequence_args seq_args;
257 struct pnfs_layout_range range;
261 struct nfs_open_context *ctx;
262 nfs4_stateid stateid;
263 struct nfs4_layoutdriver_data layout;
266 struct nfs4_layoutget_res {
267 struct nfs4_sequence_res seq_res;
269 __u32 return_on_close;
270 struct pnfs_layout_range range;
272 nfs4_stateid stateid;
273 struct nfs4_layoutdriver_data *layoutp;
276 struct nfs4_layoutget {
277 struct nfs4_layoutget_args args;
278 struct nfs4_layoutget_res res;
279 const struct cred *cred;
283 struct nfs4_getdeviceinfo_args {
284 struct nfs4_sequence_args seq_args;
285 struct pnfs_device *pdev;
289 struct nfs4_getdeviceinfo_res {
290 struct nfs4_sequence_res seq_res;
291 struct pnfs_device *pdev;
295 struct nfs4_layoutcommit_args {
296 struct nfs4_sequence_args seq_args;
297 nfs4_stateid stateid;
298 __u64 lastbytewritten;
301 size_t layoutupdate_len;
302 struct page *layoutupdate_page;
303 struct page **layoutupdate_pages;
307 struct nfs4_layoutcommit_res {
308 struct nfs4_sequence_res seq_res;
309 struct nfs_fattr *fattr;
310 const struct nfs_server *server;
314 struct nfs4_layoutcommit_data {
315 struct rpc_task task;
316 struct nfs_fattr fattr;
317 struct list_head lseg_list;
318 const struct cred *cred;
320 struct nfs4_layoutcommit_args args;
321 struct nfs4_layoutcommit_res res;
324 struct nfs4_layoutreturn_args {
325 struct nfs4_sequence_args seq_args;
326 struct pnfs_layout_hdr *layout;
328 struct pnfs_layout_range range;
329 nfs4_stateid stateid;
331 struct nfs4_xdr_opaque_data *ld_private;
334 struct nfs4_layoutreturn_res {
335 struct nfs4_sequence_res seq_res;
337 nfs4_stateid stateid;
340 struct nfs4_layoutreturn {
341 struct nfs4_layoutreturn_args args;
342 struct nfs4_layoutreturn_res res;
343 const struct cred *cred;
344 struct nfs_client *clp;
347 struct nfs4_xdr_opaque_data ld_private;
350 #define PNFS_LAYOUTSTATS_MAXSIZE 256
352 struct nfs42_layoutstat_args;
353 struct nfs42_layoutstat_devinfo;
354 typedef void (*layoutstats_encode_t)(struct xdr_stream *,
355 struct nfs42_layoutstat_args *,
356 struct nfs42_layoutstat_devinfo *);
358 /* Per file per deviceid layoutstats */
359 struct nfs42_layoutstat_devinfo {
360 struct nfs4_deviceid dev_id;
368 struct nfs4_xdr_opaque_data ld_private;
371 struct nfs42_layoutstat_args {
372 struct nfs4_sequence_args seq_args;
375 nfs4_stateid stateid;
377 struct nfs42_layoutstat_devinfo *devinfo;
380 struct nfs42_layoutstat_res {
381 struct nfs4_sequence_res seq_res;
386 struct nfs42_layoutstat_data {
388 struct nfs42_layoutstat_args args;
389 struct nfs42_layoutstat_res res;
392 struct nfs42_device_error {
393 struct nfs4_deviceid dev_id;
395 enum nfs_opnum4 opnum;
398 struct nfs42_layout_error {
401 nfs4_stateid stateid;
402 struct nfs42_device_error errors[1];
405 #define NFS42_LAYOUTERROR_MAX 5
407 struct nfs42_layouterror_args {
408 struct nfs4_sequence_args seq_args;
410 unsigned int num_errors;
411 struct nfs42_layout_error errors[NFS42_LAYOUTERROR_MAX];
414 struct nfs42_layouterror_res {
415 struct nfs4_sequence_res seq_res;
416 unsigned int num_errors;
420 struct nfs42_layouterror_data {
421 struct nfs42_layouterror_args args;
422 struct nfs42_layouterror_res res;
424 struct pnfs_layout_segment *lseg;
427 struct nfs42_clone_args {
428 struct nfs4_sequence_args seq_args;
429 struct nfs_fh *src_fh;
430 struct nfs_fh *dst_fh;
431 nfs4_stateid src_stateid;
432 nfs4_stateid dst_stateid;
436 const u32 *dst_bitmask;
439 struct nfs42_clone_res {
440 struct nfs4_sequence_res seq_res;
441 unsigned int rpc_status;
442 struct nfs_fattr *dst_fattr;
443 const struct nfs_server *server;
446 struct stateowner_id {
452 * Arguments to the open call.
454 struct nfs_openargs {
455 struct nfs4_sequence_args seq_args;
456 const struct nfs_fh * fh;
457 struct nfs_seqid * seqid;
463 struct stateowner_id id;
466 struct iattr * attrs; /* UNCHECKED, GUARDED, EXCLUSIVE4_1 */
467 nfs4_verifier verifier; /* EXCLUSIVE */
469 nfs4_stateid delegation; /* CLAIM_DELEGATE_CUR */
470 fmode_t delegation_type; /* CLAIM_PREVIOUS */
472 const struct qstr * name;
473 const struct nfs_server *server; /* Needed for ID mapping */
475 const u32 * open_bitmap;
476 enum open_claim_type4 claim;
477 enum createmode4 createmode;
478 const struct nfs4_label *label;
480 struct nfs4_layoutget_args *lg_args;
484 struct nfs4_sequence_res seq_res;
485 nfs4_stateid stateid;
487 struct nfs4_change_info cinfo;
489 struct nfs_fattr * f_attr;
490 struct nfs4_label *f_label;
491 struct nfs_seqid * seqid;
492 const struct nfs_server *server;
493 fmode_t delegation_type;
494 nfs4_stateid delegation;
495 unsigned long pagemod_limit;
497 __u32 attrset[NFS4_BITMAP_SIZE];
498 struct nfs4_string *owner;
499 struct nfs4_string *group_owner;
500 __u32 access_request;
501 __u32 access_supported;
503 struct nfs4_layoutget_res *lg_res;
507 * Arguments to the open_confirm call.
509 struct nfs_open_confirmargs {
510 struct nfs4_sequence_args seq_args;
511 const struct nfs_fh * fh;
512 nfs4_stateid * stateid;
513 struct nfs_seqid * seqid;
516 struct nfs_open_confirmres {
517 struct nfs4_sequence_res seq_res;
518 nfs4_stateid stateid;
519 struct nfs_seqid * seqid;
523 * Arguments to the close call.
525 struct nfs_closeargs {
526 struct nfs4_sequence_args seq_args;
528 nfs4_stateid stateid;
529 struct nfs_seqid * seqid;
533 u32 bitmask_store[NFS_BITMASK_SZ];
534 struct nfs4_layoutreturn_args *lr_args;
537 struct nfs_closeres {
538 struct nfs4_sequence_res seq_res;
539 nfs4_stateid stateid;
540 struct nfs_fattr * fattr;
541 struct nfs_seqid * seqid;
542 const struct nfs_server *server;
543 struct nfs4_layoutreturn_res *lr_res;
547 * * Arguments to the lock,lockt, and locku call.
555 struct nfs_lock_args {
556 struct nfs4_sequence_args seq_args;
558 struct file_lock * fl;
559 struct nfs_seqid * lock_seqid;
560 nfs4_stateid lock_stateid;
561 struct nfs_seqid * open_seqid;
562 nfs4_stateid open_stateid;
563 struct nfs_lowner lock_owner;
564 unsigned char block : 1;
565 unsigned char reclaim : 1;
566 unsigned char new_lock : 1;
567 unsigned char new_lock_owner : 1;
570 struct nfs_lock_res {
571 struct nfs4_sequence_res seq_res;
572 nfs4_stateid stateid;
573 struct nfs_seqid * lock_seqid;
574 struct nfs_seqid * open_seqid;
577 struct nfs_locku_args {
578 struct nfs4_sequence_args seq_args;
580 struct file_lock * fl;
581 struct nfs_seqid * seqid;
582 nfs4_stateid stateid;
585 struct nfs_locku_res {
586 struct nfs4_sequence_res seq_res;
587 nfs4_stateid stateid;
588 struct nfs_seqid * seqid;
591 struct nfs_lockt_args {
592 struct nfs4_sequence_args seq_args;
594 struct file_lock * fl;
595 struct nfs_lowner lock_owner;
598 struct nfs_lockt_res {
599 struct nfs4_sequence_res seq_res;
600 struct file_lock * denied; /* LOCK, LOCKT failed */
603 struct nfs_release_lockowner_args {
604 struct nfs4_sequence_args seq_args;
605 struct nfs_lowner lock_owner;
608 struct nfs_release_lockowner_res {
609 struct nfs4_sequence_res seq_res;
612 struct nfs4_delegreturnargs {
613 struct nfs4_sequence_args seq_args;
614 const struct nfs_fh *fhandle;
615 const nfs4_stateid *stateid;
617 u32 bitmask_store[NFS_BITMASK_SZ];
618 struct nfs4_layoutreturn_args *lr_args;
621 struct nfs4_delegreturnres {
622 struct nfs4_sequence_res seq_res;
623 struct nfs_fattr * fattr;
624 struct nfs_server *server;
625 struct nfs4_layoutreturn_res *lr_res;
630 * Arguments to the write call.
632 struct nfs_write_verifier {
636 struct nfs_writeverf {
637 struct nfs_write_verifier verifier;
638 enum nfs3_stable_how committed;
642 * Arguments shared by the read and write call.
644 struct nfs_pgio_args {
645 struct nfs4_sequence_args seq_args;
647 struct nfs_open_context *context;
648 struct nfs_lock_context *lock_context;
649 nfs4_stateid stateid;
653 struct page ** pages;
655 unsigned int replen; /* used by read */
657 const u32 * bitmask; /* used by write */
658 u32 bitmask_store[NFS_BITMASK_SZ]; /* used by write */
659 enum nfs3_stable_how stable; /* used by write */
664 struct nfs_pgio_res {
665 struct nfs4_sequence_res seq_res;
666 struct nfs_fattr * fattr;
671 unsigned int replen; /* used by read */
672 int eof; /* used by read */
675 struct nfs_writeverf * verf; /* used by write */
676 const struct nfs_server *server; /* used by write */
682 * Arguments to the commit call.
684 struct nfs_commitargs {
685 struct nfs4_sequence_args seq_args;
692 struct nfs_commitres {
693 struct nfs4_sequence_res seq_res;
695 struct nfs_fattr *fattr;
696 struct nfs_writeverf *verf;
697 const struct nfs_server *server;
701 * Common arguments to the unlink call
703 struct nfs_removeargs {
704 struct nfs4_sequence_args seq_args;
705 const struct nfs_fh *fh;
709 struct nfs_removeres {
710 struct nfs4_sequence_res seq_res;
711 struct nfs_server *server;
712 struct nfs_fattr *dir_attr;
713 struct nfs4_change_info cinfo;
717 * Common arguments to the rename call
719 struct nfs_renameargs {
720 struct nfs4_sequence_args seq_args;
721 const struct nfs_fh *old_dir;
722 const struct nfs_fh *new_dir;
723 const struct qstr *old_name;
724 const struct qstr *new_name;
727 struct nfs_renameres {
728 struct nfs4_sequence_res seq_res;
729 struct nfs_server *server;
730 struct nfs4_change_info old_cinfo;
731 struct nfs_fattr *old_fattr;
732 struct nfs4_change_info new_cinfo;
733 struct nfs_fattr *new_fattr;
736 /* parsed sec= options */
737 #define NFS_AUTH_INFO_MAX_FLAVORS 12 /* see fs/nfs/super.c */
738 struct nfs_auth_info {
739 unsigned int flavor_len;
740 rpc_authflavor_t flavors[NFS_AUTH_INFO_MAX_FLAVORS];
744 * Argument struct for decode_entry function
754 struct nfs_fattr * fattr;
755 struct nfs4_label *label;
756 unsigned char d_type;
757 struct nfs_server * server;
760 struct nfs_readdir_arg {
761 struct dentry *dentry;
762 const struct cred *cred;
766 unsigned int page_len;
770 struct nfs_readdir_res {
775 * The following types are for NFSv2 only.
777 struct nfs_sattrargs {
779 struct iattr * sattr;
782 struct nfs_diropargs {
788 struct nfs_createargs {
792 struct iattr * sattr;
795 struct nfs_setattrargs {
796 struct nfs4_sequence_args seq_args;
798 nfs4_stateid stateid;
800 const struct nfs_server * server; /* Needed for name mapping */
802 const struct nfs4_label *label;
805 struct nfs_setaclargs {
806 struct nfs4_sequence_args seq_args;
809 struct page ** acl_pages;
812 struct nfs_setaclres {
813 struct nfs4_sequence_res seq_res;
816 struct nfs_getaclargs {
817 struct nfs4_sequence_args seq_args;
820 struct page ** acl_pages;
823 /* getxattr ACL interface flags */
824 #define NFS4_ACL_TRUNC 0x0001 /* ACL was truncated */
825 struct nfs_getaclres {
826 struct nfs4_sequence_res seq_res;
828 size_t acl_data_offset;
830 struct page * acl_scratch;
833 struct nfs_setattrres {
834 struct nfs4_sequence_res seq_res;
835 struct nfs_fattr * fattr;
836 struct nfs4_label *label;
837 const struct nfs_server * server;
840 struct nfs_linkargs {
841 struct nfs_fh * fromfh;
842 struct nfs_fh * tofh;
847 struct nfs_symlinkargs {
848 struct nfs_fh * fromfh;
849 const char * fromname;
850 unsigned int fromlen;
851 struct page ** pages;
852 unsigned int pathlen;
853 struct iattr * sattr;
856 struct nfs_readdirargs {
860 struct page ** pages;
863 struct nfs3_getaclargs {
866 struct page ** pages;
869 struct nfs3_setaclargs {
870 struct inode * inode;
872 struct posix_acl * acl_access;
873 struct posix_acl * acl_default;
876 struct page ** pages;
881 struct nfs_fattr * fattr;
884 struct nfs_readlinkargs {
888 struct page ** pages;
891 struct nfs3_sattrargs {
893 struct iattr * sattr;
895 struct timespec64 guardtime;
898 struct nfs3_diropargs {
904 struct nfs3_accessargs {
909 struct nfs3_createargs {
913 struct iattr * sattr;
914 enum nfs3_createmode createmode;
918 struct nfs3_mkdirargs {
922 struct iattr * sattr;
925 struct nfs3_symlinkargs {
926 struct nfs_fh * fromfh;
927 const char * fromname;
928 unsigned int fromlen;
929 struct page ** pages;
930 unsigned int pathlen;
931 struct iattr * sattr;
934 struct nfs3_mknodargs {
938 enum nfs3_ftype type;
939 struct iattr * sattr;
943 struct nfs3_linkargs {
944 struct nfs_fh * fromfh;
945 struct nfs_fh * tofh;
950 struct nfs3_readdirargs {
956 struct page ** pages;
959 struct nfs3_diropres {
960 struct nfs_fattr * dir_attr;
962 struct nfs_fattr * fattr;
965 struct nfs3_accessres {
966 struct nfs_fattr * fattr;
970 struct nfs3_readlinkargs {
974 struct page ** pages;
977 struct nfs3_linkres {
978 struct nfs_fattr * dir_attr;
979 struct nfs_fattr * fattr;
982 struct nfs3_readdirres {
983 struct nfs_fattr * dir_attr;
988 struct nfs3_getaclres {
989 struct nfs_fattr * fattr;
991 unsigned int acl_access_count;
992 unsigned int acl_default_count;
993 struct posix_acl * acl_access;
994 struct posix_acl * acl_default;
997 #if IS_ENABLED(CONFIG_NFS_V4)
999 typedef u64 clientid4;
1001 struct nfs4_accessargs {
1002 struct nfs4_sequence_args seq_args;
1003 const struct nfs_fh * fh;
1004 const u32 * bitmask;
1008 struct nfs4_accessres {
1009 struct nfs4_sequence_res seq_res;
1010 const struct nfs_server * server;
1011 struct nfs_fattr * fattr;
1016 struct nfs4_create_arg {
1017 struct nfs4_sequence_args seq_args;
1021 struct page ** pages;
1023 } symlink; /* NF4LNK */
1027 } device; /* NF4BLK, NF4CHR */
1029 const struct qstr * name;
1030 const struct nfs_server * server;
1031 const struct iattr * attrs;
1032 const struct nfs_fh * dir_fh;
1033 const u32 * bitmask;
1034 const struct nfs4_label *label;
1038 struct nfs4_create_res {
1039 struct nfs4_sequence_res seq_res;
1040 const struct nfs_server * server;
1042 struct nfs_fattr * fattr;
1043 struct nfs4_label *label;
1044 struct nfs4_change_info dir_cinfo;
1047 struct nfs4_fsinfo_arg {
1048 struct nfs4_sequence_args seq_args;
1049 const struct nfs_fh * fh;
1050 const u32 * bitmask;
1053 struct nfs4_fsinfo_res {
1054 struct nfs4_sequence_res seq_res;
1055 struct nfs_fsinfo *fsinfo;
1058 struct nfs4_getattr_arg {
1059 struct nfs4_sequence_args seq_args;
1060 const struct nfs_fh * fh;
1061 const u32 * bitmask;
1064 struct nfs4_getattr_res {
1065 struct nfs4_sequence_res seq_res;
1066 const struct nfs_server * server;
1067 struct nfs_fattr * fattr;
1068 struct nfs4_label *label;
1071 struct nfs4_link_arg {
1072 struct nfs4_sequence_args seq_args;
1073 const struct nfs_fh * fh;
1074 const struct nfs_fh * dir_fh;
1075 const struct qstr * name;
1076 const u32 * bitmask;
1079 struct nfs4_link_res {
1080 struct nfs4_sequence_res seq_res;
1081 const struct nfs_server * server;
1082 struct nfs_fattr * fattr;
1083 struct nfs4_label *label;
1084 struct nfs4_change_info cinfo;
1085 struct nfs_fattr * dir_attr;
1088 struct nfs4_lookup_arg {
1089 struct nfs4_sequence_args seq_args;
1090 const struct nfs_fh * dir_fh;
1091 const struct qstr * name;
1092 const u32 * bitmask;
1095 struct nfs4_lookup_res {
1096 struct nfs4_sequence_res seq_res;
1097 const struct nfs_server * server;
1098 struct nfs_fattr * fattr;
1100 struct nfs4_label *label;
1103 struct nfs4_lookupp_arg {
1104 struct nfs4_sequence_args seq_args;
1105 const struct nfs_fh *fh;
1109 struct nfs4_lookupp_res {
1110 struct nfs4_sequence_res seq_res;
1111 const struct nfs_server *server;
1112 struct nfs_fattr *fattr;
1114 struct nfs4_label *label;
1117 struct nfs4_lookup_root_arg {
1118 struct nfs4_sequence_args seq_args;
1119 const u32 * bitmask;
1122 struct nfs4_pathconf_arg {
1123 struct nfs4_sequence_args seq_args;
1124 const struct nfs_fh * fh;
1125 const u32 * bitmask;
1128 struct nfs4_pathconf_res {
1129 struct nfs4_sequence_res seq_res;
1130 struct nfs_pathconf *pathconf;
1133 struct nfs4_readdir_arg {
1134 struct nfs4_sequence_args seq_args;
1135 const struct nfs_fh * fh;
1137 nfs4_verifier verifier;
1139 struct page ** pages; /* zero-copy data */
1140 unsigned int pgbase; /* zero-copy data */
1141 const u32 * bitmask;
1145 struct nfs4_readdir_res {
1146 struct nfs4_sequence_res seq_res;
1147 nfs4_verifier verifier;
1148 unsigned int pgbase;
1151 struct nfs4_readlink {
1152 struct nfs4_sequence_args seq_args;
1153 const struct nfs_fh * fh;
1154 unsigned int pgbase;
1155 unsigned int pglen; /* zero-copy data */
1156 struct page ** pages; /* zero-copy data */
1159 struct nfs4_readlink_res {
1160 struct nfs4_sequence_res seq_res;
1163 struct nfs4_setclientid {
1164 const nfs4_verifier * sc_verifier;
1166 unsigned int sc_netid_len;
1167 char sc_netid[RPCBIND_MAXNETIDLEN + 1];
1168 unsigned int sc_uaddr_len;
1169 char sc_uaddr[RPCBIND_MAXUADDRLEN + 1];
1170 struct nfs_client *sc_clnt;
1171 struct rpc_cred *sc_cred;
1174 struct nfs4_setclientid_res {
1176 nfs4_verifier confirm;
1179 struct nfs4_statfs_arg {
1180 struct nfs4_sequence_args seq_args;
1181 const struct nfs_fh * fh;
1182 const u32 * bitmask;
1185 struct nfs4_statfs_res {
1186 struct nfs4_sequence_res seq_res;
1187 struct nfs_fsstat *fsstat;
1190 struct nfs4_server_caps_arg {
1191 struct nfs4_sequence_args seq_args;
1192 struct nfs_fh *fhandle;
1193 const u32 * bitmask;
1196 struct nfs4_server_caps_res {
1197 struct nfs4_sequence_res seq_res;
1198 u32 attr_bitmask[3];
1199 u32 exclcreat_bitmask[3];
1206 #define NFS4_PATHNAME_MAXCOMPONENTS 512
1207 struct nfs4_pathname {
1208 unsigned int ncomponents;
1209 struct nfs4_string components[NFS4_PATHNAME_MAXCOMPONENTS];
1212 #define NFS4_FS_LOCATION_MAXSERVERS 10
1213 struct nfs4_fs_location {
1214 unsigned int nservers;
1215 struct nfs4_string servers[NFS4_FS_LOCATION_MAXSERVERS];
1216 struct nfs4_pathname rootpath;
1219 #define NFS4_FS_LOCATIONS_MAXENTRIES 10
1220 struct nfs4_fs_locations {
1221 struct nfs_fattr fattr;
1222 const struct nfs_server *server;
1223 struct nfs4_pathname fs_path;
1225 struct nfs4_fs_location locations[NFS4_FS_LOCATIONS_MAXENTRIES];
1228 struct nfs4_fs_locations_arg {
1229 struct nfs4_sequence_args seq_args;
1230 const struct nfs_fh *dir_fh;
1231 const struct nfs_fh *fh;
1232 const struct qstr *name;
1236 unsigned char migration:1, renew:1;
1239 struct nfs4_fs_locations_res {
1240 struct nfs4_sequence_res seq_res;
1241 struct nfs4_fs_locations *fs_locations;
1242 unsigned char migration:1, renew:1;
1245 struct nfs4_secinfo4 {
1247 struct rpcsec_gss_info flavor_info;
1250 struct nfs4_secinfo_flavors {
1251 unsigned int num_flavors;
1252 struct nfs4_secinfo4 flavors[];
1255 struct nfs4_secinfo_arg {
1256 struct nfs4_sequence_args seq_args;
1257 const struct nfs_fh *dir_fh;
1258 const struct qstr *name;
1261 struct nfs4_secinfo_res {
1262 struct nfs4_sequence_res seq_res;
1263 struct nfs4_secinfo_flavors *flavors;
1266 struct nfs4_fsid_present_arg {
1267 struct nfs4_sequence_args seq_args;
1268 const struct nfs_fh *fh;
1270 unsigned char renew:1;
1273 struct nfs4_fsid_present_res {
1274 struct nfs4_sequence_res seq_res;
1276 unsigned char renew:1;
1279 #endif /* CONFIG_NFS_V4 */
1286 #ifdef CONFIG_NFS_V4_1
1288 struct pnfs_commit_bucket {
1289 struct list_head written;
1290 struct list_head committing;
1291 struct pnfs_layout_segment *lseg;
1292 struct nfs_writeverf direct_verf;
1295 struct pnfs_commit_array {
1296 struct list_head cinfo_list;
1297 struct list_head lseg_list;
1298 struct pnfs_layout_segment *lseg;
1299 struct rcu_head rcu;
1300 refcount_t refcount;
1301 unsigned int nbuckets;
1302 struct pnfs_commit_bucket buckets[];
1305 struct pnfs_ds_commit_info {
1306 struct list_head commits;
1307 unsigned int nwritten;
1308 unsigned int ncommitting;
1309 const struct pnfs_commit_ops *ops;
1312 struct nfs41_state_protection {
1314 struct nfs4_op_map enforce;
1315 struct nfs4_op_map allow;
1318 struct nfs41_exchange_id_args {
1319 struct nfs_client *client;
1320 nfs4_verifier verifier;
1322 struct nfs41_state_protection state_protect;
1325 struct nfs41_server_owner {
1327 uint32_t major_id_sz;
1328 char major_id[NFS4_OPAQUE_LIMIT];
1331 struct nfs41_server_scope {
1332 uint32_t server_scope_sz;
1333 char server_scope[NFS4_OPAQUE_LIMIT];
1336 struct nfs41_impl_id {
1337 char domain[NFS4_OPAQUE_LIMIT + 1];
1338 char name[NFS4_OPAQUE_LIMIT + 1];
1339 struct nfstime4 date;
1342 #define MAX_BIND_CONN_TO_SESSION_RETRIES 3
1343 struct nfs41_bind_conn_to_session_args {
1344 struct nfs_client *client;
1345 struct nfs4_sessionid sessionid;
1347 bool use_conn_in_rdma_mode;
1351 struct nfs41_bind_conn_to_session_res {
1352 struct nfs4_sessionid sessionid;
1354 bool use_conn_in_rdma_mode;
1357 struct nfs41_exchange_id_res {
1361 struct nfs41_server_owner *server_owner;
1362 struct nfs41_server_scope *server_scope;
1363 struct nfs41_impl_id *impl_id;
1364 struct nfs41_state_protection state_protect;
1367 struct nfs41_create_session_args {
1368 struct nfs_client *client;
1372 uint32_t cb_program;
1373 struct nfs4_channel_attrs fc_attrs; /* Fore Channel */
1374 struct nfs4_channel_attrs bc_attrs; /* Back Channel */
1377 struct nfs41_create_session_res {
1378 struct nfs4_sessionid sessionid;
1381 struct nfs4_channel_attrs fc_attrs; /* Fore Channel */
1382 struct nfs4_channel_attrs bc_attrs; /* Back Channel */
1385 struct nfs41_reclaim_complete_args {
1386 struct nfs4_sequence_args seq_args;
1387 /* In the future extend to include curr_fh for use with migration */
1388 unsigned char one_fs:1;
1391 struct nfs41_reclaim_complete_res {
1392 struct nfs4_sequence_res seq_res;
1395 #define SECINFO_STYLE_CURRENT_FH 0
1396 #define SECINFO_STYLE_PARENT 1
1397 struct nfs41_secinfo_no_name_args {
1398 struct nfs4_sequence_args seq_args;
1402 struct nfs41_test_stateid_args {
1403 struct nfs4_sequence_args seq_args;
1404 nfs4_stateid *stateid;
1407 struct nfs41_test_stateid_res {
1408 struct nfs4_sequence_res seq_res;
1409 unsigned int status;
1412 struct nfs41_free_stateid_args {
1413 struct nfs4_sequence_args seq_args;
1414 nfs4_stateid stateid;
1417 struct nfs41_free_stateid_res {
1418 struct nfs4_sequence_res seq_res;
1419 unsigned int status;
1424 struct pnfs_ds_commit_info {
1427 #endif /* CONFIG_NFS_V4_1 */
1429 #ifdef CONFIG_NFS_V4_2
1430 struct nfs42_falloc_args {
1431 struct nfs4_sequence_args seq_args;
1433 struct nfs_fh *falloc_fh;
1434 nfs4_stateid falloc_stateid;
1437 const u32 *falloc_bitmask;
1440 struct nfs42_falloc_res {
1441 struct nfs4_sequence_res seq_res;
1442 unsigned int status;
1444 struct nfs_fattr *falloc_fattr;
1445 const struct nfs_server *falloc_server;
1448 struct nfs42_copy_args {
1449 struct nfs4_sequence_args seq_args;
1451 struct nfs_fh *src_fh;
1452 nfs4_stateid src_stateid;
1455 struct nfs_fh *dst_fh;
1456 nfs4_stateid dst_stateid;
1461 struct nl4_server *cp_src;
1464 struct nfs42_write_res {
1465 nfs4_stateid stateid;
1467 struct nfs_writeverf verifier;
1470 struct nfs42_copy_res {
1471 struct nfs4_sequence_res seq_res;
1472 struct nfs42_write_res write_res;
1475 struct nfs_commitres commit_res;
1478 struct nfs42_offload_status_args {
1479 struct nfs4_sequence_args osa_seq_args;
1480 struct nfs_fh *osa_src_fh;
1481 nfs4_stateid osa_stateid;
1484 struct nfs42_offload_status_res {
1485 struct nfs4_sequence_res osr_seq_res;
1490 struct nfs42_copy_notify_args {
1491 struct nfs4_sequence_args cna_seq_args;
1493 struct nfs_fh *cna_src_fh;
1494 nfs4_stateid cna_src_stateid;
1495 struct nl4_server cna_dst;
1498 struct nfs42_copy_notify_res {
1499 struct nfs4_sequence_res cnr_seq_res;
1501 struct nfstime4 cnr_lease_time;
1502 nfs4_stateid cnr_stateid;
1503 struct nl4_server cnr_src;
1506 struct nfs42_seek_args {
1507 struct nfs4_sequence_args seq_args;
1509 struct nfs_fh *sa_fh;
1510 nfs4_stateid sa_stateid;
1515 struct nfs42_seek_res {
1516 struct nfs4_sequence_res seq_res;
1517 unsigned int status;
1523 struct nfs42_setxattrargs {
1524 struct nfs4_sequence_args seq_args;
1526 const char *xattr_name;
1529 struct page **xattr_pages;
1532 struct nfs42_setxattrres {
1533 struct nfs4_sequence_res seq_res;
1534 struct nfs4_change_info cinfo;
1537 struct nfs42_getxattrargs {
1538 struct nfs4_sequence_args seq_args;
1540 const char *xattr_name;
1542 struct page **xattr_pages;
1545 struct nfs42_getxattrres {
1546 struct nfs4_sequence_res seq_res;
1550 struct nfs42_listxattrsargs {
1551 struct nfs4_sequence_args seq_args;
1555 struct page **xattr_pages;
1558 struct nfs42_listxattrsres {
1559 struct nfs4_sequence_res seq_res;
1560 struct page *scratch;
1568 struct nfs42_removexattrargs {
1569 struct nfs4_sequence_args seq_args;
1571 const char *xattr_name;
1574 struct nfs42_removexattrres {
1575 struct nfs4_sequence_res seq_res;
1576 struct nfs4_change_info cinfo;
1579 #endif /* CONFIG_NFS_V4_2 */
1583 #define NFS_PAGEVEC_SIZE (8U)
1585 struct nfs_page_array {
1586 struct page **pagevec;
1587 unsigned int npages; /* Max length of pagevec */
1588 struct page *page_array[NFS_PAGEVEC_SIZE];
1591 /* used as flag bits in nfs_pgio_header */
1593 NFS_IOHDR_ERROR = 0,
1597 NFS_IOHDR_RESEND_PNFS,
1598 NFS_IOHDR_RESEND_MDS,
1601 struct nfs_io_completion;
1602 struct nfs_pgio_header {
1603 struct inode *inode;
1604 const struct cred *cred;
1605 struct list_head pages;
1606 struct nfs_page *req;
1607 struct nfs_writeverf verf; /* Used for writes */
1609 struct pnfs_layout_segment *lseg;
1611 const struct rpc_call_ops *mds_ops;
1612 void (*release) (struct nfs_pgio_header *hdr);
1613 const struct nfs_pgio_completion_ops *completion_ops;
1614 const struct nfs_rw_ops *rw_ops;
1615 struct nfs_io_completion *io_completion;
1616 struct nfs_direct_req *dreq;
1619 int error; /* merge with pnfs_error */
1620 unsigned int good_bytes; /* boundary of good data */
1621 unsigned long flags;
1626 struct rpc_task task;
1627 struct nfs_fattr fattr;
1628 struct nfs_pgio_args args; /* argument struct */
1629 struct nfs_pgio_res res; /* result struct */
1630 unsigned long timestamp; /* For lease renewal */
1631 int (*pgio_done_cb)(struct rpc_task *, struct nfs_pgio_header *);
1632 __u64 mds_offset; /* Filelayout dense stripe */
1633 struct nfs_page_array page_array;
1634 struct nfs_client *ds_clp; /* pNFS data server */
1635 u32 ds_commit_idx; /* ds index if ds_clp is set */
1636 u32 pgio_mirror_idx;/* mirror index in pgio layer */
1639 struct nfs_mds_commit_info {
1641 atomic_long_t ncommit;
1642 struct list_head list;
1645 struct nfs_commit_info;
1646 struct nfs_commit_data;
1648 struct nfs_commit_completion_ops {
1649 void (*completion) (struct nfs_commit_data *data);
1650 void (*resched_write) (struct nfs_commit_info *, struct nfs_page *);
1653 struct nfs_commit_info {
1654 struct inode *inode; /* Needed for inode->i_lock */
1655 struct nfs_mds_commit_info *mds;
1656 struct pnfs_ds_commit_info *ds;
1657 struct nfs_direct_req *dreq; /* O_DIRECT request */
1658 const struct nfs_commit_completion_ops *completion_ops;
1661 struct nfs_commit_data {
1662 struct rpc_task task;
1663 struct inode *inode;
1664 const struct cred *cred;
1665 struct nfs_fattr fattr;
1666 struct nfs_writeverf verf;
1667 struct list_head pages; /* Coalesced requests we wish to flush */
1668 struct list_head list; /* lists of struct nfs_write_data */
1669 struct nfs_direct_req *dreq; /* O_DIRECT request */
1670 struct nfs_commitargs args; /* argument struct */
1671 struct nfs_commitres res; /* result struct */
1672 struct nfs_open_context *context;
1673 struct pnfs_layout_segment *lseg;
1674 struct nfs_client *ds_clp; /* pNFS data server */
1675 int ds_commit_index;
1677 const struct rpc_call_ops *mds_ops;
1678 const struct nfs_commit_completion_ops *completion_ops;
1679 int (*commit_done_cb) (struct rpc_task *task, struct nfs_commit_data *data);
1680 unsigned long flags;
1683 struct nfs_pgio_completion_ops {
1684 void (*error_cleanup)(struct list_head *head, int);
1685 void (*init_hdr)(struct nfs_pgio_header *hdr);
1686 void (*completion)(struct nfs_pgio_header *hdr);
1687 void (*reschedule_io)(struct nfs_pgio_header *hdr);
1690 struct nfs_unlinkdata {
1691 struct nfs_removeargs args;
1692 struct nfs_removeres res;
1693 struct dentry *dentry;
1694 wait_queue_head_t wq;
1695 const struct cred *cred;
1696 struct nfs_fattr dir_attr;
1700 struct nfs_renamedata {
1701 struct nfs_renameargs args;
1702 struct nfs_renameres res;
1703 const struct cred *cred;
1704 struct inode *old_dir;
1705 struct dentry *old_dentry;
1706 struct nfs_fattr old_fattr;
1707 struct inode *new_dir;
1708 struct dentry *new_dentry;
1709 struct nfs_fattr new_fattr;
1710 void (*complete)(struct rpc_task *, struct nfs_renamedata *);
1715 struct nfs_access_entry;
1718 struct nfs_subversion;
1719 struct nfs_mount_info;
1720 struct nfs_client_initdata;
1721 struct nfs_pageio_descriptor;
1725 * RPC procedure vector for NFSv2/NFSv3 demuxing
1727 struct nfs_rpc_ops {
1728 u32 version; /* Protocol version */
1729 const struct dentry_operations *dentry_ops;
1730 const struct inode_operations *dir_inode_ops;
1731 const struct inode_operations *file_inode_ops;
1732 const struct file_operations *file_ops;
1733 const struct nlmclnt_operations *nlmclnt_ops;
1735 int (*getroot) (struct nfs_server *, struct nfs_fh *,
1736 struct nfs_fsinfo *);
1737 int (*submount) (struct fs_context *, struct nfs_server *);
1738 int (*try_get_tree) (struct fs_context *);
1739 int (*getattr) (struct nfs_server *, struct nfs_fh *,
1740 struct nfs_fattr *, struct nfs4_label *,
1742 int (*setattr) (struct dentry *, struct nfs_fattr *,
1744 int (*lookup) (struct inode *, struct dentry *,
1745 struct nfs_fh *, struct nfs_fattr *,
1746 struct nfs4_label *);
1747 int (*lookupp) (struct inode *, struct nfs_fh *,
1748 struct nfs_fattr *, struct nfs4_label *);
1749 int (*access) (struct inode *, struct nfs_access_entry *);
1750 int (*readlink)(struct inode *, struct page *, unsigned int,
1752 int (*create) (struct inode *, struct dentry *,
1753 struct iattr *, int);
1754 int (*remove) (struct inode *, struct dentry *);
1755 void (*unlink_setup) (struct rpc_message *, struct dentry *, struct inode *);
1756 void (*unlink_rpc_prepare) (struct rpc_task *, struct nfs_unlinkdata *);
1757 int (*unlink_done) (struct rpc_task *, struct inode *);
1758 void (*rename_setup) (struct rpc_message *msg,
1759 struct dentry *old_dentry,
1760 struct dentry *new_dentry);
1761 void (*rename_rpc_prepare)(struct rpc_task *task, struct nfs_renamedata *);
1762 int (*rename_done) (struct rpc_task *task, struct inode *old_dir, struct inode *new_dir);
1763 int (*link) (struct inode *, struct inode *, const struct qstr *);
1764 int (*symlink) (struct inode *, struct dentry *, struct page *,
1765 unsigned int, struct iattr *);
1766 int (*mkdir) (struct inode *, struct dentry *, struct iattr *);
1767 int (*rmdir) (struct inode *, const struct qstr *);
1768 int (*readdir) (struct nfs_readdir_arg *, struct nfs_readdir_res *);
1769 int (*mknod) (struct inode *, struct dentry *, struct iattr *,
1771 int (*statfs) (struct nfs_server *, struct nfs_fh *,
1772 struct nfs_fsstat *);
1773 int (*fsinfo) (struct nfs_server *, struct nfs_fh *,
1774 struct nfs_fsinfo *);
1775 int (*pathconf) (struct nfs_server *, struct nfs_fh *,
1776 struct nfs_pathconf *);
1777 int (*set_capabilities)(struct nfs_server *, struct nfs_fh *);
1778 int (*decode_dirent)(struct xdr_stream *, struct nfs_entry *, bool);
1779 int (*pgio_rpc_prepare)(struct rpc_task *,
1780 struct nfs_pgio_header *);
1781 void (*read_setup)(struct nfs_pgio_header *, struct rpc_message *);
1782 int (*read_done)(struct rpc_task *, struct nfs_pgio_header *);
1783 void (*write_setup)(struct nfs_pgio_header *, struct rpc_message *,
1784 struct rpc_clnt **);
1785 int (*write_done)(struct rpc_task *, struct nfs_pgio_header *);
1786 void (*commit_setup) (struct nfs_commit_data *, struct rpc_message *,
1787 struct rpc_clnt **);
1788 void (*commit_rpc_prepare)(struct rpc_task *, struct nfs_commit_data *);
1789 int (*commit_done) (struct rpc_task *, struct nfs_commit_data *);
1790 int (*lock)(struct file *, int, struct file_lock *);
1791 int (*lock_check_bounds)(const struct file_lock *);
1792 void (*clear_acl_cache)(struct inode *);
1793 void (*close_context)(struct nfs_open_context *ctx, int);
1794 struct inode * (*open_context) (struct inode *dir,
1795 struct nfs_open_context *ctx,
1797 struct iattr *iattr,
1799 int (*have_delegation)(struct inode *, fmode_t);
1800 struct nfs_client *(*alloc_client) (const struct nfs_client_initdata *);
1801 struct nfs_client *(*init_client) (struct nfs_client *,
1802 const struct nfs_client_initdata *);
1803 void (*free_client) (struct nfs_client *);
1804 struct nfs_server *(*create_server)(struct fs_context *);
1805 struct nfs_server *(*clone_server)(struct nfs_server *, struct nfs_fh *,
1806 struct nfs_fattr *, rpc_authflavor_t);
1810 * NFS_CALL(getattr, inode, (fattr));
1812 * NFS_PROTO(inode)->getattr(fattr);
1814 #define NFS_CALL(op, inode, args) NFS_PROTO(inode)->op args
1817 * Function vectors etc. for the NFS client
1819 extern const struct nfs_rpc_ops nfs_v2_clientops;
1820 extern const struct nfs_rpc_ops nfs_v3_clientops;
1821 extern const struct nfs_rpc_ops nfs_v4_clientops;
1822 extern const struct rpc_version nfs_version2;
1823 extern const struct rpc_version nfs_version3;
1824 extern const struct rpc_version nfs_version4;
1826 extern const struct rpc_version nfsacl_version3;
1827 extern const struct rpc_program nfsacl_program;