2 * NFS internal definitions
6 #include <linux/mount.h>
7 #include <linux/security.h>
8 #include <linux/crc32.h>
10 #define NFS_MS_MASK (MS_RDONLY|MS_NOSUID|MS_NODEV|MS_NOEXEC|MS_SYNCHRONOUS)
14 /* Maximum number of readahead requests
15 * FIXME: this should really be a sysctl so that users may tune it to suit
16 * their needs. People that do NFS over a slow network, might for
17 * instance want to reduce it to something closer to 1 for improved
18 * interactive response.
20 #define NFS_MAX_READAHEAD (RPC_DEF_SLOT_TABLE - 1)
22 static inline void nfs_attr_check_mountpoint(struct super_block
*parent
, struct nfs_fattr
*fattr
)
24 if (!nfs_fsid_equal(&NFS_SB(parent
)->fsid
, &fattr
->fsid
))
25 fattr
->valid
|= NFS_ATTR_FATTR_MOUNTPOINT
;
28 static inline int nfs_attr_use_mounted_on_fileid(struct nfs_fattr
*fattr
)
30 if (((fattr
->valid
& NFS_ATTR_FATTR_MOUNTED_ON_FILEID
) == 0) ||
31 (((fattr
->valid
& NFS_ATTR_FATTR_MOUNTPOINT
) == 0) &&
32 ((fattr
->valid
& NFS_ATTR_FATTR_V4_REFERRAL
) == 0)))
35 fattr
->fileid
= fattr
->mounted_on_fileid
;
39 struct nfs_clone_mount
{
40 const struct super_block
*sb
;
41 const struct dentry
*dentry
;
43 struct nfs_fattr
*fattr
;
46 struct sockaddr
*addr
;
48 rpc_authflavor_t authflavor
;
52 * Note: RFC 1813 doesn't limit the number of auth flavors that
53 * a server can return, so make something up.
55 #define NFS_MAX_SECFLAVORS (12)
58 * Value used if the user did not specify a port value.
60 #define NFS_UNSPEC_PORT (-1)
63 * Maximum number of pages that readdir can use for creating
64 * a vmapped array of pages.
66 #define NFS_MAX_READDIR_PAGES 8
68 struct nfs_client_initdata
{
69 unsigned long init_flags
;
71 const struct sockaddr
*addr
;
73 struct nfs_subversion
*nfs_mod
;
80 * In-kernel mount arguments
82 struct nfs_parsed_mount_data
{
84 unsigned int rsize
, wsize
;
85 unsigned int timeo
, retrans
;
86 unsigned int acregmin
, acregmax
,
91 unsigned int auth_flavor_len
;
92 rpc_authflavor_t auth_flavors
[1];
95 unsigned int minorversion
;
100 struct sockaddr_storage address
;
105 unsigned short protocol
;
109 struct sockaddr_storage address
;
114 unsigned short protocol
;
117 struct security_mnt_opts lsm_opts
;
122 struct nfs_mount_request
{
123 struct sockaddr
*sap
;
128 unsigned short protocol
;
131 unsigned int *auth_flav_len
;
132 rpc_authflavor_t
*auth_flavs
;
136 struct nfs_mount_info
{
137 void (*fill_super
)(struct super_block
*, struct nfs_mount_info
*);
138 int (*set_security
)(struct super_block
*, struct dentry
*, struct nfs_mount_info
*);
139 struct nfs_parsed_mount_data
*parsed
;
140 struct nfs_clone_mount
*cloned
;
141 struct nfs_fh
*mntfh
;
144 extern int nfs_mount(struct nfs_mount_request
*info
);
145 extern void nfs_umount(const struct nfs_mount_request
*info
);
148 extern const struct rpc_program nfs_program
;
149 extern void nfs_clients_init(struct net
*net
);
150 extern struct nfs_client
*nfs_alloc_client(const struct nfs_client_initdata
*);
151 int nfs_create_rpc_client(struct nfs_client
*, const struct rpc_timeout
*, rpc_authflavor_t
);
152 struct nfs_client
*nfs_get_client(const struct nfs_client_initdata
*,
153 const struct rpc_timeout
*, const char *,
155 int nfs_probe_fsinfo(struct nfs_server
*server
, struct nfs_fh
*, struct nfs_fattr
*);
156 void nfs_server_insert_lists(struct nfs_server
*);
157 void nfs_init_timeout_values(struct rpc_timeout
*, int, unsigned int, unsigned int);
158 int nfs_init_server_rpcclient(struct nfs_server
*, const struct rpc_timeout
*t
,
160 struct nfs_server
*nfs_alloc_server(void);
161 void nfs_server_copy_userdata(struct nfs_server
*, struct nfs_server
*);
163 extern void nfs_cleanup_cb_ident_idr(struct net
*);
164 extern void nfs_put_client(struct nfs_client
*);
165 extern void nfs_free_client(struct nfs_client
*);
166 extern struct nfs_client
*nfs4_find_client_ident(struct net
*, int);
167 extern struct nfs_client
*
168 nfs4_find_client_sessionid(struct net
*, const struct sockaddr
*,
169 struct nfs4_sessionid
*, u32
);
170 extern struct nfs_server
*nfs_create_server(struct nfs_mount_info
*,
171 struct nfs_subversion
*);
172 extern struct nfs_server
*nfs4_create_server(
173 struct nfs_mount_info
*,
174 struct nfs_subversion
*);
175 extern struct nfs_server
*nfs4_create_referral_server(struct nfs_clone_mount
*,
177 extern void nfs_free_server(struct nfs_server
*server
);
178 extern struct nfs_server
*nfs_clone_server(struct nfs_server
*,
182 extern int nfs_wait_client_init_complete(const struct nfs_client
*clp
);
183 extern void nfs_mark_client_ready(struct nfs_client
*clp
, int state
);
184 extern struct nfs_client
*nfs4_set_ds_client(struct nfs_client
* mds_clp
,
185 const struct sockaddr
*ds_addr
,
186 int ds_addrlen
, int ds_proto
,
187 unsigned int ds_timeo
,
188 unsigned int ds_retrans
);
189 extern struct rpc_clnt
*nfs4_find_or_create_ds_client(struct nfs_client
*,
191 #ifdef CONFIG_PROC_FS
192 extern int __init
nfs_fs_proc_init(void);
193 extern void nfs_fs_proc_exit(void);
195 static inline int nfs_fs_proc_init(void)
199 static inline void nfs_fs_proc_exit(void)
204 #ifdef CONFIG_NFS_V4_1
205 int nfs_sockaddr_match_ipaddr(const struct sockaddr
*, const struct sockaddr
*);
209 #if IS_ENABLED(CONFIG_NFS_V3)
210 struct nfs_server
*nfs3_create_server(struct nfs_mount_info
*, struct nfs_subversion
*);
211 struct nfs_server
*nfs3_clone_server(struct nfs_server
*, struct nfs_fh
*,
212 struct nfs_fattr
*, rpc_authflavor_t
);
216 extern struct svc_version nfs4_callback_version1
;
217 extern struct svc_version nfs4_callback_version4
;
219 struct nfs_pageio_descriptor
;
221 extern int __init
nfs_init_nfspagecache(void);
222 extern void nfs_destroy_nfspagecache(void);
223 extern int __init
nfs_init_readpagecache(void);
224 extern void nfs_destroy_readpagecache(void);
225 extern int __init
nfs_init_writepagecache(void);
226 extern void nfs_destroy_writepagecache(void);
228 extern int __init
nfs_init_directcache(void);
229 extern void nfs_destroy_directcache(void);
230 extern bool nfs_pgarray_set(struct nfs_page_array
*p
, unsigned int pagecount
);
231 extern void nfs_pgheader_init(struct nfs_pageio_descriptor
*desc
,
232 struct nfs_pgio_header
*hdr
,
233 void (*release
)(struct nfs_pgio_header
*hdr
));
234 void nfs_set_pgio_error(struct nfs_pgio_header
*hdr
, int error
, loff_t pos
);
235 int nfs_iocounter_wait(struct nfs_io_counter
*c
);
237 static inline void nfs_iocounter_init(struct nfs_io_counter
*c
)
240 atomic_set(&c
->io_count
, 0);
244 extern struct rpc_procinfo nfs_procedures
[];
245 extern int nfs2_decode_dirent(struct xdr_stream
*,
246 struct nfs_entry
*, int);
249 extern struct rpc_procinfo nfs3_procedures
[];
250 extern int nfs3_decode_dirent(struct xdr_stream
*,
251 struct nfs_entry
*, int);
254 #if IS_ENABLED(CONFIG_NFS_V4)
255 extern int nfs4_decode_dirent(struct xdr_stream
*,
256 struct nfs_entry
*, int);
258 #ifdef CONFIG_NFS_V4_1
259 extern const u32 nfs41_maxread_overhead
;
260 extern const u32 nfs41_maxwrite_overhead
;
261 extern const u32 nfs41_maxgetdevinfo_overhead
;
265 #if IS_ENABLED(CONFIG_NFS_V4)
266 extern struct rpc_procinfo nfs4_procedures
[];
270 void nfs_close_context(struct nfs_open_context
*ctx
, int is_sync
);
271 extern struct nfs_client
*nfs_init_client(struct nfs_client
*clp
,
272 const struct rpc_timeout
*timeparms
,
273 const char *ip_addr
);
276 extern int nfs_access_cache_shrinker(struct shrinker
*shrink
,
277 struct shrink_control
*sc
);
278 struct dentry
*nfs_lookup(struct inode
*, struct dentry
*, unsigned int);
279 int nfs_create(struct inode
*, struct dentry
*, umode_t
, bool);
280 int nfs_mkdir(struct inode
*, struct dentry
*, umode_t
);
281 int nfs_rmdir(struct inode
*, struct dentry
*);
282 int nfs_unlink(struct inode
*, struct dentry
*);
283 int nfs_symlink(struct inode
*, struct dentry
*, const char *);
284 int nfs_link(struct dentry
*, struct inode
*, struct dentry
*);
285 int nfs_mknod(struct inode
*, struct dentry
*, umode_t
, dev_t
);
286 int nfs_rename(struct inode
*, struct dentry
*, struct inode
*, struct dentry
*);
289 int nfs_file_fsync_commit(struct file
*, loff_t
, loff_t
, int);
290 loff_t
nfs_file_llseek(struct file
*, loff_t
, int);
291 int nfs_file_flush(struct file
*, fl_owner_t
);
292 ssize_t
nfs_file_read(struct kiocb
*, const struct iovec
*, unsigned long, loff_t
);
293 ssize_t
nfs_file_splice_read(struct file
*, loff_t
*, struct pipe_inode_info
*,
294 size_t, unsigned int);
295 int nfs_file_mmap(struct file
*, struct vm_area_struct
*);
296 ssize_t
nfs_file_write(struct kiocb
*, const struct iovec
*, unsigned long, loff_t
);
297 int nfs_file_release(struct inode
*, struct file
*);
298 int nfs_lock(struct file
*, int, struct file_lock
*);
299 int nfs_flock(struct file
*, int, struct file_lock
*);
300 ssize_t
nfs_file_splice_write(struct pipe_inode_info
*, struct file
*, loff_t
*,
301 size_t, unsigned int);
302 int nfs_check_flags(int);
303 int nfs_setlease(struct file
*, long, struct file_lock
**);
306 extern struct workqueue_struct
*nfsiod_workqueue
;
307 extern struct inode
*nfs_alloc_inode(struct super_block
*sb
);
308 extern void nfs_destroy_inode(struct inode
*);
309 extern int nfs_write_inode(struct inode
*, struct writeback_control
*);
310 extern int nfs_drop_inode(struct inode
*);
311 extern void nfs_clear_inode(struct inode
*);
312 extern void nfs_evict_inode(struct inode
*);
313 void nfs_zap_acl_cache(struct inode
*inode
);
314 extern int nfs_wait_bit_killable(void *word
);
317 extern const struct super_operations nfs_sops
;
318 extern struct file_system_type nfs_fs_type
;
319 extern struct file_system_type nfs_xdev_fs_type
;
320 #if IS_ENABLED(CONFIG_NFS_V4)
321 extern struct file_system_type nfs4_xdev_fs_type
;
322 extern struct file_system_type nfs4_referral_fs_type
;
324 struct dentry
*nfs_try_mount(int, const char *, struct nfs_mount_info
*,
325 struct nfs_subversion
*);
326 void nfs_initialise_sb(struct super_block
*);
327 int nfs_set_sb_security(struct super_block
*, struct dentry
*, struct nfs_mount_info
*);
328 int nfs_clone_sb_security(struct super_block
*, struct dentry
*, struct nfs_mount_info
*);
329 struct dentry
*nfs_fs_mount_common(struct nfs_server
*, int, const char *,
330 struct nfs_mount_info
*, struct nfs_subversion
*);
331 struct dentry
*nfs_fs_mount(struct file_system_type
*, int, const char *, void *);
332 struct dentry
* nfs_xdev_mount_common(struct file_system_type
*, int,
333 const char *, struct nfs_mount_info
*);
334 void nfs_kill_super(struct super_block
*);
335 void nfs_fill_super(struct super_block
*, struct nfs_mount_info
*);
337 extern struct rpc_stat nfs_rpcstat
;
339 extern int __init
register_nfs_fs(void);
340 extern void __exit
unregister_nfs_fs(void);
341 extern void nfs_sb_active(struct super_block
*sb
);
342 extern void nfs_sb_deactive(struct super_block
*sb
);
345 #define NFS_PATH_CANONICAL 1
346 extern char *nfs_path(char **p
, struct dentry
*dentry
,
347 char *buffer
, ssize_t buflen
, unsigned flags
);
348 extern struct vfsmount
*nfs_d_automount(struct path
*path
);
349 struct vfsmount
*nfs_submount(struct nfs_server
*, struct dentry
*,
350 struct nfs_fh
*, struct nfs_fattr
*);
351 struct vfsmount
*nfs_do_submount(struct dentry
*, struct nfs_fh
*,
352 struct nfs_fattr
*, rpc_authflavor_t
);
355 extern struct dentry
*nfs_get_root(struct super_block
*, struct nfs_fh
*,
357 #if IS_ENABLED(CONFIG_NFS_V4)
358 extern struct dentry
*nfs4_get_root(struct super_block
*, struct nfs_fh
*,
361 extern int nfs4_get_rootfh(struct nfs_server
*server
, struct nfs_fh
*mntfh
, bool);
364 struct nfs_pgio_completion_ops
;
366 extern struct nfs_read_header
*nfs_readhdr_alloc(void);
367 extern void nfs_readhdr_free(struct nfs_pgio_header
*hdr
);
368 extern void nfs_pageio_init_read(struct nfs_pageio_descriptor
*pgio
,
370 const struct nfs_pgio_completion_ops
*compl_ops
);
371 extern int nfs_initiate_read(struct rpc_clnt
*clnt
,
372 struct nfs_read_data
*data
,
373 const struct rpc_call_ops
*call_ops
, int flags
);
374 extern void nfs_read_prepare(struct rpc_task
*task
, void *calldata
);
375 extern int nfs_generic_pagein(struct nfs_pageio_descriptor
*desc
,
376 struct nfs_pgio_header
*hdr
);
377 extern void nfs_pageio_reset_read_mds(struct nfs_pageio_descriptor
*pgio
);
378 extern void nfs_readdata_release(struct nfs_read_data
*rdata
);
381 void nfs_clone_super(struct super_block
*, struct nfs_mount_info
*);
382 void nfs_umount_begin(struct super_block
*);
383 int nfs_statfs(struct dentry
*, struct kstatfs
*);
384 int nfs_show_options(struct seq_file
*, struct dentry
*);
385 int nfs_show_devname(struct seq_file
*, struct dentry
*);
386 int nfs_show_path(struct seq_file
*, struct dentry
*);
387 int nfs_show_stats(struct seq_file
*, struct dentry
*);
388 void nfs_put_super(struct super_block
*);
389 int nfs_remount(struct super_block
*sb
, int *flags
, char *raw_data
);
392 extern void nfs_pageio_init_write(struct nfs_pageio_descriptor
*pgio
,
393 struct inode
*inode
, int ioflags
,
394 const struct nfs_pgio_completion_ops
*compl_ops
);
395 extern struct nfs_write_header
*nfs_writehdr_alloc(void);
396 extern void nfs_writehdr_free(struct nfs_pgio_header
*hdr
);
397 extern int nfs_generic_flush(struct nfs_pageio_descriptor
*desc
,
398 struct nfs_pgio_header
*hdr
);
399 extern void nfs_pageio_reset_write_mds(struct nfs_pageio_descriptor
*pgio
);
400 extern void nfs_writedata_release(struct nfs_write_data
*wdata
);
401 extern void nfs_commit_free(struct nfs_commit_data
*p
);
402 extern int nfs_initiate_write(struct rpc_clnt
*clnt
,
403 struct nfs_write_data
*data
,
404 const struct rpc_call_ops
*call_ops
,
406 extern void nfs_write_prepare(struct rpc_task
*task
, void *calldata
);
407 extern void nfs_commit_prepare(struct rpc_task
*task
, void *calldata
);
408 extern int nfs_initiate_commit(struct rpc_clnt
*clnt
,
409 struct nfs_commit_data
*data
,
410 const struct rpc_call_ops
*call_ops
,
412 extern void nfs_init_commit(struct nfs_commit_data
*data
,
413 struct list_head
*head
,
414 struct pnfs_layout_segment
*lseg
,
415 struct nfs_commit_info
*cinfo
);
416 int nfs_scan_commit_list(struct list_head
*src
, struct list_head
*dst
,
417 struct nfs_commit_info
*cinfo
, int max
);
418 int nfs_scan_commit(struct inode
*inode
, struct list_head
*dst
,
419 struct nfs_commit_info
*cinfo
);
420 void nfs_mark_request_commit(struct nfs_page
*req
,
421 struct pnfs_layout_segment
*lseg
,
422 struct nfs_commit_info
*cinfo
);
423 int nfs_generic_commit_list(struct inode
*inode
, struct list_head
*head
,
424 int how
, struct nfs_commit_info
*cinfo
);
425 void nfs_retry_commit(struct list_head
*page_list
,
426 struct pnfs_layout_segment
*lseg
,
427 struct nfs_commit_info
*cinfo
);
428 void nfs_commitdata_release(struct nfs_commit_data
*data
);
429 void nfs_request_add_commit_list(struct nfs_page
*req
, struct list_head
*dst
,
430 struct nfs_commit_info
*cinfo
);
431 void nfs_request_remove_commit_list(struct nfs_page
*req
,
432 struct nfs_commit_info
*cinfo
);
433 void nfs_init_cinfo(struct nfs_commit_info
*cinfo
,
435 struct nfs_direct_req
*dreq
);
436 int nfs_key_timeout_notify(struct file
*filp
, struct inode
*inode
);
437 bool nfs_ctx_key_to_expire(struct nfs_open_context
*ctx
);
439 #ifdef CONFIG_MIGRATION
440 extern int nfs_migrate_page(struct address_space
*,
441 struct page
*, struct page
*, enum migrate_mode
);
443 #define nfs_migrate_page NULL
447 void nfs_init_cinfo_from_dreq(struct nfs_commit_info
*cinfo
,
448 struct nfs_direct_req
*dreq
);
449 static inline void nfs_inode_dio_wait(struct inode
*inode
)
451 inode_dio_wait(inode
);
453 extern ssize_t
nfs_dreq_bytes_left(struct nfs_direct_req
*dreq
);
456 extern void __nfs4_read_done_cb(struct nfs_read_data
*);
457 extern struct nfs_client
*nfs4_init_client(struct nfs_client
*clp
,
458 const struct rpc_timeout
*timeparms
,
459 const char *ip_addr
);
460 extern int nfs40_walk_client_list(struct nfs_client
*clp
,
461 struct nfs_client
**result
,
462 struct rpc_cred
*cred
);
463 extern int nfs41_walk_client_list(struct nfs_client
*clp
,
464 struct nfs_client
**result
,
465 struct rpc_cred
*cred
);
468 * Determine the device name as a string
470 static inline char *nfs_devname(struct dentry
*dentry
,
471 char *buffer
, ssize_t buflen
)
474 return nfs_path(&dummy
, dentry
, buffer
, buflen
, NFS_PATH_CANONICAL
);
478 * Determine the actual block size (and log2 thereof)
481 unsigned long nfs_block_bits(unsigned long bsize
, unsigned char *nrbitsp
)
483 /* make sure blocksize is a power of two */
484 if ((bsize
& (bsize
- 1)) || nrbitsp
) {
485 unsigned char nrbits
;
487 for (nrbits
= 31; nrbits
&& !(bsize
& (1 << nrbits
)); nrbits
--)
498 * Calculate the number of 512byte blocks used.
500 static inline blkcnt_t
nfs_calc_block_size(u64 tsize
)
502 blkcnt_t used
= (tsize
+ 511) >> 9;
503 return (used
> ULONG_MAX
) ? ULONG_MAX
: used
;
507 * Compute and set NFS server blocksize
510 unsigned long nfs_block_size(unsigned long bsize
, unsigned char *nrbitsp
)
512 if (bsize
< NFS_MIN_FILE_IO_SIZE
)
513 bsize
= NFS_DEF_FILE_IO_SIZE
;
514 else if (bsize
>= NFS_MAX_FILE_IO_SIZE
)
515 bsize
= NFS_MAX_FILE_IO_SIZE
;
517 return nfs_block_bits(bsize
, nrbitsp
);
521 * Determine the maximum file size for a superblock
524 void nfs_super_set_maxbytes(struct super_block
*sb
, __u64 maxfilesize
)
526 sb
->s_maxbytes
= (loff_t
)maxfilesize
;
527 if (sb
->s_maxbytes
> MAX_LFS_FILESIZE
|| sb
->s_maxbytes
<= 0)
528 sb
->s_maxbytes
= MAX_LFS_FILESIZE
;
532 * Determine the number of bytes of data the page contains
535 unsigned int nfs_page_length(struct page
*page
)
537 loff_t i_size
= i_size_read(page_file_mapping(page
)->host
);
540 pgoff_t page_index
= page_file_index(page
);
541 pgoff_t end_index
= (i_size
- 1) >> PAGE_CACHE_SHIFT
;
542 if (page_index
< end_index
)
543 return PAGE_CACHE_SIZE
;
544 if (page_index
== end_index
)
545 return ((i_size
- 1) & ~PAGE_CACHE_MASK
) + 1;
551 * Convert a umode to a dirent->d_type
554 unsigned char nfs_umode_to_dtype(umode_t mode
)
556 return (mode
>> 12) & 15;
560 * Determine the number of pages in an array of length 'len' and
561 * with a base offset of 'base'
564 unsigned int nfs_page_array_len(unsigned int base
, size_t len
)
566 return ((unsigned long)len
+ (unsigned long)base
+
567 PAGE_SIZE
- 1) >> PAGE_SHIFT
;
571 * Convert a struct timespec into a 64-bit change attribute
573 * This does approximately the same thing as timespec_to_ns(),
574 * but for calculation efficiency, we multiply the seconds by
578 u64
nfs_timespec_to_change_attr(const struct timespec
*ts
)
580 return ((u64
)ts
->tv_sec
<< 30) + ts
->tv_nsec
;
585 * nfs_fhandle_hash - calculate the crc32 hash for the filehandle
586 * @fh - pointer to filehandle
588 * returns a crc32 hash for the filehandle that is compatible with
589 * the one displayed by "wireshark".
591 static inline u32
nfs_fhandle_hash(const struct nfs_fh
*fh
)
593 return ~crc32_le(0xFFFFFFFF, &fh
->data
[0], fh
->size
);
596 static inline u32
nfs_fhandle_hash(const struct nfs_fh
*fh
)