Commit f2453978 authored Apr 06, 2020 by Chuck Lever

NFSD: Fix improperly-formatted Doxygen comments

fs/nfsd/nfsctl.c:256: warning: Function parameter or member 'file' not described in 'write_unlock_ip'
fs/nfsd/nfsctl.c:256: warning: Function parameter or member 'buf' not described in 'write_unlock_ip'
fs/nfsd/nfsctl.c:256: warning: Function parameter or member 'size' not described in 'write_unlock_ip'
fs/nfsd/nfsctl.c:295: warning: Function parameter or member 'file' not described in 'write_unlock_fs'
fs/nfsd/nfsctl.c:295: warning: Function parameter or member 'buf' not described in 'write_unlock_fs'
fs/nfsd/nfsctl.c:295: warning: Function parameter or member 'size' not described in 'write_unlock_fs'
fs/nfsd/nfsctl.c:352: warning: Function parameter or member 'file' not described in 'write_filehandle'
fs/nfsd/nfsctl.c:352: warning: Function parameter or member 'buf' not described in 'write_filehandle'
fs/nfsd/nfsctl.c:352: warning: Function parameter or member 'size' not described in 'write_filehandle'
fs/nfsd/nfsctl.c:434: warning: Function parameter or member 'file' not described in 'write_threads'
fs/nfsd/nfsctl.c:434: warning: Function parameter or member 'buf' not described in 'write_threads'
fs/nfsd/nfsctl.c:434: warning: Function parameter or member 'size' not described in 'write_threads'
fs/nfsd/nfsctl.c:478: warning: Function parameter or member 'file' not described in 'write_pool_threads'
fs/nfsd/nfsctl.c:478: warning: Function parameter or member 'buf' not described in 'write_pool_threads'
fs/nfsd/nfsctl.c:478: warning: Function parameter or member 'size' not described in 'write_pool_threads'
fs/nfsd/nfsctl.c:697: warning: Function parameter or member 'file' not described in 'write_versions'
fs/nfsd/nfsctl.c:697: warning: Function parameter or member 'buf' not described in 'write_versions'
fs/nfsd/nfsctl.c:697: warning: Function parameter or member 'size' not described in 'write_versions'
fs/nfsd/nfsctl.c:858: warning: Function parameter or member 'file' not described in 'write_ports'
fs/nfsd/nfsctl.c:858: warning: Function parameter or member 'buf' not described in 'write_ports'
fs/nfsd/nfsctl.c:858: warning: Function parameter or member 'size' not described in 'write_ports'
fs/nfsd/nfsctl.c:892: warning: Function parameter or member 'file' not described in 'write_maxblksize'
fs/nfsd/nfsctl.c:892: warning: Function parameter or member 'buf' not described in 'write_maxblksize'
fs/nfsd/nfsctl.c:892: warning: Function parameter or member 'size' not described in 'write_maxblksize'
fs/nfsd/nfsctl.c:941: warning: Function parameter or member 'file' not described in 'write_maxconn'
fs/nfsd/nfsctl.c:941: warning: Function parameter or member 'buf' not described in 'write_maxconn'
fs/nfsd/nfsctl.c:941: warning: Function parameter or member 'size' not described in 'write_maxconn'
fs/nfsd/nfsctl.c:1023: warning: Function parameter or member 'file' not described in 'write_leasetime'
fs/nfsd/nfsctl.c:1023: warning: Function parameter or member 'buf' not described in 'write_leasetime'
fs/nfsd/nfsctl.c:1023: warning: Function parameter or member 'size' not described in 'write_leasetime'
fs/nfsd/nfsctl.c:1039: warning: Function parameter or member 'file' not described in 'write_gracetime'
fs/nfsd/nfsctl.c:1039: warning: Function parameter or member 'buf' not described in 'write_gracetime'
fs/nfsd/nfsctl.c:1039: warning: Function parameter or member 'size' not described in 'write_gracetime'
fs/nfsd/nfsctl.c:1094: warning: Function parameter or member 'file' not described in 'write_recoverydir'
fs/nfsd/nfsctl.c:1094: warning: Function parameter or member 'buf' not described in 'write_recoverydir'
fs/nfsd/nfsctl.c:1094: warning: Function parameter or member 'size' not described in 'write_recoverydir'
fs/nfsd/nfsctl.c:1125: warning: Function parameter or member 'file' not described in 'write_v4_end_grace'
fs/nfsd/nfsctl.c:1125: warning: Function parameter or member 'buf' not described in 'write_v4_end_grace'
fs/nfsd/nfsctl.c:1125: warning: Function parameter or member 'size' not described in 'write_v4_end_grace'

fs/nfsd/nfs4proc.c:1164: warning: Function parameter or member 'nss' not described in 'nfsd4_interssc_connect'
fs/nfsd/nfs4proc.c:1164: warning: Function parameter or member 'rqstp' not described in 'nfsd4_interssc_connect'
fs/nfsd/nfs4proc.c:1164: warning: Function parameter or member 'mount' not described in 'nfsd4_interssc_connect'
fs/nfsd/nfs4proc.c:1262: warning: Function parameter or member 'rqstp' not described in 'nfsd4_setup_inter_ssc'
fs/nfsd/nfs4proc.c:1262: warning: Function parameter or member 'cstate' not described in 'nfsd4_setup_inter_ssc'
fs/nfsd/nfs4proc.c:1262: warning: Function parameter or member 'copy' not described in 'nfsd4_setup_inter_ssc'
fs/nfsd/nfs4proc.c:1262: warning: Function parameter or member 'mount' not described in 'nfsd4_setup_inter_ssc'

Signed-off-by: Chuck Lever <chuck.lever@oracle.com>

parent 45f56da8

fs/nfsd/nfs4proc.c

+3 −4

Original line number	Diff line number	Diff line
		@@ -1155,7 +1155,7 @@ extern void nfs_sb_deactive(struct super_block *sb);

		#define NFSD42_INTERSSC_MOUNTOPS "vers=4.2,addr=%s,sec=sys"

		/**
		/*
		* Support one copy source server for now.
		*/
		static __be32
		@@ -1245,10 +1245,9 @@ nfsd4_interssc_disconnect(struct vfsmount *ss_mnt)
		mntput(ss_mnt);
		}

		/**
		* nfsd4_setup_inter_ssc
		*
		/*
		* Verify COPY destination stateid.
		*
		* Connect to the source server with NFSv4.1.
		* Create the source struct file for nfsd_copy_range.
		* Called with COPY cstate:

fs/nfsd/nfsctl.c

+13 −13

Original line number	Diff line number	Diff line
		@@ -238,7 +238,7 @@ static inline struct net netns(struct file file)
		return file_inode(file)->i_sb->s_fs_info;
		}

		/**
		/*
		* write_unlock_ip - Release all locks used by a client
		*
		* Experimental.
		@@ -277,7 +277,7 @@ static ssize_t write_unlock_ip(struct file file, char buf, size_t size)
		return nlmsvc_unlock_all_by_ip(sap);
		}

		/**
		/*
		* write_unlock_fs - Release all locks on a local file system
		*
		* Experimental.
		@@ -327,7 +327,7 @@ static ssize_t write_unlock_fs(struct file file, char buf, size_t size)
		return error;
		}

		/**
		/*
		* write_filehandle - Get a variable-length NFS file handle by path
		*
		* On input, the buffer contains a '\n'-terminated C string comprised of
		@@ -402,7 +402,7 @@ static ssize_t write_filehandle(struct file file, char buf, size_t size)
		return mesg - buf;
		}

		/**
		/*
		* write_threads - Start NFSD, or report the current number of running threads
		*
		* Input:
		@@ -452,7 +452,7 @@ static ssize_t write_threads(struct file file, char buf, size_t size)
		return scnprintf(buf, SIMPLE_TRANSACTION_LIMIT, "%d\n", rv);
		}

		/**
		/*
		* write_pool_threads - Set or report the current number of threads per pool
		*
		* Input:
		@@ -661,7 +661,7 @@ out:
		return tlen + len;
		}

		/**
		/*
		* write_versions - Set or report the available NFS protocol versions
		*
		* Input:
		@@ -811,7 +811,7 @@ static ssize_t __write_ports(struct file file, char buf, size_t size,
		return -EINVAL;
		}

		/**
		/*
		* write_ports - Pass a socket file descriptor or transport name to listen on
		*
		* Input:
		@@ -867,7 +867,7 @@ static ssize_t write_ports(struct file file, char buf, size_t size)

		int nfsd_max_blksize;

		/**
		/*
		* write_maxblksize - Set or report the current NFS blksize
		*
		* Input:
		@@ -917,7 +917,7 @@ static ssize_t write_maxblksize(struct file file, char buf, size_t size)
		nfsd_max_blksize);
		}

		/**
		/*
		* write_maxconn - Set or report the current max number of connections
		*
		* Input:
		@@ -998,7 +998,7 @@ static ssize_t nfsd4_write_time(struct file file, char buf, size_t size,
		return rv;
		}

		/**
		/*
		* write_leasetime - Set or report the current NFSv4 lease time
		*
		* Input:
		@@ -1025,7 +1025,7 @@ static ssize_t write_leasetime(struct file file, char buf, size_t size)
		return nfsd4_write_time(file, buf, size, &nn->nfsd4_lease, nn);
		}

		/**
		/*
		* write_gracetime - Set or report current NFSv4 grace period time
		*
		* As above, but sets the time of the NFSv4 grace period.
		@@ -1069,7 +1069,7 @@ static ssize_t __write_recoverydir(struct file file, char buf, size_t size,
		nfs4_recoverydir());
		}

		/**
		/*
		* write_recoverydir - Set or report the pathname of the recovery directory
		*
		* Input:
		@@ -1101,7 +1101,7 @@ static ssize_t write_recoverydir(struct file file, char buf, size_t size)
		return rv;
		}

		/**
		/*
		* write_v4_end_grace - release grace period for nfsd's v4.x lock manager
		*
		* Input:

Admin message