lustre: move DocBook comments to sphinix format
cover lustre: move DocBook comments to sphinix format
The Linux kernel deprecated DocBook so update Lustre to using sphinix instead. I'm no Sphinix expert so things might be missed but the major has been ported over. This should get the lustre in shape to move out of staging.
James Simmons (7):
lnet: move comments to sphinix format
lustre: move header file comments to sphinix format
ptlrpc: move comments to sphinix format
ldlm: move comments to sphinix format
llite: move comments to sphinix format
obdclass: move comments to sphinix format
lustre: move remaining comments to sphinix format
.../lustre/include/linux/libcfs/libcfs_cpu.h | 50 ++-- .../lustre/include/linux/libcfs/libcfs_crypto.h | 20 +- .../lustre/include/uapi/linux/lnet/lnetctl.h | 2 +- .../lustre/include/uapi/linux/lustre/lustre_fid.h | 20 +- .../lustre/include/uapi/linux/lustre/lustre_idl.h | 2 +- .../lustre/include/uapi/linux/lustre/lustre_user.h | 13 +- .../staging/lustre/lnet/klnds/o2iblnd/o2iblnd.h | 2 +- drivers/staging/lustre/lnet/libcfs/debug.c | 2 +- drivers/staging/lustre/lnet/libcfs/libcfs_cpu.c | 2 +- drivers/staging/lustre/lnet/libcfs/libcfs_lock.c | 8 +- drivers/staging/lustre/lnet/libcfs/libcfs_string.c | 67 +++-- drivers/staging/lustre/lnet/libcfs/linux-crypto.c | 131 ++++----- drivers/staging/lustre/lnet/lnet/api-ni.c | 34 +-- drivers/staging/lustre/lnet/lnet/lib-eq.c | 100 +++---- drivers/staging/lustre/lnet/lnet/lib-md.c | 67 ++--- drivers/staging/lustre/lnet/lnet/lib-me.c | 76 ++--- drivers/staging/lustre/lnet/lnet/lib-move.c | 113 ++++---- drivers/staging/lustre/lnet/lnet/lib-ptl.c | 12 +- drivers/staging/lustre/lnet/lnet/net_fault.c | 30 +- drivers/staging/lustre/lnet/lnet/nidstrings.c | 125 ++++----- drivers/staging/lustre/lustre/fld/fld_cache.c | 4 +- drivers/staging/lustre/lustre/fld/fld_internal.h | 2 +- drivers/staging/lustre/lustre/include/cl_object.h | 91 +++--- drivers/staging/lustre/lustre/include/lu_object.h | 8 +- drivers/staging/lustre/lustre/include/lustre_dlm.h | 10 +- .../staging/lustre/lustre/include/lustre_import.h | 4 +- drivers/staging/lustre/lustre/include/lustre_mdc.h | 4 +- drivers/staging/lustre/lustre/include/lustre_net.h | 76 ++--- drivers/staging/lustre/lustre/include/lustre_nrs.h | 118 ++++---- drivers/staging/lustre/lustre/include/lustre_sec.h | 83 +++--- drivers/staging/lustre/lustre/include/obd_class.h | 9 +- drivers/staging/lustre/lustre/include/seq_range.h | 32 +-- drivers/staging/lustre/lustre/ldlm/ldlm_flock.c | 14 +- drivers/staging/lustre/lustre/ldlm/ldlm_lib.c | 8 +- drivers/staging/lustre/lustre/ldlm/ldlm_lock.c | 90 +++--- drivers/staging/lustre/lustre/ldlm/ldlm_lockd.c | 6 +- drivers/staging/lustre/lustre/ldlm/ldlm_pool.c | 22 +- drivers/staging/lustre/lustre/ldlm/ldlm_request.c | 99 ++++--- drivers/staging/lustre/lustre/ldlm/ldlm_resource.c | 18 +- drivers/staging/lustre/lustre/llite/dir.c | 14 +- drivers/staging/lustre/lustre/llite/file.c | 62 +++-- drivers/staging/lustre/lustre/llite/glimpse.c | 4 +- drivers/staging/lustre/lustre/llite/lcommon_cl.c | 5 +- drivers/staging/lustre/lustre/llite/llite_lib.c | 48 ++-- drivers/staging/lustre/lustre/llite/llite_mmap.c | 19 +- drivers/staging/lustre/lustre/llite/llite_nfs.c | 4 +- drivers/staging/lustre/lustre/llite/lproc_llite.c | 22 +- drivers/staging/lustre/lustre/llite/range_lock.c | 20 +- drivers/staging/lustre/lustre/llite/rw.c | 14 +- drivers/staging/lustre/lustre/llite/statahead.c | 59 ++-- drivers/staging/lustre/lustre/llite/super25.c | 3 +- drivers/staging/lustre/lustre/llite/vvp_io.c | 2 +- drivers/staging/lustre/lustre/llite/vvp_page.c | 8 +- drivers/staging/lustre/lustre/llite/xattr_cache.c | 44 +-- .../staging/lustre/lustre/llite/xattr_security.c | 12 +- drivers/staging/lustre/lustre/lmv/lmv_obd.c | 119 ++++---- drivers/staging/lustre/lustre/lov/lov_io.c | 2 +- drivers/staging/lustre/lustre/lov/lov_object.c | 47 ++-- drivers/staging/lustre/lustre/lov/lov_pack.c | 4 +- drivers/staging/lustre/lustre/mdc/mdc_changelog.c | 91 +++--- drivers/staging/lustre/lustre/mdc/mdc_lib.c | 12 +- drivers/staging/lustre/lustre/mdc/mdc_request.c | 34 +-- drivers/staging/lustre/lustre/mgc/mgc_request.c | 8 +- drivers/staging/lustre/lustre/obdclass/cl_io.c | 12 +- drivers/staging/lustre/lustre/obdclass/cl_lock.c | 11 +- drivers/staging/lustre/lustre/obdclass/cl_object.c | 44 +-- drivers/staging/lustre/lustre/obdclass/cl_page.c | 30 +- drivers/staging/lustre/lustre/obdclass/genops.c | 22 +- .../staging/lustre/lustre/obdclass/kernelcomm.c | 23 +- drivers/staging/lustre/lustre/obdclass/linkea.c | 15 +- .../lustre/lustre/obdclass/lprocfs_status.c | 30 +- drivers/staging/lustre/lustre/obdclass/lu_object.c | 44 +-- drivers/staging/lustre/lustre/obdclass/obd_mount.c | 47 ++-- drivers/staging/lustre/lustre/osc/osc_cache.c | 12 +- drivers/staging/lustre/lustre/osc/osc_lock.c | 10 +- drivers/staging/lustre/lustre/osc/osc_request.c | 4 +- drivers/staging/lustre/lustre/ptlrpc/client.c | 72 ++--- drivers/staging/lustre/lustre/ptlrpc/import.c | 6 +- drivers/staging/lustre/lustre/ptlrpc/layout.c | 102 +++---- .../staging/lustre/lustre/ptlrpc/lproc_ptlrpc.c | 10 +- drivers/staging/lustre/lustre/ptlrpc/niobuf.c | 14 +- drivers/staging/lustre/lustre/ptlrpc/nrs.c | 305 +++++++++++---------- drivers/staging/lustre/lustre/ptlrpc/nrs_fifo.c | 68 ++--- .../staging/lustre/lustre/ptlrpc/pack_generic.c | 8 +- drivers/staging/lustre/lustre/ptlrpc/sec.c | 104 +++---- drivers/staging/lustre/lustre/ptlrpc/sec_config.c | 2 +- drivers/staging/lustre/lustre/ptlrpc/service.c | 4 +- 87 files changed, 1641 insertions(+), 1589 deletions(-)
Signature · 1 line
1.8.3.1
PATCH 1/7 lnet: move comments to sphinix format
Lustre comments was written for DocBook which is no longer used by the Linux kernel. Move all the DocBook handling to sphinix.
--- .../lustre/include/linux/libcfs/libcfs_cpu.h | 50 ++++---- .../lustre/include/linux/libcfs/libcfs_crypto.h | 20 ++-- .../lustre/include/uapi/linux/lnet/lnetctl.h | 2 +- .../staging/lustre/lnet/klnds/o2iblnd/o2iblnd.h | 2 +- drivers/staging/lustre/lnet/libcfs/debug.c | 2 +- drivers/staging/lustre/lnet/libcfs/libcfs_cpu.c | 2 +- drivers/staging/lustre/lnet/libcfs/libcfs_lock.c | 8 +- drivers/staging/lustre/lnet/libcfs/libcfs_string.c | 67 +++++------ drivers/staging/lustre/lnet/libcfs/linux-crypto.c | 131 +++++++++++---------- drivers/staging/lustre/lnet/lnet/api-ni.c | 34 +++--- drivers/staging/lustre/lnet/lnet/lib-eq.c | 100 ++++++++-------- drivers/staging/lustre/lnet/lnet/lib-md.c | 67 +++++------ drivers/staging/lustre/lnet/lnet/lib-me.c | 76 ++++++------ drivers/staging/lustre/lnet/lnet/lib-move.c | 113 ++++++++++-------- drivers/staging/lustre/lnet/lnet/lib-ptl.c | 12 +- drivers/staging/lustre/lnet/lnet/net_fault.c | 30 ++--- drivers/staging/lustre/lnet/lnet/nidstrings.c | 125 +++++++++----------- 17 files changed, 425 insertions(+), 416 deletions(-)
drivers/staging/lustre/include/linux/libcfs/libcfs_cpu.h +25 -25
@@ -85,7 +85,7 @@extern struct cfs_cpt_table *cfs_cpt_tab;/** -* return cpumask of CPU partition \a cpt +* return cpumask of CPU partition @cpt */ cpumask_var_t *cfs_cpt_cpumask (struct cfs_cpt_table *cptab,int cpt);/**
@@ -97,83 +97,83 @@*/ int cfs_cpt_distance_print (struct cfs_cpt_table *cptab,char *buf,int len);/** -* return total number of CPU partitions in \a cptab +* return total number of CPU partitions in @cptab */ int cfs_cpt_number (struct cfs_cpt_table *cptab);/** -* return number of HW cores or hyper-threadings in a CPU partition \a cpt +* return number of HW cores or hyper-threadings in a CPU partition @cpt */ int cfs_cpt_weight (struct cfs_cpt_table *cptab,int cpt);/** -* is there any online CPU in CPU partition \a cpt +* is there any online CPU in CPU partition @cpt */ int cfs_cpt_online (struct cfs_cpt_table *cptab,int cpt);/** -* return nodemask of CPU partition \a cpt +* return nodemask of CPU partition @cpt */ nodemask_t *cfs_cpt_nodemask (struct cfs_cpt_table *cptab,int cpt);/** -* shadow current HW processor ID to CPU-partition ID of \a cptab +* shadow current HW processor ID to CPU-partition ID of @cptab */ int cfs_cpt_current (struct cfs_cpt_table *cptab,int remap);/** -* shadow HW processor ID \a CPU to CPU-partition ID by \a cptab +* shadow HW processor ID @CPU to CPU-partition ID by @cptab */ int cfs_cpt_of_cpu (struct cfs_cpt_table *cptab,int cpu);/** -* shadow HW node ID \a NODE to CPU-partition ID by \a cptab +* shadow HW node ID @NODE to CPU-partition ID by @cptab */ int cfs_cpt_of_node (struct cfs_cpt_table *cptab,int node);/** -* NUMA distance between \a cpt1 and \a cpt2 in \a cptab +* NUMA distance between @cpt1 and @cpt2 in @cptab */ unsigned int cfs_cpt_distance (struct cfs_cpt_table *cptab,int cpt1,int cpt2);/** -* bind current thread on a CPU-partition \a cpt of \a cptab +* bind current thread on a CPU-partition @cpt of @cptab */ int cfs_cpt_bind (struct cfs_cpt_table *cptab,int cpt);/** -* add \a cpu to CPU partition @cpt of \a cptab, return 1 for success, +* add @cpu to CPU partition @cpt of @cptab, return 1 for success, * otherwise 0 is returned */ int cfs_cpt_set_cpu (struct cfs_cpt_table *cptab,int cpt,int cpu);/** -* remove \a cpu from CPU partition \a cpt of \a cptab +* remove @cpu from CPU partition @cpt of @cptab */ void cfs_cpt_unset_cpu (struct cfs_cpt_table *cptab,int cpt,int cpu);/** -* add all cpus in \a mask to CPU partition \a cpt +* add all cpus in @mask to CPU partition @cpt * return 1 if successfully set all CPUs, otherwise return 0 */ int cfs_cpt_set_cpumask (struct cfs_cpt_table *cptab,int cpt,const cpumask_t *mask);/** -* remove all cpus in \a mask from CPU partition \a cpt +* remove all cpus in @mask from CPU partition @cpt */ void cfs_cpt_unset_cpumask (struct cfs_cpt_table *cptab,int cpt,const cpumask_t *mask);/** -* add all cpus in NUMA node \a node to CPU partition \a cpt +* add all cpus in NUMA node @node to CPU partition @cpt * return 1 if successfully set all CPUs, otherwise return 0 */ int cfs_cpt_set_node (struct cfs_cpt_table *cptab,int cpt,int node);/** -* remove all cpus in NUMA node \a node from CPU partition \a cpt +* remove all cpus in NUMA node @node from CPU partition @cpt */ void cfs_cpt_unset_node (struct cfs_cpt_table *cptab,int cpt,int node);/** -* add all cpus in node mask \a mask to CPU partition \a cpt +* add all cpus in node mask @mask to CPU partition @cpt * return 1 if successfully set all CPUs, otherwise return 0 */ int cfs_cpt_set_nodemask (struct cfs_cpt_table *cptab,int cpt,const nodemask_t *mask);/** -* remove all cpus in node mask \a mask from CPU partition \a cpt +* remove all cpus in node mask @mask from CPU partition @cpt */ void cfs_cpt_unset_nodemask (struct cfs_cpt_table *cptab,int cpt,const nodemask_t *mask);/** -* convert partition id \a cpt to numa node id, if there are more than one +* convert partition id @cpt to numa node id, if there are more than one * nodes in this partition, it might return a different node id each time. */ int cfs_cpt_spread_node (struct cfs_cpt_table *cptab,int cpt);
@@ -329,7 +329,7 @@ static inline void cfs_cpu_fini(void)*/ void cfs_cpt_table_free (struct cfs_cpt_table *cptab);/** -* create a cfs_cpt_table with \a ncpt number of partitions +* create a cfs_cpt_table with @ncpt number of partitions */ struct cfs_cpt_table *cfs_cpt_table_alloc (unsigned int ncpt);
@@ -383,18 +383,18 @@ struct cfs_percpt_lock {#define cfs_percpt_lock_num (pcl) cfs_cpt_number(pcl->pcl_cptab)/* -* create a cpu-partition lock based on CPU partition table \a cptab, -* each private lock has extra \a psize bytes padding data +* create a cpu-partition lock based on CPU partition table @cptab, +* each private lock has extra @psize bytes padding data */ struct cfs_percpt_lock *cfs_percpt_lock_create (struct cfs_cpt_table *cptab,struct lock_class_key *keys);/* destroy a cpu-partition lock */ void cfs_percpt_lock_free (struct cfs_percpt_lock *pcl); -/* lock private lock \a index of \a pcl */ +/* lock private lock @index of @pcl */ void cfs_percpt_lock (struct cfs_percpt_lock *pcl,int index); -/* unlock private lock \a index of \a pcl */ +/* unlock private lock @index of @pcl */ void cfs_percpt_unlock (struct cfs_percpt_lock *pcl,int index);#define CFS_PERCPT_LOCK_KEYS 256
@@ -413,7 +413,7 @@ struct cfs_percpt_lock *cfs_percpt_lock_create(struct cfs_cpt_table *cptab, })/** -* iterate over all CPU partitions in \a cptab +* iterate over all CPU partitions in @cptab */ #define cfs_cpt_for_each (i, cptab) \ for (i = 0; i < cfs_cpt_number(cptab); i++)
drivers/staging/lustre/include/linux/libcfs/libcfs_crypto.h +10 -10
@@ -119,8 +119,8 @@ enum cfs_crypto_hash_alg {* * Hash information includes algorithm name, initial seed, hash size. * -* \retval cfs_crypto_hash_type for valid ID (CFS_HASH_ALG_*) -* \retval NULL for unknown algorithm identifier +* Return: cfs_crypto_hash_type for valid ID (CFS_HASH_ALG_*) +* NULL for unknown algorithm identifier */ static inline const struct cfs_crypto_hash_type *cfs_crypto_hash_type (enum cfs_crypto_hash_alg hash_alg)
@@ -138,10 +138,10 @@ enum cfs_crypto_hash_alg {/** * Return hash name for hash algorithm identifier * -* \param[in] hash_alg hash alrgorithm id (CFS_HASH_ALG_*) +* @hash_alg hash alrgorithm id (CFS_HASH_ALG_*) * -* \retval string name of known hash algorithm -* \retval "unknown" if hash algorithm is unknown +* Return: string name of known hash algorithm +* "unknown" if hash algorithm is unknown */ static inline const char *cfs_crypto_hash_name (enum cfs_crypto_hash_alg hash_alg)
@@ -157,10 +157,10 @@ enum cfs_crypto_hash_alg {/** * Return digest size for hash algorithm type * -* \param[in] hash_alg hash alrgorithm id (CFS_HASH_ALG_*) +* @hash_alg hash alrgorithm id (CFS_HASH_ALG_*) * -* \retval hash algorithm digest size in bytes -* \retval 0 if hash algorithm type is unknown +* Return: hash algorithm digest size in bytes +* 0 if hash algorithm type is unknown */ static inline int cfs_crypto_hash_digestsize (enum cfs_crypto_hash_alg hash_alg) {
@@ -175,8 +175,8 @@ static inline int cfs_crypto_hash_digestsize(enum cfs_crypto_hash_alg hash_alg)/** * Find hash algorithm ID for the specified algorithm name * -* \retval hash algorithm ID for valid ID (CFS_HASH_ALG_*) -* \retval CFS_HASH_ALG_UNKNOWN for unknown algorithm name +* Return: hash algorithm ID for valid ID (CFS_HASH_ALG_*) +* CFS_HASH_ALG_UNKNOWN for unknown algorithm name */ static inline unsigned char cfs_crypto_hash_alg (const char *algname) {
drivers/staging/lustre/include/uapi/linux/lnet/lnetctl.h +1 -1
@@ -46,7 +46,7 @@ struct lnet_fault_attr {* 255.255.255.255@net is wildcard for all addresses from @net */ lnet_nid_t fa_src; -/** destination NID of drop rule, see \a dr_src for details */ +/** destination NID of drop rule, see @dr_src for details */ lnet_nid_t fa_dst;/** * Portal mask to drop, -1 means all portals, for example:
drivers/staging/lustre/lnet/klnds/o2iblnd/o2iblnd.h +1 -1
@@ -346,7 +346,7 @@ struct kib_data {/* peers wait for reconnection */ struct list_head kib_reconn_wait;/** -* The second that peers are pulled out from \a kib_reconn_wait +* The second that peers are pulled out from @kib_reconn_wait * for reconnection. */ time64_t kib_reconn_sec;
drivers/staging/lustre/lnet/libcfs/debug.c +1 -1
@@ -335,7 +335,7 @@ static const char *libcfs_debug_dbg2str(int debug)/** * Upcall function once a Lustre log has been dumped. * -* \param file path of the dumped log +* @file path of the dumped log */ static void libcfs_run_debug_log_upcall (char *file) {
drivers/staging/lustre/lnet/libcfs/libcfs_cpu.c +1 -1
@@ -759,7 +759,7 @@ int cfs_cpt_bind(struct cfs_cpt_table *cptab, int cpt)EXPORT_SYMBOL (cfs_cpt_bind);/** -* Choose max to \a number CPUs from \a node and set them in \a cpt. +* Choose max to @number CPUs from @node and set them in @cpt. * We always prefer to choose CPU in the same core/socket. */ static int cfs_cpt_choose_ncpus(struct cfs_cpt_table *cptab, int cpt,
drivers/staging/lustre/lnet/libcfs/libcfs_lock.c +4 -4
@@ -88,11 +88,11 @@ struct cfs_percpt_lock */** * lock a CPU partition * -* \a index != CFS_PERCPT_LOCK_EX -* hold private lock indexed by \a index +* @index != CFS_PERCPT_LOCK_EX +* hold private lock indexed by @index * -* \a index == CFS_PERCPT_LOCK_EX -* exclusively lock @pcl and nobody can take private lock +* @index == CFS_PERCPT_LOCK_EX +* exclusively lock @pcl and nobody can take private lock */ void cfs_percpt_lock (struct cfs_percpt_lock *pcl,int index)
drivers/staging/lustre/lnet/libcfs/libcfs_string.c +32 -35
142 lines not on this page · raw message
drivers/staging/lustre/lnet/libcfs/linux-crypto.c +66 -65
208 lines not on this page · raw message
drivers/staging/lustre/lnet/lnet/api-ni.c +17 -17
@@ -1950,8 +1950,8 @@ static void lnet_push_target_fini(void)* lnet_lib_exit() after a call to lnet_lib_init(), if and only if the * latter returned 0. It must be called exactly once. * -* \retval 0 on success -* \retval -ve on failures. +* Return: 0 on success +* -ve on failures. */ int lnet_lib_init (void ) {
@@ -2031,15 +2031,15 @@ void lnet_lib_exit(void)* * Users must call this function at least once before any other functions. * For each successful call there must be a corresponding call to -* LNetNIFini(). For subsequent calls to LNetNIInit(), \a requested_pid is +* LNetNIFini(). For subsequent calls to LNetNIInit(), @requested_pid is * ignored. * * The PID used by LNet may be different from the one requested. * See LNetGetId(). * -* \param requested_pid PID requested by the caller. +* @requested_pid PID requested by the caller. * -* \return >= 0 on success, and < 0 error code on failures. +* Return: >= 0 on success, and < 0 error code on failures. */ int LNetNIInit (lnet_pid_t requested_pid)
@@ -2185,7 +2185,7 @@ void lnet_lib_exit(void)* Once the LNetNIFini() operation has been started, the results of pending * API operations are undefined. * -* \return always 0 for current implementation. +* Return: always 0 for current implementation. */ int LNetNIFini (void )
@@ -2224,9 +2224,9 @@ void lnet_lib_exit(void)* Grabs the ni data from the ni structure and fills the out * parameters * -* \param[in] ni network interface structure -* \param[out] cfg_ni NI config information -* \param[out] tun network and LND tunables +* @ni network interface structure +* @cfg_ni NI config information +* @tun network and LND tunables */ static void lnet_fill_ni_info(struct lnet_ni *ni, struct lnet_ioctl_config_ni *cfg_ni,
@@ -2302,8 +2302,8 @@ void lnet_lib_exit(void)* Grabs the ni data from the ni structure and fills the out * parameters * -* \param[in] ni network interface structure -* \param[out] config config information +* @ni network interface structure +* @config config information */ static void lnet_fill_ni_info_legacy(struct lnet_ni *ni,
@@ -3308,15 +3308,15 @@ void LNetDebugPeer(struct lnet_process_id id)EXPORT_SYMBOL (LNetDebugPeer);/** -* Retrieve the lnet_process_id ID of LNet interface at \a index. Note that +* Retrieve the lnet_process_id ID of LNet interface at @index. Note that * all interfaces share a same PID, as requested by LNetNIInit(). * -* \param index Index of the interface to look up. -* \param id On successful return, this location will hold the -* lnet_process_id ID of the interface. +* @index Index of the interface to look up. +* @id On successful return, this location will hold the +* lnet_process_id ID of the interface. * -* \retval 0 If an interface exists at \a index. -* \retval -ENOENT If no interface has been found. +* Return: 0 If an interface exists@@index. +* -ENOENT If no interface has been found. */ int LNetGetId (unsigned int index,struct lnet_process_id *id)
drivers/staging/lustre/lnet/lnet/lib-eq.c +52 -48
144 lines not on this page · raw message
drivers/staging/lustre/lnet/lnet/lib-md.c +34 -33
88 lines not on this page · raw message
drivers/staging/lustre/lnet/lnet/lib-me.c +41 -35
105 lines not on this page · raw message
drivers/staging/lustre/lnet/lnet/lib-move.c +61 -52
154 lines not on this page · raw message
drivers/staging/lustre/lnet/lnet/lib-ptl.c +6 -6
@@ -894,10 +894,10 @@ struct list_head ** especially vulnerable since the connections to its neighbor routers are * shared among all clients. * -* \param portal Index of the portal to enable the lazy attribute on. +* @portal Index of the portal to enable the lazy attribute on. * -* \retval 0 On success. -* \retval -EINVAL If \a portal is not a valid index. +* Return: 0 On success. +* -EINVAL If @portal is not a valid index. */ int LNetSetLazyPortal (int portal)
@@ -975,10 +975,10 @@ struct list_head ** Turn off the lazy portal attribute. Delayed requests on the portal, * if any, will be all dropped when this function returns. * -* \param portal Index of the portal to disable the lazy attribute on. +* @portal Index of the portal to disable the lazy attribute on. * -* \retval 0 On success. -* \retval -EINVAL If \a portal is not a valid index. +* Return: 0 On success. +* -EINVAL If @portal is not a valid index. */ int LNetClearLazyPortal (int portal)
drivers/staging/lustre/lnet/lnet/net_fault.c +15 -15
@@ -47,7 +47,7 @@ struct lnet_drop_rule {struct list_head dr_link;/** attributes of this rule */ struct lnet_fault_attr dr_attr; -/** lock to protect \a dr_drop_at and \a dr_stat */ +/** lock to protect @dr_drop_at and @dr_stat */ spinlock_t dr_lock;/** * the message sequence to drop, which means message is dropped when
@@ -188,10 +188,10 @@ struct lnet_drop_rule { }/** -* Remove matched drop rules from lnet, all rules that can match \a src and -* \a dst will be removed. -* If \a src is zero, then all rules have \a dst as destination will be remove -* If \a dst is zero, then all rules have \a src as source will be removed +* Remove matched drop rules from lnet, all rules that can match @src and +* @dst will be removed. +* If @src is zero, then all rules have @dst as destination will be remove +* If @dst is zero, then all rules have @src as source will be removed * If both of them are zero, all rules will be removed */ static int
@@ -233,7 +233,7 @@ struct lnet_drop_rule { }/** -* List drop rule at position of \a pos +* List drop rule at position of @pos */ static int lnet_drop_rule_list(int pos, struct lnet_fault_attr *attr,
@@ -349,7 +349,7 @@ struct lnet_drop_rule { }/** -* Check if message from \a src to \a dst can match any existed drop rule +* Check if message from @src to @dst can match any existed drop rule */ bool lnet_drop_rule_match (struct lnet_hdr *hdr)
@@ -395,7 +395,7 @@ struct lnet_delay_rule {struct list_head dl_sched_link;/** attributes of this rule */ struct lnet_fault_attr dl_attr; -/** lock to protect \a below members */ +/** lock to protect @below members */ spinlock_t dl_lock;/** refcount of delay rule */ atomic_t dl_refcount;
@@ -423,7 +423,7 @@ struct lnet_delay_rule {struct delay_daemon_data {/** serialise rule add/remove */ struct mutex dd_mutex; -/** protect rules on \a dd_sched_rules */ +/** protect rules on @dd_sched_rules */ spinlock_t dd_lock;/** scheduled delay rules (by timer) */ struct list_head dd_sched_rules;
@@ -520,7 +520,7 @@ struct delay_daemon_data { }/** -* check if \a msg can match any Delay Rule, receiving of this message +* check if @msg can match any Delay Rule, receiving of this message * will be delayed if there is a match. */ bool
@@ -792,11 +792,11 @@ struct delay_daemon_data { }/** -* Remove matched Delay Rules from lnet, if \a shutdown is true or both \a src -* and \a dst are zero, all rules will be removed, otherwise only matched rules +* Remove matched Delay Rules from lnet, if @shutdown is true or both @src +* and @dst are zero, all rules will be removed, otherwise only matched rules * will be removed. -* If \a src is zero, then all rules have \a dst as destination will be remove -* If \a dst is zero, then all rules have \a src as source will be removed +* If @src is zero, then all rules have @dst as destination will be remove +* If @dst is zero, then all rules have @src as source will be removed * * When a delay rule is removed, all delayed messages of this rule will be * processed immediately.
@@ -871,7 +871,7 @@ struct delay_daemon_data { }/** -* List Delay Rule at position of \a pos +* List Delay Rule at position of @pos */ int lnet_delay_rule_list(int pos, struct lnet_fault_attr *attr,
drivers/staging/lustre/lnet/lnet/nidstrings.c +58 -67
271 lines not on this page · raw message
Signature · 1 line
1.8.3.1
PATCH 2/7 lustre: move header file comments to sphinix format
In reply to James SimmonsLustre comments was written for DocBook which is no longer used by the Linux kernel. Move all the DocBook handling to sphinix.
--- .../lustre/include/uapi/linux/lustre/lustre_fid.h | 20 ++-- .../lustre/include/uapi/linux/lustre/lustre_idl.h | 2 +- .../lustre/include/uapi/linux/lustre/lustre_user.h | 13 +-- drivers/staging/lustre/lustre/include/cl_object.h | 91 ++++++++-------- drivers/staging/lustre/lustre/include/lu_object.h | 8 +- drivers/staging/lustre/lustre/include/lustre_dlm.h | 10 +- .../staging/lustre/lustre/include/lustre_import.h | 4 +- drivers/staging/lustre/lustre/include/lustre_mdc.h | 4 +- drivers/staging/lustre/lustre/include/lustre_net.h | 76 ++++++------- drivers/staging/lustre/lustre/include/lustre_nrs.h | 118 ++++++++++----------- drivers/staging/lustre/lustre/include/lustre_sec.h | 83 ++++++++------- drivers/staging/lustre/lustre/include/obd_class.h | 9 +- drivers/staging/lustre/lustre/include/seq_range.h | 32 +++--- 13 files changed, 240 insertions(+), 230 deletions(-)
drivers/staging/lustre/include/uapi/linux/lustre/lustre_fid.h +12 -8
@@ -137,8 +137,9 @@ static inline bool fid_is_mdt0(const struct lu_fid *fid)/** * Check if a fid is igif or not. -* \param fid the fid to be tested. -* \return true if the fid is an igif; otherwise false. +* +* @fid the fid to be tested. +* Return: true if the fid is an igif; otherwise false. */ static inline bool fid_seq_is_igif (__u64 seq) {
@@ -152,8 +153,9 @@ static inline bool fid_is_igif(const struct lu_fid *fid)/** * Check if a fid is idif or not. -* \param fid the fid to be tested. -* \return true if the fid is an idif; otherwise false. +* +* @fid the fid to be tested. +* Return: true if the fid is an idif; otherwise false. */ static inline bool fid_seq_is_idif (__u64 seq) {
@@ -205,8 +207,9 @@ static inline __u32 fid_idif_ost_idx(const struct lu_fid *fid)/** * Get inode number from an igif. -* \param fid an igif to get inode number from. -* \return inode number for the igif. +* +* @fid an igif to get inode number from. +* Return: inode number for the igif. */ static inline ino_t lu_igif_ino (const struct lu_fid *fid) {
@@ -215,8 +218,9 @@ static inline ino_t lu_igif_ino(const struct lu_fid *fid)/** * Get inode generation from an igif. -* \param fid an igif to get inode generation from. -* \return inode generation for the igif. +* +* @fid an igif to get inode generation from. +* Return: inode generation for the igif. */ static inline __u32 lu_igif_gen (const struct lu_fid *fid) {
drivers/staging/lustre/include/uapi/linux/lustre/lustre_idl.h +1 -1
@@ -2746,7 +2746,7 @@ struct lustre_capa_key {__u8 lk_key[CAPA_HMAC_KEY_MAX_LEN ];/**< key */ } __packed; -/** The link ea holds 1 \a link_ea_entry for each hardlink */ +/** The link ea holds 1 @link_ea_entry for each hardlink */ #define LINK_EA_MAGIC 0x11EAF1DFULstruct link_ea_header {__u32 leh_magic;
drivers/staging/lustre/include/uapi/linux/lustre/lustre_user.h +7 -6
@@ -1018,8 +1018,8 @@ static inline char *changelog_rec_sname(struct changelog_rec *rec)* - CLF_RENAME will not be removed * - CLF_JOBID will not be added without CLF_RENAME being added too * -* @param[in,out] rec The record to remap. -* @param[in] crf_wanted Flags describing the desired extensions. +* @rec The record to remap. +* @crf_wanted Flags describing the desired extensions. */ static inline void changelog_remap_rec (struct changelog_rec *rec,enum changelog_rec_flags crf_wanted)
@@ -1297,10 +1297,11 @@ struct hsm_action_item {/* * helper function which print in hexa the first bytes of * hai opaque field -* \param hai [IN] record to print -* \param buffer [OUT] output buffer -* \param len [IN] max buffer len -* \retval buffer +* +* @hai record to print +* @buffer output buffer +* @len max buffer len +* Return: buffer */ static inline char *hai_dump_data_field (struct hsm_action_item *hai,char *buffer,size_t len)
drivers/staging/lustre/lustre/include/cl_object.h +46 -45
230 lines not on this page · raw message
drivers/staging/lustre/lustre/include/lu_object.h +4 -4
@@ -739,7 +739,7 @@ static inline const struct lu_fid *lu_object_fid(const struct lu_object *o)/** * Given a compound object, find its slice, corresponding to the device type -* \a dtype. +* @dtype. */ struct lu_object *lu_object_locate (struct lu_object_header *h,const struct lu_device_type *dtype);
@@ -1058,7 +1058,7 @@ struct lu_context_key { struct lu_context_key *key);/** * Value destructor. Called when context with previously allocated -* value of this slot is destroyed. \a data is a value that was returned +* value of this slot is destroyed. @data is a value that was returned * by a matching call to lu_context_key::lct_init(). */ void (*lct_fini)(const struct lu_context *ctx,
@@ -1247,8 +1247,8 @@ struct lu_name {/** * Validate names (path components) * -* To be valid \a name must be non-empty, '\0' terminated of length \a -* name_len, and not contain '/'. The maximum length of a name (before +* To be valid @name must be non-empty, '\0' terminated of length +* @name_len, and not contain '/'. The maximum length of a name (before * say -ENAMETOOLONG will be returned) is really controlled by llite * and the server. We only check for something insane coming from bad * integer handling here.
drivers/staging/lustre/lustre/include/lustre_dlm.h +5 -5
@@ -203,9 +203,9 @@ static inline int lockmode_compat(enum ldlm_mode exist_mode,* can trigger freeing of locks from the pool */ struct ldlm_pool_ops { -/** Recalculate pool \a pl usage */ +/** Recalculate pool @pl usage */ int (*po_recalc)(struct ldlm_pool *pl); -/** Cancel at least \a nr locks from pool \a pl */ +/** Cancel at least @nr locks from pool @pl */ int (*po_shrink)(struct ldlm_pool *pl,int nr,gfp_t gfp_mask); };
@@ -429,7 +429,7 @@ struct ldlm_namespace {/** * Used by filter code to store pointer to OBD of the service. -* Should be dropped in favor of \a ns_obd +* Should be dropped in favor of @ns_obd */ void *ns_lvbp;
@@ -466,7 +466,7 @@ struct ldlm_namespace { };/** -* Returns 1 if namespace \a ns supports early lock cancel (ELC). +* Returns 1 if namespace @ns supports early lock cancel (ELC). */ static inline int ns_connect_cancelset (struct ldlm_namespace *ns) {
@@ -1082,7 +1082,7 @@ static inline struct ldlm_lock *ldlm_handle2lock(const struct lustre_handle *h)/** * Update Lock Value Block Operations (LVBO) on a resource taking into account -* data from request \a r +* data from request @r */ static inline int ldlm_res_lvbo_update (struct ldlm_resource *res,struct ptlrpc_request *r,int increase)
drivers/staging/lustre/lustre/include/lustre_import.h +2 -2
@@ -98,7 +98,7 @@ enum lustre_imp_state { LUSTRE_IMP_EVICTED = 10, }; -/** Returns test string representation of numeric import state \a state */ +/** Returns test string representation of numeric import state @state */ static inline char *ptlrpc_import_state_name (enum lustre_imp_state state) {static char *import_state_names[] = {
@@ -257,7 +257,7 @@ struct obd_import {/** List of all possible connection for import. */ struct list_head imp_conn_list;/** -* Current connection. \a imp_connection is imp_conn_current->oic_conn +* Current connection. @imp_connection is imp_conn_current->oic_conn */ struct obd_import_conn *imp_conn_current;
drivers/staging/lustre/lustre/include/lustre_mdc.h +2 -2
@@ -190,8 +190,8 @@ static inline void mdc_put_mod_rpc_slot(struct ptlrpc_request *req,* * \see client_obd::cl_default_mds_easize * -* \param[in] exp export for MDC device -* \param[in] body body of ptlrpc reply from MDT +* @exp: export for MDC device +* @body: body of ptlrpc reply from MDT * */ static inline void mdc_update_max_ea_from_body(struct obd_export *exp,
drivers/staging/lustre/lustre/include/lustre_net.h +38 -38
201 lines not on this page · raw message
drivers/staging/lustre/lustre/include/lustre_nrs.h +59 -59
205 lines not on this page · raw message
drivers/staging/lustre/lustre/include/lustre_sec.h +43 -40
229 lines not on this page · raw message
drivers/staging/lustre/lustre/include/obd_class.h +5 -4
@@ -677,10 +677,11 @@ static inline struct obd_uuid *obd_get_uuid(struct obd_export *exp) }/* -* Create a new /a exp on device /a obd for the uuid /a cluuid -* @param exp New export handle -* @param d Connect data, supported flags are set, flags also understood -* by obd are returned. +* Create a new @exp on device @obd for the uuid @cluuid +* +* @exp: New export handle +* @d: Connect data, supported flags are set, flags also understood +* by obd are returned. */ static inline int obd_connect(const struct lu_env *env, struct obd_export **exp, struct obd_device *obd,
drivers/staging/lustre/lustre/include/seq_range.h +16 -16
@@ -38,7 +38,7 @@#include <uapi/linux/lustre/lustre_idl.h> /** -* computes the sequence range type \a range +* computes the sequence range type @range */ static inline unsigned int fld_range_type (const struct lu_seq_range *range)
@@ -47,7 +47,7 @@ static inline unsigned int fld_range_type(const struct lu_seq_range *range) }/** -* Is this sequence range an OST? \a range +* Is this sequence range an OST? @range */ static inline bool fld_range_is_ost (const struct lu_seq_range *range)
@@ -56,7 +56,7 @@ static inline bool fld_range_is_ost(const struct lu_seq_range *range) }/** -* Is this sequence range an MDT? \a range +* Is this sequence range an MDT? @range */ static inline bool fld_range_is_mdt (const struct lu_seq_range *range)
@@ -68,7 +68,7 @@ static inline bool fld_range_is_mdt(const struct lu_seq_range *range)* ANY range is only used when the fld client sends a fld query request, * but it does not know whether the seq is an MDT or OST, so it will send the * request with ANY type, which means any seq type from the lookup can be -* expected. /a range +* expected. @range */ static inline unsigned int fld_range_is_any (const struct lu_seq_range *range) {
@@ -76,7 +76,7 @@ static inline unsigned int fld_range_is_any(const struct lu_seq_range *range) }/** -* Apply flags to range \a range \a flags +* Apply flags @flasg to range @range */ static inline void fld_range_set_type(struct lu_seq_range *range,
@@ -86,7 +86,7 @@ static inline void fld_range_set_type(struct lu_seq_range *range, }/** -* Add MDT to range type \a range +* Add MDT to range type @range */ static inline void fld_range_set_mdt (struct lu_seq_range *range)
@@ -95,7 +95,7 @@ static inline void fld_range_set_mdt(struct lu_seq_range *range) }/** -* Add OST to range type \a range +* Add OST to range type @range */ static inline void fld_range_set_ost (struct lu_seq_range *range)
@@ -104,7 +104,7 @@ static inline void fld_range_set_ost(struct lu_seq_range *range) }/** -* Add ANY to range type \a range +* Add ANY to range type @range */ static inline void fld_range_set_any (struct lu_seq_range *range)
@@ -113,7 +113,7 @@ static inline void fld_range_set_any(struct lu_seq_range *range) }/** -* computes width of given sequence range \a range +* computes width of given sequence range @range */ static inline u64 lu_seq_range_space (const struct lu_seq_range *range)
@@ -122,7 +122,7 @@ static inline u64 lu_seq_range_space(const struct lu_seq_range *range) }/** -* initialize range to zero \a range +* initialize range to zero @range */ static inline void lu_seq_range_init (struct lu_seq_range *range)
@@ -131,7 +131,7 @@ static inline void lu_seq_range_init(struct lu_seq_range *range) }/** -* check if given seq id \a s is within given range \a range +* check if given seq id @s is within given range @range */ static inline bool lu_seq_range_within(const struct lu_seq_range *range,
@@ -141,7 +141,7 @@ static inline bool lu_seq_range_within(const struct lu_seq_range *range, }/** -* Is the range sane? Is the end after the beginning? \a range +* Is the range sane? Is the end after the beginning? @range */ static inline bool lu_seq_range_is_sane (const struct lu_seq_range *range)
@@ -150,7 +150,7 @@ static inline bool lu_seq_range_is_sane(const struct lu_seq_range *range) }/** -* Is the range 0? \a range +* Is the range 0? @range */ static inline bool lu_seq_range_is_zero (const struct lu_seq_range *range)
@@ -159,7 +159,7 @@ static inline bool lu_seq_range_is_zero(const struct lu_seq_range *range) }/** -* Is the range out of space? \a range +* Is the range out of space? @range */ static inline bool lu_seq_range_is_exhausted (const struct lu_seq_range *range)
@@ -169,7 +169,7 @@ static inline bool lu_seq_range_is_exhausted(const struct lu_seq_range *range)/** * return 0 if two ranges have the same location, nonzero if they are -* different \a r1 \a r2 +* different @r1 @r2 */ static inline int lu_seq_range_compare_loc(const struct lu_seq_range *r1,
@@ -181,7 +181,7 @@ static inline int lu_seq_range_compare_loc(const struct lu_seq_range *r1,#if !defined(__REQ_LAYOUT_USER__)/** -* byte swap range structure \a range +* byte swap range structure @range */ void lustre_swab_lu_seq_range (struct lu_seq_range *range);
Signature · 1 line
1.8.3.1
PATCH 3/7 ptlrpc: move comments to sphinix format
In reply to James SimmonsLustre comments was written for DocBook which is no longer used by the Linux kernel. Move all the DocBook handling to sphinix.
--- drivers/staging/lustre/lustre/ptlrpc/client.c | 72 ++--- drivers/staging/lustre/lustre/ptlrpc/import.c | 6 +- drivers/staging/lustre/lustre/ptlrpc/layout.c | 102 +++---- .../staging/lustre/lustre/ptlrpc/lproc_ptlrpc.c | 10 +- drivers/staging/lustre/lustre/ptlrpc/niobuf.c | 14 +- drivers/staging/lustre/lustre/ptlrpc/nrs.c | 305 +++++++++++---------- drivers/staging/lustre/lustre/ptlrpc/nrs_fifo.c | 68 ++--- .../staging/lustre/lustre/ptlrpc/pack_generic.c | 8 +- drivers/staging/lustre/lustre/ptlrpc/sec.c | 104 +++---- drivers/staging/lustre/lustre/ptlrpc/sec_config.c | 2 +- drivers/staging/lustre/lustre/ptlrpc/service.c | 4 +- 11 files changed, 350 insertions(+), 345 deletions(-)
drivers/staging/lustre/lustre/ptlrpc/client.c +36 -36
@@ -65,7 +65,7 @@static int ptlrpc_unregister_reply (struct ptlrpc_request *request,int async);/** -* Initialize passed in client structure \a cl. +* Initialize passed in client structure @cl. */ void ptlrpc_init_client (int req_portal,int rep_portal,char *name,struct ptlrpc_client *cl)
@@ -77,7 +77,7 @@ void ptlrpc_init_client(int req_portal, int rep_portal, char *name,EXPORT_SYMBOL (ptlrpc_init_client);/** -* Return PortalRPC connection for remote uud \a uuid +* Return PortalRPC connection for remote uud @uuid */ struct ptlrpc_connection *ptlrpc_uuid_to_connection (struct obd_uuid *uuid,lnet_nid_t nid4refnet)
@@ -167,8 +167,8 @@ struct ptlrpc_bulk_desc *ptlrpc_new_bulk(unsigned int nfrags, }/** -* Prepare bulk descriptor for specified outgoing request \a req that -* can fit \a nfrags * pages. \a type is bulk type. \a portal is where +* Prepare bulk descriptor for specified outgoing request @req that +* can fit @nfrags * pages. @type is bulk type. @portal is where * the bulk to be sent. Used on client-side. * Returns pointer to newly allocated initialized bulk descriptor or NULL on * error.
@@ -296,7 +296,7 @@ void ptlrpc_at_set_req_timeout(struct ptlrpc_request *req)/* * non-AT settings * -* \a imp_server_timeout means this is reverse import and +* @imp_server_timeout means this is reverse import and * we send (currently only) ASTs to the client and cannot afford * to wait too long for the reply, otherwise the other client * (because of which we are sending this request) would
@@ -505,7 +505,7 @@ void ptlrpc_request_cache_free(struct ptlrpc_request *req) }/** -* Wind down request pool \a pool. +* Wind down request pool @pool. * Frees all requests from the pool too */ void ptlrpc_free_rq_pool (struct ptlrpc_request_pool *pool)
@@ -525,7 +525,7 @@ void ptlrpc_free_rq_pool(struct ptlrpc_request_pool *pool)EXPORT_SYMBOL (ptlrpc_free_rq_pool);/** -* Allocates, initializes and adds \a num_rq requests to the pool \a pool +* Allocates, initializes and adds @num_rq requests to the pool @pool */ int ptlrpc_add_rqs_to_pool (struct ptlrpc_request_pool *pool,int num_rq) {
@@ -568,9 +568,9 @@ int ptlrpc_add_rqs_to_pool(struct ptlrpc_request_pool *pool, int num_rq)/** * Create and initialize new request pool with given attributes: -* \a num_rq - initial number of requests to create for the pool -* \a msgsize - maximum message size possible for requests in thid pool -* \a populate_pool - function to be called when more requests need to be added +* @num_rq - initial number of requests to create for the pool +* @msgsize - maximum message size possible for requests in thid pool +* @populate_pool - function to be called when more requests need to be added * to the pool * Returns pointer to newly created pool or NULL on error. */
@@ -601,7 +601,7 @@ struct ptlrpc_request_pool *EXPORT_SYMBOL (ptlrpc_init_rq_pool);/** -* Fetches one request from pool \a pool +* Fetches one request from pool @pool */ static struct ptlrpc_request *ptlrpc_prep_req_from_pool (struct ptlrpc_request_pool *pool)
@@ -643,7 +643,7 @@ struct ptlrpc_request_pool * }/** -* Returns freed \a request to pool. +* Returns freed @request to pool. */ static void __ptlrpc_free_req_to_pool (struct ptlrpc_request *request) {
@@ -816,8 +816,8 @@ int ptlrpc_request_pack(struct ptlrpc_request *request,EXPORT_SYMBOL (ptlrpc_request_pack);/** -* Helper function to allocate new request on import \a imp -* and possibly using existing request from pool \a pool if provided. +* Helper function to allocate new request on import @imp +* and possibly using existing request from pool @pool if provided. * Returns allocated request structure with import field filled or * NULL on error. */
@@ -852,7 +852,7 @@ struct ptlrpc_request *__ptlrpc_request_alloc(struct obd_import *imp,/** * Helper function for creating a request. * Calls __ptlrpc_request_alloc to allocate new request structure and inits -* buffer structures according to capsule template \a format. +* buffer structures according to capsule template @format. * Returns allocated request structure pointer or NULL on error. */ static struct ptlrpc_request *
@@ -872,8 +872,8 @@ struct ptlrpc_request *__ptlrpc_request_alloc(struct obd_import *imp, }/** -* Allocate new request structure for import \a imp and initialize its -* buffer structure according to capsule template \a format. +* Allocate new request structure for import @imp and initialize its +* buffer structure according to capsule template @format. */ struct ptlrpc_request *ptlrpc_request_alloc (struct obd_import *imp,const struct req_format *format)
@@ -883,8 +883,8 @@ struct ptlrpc_request *ptlrpc_request_alloc(struct obd_import *imp,EXPORT_SYMBOL (ptlrpc_request_alloc);/** -* Allocate new request structure for import \a imp from pool \a pool and -* initialize its buffer structure according to capsule template \a format. +* Allocate new request structure for import @imp from pool @pool and +* initialize its buffer structure according to capsule template @format. */ struct ptlrpc_request *ptlrpc_request_alloc_pool(struct obd_import *imp, struct ptlrpc_request_pool *pool,
@@ -908,7 +908,7 @@ void ptlrpc_request_free(struct ptlrpc_request *request)EXPORT_SYMBOL (ptlrpc_request_free);/** -* Allocate new request for operation \a opcode and immediately pack it for +* Allocate new request for operation @opcode and immediately pack it for * network transfer. * Only used for simple requests like OBD_PING where the only important * part of the request is operation itself.
@@ -1178,10 +1178,10 @@ static int ptlrpc_import_delay_req(struct obd_import *imp,* Decide if the error message should be printed to the console or not. * Makes its decision based on request type, status, and failure frequency. * -* \param[in] req request that failed and may need a console message +* @req: request that failed and may need a console message * -* \retval false if no message should be printed -* \retval true if console message should be printed +* Return: false if no message should be printed +* true if console message should be printed */ static bool ptlrpc_console_allow (struct ptlrpc_request *req) {
@@ -1285,7 +1285,7 @@ u64 ptlrpc_known_replied_xid(struct obd_import *imp) }/** -* Callback function called when client receives RPC reply for \a req. +* Callback function called when client receives RPC reply for @req. * Returns 0 on success or error code. * The return value would be assigned to req->rq_status by the caller * as request processing status.
@@ -1482,7 +1482,7 @@ static int after_reply(struct ptlrpc_request *req) }/** -* Helper function to send request \a req over the network for the first time +* Helper function to send request @req over the network for the first time * Also adjusts request phase. * Returns 0 on success or error code. */
@@ -1629,7 +1629,7 @@ static inline int ptlrpc_set_producer(struct ptlrpc_request_set *set) }/** -* this sends any unsent RPCs in \a set and returns 1 if all are sent +* this sends any unsent RPCs in @set and returns 1 if all are sent * and no more replies are expected. * (it is possible to get less replies than requests sent e.g. due to timed out * requests or requests that we had trouble to send out)
@@ -2046,7 +2046,7 @@ int ptlrpc_check_set(const struct lu_env *env, struct ptlrpc_request_set *set)EXPORT_SYMBOL (ptlrpc_check_set);/** -* Time out request \a req. is \a async_unlink is set, that means do not wait +* Time out request @req. is @async_unlink is set, that means do not wait * until LNet actually confirms network buffer unlinking. * Return 1 if we should give up further retrying attempts or 0 otherwise. */
@@ -2119,7 +2119,7 @@ int ptlrpc_expire_one_request(struct ptlrpc_request *req, int async_unlink) }/** -* Time out all uncompleted requests in request set pointed by \a data +* Time out all uncompleted requests in request set pointed by @data * Called when wait_event_idle_timeout times out. */ void ptlrpc_expired_set (struct ptlrpc_request_set *set)
@@ -2153,7 +2153,7 @@ void ptlrpc_expired_set(struct ptlrpc_request_set *set)/** * Interrupts (sets interrupted flag) all uncompleted requests in -* a set \a data. Called when l_wait_event_abortable_timeout receives signal. +* a set @data. Called when l_wait_event_abortable_timeout receives signal. */ static void ptlrpc_interrupted_set (struct ptlrpc_request_set *set) {
@@ -2343,7 +2343,7 @@ int ptlrpc_set_wait(struct ptlrpc_request_set *set)* Called when request count reached zero and request needs to be freed. * Removes request from all sorts of sending/replay lists it might be on, * frees network buffers if any are present. -* If \a locked is set, that means caller is already holding import imp_lock +* If @locked is set, that means caller is already holding import imp_lock * and so we no longer need to reobtain it (for certain lists manipulations) */ static void __ptlrpc_free_req (struct ptlrpc_request *request,int locked)
@@ -2403,8 +2403,8 @@ static void __ptlrpc_free_req(struct ptlrpc_request *request, int locked)/** * Helper function -* Drops one reference count for request \a request. -* \a locked set indicates that caller holds import imp_lock. +* Drops one reference count for request @request. +* @locked set indicates that caller holds import imp_lock. * Frees the request when reference count reaches zero. * * RETURN 1 the request is freed
@@ -2466,7 +2466,7 @@ void ptlrpc_req_finished(struct ptlrpc_request *request)EXPORT_SYMBOL (ptlrpc_req_finished);/** -* Returns xid of a \a request +* Returns xid of a @request */ u64 ptlrpc_req_xid (struct ptlrpc_request *request) {
@@ -2699,7 +2699,7 @@ void ptlrpc_resend_req(struct ptlrpc_request *req) }/** -* Grab additional reference on a request \a req +* Grab additional reference on a request @req */ struct ptlrpc_request *ptlrpc_request_addref (struct ptlrpc_request *req) {
@@ -2949,7 +2949,7 @@ int ptlrpc_replay_req(struct ptlrpc_request *req) }/** -* Aborts all in-flight request on import \a imp sending and delayed lists +* Aborts all in-flight request on import @imp sending and delayed lists */ void ptlrpc_abort_inflight (struct obd_import *imp) {
@@ -3002,7 +3002,7 @@ void ptlrpc_abort_inflight(struct obd_import *imp) }/** -* Abort all uncompleted requests in request set \a set +* Abort all uncompleted requests in request set @set */ void ptlrpc_abort_set (struct ptlrpc_request_set *set) {
drivers/staging/lustre/lustre/ptlrpc/import.c +3 -3
@@ -56,7 +56,7 @@ struct ptlrpc_connect_async_args { };/** -* Updates import \a imp current state to provided \a state value +* Updates import @imp current state to provided @state value * Helper function. Must be called under imp_lock. */ static void __import_set_state(struct obd_import *imp,
@@ -435,7 +435,7 @@ int ptlrpc_reconnect_import(struct obd_import *imp)EXPORT_SYMBOL (ptlrpc_reconnect_import);/** -* Connection on import \a imp is changed to another one (if more than one is +* Connection on import @imp is changed to another one (if more than one is * present). We typically chose connection that we have not tried to connect to * the longest */
@@ -579,7 +579,7 @@ static int ptlrpc_first_transno(struct obd_import *imp, u64 *transno) }/** -* Attempt to (re)connect import \a imp. This includes all preparations, +* Attempt to (re)connect import @imp. This includes all preparations, * initializing CONNECT RPC request and passing it to ptlrpcd for * actual sending. * Returns 0 on success or error code.
drivers/staging/lustre/lustre/ptlrpc/layout.c +51 -51
264 lines not on this page · raw message
drivers/staging/lustre/lustre/ptlrpc/lproc_ptlrpc.c +5 -5
@@ -415,7 +415,7 @@ static ssize_t threads_max_store(struct kobject *kobj, struct attribute *attr,/** * Translates \e ptlrpc_nrs_pol_state values to human-readable strings. * -* \param[in] state The policy state +* @state: The policy state */ static const char *nrs_state2str (enum ptlrpc_nrs_pol_state state) {
@@ -436,12 +436,12 @@ static const char *nrs_state2str(enum ptlrpc_nrs_pol_state state) }/** -* Obtains status information for \a policy. +* Obtains status information for @policy. * -* Information is copied in \a info. +* Information is copied in @info. * -* \param[in] policy The policy -* \param[out] info Holds returned status information +* @policy: The policy +* @info: Holds returned status information */ static void nrs_policy_get_info_locked (struct ptlrpc_nrs_policy *policy,struct ptlrpc_nrs_pol_info *info)
drivers/staging/lustre/lustre/ptlrpc/niobuf.c +7 -7
@@ -41,8 +41,8 @@#include "ptlrpc_internal.h" /** -* Helper function. Sends \a len bytes from \a base at offset \a offset -* over \a conn connection to portal \a portal. +* Helper function. Sends @len bytes from @base at offset @offset +* over @conn connection to portal @portal. * Returns 0 on success or error code. */ static int ptl_send_buf(struct lnet_handle_md *mdh, void *base, int len,
@@ -343,8 +343,8 @@ static void ptlrpc_at_set_reply(struct ptlrpc_request *req, int flags) }/** -* Send request reply from request \a req reply buffer. -* \a flags defines reply types +* Send request reply from request @req reply buffer. +* @flags defines reply types * Returns 0 on success or error code */ int ptlrpc_send_reply (struct ptlrpc_request *req,int flags)
@@ -443,7 +443,7 @@ int ptlrpc_reply(struct ptlrpc_request *req) }/** -* For request \a req send an error reply back. Create empty +* For request @req send an error reply back. Create empty * reply buffers if necessary. */ int ptlrpc_send_error (struct ptlrpc_request *req,int may_be_difficult)
@@ -474,8 +474,8 @@ int ptlrpc_error(struct ptlrpc_request *req) }/** -* Send request \a request. -* if \a noreply is set, don't expect any reply back and don't set up +* Send request @request. +* if @noreply is set, don't expect any reply back and don't set up * reply buffers. * Returns 0 on success or error code. */
drivers/staging/lustre/lustre/ptlrpc/nrs.c +153 -152
524 lines not on this page · raw message
drivers/staging/lustre/lustre/ptlrpc/nrs_fifo.c +34 -34
118 lines not on this page · raw message
drivers/staging/lustre/lustre/ptlrpc/pack_generic.c +4 -4
@@ -648,11 +648,11 @@ static inline u32 lustre_msg_buflen_v2(struct lustre_msg_v2 *m, u32 n) }/** -* lustre_msg_buflen - return the length of buffer \a n in message \a m -* \param m lustre_msg (request or reply) to look at -* \param n message index (base 0) +* lustre_msg_buflen - return the length of buffer @n in message @m +* @m lustre_msg (request or reply) to look at +* @n message index (base 0) * -* returns zero for non-existent message indices +* Return: zero for non-existent message indices */ u32 lustre_msg_buflen (struct lustre_msg *m,u32 n) {
drivers/staging/lustre/lustre/ptlrpc/sec.c +54 -50
258 lines not on this page · raw message
drivers/staging/lustre/lustre/ptlrpc/sec_config.c +1 -1
@@ -568,7 +568,7 @@ static int sptlrpc_conf_merge_rule(struct sptlrpc_conf *conf, }/** -* process one LCFG_SPTLRPC_CONF record. if \a conf is NULL, we +* process one LCFG_SPTLRPC_CONF record. if @conf is NULL, we * find one through the target name in the record inside conf_lock; * otherwise means caller already hold conf_lock. */
drivers/staging/lustre/lustre/ptlrpc/service.c +2 -2
@@ -877,7 +877,7 @@ static void ptlrpc_server_finish_active_request( }/** -* Sanity check request \a req. +* Sanity check request @req. * Return 0 if all is ok, error code otherwise. */ static int ptlrpc_check_req (struct ptlrpc_request *req)
@@ -2375,7 +2375,7 @@ static void ptlrpc_svcpt_stop_threads(struct ptlrpc_service_part *svcpt) }/** -* Stops all threads of a particular service \a svc +* Stops all threads of a particular service @svc */ static void ptlrpc_stop_all_threads (struct ptlrpc_service *svc) {
Signature · 1 line
1.8.3.1
PATCH 4/7 ldlm: move comments to sphinix format
In reply to James SimmonsLustre comments was written for DocBook which is no longer used by the Linux kernel. Move all the DocBook handling to sphinix.
--- drivers/staging/lustre/lustre/ldlm/ldlm_flock.c | 14 +-- drivers/staging/lustre/lustre/ldlm/ldlm_lib.c | 8 +- drivers/staging/lustre/lustre/ldlm/ldlm_lock.c | 90 ++++++++++---------- drivers/staging/lustre/lustre/ldlm/ldlm_lockd.c | 6 +- drivers/staging/lustre/lustre/ldlm/ldlm_pool.c | 22 ++--- drivers/staging/lustre/lustre/ldlm/ldlm_request.c | 99 +++++++++++----------- drivers/staging/lustre/lustre/ldlm/ldlm_resource.c | 18 ++-- 7 files changed, 127 insertions(+), 130 deletions(-)
drivers/staging/lustre/lustre/ldlm/ldlm_flock.c +7 -7
@@ -100,7 +100,7 @@* Process a granting attempt for flock lock. * Must be called under ns lock held. * -* This function looks for any conflicts for \a lock in the granted or +* This function looks for any conflicts for @lock in the granted or * waiting queues. The lock is granted if no conflicts are found in * either queue. *
@@ -291,7 +291,7 @@ static int ldlm_process_flock_lock(struct ldlm_lock *req)/* In case we're reprocessing the requested lock we can't destroy * it until after calling ldlm_add_ast_work_item() above so that laawi() -* can bump the reference count on \a req. Otherwise \a req +* can bump the reference count on @req. Otherwise @req * could be freed before the completion AST can be sent. */ if (added)
@@ -304,12 +304,12 @@ static int ldlm_process_flock_lock(struct ldlm_lock *req)/** * Flock completion callback function. * -* \param lock [in,out]: A lock to be handled -* \param flags [in]: flags -* \param *data [in]: ldlm_work_cp_ast_lock() will use ldlm_cb_set_arg +* @lock A lock to be handled +* @flags flags +* @data ldlm_work_cp_ast_lock() will use ldlm_cb_set_arg * -* \retval 0 : success -* \retval <0 : failure +* Return: 0 success +* <0 failure */ int ldlm_flock_completion_ast (struct ldlm_lock *lock,u64 flags,void *data)
drivers/staging/lustre/lustre/ldlm/ldlm_lib.c +4 -4
@@ -99,7 +99,7 @@ static int import_set_conn(struct obd_import *imp, struct obd_uuid *uuid, goto out_free; } } -/* No existing import connection found for \a uuid. */ +/* No existing import connection found for @uuid. */ if (create) { imp_conn->oic_conn = ptlrpc_conn; imp_conn->oic_uuid = *uuid;
@@ -198,8 +198,8 @@ int client_import_del_conn(struct obd_import *imp, struct obd_uuid *uuid)EXPORT_SYMBOL (client_import_del_conn);/** -* Find conn UUID by peer NID. \a peer is a server NID. This function is used -* to find a conn uuid of \a imp which can reach \a peer. +* Find conn UUID by peer NID. @peer is a server NID. This function is used +* to find a conn uuid of @imp which can reach @peer. */ int client_import_find_conn (struct obd_import *imp,lnet_nid_t peer,struct obd_uuid *uuid)
@@ -654,7 +654,7 @@ int client_disconnect_export(struct obd_export *exp)EXPORT_SYMBOL (client_disconnect_export);/** -* Packs current SLV and Limit into \a req. +* Packs current SLV and Limit into @req. */ int target_pack_pool_reply (struct ptlrpc_request *req) {
drivers/staging/lustre/lustre/ldlm/ldlm_lock.c +45 -45
271 lines not on this page · raw message
drivers/staging/lustre/lustre/ldlm/ldlm_lockd.c +3 -3
@@ -382,9 +382,9 @@ static inline void init_blwi(struct ldlm_bl_work_item *blwi, }/** -* Queues a list of locks \a cancels containing \a count locks -* for later processing by a blocking thread. If \a count is zero, -* then the lock referenced as \a lock is queued instead. +* Queues a list of locks @cancels containing @count locks +* for later processing by a blocking thread. If @count is zero, +* then the lock referenced as @lock is queued instead. * * The blocking thread would then call ->l_blocking_ast callback in the lock. * If list addition fails an error is returned and caller is supposed to
drivers/staging/lustre/lustre/ldlm/ldlm_pool.c +11 -11
@@ -175,7 +175,7 @@ enum {/** * Calculates suggested grant_step in % of available locks for passed -* \a period. This is later used in grant_plan calculations. +* @period. This is later used in grant_plan calculations. */ static inline int ldlm_pool_t2gsp (unsigned int t) {
@@ -205,7 +205,7 @@ static inline int ldlm_pool_t2gsp(unsigned int t) }/** -* Recalculates next stats on passed \a pl. +* Recalculates next stats on passed @pl. * * \pre ->pl_lock is locked. */
@@ -231,7 +231,7 @@ static void ldlm_pool_recalc_stats(struct ldlm_pool *pl)/** * Sets SLV and Limit from container_of(pl, struct ldlm_namespace, -* ns_pool)->ns_obd tp passed \a pl. +* ns_pool)->ns_obd tp passed @pl. */ static void ldlm_cli_pool_pop_slv (struct ldlm_pool *pl) {
@@ -250,7 +250,7 @@ static void ldlm_cli_pool_pop_slv(struct ldlm_pool *pl) }/** -* Recalculates client size pool \a pl according to current SLV and Limit. +* Recalculates client size pool @pl according to current SLV and Limit. */ static int ldlm_cli_pool_recalc (struct ldlm_pool *pl) {
@@ -312,7 +312,7 @@ static int ldlm_cli_pool_recalc(struct ldlm_pool *pl)/** * This function is main entry point for memory pressure handling on client * side. Main goal of this function is to cancel some number of locks on -* passed \a pl according to \a nr and \a gfp_mask. +* passed @pl according to @nr and @gfp_mask. */ static int ldlm_cli_pool_shrink (struct ldlm_pool *pl,int nr,gfp_t gfp_mask)
@@ -350,7 +350,7 @@ static int ldlm_cli_pool_shrink(struct ldlm_pool *pl,/** * Pool recalc wrapper. Will call either client or server pool recalc callback -* depending what pool \a pl is used. +* depending what pool @pl is used. */ static int ldlm_pool_recalc (struct ldlm_pool *pl) {
@@ -691,7 +691,7 @@ void ldlm_pool_fini(struct ldlm_pool *pl) }/** -* Add new taken ldlm lock \a lock into pool \a pl accounting. +* Add new taken ldlm lock @lock into pool @pl accounting. */ void ldlm_pool_add (struct ldlm_pool *pl,struct ldlm_lock *lock) {
@@ -716,7 +716,7 @@ void ldlm_pool_add(struct ldlm_pool *pl, struct ldlm_lock *lock) }/** -* Remove ldlm lock \a lock from pool \a pl accounting. +* Remove ldlm lock @lock from pool @pl accounting. */ void ldlm_pool_del (struct ldlm_pool *pl,struct ldlm_lock *lock) {
@@ -734,7 +734,7 @@ void ldlm_pool_del(struct ldlm_pool *pl, struct ldlm_lock *lock) }/** -* Returns current \a pl SLV. +* Returns current @pl SLV. * * \pre ->pl_lock is not locked. */
@@ -749,7 +749,7 @@ u64 ldlm_pool_get_slv(struct ldlm_pool *pl) }/** -* Sets passed \a clv to \a pl. +* Sets passed @clv to @pl. * * \pre ->pl_lock is not locked. */
@@ -761,7 +761,7 @@ void ldlm_pool_set_clv(struct ldlm_pool *pl, u64 clv) }/** -* Returns current LVF from \a pl. +* Returns current LVF from @pl. */ u32 ldlm_pool_get_lvf (struct ldlm_pool *pl) {
drivers/staging/lustre/lustre/ldlm/ldlm_request.c +48 -51
217 lines not on this page · raw message
drivers/staging/lustre/lustre/ldlm/ldlm_resource.c +9 -9
@@ -557,7 +557,7 @@ struct ldlm_ns_hash_def { }, }; -/** Register \a ns in the list of namespaces */ +/** Register @ns in the list of namespaces */ static void ldlm_namespace_register (struct ldlm_namespace *ns,enum ldlm_side client) {
@@ -859,13 +859,13 @@ static int __ldlm_namespace_free(struct ldlm_namespace *ns, int force) }/** -* Performs various cleanups for passed \a ns to make it drop refc and be +* Performs various cleanups for passed @ns to make it drop refc and be * ready for freeing. Waits for refc == 0. * * The following is done: -* (0) Unregister \a ns from its list to make inaccessible for potential +* (0) Unregister @ns from its list to make inaccessible for potential * users like pools thread and others; -* (1) Clear all locks in \a ns. +* (1) Clear all locks in @ns. */ void ldlm_namespace_free_prior(struct ldlm_namespace *ns, struct obd_import *imp,
@@ -899,7 +899,7 @@ void ldlm_namespace_free_prior(struct ldlm_namespace *ns, } } -/** Unregister \a ns from the list of namespaces. */ +/** Unregister @ns from the list of namespaces. */ static void ldlm_namespace_unregister (struct ldlm_namespace *ns,enum ldlm_side client) {
@@ -915,9 +915,9 @@ static void ldlm_namespace_unregister(struct ldlm_namespace *ns, }/** -* Performs freeing memory structures related to \a ns. This is only done +* Performs freeing memory structures related to @ns. This is only done * when ldlm_namespce_free_prior() successfully removed all resources -* referencing \a ns and its refc == 0. +* referencing @ns and its refc == 0. */ void ldlm_namespace_free_post (struct ldlm_namespace *ns) {
@@ -936,8 +936,8 @@ void ldlm_namespace_free_post(struct ldlm_namespace *ns)ldlm_namespace_sysfs_unregister (ns);cfs_hash_putref (ns->ns_rs_hash);kfree (ns->ns_name); -/* Namespace \a ns should be not on list at this time, otherwise -* this will cause issues related to using freed \a ns in poold +/* Namespace @ns should be not on list at this time, otherwise +* this will cause issues related to using freed @ns in poold * thread. */ LASSERT (list_empty (&ns->ns_list_chain));
Signature · 1 line
1.8.3.1
PATCH 5/7 llite: move comments to sphinix format
In reply to James SimmonsLustre comments was written for DocBook which is no longer used by the Linux kernel. Move all the DocBook handling to sphinix.
--- drivers/staging/lustre/lustre/llite/dir.c | 14 ++--- drivers/staging/lustre/lustre/llite/file.c | 62 +++++++++++----------- drivers/staging/lustre/lustre/llite/glimpse.c | 4 +- drivers/staging/lustre/lustre/llite/lcommon_cl.c | 5 +- drivers/staging/lustre/lustre/llite/llite_lib.c | 48 ++++++++--------- drivers/staging/lustre/lustre/llite/llite_mmap.c | 19 +++---- drivers/staging/lustre/lustre/llite/llite_nfs.c | 4 +- drivers/staging/lustre/lustre/llite/lproc_llite.c | 22 ++++---- drivers/staging/lustre/lustre/llite/range_lock.c | 20 +++---- drivers/staging/lustre/lustre/llite/rw.c | 14 ++--- drivers/staging/lustre/lustre/llite/statahead.c | 59 ++++++++++---------- drivers/staging/lustre/lustre/llite/super25.c | 3 +- drivers/staging/lustre/lustre/llite/vvp_io.c | 2 +- drivers/staging/lustre/lustre/llite/vvp_page.c | 8 +-- drivers/staging/lustre/lustre/llite/xattr_cache.c | 44 +++++++-------- .../staging/lustre/lustre/llite/xattr_security.c | 12 ++--- 16 files changed, 174 insertions(+), 166 deletions(-)
drivers/staging/lustre/lustre/llite/dir.c +7 -7
@@ -393,13 +393,13 @@ static int ll_send_mgc_param(struct obd_export *mgc, char *string)/** * Create striped directory with specified stripe(@lump) * -* param[in] dparent the parent of the directory. -* param[in] lump the specified stripes. -* param[in] dirname the name of the directory. -* param[in] mode the specified mode of the directory. +* @dparent: the parent of the directory. +* @lump: the specified stripes. +* @dirname: the name of the directory. +* @mode: the specified mode of the directory. * -* retval =0 if striped directory is being created successfully. -* <0 if the creation is failed. +* Returns: =0 if striped directory is being created successfully. +* <0 if the creation is failed. */ static int ll_dir_setdirstripe (struct dentry *dparent,struct lmv_user_md *lump,const char *dirname,umode_t mode)
@@ -738,7 +738,7 @@ int ll_get_mdt_idx(struct inode *inode)* first information for it that real work has started. * * Moreover, for a ARCHIVE request, it will sample the file data version and -* store it in \a copy. +* store it in @copy. * * \return 0 on success. */
drivers/staging/lustre/lustre/llite/file.c +32 -30
120 lines not on this page · raw message
drivers/staging/lustre/lustre/llite/glimpse.c +2 -2
@@ -58,8 +58,8 @@/* * Check whether file has possible unwriten pages. * -* \retval 1 file is mmap-ed or has dirty pages -* 0 otherwise +* Return: 1 if file is mmap-ed or has dirty pages +* 0 otherwise */ blkcnt_t dirty_cnt (struct inode *inode) {
drivers/staging/lustre/lustre/llite/lcommon_cl.c +3 -2
@@ -130,8 +130,9 @@ int cl_setattr_ost(struct cl_object *obj, const struct iattr *attr,* Initialize or update CLIO structures for regular files when new * meta-data arrives from the server. * -* \param inode regular file inode -* \param md new file metadata from MDS +* @inode regular file inode +* @md new file metadata from MDS +* * - allocates cl_object if necessary, * - updated layout, if object was already here. */
drivers/staging/lustre/lustre/llite/llite_lib.c +24 -24
88 lines not on this page · raw message
drivers/staging/lustre/lustre/llite/llite_mmap.c +10 -9
@@ -79,10 +79,11 @@ struct vm_area_struct *our_vma(struct mm_struct *mm, unsigned long addr,/** * API independent part for page fault initialization. -* \param vma - virtual memory area addressed to page fault -* \param env - corespondent lu_env to processing -* \param index - page index corespondent to fault. -* \parm ra_flags - vma readahead flags. +* +* @vma virtual memory area addressed to page fault +* @env corespondent lu_env to processing +* @index page index corespondent to fault. +* @ra_flags vma readahead flags. * * \return error codes from cl_io_init. */
@@ -254,12 +255,12 @@ static inline vm_fault_t to_fault_error(int result)* Lustre implementation of a vm_operations_struct::fault() method, called by * VM to server page fault (both in kernel and user space). * -* \param vma - is virtual area struct related to page fault -* \param vmf - structure which describe type and address where hit fault +* @vma is virtual area struct related to page fault +* @vmf structure which describe type and address where hit fault * -* \return allocated and filled _locked_ page for address -* \retval VM_FAULT_ERROR on general error -* \retval NOPAGE_OOM not have memory for allocate new page +* Return: allocated and filled _locked_ page for address +* VM_FAULT_ERROR on general error +* NOPAGE_OOM not have memory for allocate new page */ static vm_fault_t __ll_fault (struct vm_area_struct *vma,struct vm_fault *vmf) {
drivers/staging/lustre/lustre/llite/llite_nfs.c +2 -2
@@ -178,8 +178,8 @@ struct lustre_nfs_fid { }/** -* \a connectable - is nfsd will connect himself or this should be done -* at lustre +* @connectable - is nfsd will connect himself or this should be done +* @lustre * * The return value is file handle type: * 1 -- contains child file handle;
drivers/staging/lustre/lustre/llite/lproc_llite.c +11 -11
@@ -893,12 +893,12 @@ static ssize_t max_easize_show(struct kobject *kobj,* * \see client_obd::cl_default_mds_easize * -* \param[in] kobj kernel object for sysfs tree -* \param[in] attr attribute of this kernel object -* \param[in] buf buffer to write data into +* @kobj: kernel object for sysfs tree +* @attr: attribute of this kernel object +* @buf: buffer to write data into * -* \retval positive \a count on success -* \retval negative negated errno on failure +* Returns: positive @count on success +* negated errno on failure */ static ssize_t default_easize_show(struct kobject *kobj, struct attribute *attr,
@@ -924,13 +924,13 @@ static ssize_t default_easize_show(struct kobject *kobj,* * \see client_obd::cl_default_mds_easize * -* \param[in] kobj kernel object for sysfs tree -* \param[in] attr attribute of this kernel object -* \param[in] buffer string passed from user space -* \param[in] count \a buffer length +* @kobj: kernel object for sysfs tree +* @attr: attribute of this kernel object +* @buffer: string passed from user space +* @count: @buffer length * -* \retval positive \a count on success -* \retval negative negated errno on failure +* Returns: positive @count on success +* negated errno on failure */ static ssize_t default_easize_store(struct kobject *kobj, struct attribute *attr,
drivers/staging/lustre/lustre/llite/range_lock.c +10 -10
@@ -47,7 +47,7 @@/** * Initialize a range lock tree * -* \param tree [in] an empty range lock tree +* @tree an empty range lock tree * * Pre: Caller should have allocated the range lock tree. * Post: The range lock tree is ready to function.
@@ -62,9 +62,9 @@ void range_lock_tree_init(struct range_lock_tree *tree)/** * Initialize a range lock node * -* \param lock [in] an empty range lock node -* \param start [in] start of the covering region -* \param end [in] end of the covering region +* @lock an empty range lock node +* @start start of the covering region +* @end end of the covering region * * Pre: Caller should have allocated the range lock node. * Post: The range lock node is meant to cover [start, end] region
@@ -89,8 +89,8 @@ int range_lock_init(struct range_lock *lock, u64 start, u64 end)/** * Unlock a range lock, wake up locks blocked by this lock. * -* \param tree [in] range lock tree -* \param lock [in] range lock to be deleted +* @tree range lock tree +* @lock range lock to be deleted * * If this lock has been granted, relase it; if not, just delete it from * the tree or the same region lock list. Wake up those locks only blocked
@@ -120,11 +120,11 @@ void range_unlock(struct range_lock_tree *tree, struct range_lock *lock)/** * Lock a region * -* \param tree [in] range lock tree -* \param lock [in] range lock node containing the region span +* @tree range lock tree +* @lock range lock node containing the region span * -* \retval 0 get the range lock -* \retval <0 error code while not getting the range lock +* Return: 0 get the range lock +* <0 error code while not getting the range lock * * If there exists overlapping range lock, the new lock will wait and * retry, if later it find that it is not the chosen one to wake up,
drivers/staging/lustre/lustre/llite/rw.c +7 -7
@@ -62,9 +62,9 @@* Get readahead pages from the filesystem readahead pool of the client for a * thread. * -* /param sbi superblock for filesystem readahead state ll_ra_info -* /param ria per-thread readahead state -* /param pages number of pages requested for readahead for the thread. +* @sbi: superblock for filesystem readahead state ll_ra_info +* @ria: per-thread readahead state +* @pages: number of pages requested for readahead for the thread. * * WARNING: This algorithm is used to reduce contention on sbi->ll_lock. * It should work well if the ra_max_pages is much greater than the single
@@ -73,7 +73,7 @@* * TODO: There may be a 'global sync problem' if many threads are trying * to get an ra budget that is larger than the remaining readahead pages -* and reach here at exactly the same time. They will compute /a ret to +* and reach here at exactly the same time. They will compute @ret to * consume the remaining pages, but will fail at atomic_add_return() and * get a zero ra window, although there is still ra space remaining. - Jay */
@@ -168,10 +168,10 @@ void ll_ras_enter(struct file *f)/** * Initiates read-ahead of a page with given index. * -* \retval +ve: page was already uptodate so it will be skipped +* Return: +ve if page was already uptodate so it will be skipped * from being added; -* \retval -ve: page wasn't added to \a queue for error; -* \retval 0: page was added into \a queue for read ahead. +* -ve if page wasn't added to @queue for error; +* 0 if page was added into @queue for read ahead. */ static int ll_read_ahead_page (const struct lu_env *env,struct cl_io *io,struct cl_page_list *queue,pgoff_t index)
drivers/staging/lustre/lustre/llite/statahead.c +31 -28
83 lines not on this page · raw message
drivers/staging/lustre/lustre/llite/super25.c +2 -1
@@ -86,7 +86,8 @@ struct super_operations lustre_super_operations = {/** This is the entry point for the mount call into Lustre. * This is called when a server or client is mounted, * and this is where we start setting things up. -* @param data Mount options (e.g. -o flock,abort_recov) +* +* @data: Mount options (e.g. -o flock,abort_recov) */ static int lustre_fill_super (struct super_block *sb,void *lmd2_data,int silent) {
drivers/staging/lustre/lustre/llite/vvp_io.c +1 -1
@@ -107,7 +107,7 @@ static void vvp_object_size_unlock(struct cl_object *obj)/** * Helper function that if necessary adjusts file size (inode->i_size), when -* position at the offset \a pos is accessed. File size can be arbitrary stale +* position at the offset @pos is accessed. File size can be arbitrary stale * on a Lustre client, but client at least knows KMS. If accessed area is * inside [0, KMS], set file size to KMS, otherwise glimpse file size. *
drivers/staging/lustre/lustre/llite/vvp_page.c +4 -4
@@ -227,7 +227,7 @@ static int vvp_page_prep_write(const struct lu_env *env,* Handles page transfer errors at VM level. * * This takes inode as a separate argument, because inode on which error is to -* be set can be different from \a vmpage inode in case of direct-io. +* be set can be different from @vmpage inode in case of direct-io. */ static void vvp_vmpage_error (struct inode *inode,struct page *vmpage,int ioret)
@@ -309,10 +309,10 @@ static void vvp_page_completion_write(const struct lu_env *env,* but hopefully rare situation, as it usually results in transfer being * shorter than possible). * -* \retval 0 success, page can be placed into transfer +* Return: 0 success, page can be placed into transfer * -* \retval -EAGAIN page is either used by concurrent IO has been -* truncated. Skip it. +* -EAGAIN page is either used by concurrent IO has been +* truncated. Skip it. */ static int vvp_page_make_ready (const struct lu_env *env,const struct cl_page_slice *slice)
drivers/staging/lustre/lustre/llite/xattr_cache.c +22 -22
98 lines not on this page · raw message
drivers/staging/lustre/lustre/llite/xattr_security.c +6 -6
@@ -79,9 +79,9 @@ int ll_dentry_init_security(struct dentry *dentry, int mode, struct qstr *name,* and put it in 'security.xxx' xattr of dentry * stored in @fs_info. * -* \retval 0 success -* \retval -ENOMEM if no memory could be allocated for xattr name -* \retval < 0 failure to set xattr +* Return: 0 success +* -ENOMEM if no memory could be allocated for xattr name +* < 0 failure to set xattr */ static int ll_initxattrs(struct inode *inode, const struct xattr *xattr_array,
@@ -116,9 +116,9 @@ int ll_dentry_init_security(struct dentry *dentry, int mode, struct qstr *name,* Get security context of @inode in @dir, * and put it in 'security.xxx' xattr of @dentry. * -* \retval 0 success, or SELinux is disabled -* \retval -ENOMEM if no memory could be allocated for xattr name -* \retval < 0 failure to get security context or set xattr +* Return: 0 success, or SELinux is disabled +* -ENOMEM if no memory could be allocated for xattr name +* < 0 failure to get security context or set xattr */ int ll_inode_init_security(struct dentry *dentry, struct inode *inode,
Signature · 1 line
1.8.3.1
PATCH 6/7 obdclass: move comments to sphinix format
In reply to James SimmonsLustre comments was written for DocBook which is no longer used by the Linux kernel. Move all the DocBook handling to sphinix.
--- drivers/staging/lustre/lustre/obdclass/cl_io.c | 12 +++--- drivers/staging/lustre/lustre/obdclass/cl_lock.c | 11 ++--- drivers/staging/lustre/lustre/obdclass/cl_object.c | 44 ++++++++++---------- drivers/staging/lustre/lustre/obdclass/cl_page.c | 30 +++++++------- drivers/staging/lustre/lustre/obdclass/genops.c | 22 +++++----- .../staging/lustre/lustre/obdclass/kernelcomm.c | 23 ++++++----- drivers/staging/lustre/lustre/obdclass/linkea.c | 15 +++---- .../lustre/lustre/obdclass/lprocfs_status.c | 30 +++++++------- drivers/staging/lustre/lustre/obdclass/lu_object.c | 44 ++++++++++---------- drivers/staging/lustre/lustre/obdclass/obd_mount.c | 47 ++++++++++++---------- 10 files changed, 143 insertions(+), 135 deletions(-)
drivers/staging/lustre/lustre/obdclass/cl_io.c +6 -6
@@ -83,7 +83,7 @@ static int cl_io_invariant(const struct cl_io *io) }/** -* Finalize \a io, by calling cl_io_operations::cio_fini() bottom-to-top. +* Finalize @io, by calling cl_io_operations::cio_fini() bottom-to-top. */ void cl_io_fini (const struct lu_env *env,struct cl_io *io) {
@@ -175,7 +175,7 @@ int cl_io_sub_init(const struct lu_env *env, struct cl_io *io,EXPORT_SYMBOL (cl_io_sub_init);/** -* Initialize \a io, by calling cl_io_operations::cio_init() top-to-bottom. +* Initialize @io, by calling cl_io_operations::cio_init() top-to-bottom. * * Caller has to call cl_io_fini() after a call to cl_io_init(), no matter * what the latter returned.
@@ -413,7 +413,7 @@ void cl_io_iter_fini(const struct lu_env *env, struct cl_io *io)EXPORT_SYMBOL (cl_io_iter_fini);/** -* Records that read or write io progressed \a nob bytes forward. +* Records that read or write io progressed @nob bytes forward. */ static void cl_io_rw_advance (const struct lu_env *env,struct cl_io *io,size_t nob)
@@ -618,7 +618,7 @@ static void cl_page_list_assume(const struct lu_env *env,/** * Submit a sync_io and wait for the IO to be finished, or error happens. -* If \a timeout is zero, it means to wait for the IO unconditionally. +* If @timeout is zero, it means to wait for the IO unconditionally. */ int cl_io_submit_sync(const struct lu_env *env, struct cl_io *io, enum cl_req_type iot, struct cl_2queue *queue,
@@ -962,7 +962,7 @@ void cl_2queue_fini(const struct lu_env *env, struct cl_2queue *queue)EXPORT_SYMBOL (cl_2queue_fini);/** -* Initialize a 2-queue to contain \a page in its incoming page list. +* Initialize a 2-queue to contain @page in its incoming page list. */ void cl_2queue_init_page (struct cl_2queue *queue,struct cl_page *page) {
@@ -989,7 +989,7 @@ struct cl_io *cl_io_top(struct cl_io *io)/** * Fills in attributes that are passed to server together with transfer. Only -* attributes from \a flags may be touched. This can be called multiple times +* attributes from @flags may be touched. This can be called multiple times * for the same request. */ void cl_req_attr_set(const struct lu_env *env, struct cl_object *obj,
drivers/staging/lustre/lustre/obdclass/cl_lock.c +6 -5
@@ -148,10 +148,11 @@ void cl_lock_cancel(const struct lu_env *env, struct cl_lock *lock)/** * Enqueue a lock. -* \param anchor: if we need to wait for resources before getting the lock, -* use @anchor for the purpose. -* \retval 0 enqueue successfully -* \retval <0 error code +* @anchor if we need to wait for resources before getting the lock, +* use @anchor for the purpose. +* +* Return: 0 enqueue successfully +* <0 error code */ int cl_lock_enqueue (const struct lu_env *env,struct cl_io *io,struct cl_lock *lock,struct cl_sync_io *anchor)
@@ -250,7 +251,7 @@ void cl_lock_descr_print(const struct lu_env *env, void *cookie,EXPORT_SYMBOL (cl_lock_descr_print);/** -* Prints human readable representation of \a lock to the \a f. +* Prints human readable representation of @lock to the @f. */ void cl_lock_print (const struct lu_env *env,void *cookie,lu_printer_t printer,const struct cl_lock *lock)
drivers/staging/lustre/lustre/obdclass/cl_object.c +22 -22
123 lines not on this page · raw message
drivers/staging/lustre/lustre/obdclass/cl_page.c +15 -15
@@ -61,7 +61,7 @@* This function can be used to obtain initial reference to previously * unreferenced cached object. It can be called only if concurrent page * reclamation is somehow prevented, e.g., by keeping a lock on a VM page, -* associated with \a page. +* associated with @page. * * Use with care! Not exported. */
@@ -165,8 +165,8 @@ struct cl_page *cl_page_alloc(const struct lu_env *env, }/** -* Returns a cl_page with index \a idx at the object \a o, and associated with -* the VM page \a vmpage. +* Returns a cl_page with index @idx@the object @o, and associated with +* the VM page @vmpage. * * This is the main entry point into the cl_page caching interface. First, a * cache (implemented as a per-object radix tree) is consulted. If page is
@@ -287,8 +287,8 @@ static void cl_page_state_set(const struct lu_env *env,/** * Acquires an additional reference to a page. * -* This can be called only by caller already possessing a reference to \a -* page. +* This can be called only by caller already possessing a reference to +* @page. * * \see cl_object_get(), cl_lock_get(). */
@@ -415,11 +415,11 @@ int cl_page_is_owned(const struct cl_page *pg, const struct cl_io *io)* \pre !cl_page_is_owned(pg, io) * \post result == 0 iff cl_page_is_owned(pg, io) * -* \retval 0 success +* Return: 0 success * -* \retval -ve failure, e.g., page was destroyed (and landed in -* cl_page_state::CPS_FREEING instead of cl_page_state::CPS_CACHED). -* or, page was owned by another thread, or in IO. +* -ve failure, e.g., page was destroyed (and landed in +* cl_page_state::CPS_FREEING instead of cl_page_state::CPS_CACHED). +* or, page was owned by another thread, or in IO. * * \see cl_page_disown() * \see cl_page_operations::cpo_own()
@@ -642,7 +642,7 @@ void cl_page_delete(const struct lu_env *env, struct cl_page *pg)* * Call cl_page_operations::cpo_export() through all layers top-to-bottom. The * layer responsible for VM interaction has to mark/clear page as up-to-date -* by the \a uptodate argument. +* by the @uptodate argument. * * \see cl_page_operations::cpo_export() */
@@ -658,7 +658,7 @@ void cl_page_export(const struct lu_env *env, struct cl_page *pg, int uptodate)EXPORT_SYMBOL (cl_page_export);/** -* Returns true, iff \a pg is VM locked in a suitable sense by the calling +* Returns true, if @pg is VM locked in a suitable sense by the calling * thread. */ int cl_page_is_vmlocked (const struct lu_env *env,const struct cl_page *pg)
@@ -862,7 +862,7 @@ void cl_page_clip(const struct lu_env *env, struct cl_page *pg,EXPORT_SYMBOL (cl_page_clip);/** -* Prints human readable representation of \a pg to the \a f. +* Prints human readable representation of @pg to the @f. */ void cl_page_header_print (const struct lu_env *env,void *cookie,lu_printer_t printer,const struct cl_page *pg)
@@ -876,7 +876,7 @@ void cl_page_header_print(const struct lu_env *env, void *cookie,EXPORT_SYMBOL (cl_page_header_print);/** -* Prints human readable representation of \a pg to the \a f. +* Prints human readable representation of @pg to the @f. */ void cl_page_print (const struct lu_env *env,void *cookie,lu_printer_t printer,const struct cl_page *pg)
@@ -898,7 +898,7 @@ void cl_page_print(const struct lu_env *env, void *cookie,EXPORT_SYMBOL (cl_page_print);/** -* Converts a byte offset within object \a obj into a page index. +* Converts a byte offset within object @obj into a page index. */ loff_t cl_offset (const struct cl_object *obj,pgoff_t idx) {
@@ -910,7 +910,7 @@ loff_t cl_offset(const struct cl_object *obj, pgoff_t idx)EXPORT_SYMBOL (cl_offset);/** -* Converts a page index into a byte offset within object \a obj. +* Converts a page index into a byte offset within object @obj. */ pgoff_t cl_index (const struct cl_object *obj,loff_t offset) {
drivers/staging/lustre/lustre/obdclass/genops.c +11 -11
@@ -291,12 +291,12 @@ int class_unregister_type(const char *name)* * Allocate the new obd_device and initialize it. * -* \param[in] type_name obd device type string. -* \param[in] name obd device name. -* @uuid obd device UUID. +* @type_name: obd device type string. +* @name: obd device name. +* @uuid: obd device UUID. * -* RETURN newdev pointer to created obd_device -* RETURN ERR_PTR(errno) on error +* Returns: newdev pointer to created obd_device +* ERR_PTR(errno) on error */ struct obd_device *class_newdev (const char *type_name,const char *name,const char *uuid)
@@ -407,7 +407,7 @@ void class_free_dev(struct obd_device *obd)/** * Unregister obd device. * -* Free slot in obd_dev[] used by \a obd. +* Free slot in obd_dev[] used by @obd. * * @new_obd obd_device to be unregistered *
@@ -427,7 +427,7 @@ void class_unregister_device(struct obd_device *obd)/** * Register obd device. * -* Find free slot in obd_devs[], fills it with \a new_obd. +* Find free slot in obd_devs[], fills it with @new_obd. * * @new_obd obd_device to be registered *
@@ -538,10 +538,10 @@ int class_uuid2dev(struct obd_uuid *uuid)/** * Get obd device from ::obd_devs[] * -* \param num [in] array index +* @num array index * -* \retval NULL if ::obd_devs[\a num] does not contains an obd device -* otherwise return the obd device there. +* Return: NULL if ::obd_devs[@num] does not contains an obd device +* otherwise return the obd device there. */ struct obd_device *class_num2obd (int num) {
@@ -632,7 +632,7 @@ struct obd_device *class_devices_in_group(struct obd_uuid *grp_uuid, int *next)EXPORT_SYMBOL (class_devices_in_group);/** -* to notify sptlrpc log for \a fsname has changed, let every relevant OBD +* to notify sptlrpc log for @fsname has changed, let every relevant OBD * adjust sptlrpc settings accordingly. */ int class_notify_sptlrpc_conf (const char *fsname,int namelen)
drivers/staging/lustre/lustre/obdclass/kernelcomm.c +13 -10
@@ -45,9 +45,10 @@/** * libcfs_kkuc_msg_put - send an message from kernel to userspace -* @param fp to send the message to -* @param payload Payload data. First field of payload is always -* struct kuc_hdr +* +* @fp: to send the message to +* @payload: Payload data. First field of payload is always +* struct kuc_hdr */ int libcfs_kkuc_msg_put (struct file *filp,void *payload) {
@@ -113,10 +114,11 @@ void libcfs_kkuc_init(void) }/** Add a receiver to a broadcast group -* @param filp pipe to write into -* @param uid identifier for this receiver -* @param group group number -* @param data user data +* +* @filp: pipe to write into +* @uid: identifier for this receiver +* @group: group number +* @data: user data */ int libcfs_kkuc_group_add (struct file *filp,int uid,unsigned int group,void *data,size_t data_len)
@@ -234,9 +236,10 @@ int libcfs_kkuc_group_put(unsigned int group, void *payload)/** * Calls a callback function for each link of the given kuc group. -* @param group the group to call the function on. -* @param cb_func the function to be called. -* @param cb_arg extra argument to be passed to the callback function. +* +* @group: the group to call the function on. +* @cb_func: the function to be called. +* @cb_arg: extra argument to be passed to the callback function. */ int libcfs_kkuc_group_foreach (unsigned int group,libcfs_kkuc_cb_t cb_func,void *cb_arg)
drivers/staging/lustre/lustre/obdclass/linkea.c +8 -7
@@ -90,7 +90,8 @@ int linkea_init_with_rec(struct linkea_data *ldata)* Pack a link_ea_entry. * All elements are stored as chars to avoid alignment issues. * Numbers are always big-endian -* \retval record length +* +* Return: record length */ int linkea_entry_pack (struct link_ea_entry *lee,const struct lu_name *lname,const struct lu_fid *pfid)
@@ -204,13 +205,13 @@ void linkea_del_buf(struct linkea_data *ldata, const struct lu_name *lname)/** * Check if such a link exists in linkEA. * -* \param ldata link data the search to be done on -* \param lname name in the parent's directory entry pointing to this object -* \param pfid parent fid the link to be found for +* @ldata link data the search to be done on +* @lname name in the parent's directory entry pointing to this object +* @pfid parent fid the link to be found for * -* \retval 0 success -* \retval -ENOENT link does not exist -* \retval -ve on error +* Return: 0 success +* -ENOENT link does not exist +* -ve on error */ int linkea_links_find (struct linkea_data *ldata,const struct lu_name *lname,const struct lu_fid *pfid)
drivers/staging/lustre/lustre/obdclass/lprocfs_status.c +15 -15
@@ -563,16 +563,16 @@ int lprocfs_rd_conn_uuid(struct seq_file *m, void *data)* * For global statistics, lock the stats structure to prevent concurrent update. * -* \param[in] stats statistics structure to lock -* \param[in] opc type of operation: -* LPROCFS_GET_SMP_ID: "lock" and return current CPU index -* for incrementing statistics for that CPU -* LPROCFS_GET_NUM_CPU: "lock" and return number of used -* CPU indices to iterate over all indices -* \param[out] flags CPU interrupt saved state for IRQ-safe locking +* @stats: statistics structure to lock +* @opc: type of operation: +* LPROCFS_GET_SMP_ID: "lock" and return current CPU index +* for incrementing statistics for that CPU +* LPROCFS_GET_NUM_CPU: "lock" and return number of used +* CPU indices to iterate over all indices +* @flags: CPU interrupt saved state for IRQ-safe locking * -* \retval cpuid of current thread or number of allocated structs -* \retval negative on error (only for opc LPROCFS_GET_SMP_ID + per-CPU stats) +* Returns: cpuid of current thread or number of allocated structs +* negative on error (only for opc LPROCFS_GET_SMP_ID + per-CPU stats) */ int lprocfs_stats_lock(struct lprocfs_stats *stats, enum lprocfs_stats_lock_ops opc,
@@ -616,9 +616,9 @@ int lprocfs_stats_lock(struct lprocfs_stats *stats,* This function must be called using the same arguments as used when calling * lprocfs_stats_lock() so that the correct operation can be performed. * -* \param[in] stats statistics structure to unlock -* \param[in] opc type of operation (current cpuid or number of structs) -* \param[in] flags CPU interrupt saved state for IRQ-safe locking +* @stats: statistics structure to unlock +* @opc: type of operation (current cpuid or number of structs) +* @flags: CPU interrupt saved state for IRQ-safe locking */ void lprocfs_stats_unlock(struct lprocfs_stats *stats, enum lprocfs_stats_lock_ops opc,
@@ -1614,9 +1614,9 @@ static char *lprocfs_strnstr(const char *s1, const char *s2, size_t len) }/** -* Find the string \a name in the input \a buffer, and return a pointer to the -* value immediately following \a name, reducing \a count appropriately. -* If \a name is not found the original \a buffer is returned. +* Find the string @name in the input @buffer, and return a pointer to the +* value immediately following @name, reducing @count appropriately. +* If @name is not found the original @buffer is returned. */ char *lprocfs_find_named_value (const char *buffer,const char *name,size_t *count)
drivers/staging/lustre/lustre/obdclass/lu_object.c +22 -22
159 lines not on this page · raw message
drivers/staging/lustre/lustre/obdclass/obd_mount.c +25 -22
87 lines not on this page · raw message
Signature · 1 line
1.8.3.1
PATCH 7/7 lustre: move remaining comments to sphinix format
In reply to James SimmonsLustre comments was written for DocBook which is no longer used by the Linux kernel. Move all the remaining lustre DocBook handling to sphinix.
--- drivers/staging/lustre/lustre/fld/fld_cache.c | 4 +- drivers/staging/lustre/lustre/fld/fld_internal.h | 2 +- drivers/staging/lustre/lustre/lmv/lmv_obd.c | 119 +++++++++++----------- drivers/staging/lustre/lustre/lov/lov_io.c | 2 +- drivers/staging/lustre/lustre/lov/lov_object.c | 47 ++++----- drivers/staging/lustre/lustre/lov/lov_pack.c | 4 +- drivers/staging/lustre/lustre/mdc/mdc_changelog.c | 91 +++++++++-------- drivers/staging/lustre/lustre/mdc/mdc_lib.c | 12 +-- drivers/staging/lustre/lustre/mdc/mdc_request.c | 34 ++++--- drivers/staging/lustre/lustre/mgc/mgc_request.c | 8 +- drivers/staging/lustre/lustre/osc/osc_cache.c | 12 +-- drivers/staging/lustre/lustre/osc/osc_lock.c | 10 +- drivers/staging/lustre/lustre/osc/osc_request.c | 4 +- 13 files changed, 182 insertions(+), 167 deletions(-)
drivers/staging/lustre/lustre/fld/fld_cache.c +2 -2
@@ -468,7 +468,7 @@ struct fld_cache_entry }/** -* lookup \a seq sequence for range in fld cache. +* lookup @seq sequence for range in fld cache. */ struct fld_cache_entry *fld_cache_entry_lookup (struct fld_cache *cache,struct lu_seq_range *range)
@@ -482,7 +482,7 @@ struct fld_cache_entry }/** -* lookup \a seq sequence for range in fld cache. +* lookup @seq sequence for range in fld cache. */ int fld_cache_lookup (struct fld_cache *cache,const u64 seq,struct lu_seq_range *range)
drivers/staging/lustre/lustre/fld/fld_internal.h +1 -1
@@ -94,7 +94,7 @@ struct fld_cache {/** Preferred number of cached entries */ int fci_cache_size; -/** Current number of cached entries. Protected by \a fci_lock */ +/** Current number of cached entries. Protected by @fci_lock */ int fci_cache_count;/** LRU list fld entries. */
drivers/staging/lustre/lustre/lmv/lmv_obd.c +60 -59
162 lines not on this page · raw message
drivers/staging/lustre/lustre/lov/lov_io.c +1 -1
@@ -722,7 +722,7 @@ static int lov_io_read_ahead(const struct lu_env *env,/** * lov implementation of cl_operations::cio_submit() method. It takes a list -* of pages in \a queue, splits it into per-stripe sub-lists, invokes +* of pages in @queue, splits it into per-stripe sub-lists, invokes * cl_io_submit() on underlying devices to submit sub-lists, and then splices * everything back. *
drivers/staging/lustre/lustre/lov/lov_object.c +24 -23
75 lines not on this page · raw message
drivers/staging/lustre/lustre/lov/lov_pack.c +2 -2
@@ -103,8 +103,8 @@ void lov_dump_lmm_v3(int level, struct lov_mds_md_v3 *lmm)* Pack LOV striping metadata for disk storage format (in little * endian byte order). * -* This follows the getxattr() conventions. If \a buf_size is zero -* then return the size needed. If \a buf_size is too small then +* This follows the getxattr() conventions. If @buf_size is zero +* then return the size needed. If @buf_size is too small then * return -ERANGE. Otherwise return the size of the result. */ ssize_t lov_lsm_pack_v1v3(const struct lov_stripe_md *lsm, void *buf,
drivers/staging/lustre/lustre/mdc/mdc_changelog.c +51 -40
158 lines not on this page · raw message
drivers/staging/lustre/lustre/mdc/mdc_lib.c +6 -6
@@ -82,14 +82,14 @@ void mdc_pack_body(struct ptlrpc_request *req, const struct lu_fid *fid,/** * Pack a name (path component) into a request * -* \param[in] req request -* \param[in] field request field (usually RMF_NAME) -* \param[in] name path component -* \param[in] name_len length of path component +* @req: request +* @field: request field (usually RMF_NAME) +* @name: path component +* @name_len: length of path component * -* \a field must be present in \a req and of size \a name_len + 1. +* @field must be present in @req and of size @name_len + 1. * -* \a name must be '\0' terminated of length \a name_len and represent +* @name must be '\0' terminated of length @name_len and represent * a single path component (not contain '/'). */ static void mdc_pack_name(struct ptlrpc_request *req,
drivers/staging/lustre/lustre/mdc/mdc_request.c +18 -16
@@ -81,16 +81,16 @@ static inline int mdc_queue_wait(struct ptlrpc_request *req)/* * Send MDS_GET_ROOT RPC to fetch root FID. * -* If \a fileset is not NULL it should contain a subdirectory off +* If @fileset is not NULL it should contain a subdirectory off * the ROOT/ directory to be mounted on the client. Return the FID * of the subdirectory to the client to mount onto its mountpoint. * -* \param[in] imp MDC import -* \param[in] fileset fileset name, which could be NULL -* \param[out] rootfid root FID of this mountpoint -* \param[out] pc root capa will be unpacked and saved in this pointer +* @imp: MDC import +* @fileset: fileset name, which could be NULL +* @rootfid: root FID of this mountpoint +* @pc: root capa will be unpacked and saved in this pointer * -* \retval 0 on success, negative errno on failure +* Returns: 0 on success, negative errno on failure */ static int mdc_get_root (struct obd_export *exp,const char *fileset,struct lu_fid *rootfid)
@@ -1273,15 +1273,15 @@ static int mdc_read_page_remote(void *data, struct page *page0)* Read dir page from cache first, if it can not find it, read it from * server and add into the cache. * -* \param[in] exp MDC export -* \param[in] op_data client MD stack parameters, transferring parameters +* @exp: MDC export +* @op_data: client MD stack parameters, transferring parameters * between different layers on client MD stack. -* \param[in] cb_op callback required for ldlm lock enqueue during +* @cb_op: callback required for ldlm lock enqueue during * read page -* \param[in] hash_offset the hash offset of the page to be read -* \param[in] ppage the page to be read +* @hash_offset: the hash offset of the page to be read +* @ppage the page to be read * -* retval = 0 get the page successfully +* Return: = 0 get the page successfully * errno(<0) get the page failed */ static int mdc_read_page(struct obd_export *exp, struct md_op_data *op_data,
@@ -2151,8 +2151,9 @@ static int mdc_ioc_hsm_ct_start(struct obd_export *exp,/** * Send a message to any listening copytools -* @param val KUC message (kuc_hdr + hsm_action_list) -* @param len total length of message +* +* @val: KUC message (kuc_hdr + hsm_action_list) +* @len: total length of message */ static int mdc_hsm_copytool_send (size_t len,void *val) {
@@ -2184,8 +2185,9 @@ static int mdc_hsm_copytool_send(size_t len, void *val)/** * callback function passed to kuc for re-registering each HSM copytool * running on MDC, after MDT shutdown/recovery. -* @param data copytool registration data -* @param cb_arg callback argument (obd_import) +* +* @data: copytool registration data +* @cb_arg: callback argument (obd_import) */ static int mdc_hsm_ct_reregister (void *data,void *cb_arg) {
drivers/staging/lustre/lustre/mgc/mgc_request.c +4 -4
@@ -1589,11 +1589,11 @@ static bool mgc_import_in_recovery(struct obd_import *imp)* trying to update from the same log simultaneously, in which case we * should use a per-log semaphore instead of cld_lock. * -* \param[in] mgc MGC device by which to fetch the configuration log -* \param[in] cld log processing state (stored in lock callback data) +* @mgc: MGC device by which to fetch the configuration log +* @cld: log processing state (stored in lock callback data) * -* \retval 0 on success -* \retval negative errno on failure +* Returns: 0 on success +* negative errno on failure */ int mgc_process_log (struct obd_device *mgc,struct config_llog_data *cld) {
drivers/staging/lustre/lustre/osc/osc_cache.c +6 -6
@@ -2105,12 +2105,12 @@ static unsigned int get_write_extents(struct osc_object *obj,/** * prepare pages for ASYNC io and put pages in send queue. * -* \param cmd OBD_BRW_* macroses -* \param lop pending pages +* @cmd OBD_BRW_* macroses +* @lop pending pages * -* \return zero if no page added to send queue. -* \return 1 if pages successfully added to send queue. -* \return negative on errors. +* Return: zero if no page added to send queue. +* 1 if pages successfully added to send queue. +* negative on errors. */ static int osc_send_read_rpc(const struct lu_env *env, struct client_obd *cli,
@@ -3021,7 +3021,7 @@ int osc_cache_writeback_range(const struct lu_env *env, struct osc_object *obj, }/** -* Returns a list of pages by a given [start, end] of \a obj. +* Returns a list of pages by a given [start, end] of @obj. * * Gang tree lookup (radix_tree_gang_lookup()) optimization is absolutely * crucial in the face of [offset, EOF] locks.
drivers/staging/lustre/lustre/osc/osc_lock.c +5 -5
@@ -485,14 +485,14 @@ static int __osc_dlm_blocking_ast(const struct lu_env *env,* Control flow is tricky, because ldlm uses the same call-back * (ldlm_lock::l_blocking_ast()) for both blocking and cancellation ast's. * -* \param dlmlock lock for which ast occurred. +* @dlmlock lock for which ast occurred. * -* \param new description of a conflicting lock in case of blocking ast. +* @new description of a conflicting lock in case of blocking ast. * -* \param data value of dlmlock->l_ast_data +* @data value of dlmlock->l_ast_data * -* \param flag LDLM_CB_BLOCKING or LDLM_CB_CANCELING. Used to distinguish -* cancellation and blocking ast's. +* @flag LDLM_CB_BLOCKING or LDLM_CB_CANCELING. Used to distinguish +* cancellation and blocking ast's. * * Possible use cases: *
drivers/staging/lustre/lustre/osc/osc_request.c +2 -2
@@ -2807,8 +2807,8 @@ static int osc_import_event(struct obd_device *obd,* Determine whether the lock can be canceled before replaying the lock * during recovery, see bug16774 for detailed information. * -* \retval zero the lock can't be canceled -* \retval other ok to cancel +* Return: zero the lock can't be canceled +* other ok to cancel */ static int osc_cancel_weight (struct ldlm_lock *lock) {
Signature · 1 line
1.8.3.1
cover lustre: move DocBook comments to sphinix format
In reply to James SimmonsQuoted 5 lines
The Linux kernel deprecated DocBook so update Lustre to using sphinix instead. I'm no Sphinix expert so things might be missed but the major has been ported over. This should get the lustre in shape to move out of staging.
Forgot to add. This is against lustre-testing since the wip* trees are stil churning.
Quoted 102 lines
James Simmons (7):
lnet: move comments to sphinix format
lustre: move header file comments to sphinix format
ptlrpc: move comments to sphinix format
ldlm: move comments to sphinix format
llite: move comments to sphinix format
obdclass: move comments to sphinix format
lustre: move remaining comments to sphinix format.../lustre/include/linux/libcfs/libcfs_cpu.h | 50 ++-- .../lustre/include/linux/libcfs/libcfs_crypto.h | 20 +- .../lustre/include/uapi/linux/lnet/lnetctl.h | 2 +- .../lustre/include/uapi/linux/lustre/lustre_fid.h | 20 +- .../lustre/include/uapi/linux/lustre/lustre_idl.h | 2 +- .../lustre/include/uapi/linux/lustre/lustre_user.h | 13 +- .../staging/lustre/lnet/klnds/o2iblnd/o2iblnd.h | 2 +- drivers/staging/lustre/lnet/libcfs/debug.c | 2 +- drivers/staging/lustre/lnet/libcfs/libcfs_cpu.c | 2 +- drivers/staging/lustre/lnet/libcfs/libcfs_lock.c | 8 +- drivers/staging/lustre/lnet/libcfs/libcfs_string.c | 67 +++-- drivers/staging/lustre/lnet/libcfs/linux-crypto.c | 131 ++++----- drivers/staging/lustre/lnet/lnet/api-ni.c | 34 +-- drivers/staging/lustre/lnet/lnet/lib-eq.c | 100 +++---- drivers/staging/lustre/lnet/lnet/lib-md.c | 67 ++--- drivers/staging/lustre/lnet/lnet/lib-me.c | 76 ++--- drivers/staging/lustre/lnet/lnet/lib-move.c | 113 ++++---- drivers/staging/lustre/lnet/lnet/lib-ptl.c | 12 +- drivers/staging/lustre/lnet/lnet/net_fault.c | 30 +- drivers/staging/lustre/lnet/lnet/nidstrings.c | 125 ++++----- drivers/staging/lustre/lustre/fld/fld_cache.c | 4 +- drivers/staging/lustre/lustre/fld/fld_internal.h | 2 +- drivers/staging/lustre/lustre/include/cl_object.h | 91 +++--- drivers/staging/lustre/lustre/include/lu_object.h | 8 +- drivers/staging/lustre/lustre/include/lustre_dlm.h | 10 +- .../staging/lustre/lustre/include/lustre_import.h | 4 +- drivers/staging/lustre/lustre/include/lustre_mdc.h | 4 +- drivers/staging/lustre/lustre/include/lustre_net.h | 76 ++--- drivers/staging/lustre/lustre/include/lustre_nrs.h | 118 ++++---- drivers/staging/lustre/lustre/include/lustre_sec.h | 83 +++--- drivers/staging/lustre/lustre/include/obd_class.h | 9 +- drivers/staging/lustre/lustre/include/seq_range.h | 32 +-- drivers/staging/lustre/lustre/ldlm/ldlm_flock.c | 14 +- drivers/staging/lustre/lustre/ldlm/ldlm_lib.c | 8 +- drivers/staging/lustre/lustre/ldlm/ldlm_lock.c | 90 +++--- drivers/staging/lustre/lustre/ldlm/ldlm_lockd.c | 6 +- drivers/staging/lustre/lustre/ldlm/ldlm_pool.c | 22 +- drivers/staging/lustre/lustre/ldlm/ldlm_request.c | 99 ++++--- drivers/staging/lustre/lustre/ldlm/ldlm_resource.c | 18 +- drivers/staging/lustre/lustre/llite/dir.c | 14 +- drivers/staging/lustre/lustre/llite/file.c | 62 +++-- drivers/staging/lustre/lustre/llite/glimpse.c | 4 +- drivers/staging/lustre/lustre/llite/lcommon_cl.c | 5 +- drivers/staging/lustre/lustre/llite/llite_lib.c | 48 ++-- drivers/staging/lustre/lustre/llite/llite_mmap.c | 19 +- drivers/staging/lustre/lustre/llite/llite_nfs.c | 4 +- drivers/staging/lustre/lustre/llite/lproc_llite.c | 22 +- drivers/staging/lustre/lustre/llite/range_lock.c | 20 +- drivers/staging/lustre/lustre/llite/rw.c | 14 +- drivers/staging/lustre/lustre/llite/statahead.c | 59 ++-- drivers/staging/lustre/lustre/llite/super25.c | 3 +- drivers/staging/lustre/lustre/llite/vvp_io.c | 2 +- drivers/staging/lustre/lustre/llite/vvp_page.c | 8 +- drivers/staging/lustre/lustre/llite/xattr_cache.c | 44 +-- .../staging/lustre/lustre/llite/xattr_security.c | 12 +- drivers/staging/lustre/lustre/lmv/lmv_obd.c | 119 ++++---- drivers/staging/lustre/lustre/lov/lov_io.c | 2 +- drivers/staging/lustre/lustre/lov/lov_object.c | 47 ++-- drivers/staging/lustre/lustre/lov/lov_pack.c | 4 +- drivers/staging/lustre/lustre/mdc/mdc_changelog.c | 91 +++--- drivers/staging/lustre/lustre/mdc/mdc_lib.c | 12 +- drivers/staging/lustre/lustre/mdc/mdc_request.c | 34 +-- drivers/staging/lustre/lustre/mgc/mgc_request.c | 8 +- drivers/staging/lustre/lustre/obdclass/cl_io.c | 12 +- drivers/staging/lustre/lustre/obdclass/cl_lock.c | 11 +- drivers/staging/lustre/lustre/obdclass/cl_object.c | 44 +-- drivers/staging/lustre/lustre/obdclass/cl_page.c | 30 +- drivers/staging/lustre/lustre/obdclass/genops.c | 22 +- .../staging/lustre/lustre/obdclass/kernelcomm.c | 23 +- drivers/staging/lustre/lustre/obdclass/linkea.c | 15 +- .../lustre/lustre/obdclass/lprocfs_status.c | 30 +- drivers/staging/lustre/lustre/obdclass/lu_object.c | 44 +-- drivers/staging/lustre/lustre/obdclass/obd_mount.c | 47 ++-- drivers/staging/lustre/lustre/osc/osc_cache.c | 12 +- drivers/staging/lustre/lustre/osc/osc_lock.c | 10 +- drivers/staging/lustre/lustre/osc/osc_request.c | 4 +- drivers/staging/lustre/lustre/ptlrpc/client.c | 72 ++--- drivers/staging/lustre/lustre/ptlrpc/import.c | 6 +- drivers/staging/lustre/lustre/ptlrpc/layout.c | 102 +++---- .../staging/lustre/lustre/ptlrpc/lproc_ptlrpc.c | 10 +- drivers/staging/lustre/lustre/ptlrpc/niobuf.c | 14 +- drivers/staging/lustre/lustre/ptlrpc/nrs.c | 305 +++++++++++---------- drivers/staging/lustre/lustre/ptlrpc/nrs_fifo.c | 68 ++--- .../staging/lustre/lustre/ptlrpc/pack_generic.c | 8 +- drivers/staging/lustre/lustre/ptlrpc/sec.c | 104 +++---- drivers/staging/lustre/lustre/ptlrpc/sec_config.c | 2 +- drivers/staging/lustre/lustre/ptlrpc/service.c | 4 +- 87 files changed, 1641 insertions(+), 1589 deletions(-)Signature · 1 line
1.8.3.1
cover lustre: move DocBook comments to sphinix format
Quoted 8 lines · James Simmons
Quoted 4 lines
The Linux kernel deprecated DocBook so update Lustre to using sphinix instead. I'm no Sphinix expert so things might be missed but the major has been ported over. This should get the lustre in shape to move out of staging.
Forgot to add. This is against lustre-testing since the wip* trees are stil churning.
Definitely the right thing to do. wip is just patches that need more work. It never makes sense to build on them.
Thanks,
NeilBrown
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 832 bytes
Desc: not available
URL: <http://lists.lustre.org/pipermail/lustre-devel-lustre.org/attachments/20190304/2cacfff0/attachment.sig>
cover lustre: move DocBook comments to sphinix format
In reply to James SimmonsQuoted 4 lines · James Simmons
The Linux kernel deprecated DocBook so update Lustre to using sphinix instead. I'm no Sphinix expert so things might be missed but the major has been ported over. This should get the lustre in shape to move out of staging.
Thanks.
This is a really good start - I've applied them all.
I suspect there is still a lot of work to do.
Any comment that starts "/**" but don't a Sphinix comment should be changed to "/*", and we should link all of this into the Documentation tree, at least for test (I don't want to include any patches that aren't in driver/staging, but having the patch available would be good).
Thanks,
NeilBrown
Quoted 90 lines
James Simmons (7):
lnet: move comments to sphinix format
lustre: move header file comments to sphinix format
ptlrpc: move comments to sphinix format
ldlm: move comments to sphinix format
llite: move comments to sphinix format
obdclass: move comments to sphinix format
lustre: move remaining comments to sphinix format.../lustre/include/linux/libcfs/libcfs_cpu.h | 50 ++-- .../lustre/include/linux/libcfs/libcfs_crypto.h | 20 +- .../lustre/include/uapi/linux/lnet/lnetctl.h | 2 +- .../lustre/include/uapi/linux/lustre/lustre_fid.h | 20 +- .../lustre/include/uapi/linux/lustre/lustre_idl.h | 2 +- .../lustre/include/uapi/linux/lustre/lustre_user.h | 13 +- .../staging/lustre/lnet/klnds/o2iblnd/o2iblnd.h | 2 +- drivers/staging/lustre/lnet/libcfs/debug.c | 2 +- drivers/staging/lustre/lnet/libcfs/libcfs_cpu.c | 2 +- drivers/staging/lustre/lnet/libcfs/libcfs_lock.c | 8 +- drivers/staging/lustre/lnet/libcfs/libcfs_string.c | 67 +++-- drivers/staging/lustre/lnet/libcfs/linux-crypto.c | 131 ++++----- drivers/staging/lustre/lnet/lnet/api-ni.c | 34 +-- drivers/staging/lustre/lnet/lnet/lib-eq.c | 100 +++---- drivers/staging/lustre/lnet/lnet/lib-md.c | 67 ++--- drivers/staging/lustre/lnet/lnet/lib-me.c | 76 ++--- drivers/staging/lustre/lnet/lnet/lib-move.c | 113 ++++---- drivers/staging/lustre/lnet/lnet/lib-ptl.c | 12 +- drivers/staging/lustre/lnet/lnet/net_fault.c | 30 +- drivers/staging/lustre/lnet/lnet/nidstrings.c | 125 ++++----- drivers/staging/lustre/lustre/fld/fld_cache.c | 4 +- drivers/staging/lustre/lustre/fld/fld_internal.h | 2 +- drivers/staging/lustre/lustre/include/cl_object.h | 91 +++--- drivers/staging/lustre/lustre/include/lu_object.h | 8 +- drivers/staging/lustre/lustre/include/lustre_dlm.h | 10 +- .../staging/lustre/lustre/include/lustre_import.h | 4 +- drivers/staging/lustre/lustre/include/lustre_mdc.h | 4 +- drivers/staging/lustre/lustre/include/lustre_net.h | 76 ++--- drivers/staging/lustre/lustre/include/lustre_nrs.h | 118 ++++---- drivers/staging/lustre/lustre/include/lustre_sec.h | 83 +++--- drivers/staging/lustre/lustre/include/obd_class.h | 9 +- drivers/staging/lustre/lustre/include/seq_range.h | 32 +-- drivers/staging/lustre/lustre/ldlm/ldlm_flock.c | 14 +- drivers/staging/lustre/lustre/ldlm/ldlm_lib.c | 8 +- drivers/staging/lustre/lustre/ldlm/ldlm_lock.c | 90 +++--- drivers/staging/lustre/lustre/ldlm/ldlm_lockd.c | 6 +- drivers/staging/lustre/lustre/ldlm/ldlm_pool.c | 22 +- drivers/staging/lustre/lustre/ldlm/ldlm_request.c | 99 ++++--- drivers/staging/lustre/lustre/ldlm/ldlm_resource.c | 18 +- drivers/staging/lustre/lustre/llite/dir.c | 14 +- drivers/staging/lustre/lustre/llite/file.c | 62 +++-- drivers/staging/lustre/lustre/llite/glimpse.c | 4 +- drivers/staging/lustre/lustre/llite/lcommon_cl.c | 5 +- drivers/staging/lustre/lustre/llite/llite_lib.c | 48 ++-- drivers/staging/lustre/lustre/llite/llite_mmap.c | 19 +- drivers/staging/lustre/lustre/llite/llite_nfs.c | 4 +- drivers/staging/lustre/lustre/llite/lproc_llite.c | 22 +- drivers/staging/lustre/lustre/llite/range_lock.c | 20 +- drivers/staging/lustre/lustre/llite/rw.c | 14 +- drivers/staging/lustre/lustre/llite/statahead.c | 59 ++-- drivers/staging/lustre/lustre/llite/super25.c | 3 +- drivers/staging/lustre/lustre/llite/vvp_io.c | 2 +- drivers/staging/lustre/lustre/llite/vvp_page.c | 8 +- drivers/staging/lustre/lustre/llite/xattr_cache.c | 44 +-- .../staging/lustre/lustre/llite/xattr_security.c | 12 +- drivers/staging/lustre/lustre/lmv/lmv_obd.c | 119 ++++---- drivers/staging/lustre/lustre/lov/lov_io.c | 2 +- drivers/staging/lustre/lustre/lov/lov_object.c | 47 ++-- drivers/staging/lustre/lustre/lov/lov_pack.c | 4 +- drivers/staging/lustre/lustre/mdc/mdc_changelog.c | 91 +++--- drivers/staging/lustre/lustre/mdc/mdc_lib.c | 12 +- drivers/staging/lustre/lustre/mdc/mdc_request.c | 34 +-- drivers/staging/lustre/lustre/mgc/mgc_request.c | 8 +- drivers/staging/lustre/lustre/obdclass/cl_io.c | 12 +- drivers/staging/lustre/lustre/obdclass/cl_lock.c | 11 +- drivers/staging/lustre/lustre/obdclass/cl_object.c | 44 +-- drivers/staging/lustre/lustre/obdclass/cl_page.c | 30 +- drivers/staging/lustre/lustre/obdclass/genops.c | 22 +- .../staging/lustre/lustre/obdclass/kernelcomm.c | 23 +- drivers/staging/lustre/lustre/obdclass/linkea.c | 15 +- .../lustre/lustre/obdclass/lprocfs_status.c | 30 +- drivers/staging/lustre/lustre/obdclass/lu_object.c | 44 +-- drivers/staging/lustre/lustre/obdclass/obd_mount.c | 47 ++-- drivers/staging/lustre/lustre/osc/osc_cache.c | 12 +- drivers/staging/lustre/lustre/osc/osc_lock.c | 10 +- drivers/staging/lustre/lustre/osc/osc_request.c | 4 +- drivers/staging/lustre/lustre/ptlrpc/client.c | 72 ++--- drivers/staging/lustre/lustre/ptlrpc/import.c | 6 +- drivers/staging/lustre/lustre/ptlrpc/layout.c | 102 +++---- .../staging/lustre/lustre/ptlrpc/lproc_ptlrpc.c | 10 +-
Quoted 11 lines
drivers/staging/lustre/lustre/ptlrpc/niobuf.c | 14 +- drivers/staging/lustre/lustre/ptlrpc/nrs.c | 305 +++++++++++---------- drivers/staging/lustre/lustre/ptlrpc/nrs_fifo.c | 68 ++--- .../staging/lustre/lustre/ptlrpc/pack_generic.c | 8 +- drivers/staging/lustre/lustre/ptlrpc/sec.c | 104 +++---- drivers/staging/lustre/lustre/ptlrpc/sec_config.c | 2 +- drivers/staging/lustre/lustre/ptlrpc/service.c | 4 +- 87 files changed, 1641 insertions(+), 1589 deletions(-)Signature · 1 line
1.8.3.1
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 832 bytes
Desc: not available
URL: <http://lists.lustre.org/pipermail/lustre-devel-lustre.org/attachments/20190304/fbd59d4d/attachment.sig>