1 #ifndef _LINUX_NFS_XDR_H
2 #define _LINUX_NFS_XDR_H
4 #include <linux/nfsacl.h>
7 * To change the maximum rsize and wsize supported by the NFS client, adjust
8 * NFS_MAX_FILE_IO_SIZE. 64KB is a typical maximum, but some servers can
9 * support a megabyte or more. The default is left at 4096 bytes, which is
10 * reasonable for NFS over UDP.
12 #define NFS_MAX_FILE_IO_SIZE (1048576U)
13 #define NFS_DEF_FILE_IO_SIZE (4096U)
14 #define NFS_MIN_FILE_IO_SIZE (1024U)
22 * Helper for checking equality between 2 fsids.
24 static inline int nfs_fsid_equal(const struct nfs_fsid
*a
, const struct nfs_fsid
*b
)
26 return a
->major
== b
->major
&& a
->minor
== b
->minor
;
30 unsigned short valid
; /* which fields are valid */
31 __u64 pre_size
; /* pre_op_attr.size */
32 struct timespec pre_mtime
; /* pre_op_attr.mtime */
33 struct timespec pre_ctime
; /* pre_op_attr.ctime */
34 enum nfs_ftype type
; /* always use NFSv2 types */
52 struct timespec atime
;
53 struct timespec mtime
;
54 struct timespec ctime
;
55 __u32 bitmap
[2]; /* NFSv4 returned attribute bitmap */
56 __u64 change_attr
; /* NFSv4 change attribute */
57 __u64 pre_change_attr
;/* pre-op NFSv4 change attribute */
58 unsigned long time_start
;
61 #define NFS_ATTR_WCC 0x0001 /* pre-op WCC data */
62 #define NFS_ATTR_FATTR 0x0002 /* post-op attributes */
63 #define NFS_ATTR_FATTR_V3 0x0004 /* NFSv3 attributes */
64 #define NFS_ATTR_FATTR_V4 0x0008 /* NFSv4 change attribute */
65 #define NFS_ATTR_FATTR_V4_REFERRAL 0x0010 /* NFSv4 referral */
68 * Info on the file system
71 struct nfs_fattr
*fattr
; /* Post-op attributes */
72 __u32 rtmax
; /* max. read transfer size */
73 __u32 rtpref
; /* pref. read transfer size */
74 __u32 rtmult
; /* reads should be multiple of this */
75 __u32 wtmax
; /* max. write transfer size */
76 __u32 wtpref
; /* pref. write transfer size */
77 __u32 wtmult
; /* writes should be multiple of this */
78 __u32 dtpref
; /* pref. readdir transfer size */
80 __u32 lease_time
; /* in seconds */
84 struct nfs_fattr
*fattr
; /* Post-op attributes */
85 __u64 tbytes
; /* total size in bytes */
86 __u64 fbytes
; /* # of free bytes */
87 __u64 abytes
; /* # of bytes available to user */
88 __u64 tfiles
; /* # of files */
89 __u64 ffiles
; /* # of free files */
90 __u64 afiles
; /* # of files available to user */
94 __u32 tsize
; /* Server transfer size */
95 __u32 bsize
; /* Filesystem block size */
96 __u32 blocks
; /* No. of "bsize" blocks on filesystem */
97 __u32 bfree
; /* No. of free "bsize" blocks */
98 __u32 bavail
; /* No. of available "bsize" blocks */
101 struct nfs_pathconf
{
102 struct nfs_fattr
*fattr
; /* Post-op attributes */
103 __u32 max_link
; /* max # of hard links */
104 __u32 max_namelen
; /* max name length */
107 struct nfs4_change_info
{
115 * Arguments to the open call.
117 struct nfs_openargs
{
118 const struct nfs_fh
* fh
;
119 struct nfs_seqid
* seqid
;
124 struct iattr
* attrs
; /* UNCHECKED, GUARDED */
125 nfs4_verifier verifier
; /* EXCLUSIVE */
126 nfs4_stateid delegation
; /* CLAIM_DELEGATE_CUR */
127 int delegation_type
; /* CLAIM_PREVIOUS */
129 const struct qstr
* name
;
130 const struct nfs_server
*server
; /* Needed for ID mapping */
136 nfs4_stateid stateid
;
138 struct nfs4_change_info cinfo
;
140 struct nfs_fattr
* f_attr
;
141 struct nfs_fattr
* dir_attr
;
142 const struct nfs_server
*server
;
144 nfs4_stateid delegation
;
150 * Arguments to the open_confirm call.
152 struct nfs_open_confirmargs
{
153 const struct nfs_fh
* fh
;
154 nfs4_stateid
* stateid
;
155 struct nfs_seqid
* seqid
;
158 struct nfs_open_confirmres
{
159 nfs4_stateid stateid
;
163 * Arguments to the close call.
165 struct nfs_closeargs
{
167 nfs4_stateid
* stateid
;
168 struct nfs_seqid
* seqid
;
173 struct nfs_closeres
{
174 nfs4_stateid stateid
;
175 struct nfs_fattr
* fattr
;
176 const struct nfs_server
*server
;
179 * * Arguments to the lock,lockt, and locku call.
186 struct nfs_lock_args
{
188 struct file_lock
* fl
;
189 struct nfs_seqid
* lock_seqid
;
190 nfs4_stateid
* lock_stateid
;
191 struct nfs_seqid
* open_seqid
;
192 nfs4_stateid
* open_stateid
;
193 struct nfs_lowner lock_owner
;
194 unsigned char block
: 1;
195 unsigned char reclaim
: 1;
196 unsigned char new_lock_owner
: 1;
199 struct nfs_lock_res
{
200 nfs4_stateid stateid
;
203 struct nfs_locku_args
{
205 struct file_lock
* fl
;
206 struct nfs_seqid
* seqid
;
207 nfs4_stateid
* stateid
;
210 struct nfs_locku_res
{
211 nfs4_stateid stateid
;
214 struct nfs_lockt_args
{
216 struct file_lock
* fl
;
217 struct nfs_lowner lock_owner
;
220 struct nfs_lockt_res
{
221 struct file_lock
* denied
; /* LOCK, LOCKT failed */
224 struct nfs4_delegreturnargs
{
225 const struct nfs_fh
*fhandle
;
226 const nfs4_stateid
*stateid
;
230 struct nfs4_delegreturnres
{
231 struct nfs_fattr
* fattr
;
232 const struct nfs_server
*server
;
236 * Arguments to the read call.
238 struct nfs_readargs
{
240 struct nfs_open_context
*context
;
244 struct page
** pages
;
248 struct nfs_fattr
* fattr
;
254 * Arguments to the write call.
256 struct nfs_writeargs
{
258 struct nfs_open_context
*context
;
261 enum nfs3_stable_how stable
;
263 struct page
** pages
;
267 struct nfs_writeverf
{
268 enum nfs3_stable_how committed
;
272 struct nfs_writeres
{
273 struct nfs_fattr
* fattr
;
274 struct nfs_writeverf
* verf
;
276 const struct nfs_server
*server
;
280 * Argument struct for decode_entry function
290 struct nfs_fattr
* fattr
;
294 * The following types are for NFSv2 only.
296 struct nfs_sattrargs
{
298 struct iattr
* sattr
;
301 struct nfs_diropargs
{
307 struct nfs_createargs
{
311 struct iattr
* sattr
;
314 struct nfs_renameargs
{
315 struct nfs_fh
* fromfh
;
316 const char * fromname
;
317 unsigned int fromlen
;
318 struct nfs_fh
* tofh
;
323 struct nfs_setattrargs
{
325 nfs4_stateid stateid
;
327 const struct nfs_server
* server
; /* Needed for name mapping */
331 struct nfs_setaclargs
{
334 unsigned int acl_pgbase
;
335 struct page
** acl_pages
;
338 struct nfs_getaclargs
{
341 unsigned int acl_pgbase
;
342 struct page
** acl_pages
;
345 struct nfs_setattrres
{
346 struct nfs_fattr
* fattr
;
347 const struct nfs_server
* server
;
350 struct nfs_linkargs
{
351 struct nfs_fh
* fromfh
;
352 struct nfs_fh
* tofh
;
357 struct nfs_symlinkargs
{
358 struct nfs_fh
* fromfh
;
359 const char * fromname
;
360 unsigned int fromlen
;
361 struct page
** pages
;
362 unsigned int pathlen
;
363 struct iattr
* sattr
;
366 struct nfs_readdirargs
{
370 struct page
** pages
;
373 struct nfs3_getaclargs
{
376 struct page
** pages
;
379 struct nfs3_setaclargs
{
380 struct inode
* inode
;
382 struct posix_acl
* acl_access
;
383 struct posix_acl
* acl_default
;
384 struct page
** pages
;
389 struct nfs_fattr
* fattr
;
392 struct nfs_readlinkargs
{
396 struct page
** pages
;
399 struct nfs3_sattrargs
{
401 struct iattr
* sattr
;
403 struct timespec guardtime
;
406 struct nfs3_diropargs
{
412 struct nfs3_accessargs
{
417 struct nfs3_createargs
{
421 struct iattr
* sattr
;
422 enum nfs3_createmode createmode
;
426 struct nfs3_mkdirargs
{
430 struct iattr
* sattr
;
433 struct nfs3_symlinkargs
{
434 struct nfs_fh
* fromfh
;
435 const char * fromname
;
436 unsigned int fromlen
;
437 struct page
** pages
;
438 unsigned int pathlen
;
439 struct iattr
* sattr
;
442 struct nfs3_mknodargs
{
446 enum nfs3_ftype type
;
447 struct iattr
* sattr
;
451 struct nfs3_renameargs
{
452 struct nfs_fh
* fromfh
;
453 const char * fromname
;
454 unsigned int fromlen
;
455 struct nfs_fh
* tofh
;
460 struct nfs3_linkargs
{
461 struct nfs_fh
* fromfh
;
462 struct nfs_fh
* tofh
;
467 struct nfs3_readdirargs
{
473 struct page
** pages
;
476 struct nfs3_diropres
{
477 struct nfs_fattr
* dir_attr
;
479 struct nfs_fattr
* fattr
;
482 struct nfs3_accessres
{
483 struct nfs_fattr
* fattr
;
487 struct nfs3_readlinkargs
{
491 struct page
** pages
;
494 struct nfs3_renameres
{
495 struct nfs_fattr
* fromattr
;
496 struct nfs_fattr
* toattr
;
499 struct nfs3_linkres
{
500 struct nfs_fattr
* dir_attr
;
501 struct nfs_fattr
* fattr
;
504 struct nfs3_readdirres
{
505 struct nfs_fattr
* dir_attr
;
510 struct nfs3_getaclres
{
511 struct nfs_fattr
* fattr
;
513 unsigned int acl_access_count
;
514 unsigned int acl_default_count
;
515 struct posix_acl
* acl_access
;
516 struct posix_acl
* acl_default
;
521 typedef u64 clientid4
;
523 struct nfs4_accessargs
{
524 const struct nfs_fh
* fh
;
528 struct nfs4_accessres
{
533 struct nfs4_create_arg
{
537 struct page
** pages
;
539 } symlink
; /* NF4LNK */
543 } device
; /* NF4BLK, NF4CHR */
545 const struct qstr
* name
;
546 const struct nfs_server
* server
;
547 const struct iattr
* attrs
;
548 const struct nfs_fh
* dir_fh
;
552 struct nfs4_create_res
{
553 const struct nfs_server
* server
;
555 struct nfs_fattr
* fattr
;
556 struct nfs4_change_info dir_cinfo
;
557 struct nfs_fattr
* dir_fattr
;
560 struct nfs4_fsinfo_arg
{
561 const struct nfs_fh
* fh
;
565 struct nfs4_getattr_arg
{
566 const struct nfs_fh
* fh
;
570 struct nfs4_getattr_res
{
571 const struct nfs_server
* server
;
572 struct nfs_fattr
* fattr
;
575 struct nfs4_link_arg
{
576 const struct nfs_fh
* fh
;
577 const struct nfs_fh
* dir_fh
;
578 const struct qstr
* name
;
582 struct nfs4_link_res
{
583 const struct nfs_server
* server
;
584 struct nfs_fattr
* fattr
;
585 struct nfs4_change_info cinfo
;
586 struct nfs_fattr
* dir_attr
;
590 struct nfs4_lookup_arg
{
591 const struct nfs_fh
* dir_fh
;
592 const struct qstr
* name
;
596 struct nfs4_lookup_res
{
597 const struct nfs_server
* server
;
598 struct nfs_fattr
* fattr
;
602 struct nfs4_lookup_root_arg
{
606 struct nfs4_pathconf_arg
{
607 const struct nfs_fh
* fh
;
611 struct nfs4_readdir_arg
{
612 const struct nfs_fh
* fh
;
614 nfs4_verifier verifier
;
616 struct page
** pages
; /* zero-copy data */
617 unsigned int pgbase
; /* zero-copy data */
621 struct nfs4_readdir_res
{
622 nfs4_verifier verifier
;
626 struct nfs4_readlink
{
627 const struct nfs_fh
* fh
;
629 unsigned int pglen
; /* zero-copy data */
630 struct page
** pages
; /* zero-copy data */
633 struct nfs4_remove_arg
{
634 const struct nfs_fh
* fh
;
635 const struct qstr
* name
;
639 struct nfs4_remove_res
{
640 const struct nfs_server
* server
;
641 struct nfs4_change_info cinfo
;
642 struct nfs_fattr
* dir_attr
;
645 struct nfs4_rename_arg
{
646 const struct nfs_fh
* old_dir
;
647 const struct nfs_fh
* new_dir
;
648 const struct qstr
* old_name
;
649 const struct qstr
* new_name
;
653 struct nfs4_rename_res
{
654 const struct nfs_server
* server
;
655 struct nfs4_change_info old_cinfo
;
656 struct nfs_fattr
* old_fattr
;
657 struct nfs4_change_info new_cinfo
;
658 struct nfs_fattr
* new_fattr
;
661 struct nfs4_setclientid
{
662 const nfs4_verifier
* sc_verifier
; /* request */
663 unsigned int sc_name_len
;
664 char sc_name
[48]; /* request */
665 u32 sc_prog
; /* request */
666 unsigned int sc_netid_len
;
667 char sc_netid
[4]; /* request */
668 unsigned int sc_uaddr_len
;
669 char sc_uaddr
[24]; /* request */
670 u32 sc_cb_ident
; /* request */
673 struct nfs4_statfs_arg
{
674 const struct nfs_fh
* fh
;
678 struct nfs4_server_caps_res
{
690 #define NFS4_PATHNAME_MAXCOMPONENTS 512
691 struct nfs4_pathname
{
692 unsigned int ncomponents
;
693 struct nfs4_string components
[NFS4_PATHNAME_MAXCOMPONENTS
];
696 #define NFS4_FS_LOCATION_MAXSERVERS 10
697 struct nfs4_fs_location
{
698 unsigned int nservers
;
699 struct nfs4_string servers
[NFS4_FS_LOCATION_MAXSERVERS
];
700 struct nfs4_pathname rootpath
;
703 #define NFS4_FS_LOCATIONS_MAXENTRIES 10
704 struct nfs4_fs_locations
{
705 struct nfs_fattr fattr
;
706 const struct nfs_server
*server
;
707 struct nfs4_pathname fs_path
;
709 struct nfs4_fs_location locations
[NFS4_FS_LOCATIONS_MAXENTRIES
];
712 struct nfs4_fs_locations_arg
{
713 const struct nfs_fh
*dir_fh
;
714 const struct qstr
*name
;
719 #endif /* CONFIG_NFS_V4 */
723 #define NFS_PAGEVEC_SIZE (8U)
725 struct nfs_read_data
{
727 struct rpc_task task
;
729 struct rpc_cred
*cred
;
730 struct nfs_fattr fattr
; /* fattr storage */
731 struct list_head pages
; /* Coalesced read requests */
732 struct nfs_page
*req
; /* multi ops per nfs_page */
733 struct page
**pagevec
;
734 unsigned int npages
; /* Max length of pagevec */
735 struct nfs_readargs args
;
736 struct nfs_readres res
;
738 unsigned long timestamp
; /* For lease renewal */
740 struct page
*page_array
[NFS_PAGEVEC_SIZE
];
743 struct nfs_write_data
{
745 struct rpc_task task
;
747 struct rpc_cred
*cred
;
748 struct nfs_fattr fattr
;
749 struct nfs_writeverf verf
;
750 struct list_head pages
; /* Coalesced requests we wish to flush */
751 struct nfs_page
*req
; /* multi ops per nfs_page */
752 struct page
**pagevec
;
753 unsigned int npages
; /* Max length of pagevec */
754 struct nfs_writeargs args
; /* argument struct */
755 struct nfs_writeres res
; /* result struct */
757 unsigned long timestamp
; /* For lease renewal */
759 struct page
*page_array
[NFS_PAGEVEC_SIZE
];
762 struct nfs_access_entry
;
765 * RPC procedure vector for NFSv2/NFSv3 demuxing
768 int version
; /* Protocol version */
769 struct dentry_operations
*dentry_ops
;
770 struct inode_operations
*dir_inode_ops
;
771 struct inode_operations
*file_inode_ops
;
773 int (*getroot
) (struct nfs_server
*, struct nfs_fh
*,
774 struct nfs_fsinfo
*);
775 int (*lookupfh
)(struct nfs_server
*, struct nfs_fh
*,
776 struct qstr
*, struct nfs_fh
*,
778 int (*getattr
) (struct nfs_server
*, struct nfs_fh
*,
780 int (*setattr
) (struct dentry
*, struct nfs_fattr
*,
782 int (*lookup
) (struct inode
*, struct qstr
*,
783 struct nfs_fh
*, struct nfs_fattr
*);
784 int (*access
) (struct inode
*, struct nfs_access_entry
*);
785 int (*readlink
)(struct inode
*, struct page
*, unsigned int,
787 int (*read
) (struct nfs_read_data
*);
788 int (*write
) (struct nfs_write_data
*);
789 int (*commit
) (struct nfs_write_data
*);
790 int (*create
) (struct inode
*, struct dentry
*,
791 struct iattr
*, int, struct nameidata
*);
792 int (*remove
) (struct inode
*, struct qstr
*);
793 int (*unlink_setup
) (struct rpc_message
*,
794 struct dentry
*, struct qstr
*);
795 int (*unlink_done
) (struct dentry
*, struct rpc_task
*);
796 int (*rename
) (struct inode
*, struct qstr
*,
797 struct inode
*, struct qstr
*);
798 int (*link
) (struct inode
*, struct inode
*, struct qstr
*);
799 int (*symlink
) (struct inode
*, struct dentry
*, struct page
*,
800 unsigned int, struct iattr
*);
801 int (*mkdir
) (struct inode
*, struct dentry
*, struct iattr
*);
802 int (*rmdir
) (struct inode
*, struct qstr
*);
803 int (*readdir
) (struct dentry
*, struct rpc_cred
*,
804 u64
, struct page
*, unsigned int, int);
805 int (*mknod
) (struct inode
*, struct dentry
*, struct iattr
*,
807 int (*statfs
) (struct nfs_server
*, struct nfs_fh
*,
808 struct nfs_fsstat
*);
809 int (*fsinfo
) (struct nfs_server
*, struct nfs_fh
*,
810 struct nfs_fsinfo
*);
811 int (*pathconf
) (struct nfs_server
*, struct nfs_fh
*,
812 struct nfs_pathconf
*);
813 int (*set_capabilities
)(struct nfs_server
*, struct nfs_fh
*);
814 u32
* (*decode_dirent
)(u32
*, struct nfs_entry
*, int plus
);
815 void (*read_setup
) (struct nfs_read_data
*);
816 int (*read_done
) (struct rpc_task
*, struct nfs_read_data
*);
817 void (*write_setup
) (struct nfs_write_data
*, int how
);
818 int (*write_done
) (struct rpc_task
*, struct nfs_write_data
*);
819 void (*commit_setup
) (struct nfs_write_data
*, int how
);
820 int (*commit_done
) (struct rpc_task
*, struct nfs_write_data
*);
821 int (*file_open
) (struct inode
*, struct file
*);
822 int (*file_release
) (struct inode
*, struct file
*);
823 int (*lock
)(struct file
*, int, struct file_lock
*);
824 void (*clear_acl_cache
)(struct inode
*);
828 * NFS_CALL(getattr, inode, (fattr));
830 * NFS_PROTO(inode)->getattr(fattr);
832 #define NFS_CALL(op, inode, args) NFS_PROTO(inode)->op args
835 * Function vectors etc. for the NFS client
837 extern const struct nfs_rpc_ops nfs_v2_clientops
;
838 extern const struct nfs_rpc_ops nfs_v3_clientops
;
839 extern const struct nfs_rpc_ops nfs_v4_clientops
;
840 extern struct rpc_version nfs_version2
;
841 extern struct rpc_version nfs_version3
;
842 extern struct rpc_version nfs_version4
;
844 extern struct rpc_version nfsacl_version3
;
845 extern struct rpc_program nfsacl_program
;