https://jira.whamcloud.com This file is an XML representation of an issue en-us 9.4.14 940014 05-12-2023 https://jira.whamcloud.com/browse/LU-4975 Lustre <p>Bug to track development and landing of code comments for the lustre/ofd module.</p> LU-4975

Doxygen comments - ofd module

Technical task LU-1892 Minor Resolved Fixed Richard Henwood Andreas Dilger Tue, 29 Apr 2014 09:04:53 +0000 Sat, 6 Dec 2014 06:45:05 +0000 Sat, 6 Dec 2014 06:45:05 +0000 Lustre 2.7.0 0 7 <p>ofd_fs.c: <a href="http://review.whamcloud.com/10417" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/10417</a></p> <p>ofd_grant.c: <a href="http://review.whamcloud.com/#/c/10586" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/#/c/10586</a></p> <p>ofd_capa.c: <a href="http://review.whamcloud.com/10606" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/10606</a></p> <p>lproc_osp.c: <a href="http://review.whamcloud.com/#/c/10893/" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/#/c/10893/</a></p> <p>Please correct the following.</p> <p>ofd_grant.c:</p> <div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent"> <pre>/home/bass6/lustre/lustre/ofd/ofd_grant.c:480: warning: argument 'niocont' of command @param is not found in the argument list of ofd_grant_check(const struct lu_env *env, struct obd_export *exp, struct obdo *oa, struct niobuf_remote *rnb, int niocount, obd_size *left) /home/bass6/lustre/lustre/ofd/ofd_grant.c:480: warning: The following parameters of ofd_grant_check(const struct lu_env *env, struct obd_export *exp, struct obdo *oa, struct niobuf_remote *rnb, int niocount, obd_size *left) are not documented: parameter 'niocount' /home/bass6/lustre/lustre/ofd/ofd_grant.c:1109: warning: The following parameters of ofd_grant_commit(const struct lu_env *env, struct obd_export *exp, int rc) are not documented: parameter 'rc' /home/bass6/lustre/lustre/ofd/ofd_grant.c:850: warning: Found unknown command `\paral' /home/bass6/lustre/lustre/ofd/ofd_grant.c:842: warning: The following parameters of ofd_grant_prepare_read(const struct lu_env *env, struct obd_export *exp, struct obdo *oa) are not documented: parameter 'oa' /home/bass6/lustre/lustre/ofd/ofd_grant.c:909: warning: argument 'niocont' of command @param is not found in the argument list of ofd_grant_prepare_write(const struct lu_env *env, struct obd_export *exp, struct obdo *oa, struct niobuf_remote *rnb, int niocount) /home/bass6/lustre/lustre/ofd/ofd_grant.c:909: warning: The following parameters of ofd_grant_prepare_write(const struct lu_env *env, struct obd_export *exp, struct obdo *oa, struct niobuf_remote *rnb, int niocount) are not documented: parameter 'niocount' </pre> </div></div> <p>ofd_fs.c</p> <div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent"> <pre>/home/bass6/lustre/lustre/ofd/ofd_fs.c:49: warning: argument 'int' of command @param is not found in the argument list of ofd_precreate_batch(struct ofd_device *ofd, int batch) /home/bass6/lustre/lustre/ofd/ofd_fs.c:49: warning: The following parameters of ofd_precreate_batch(struct ofd_device *ofd, int batch) are not documented: parameter 'batch' /home/bass6/lustre/lustre/ofd/ofd_fs.c:157: warning: argument 'ofd_seq' of command @param is not found in the argument list of ofd_seq_last_oid(struct ofd_seq *oseq) /home/bass6/lustre/lustre/ofd/ofd_fs.c:157: warning: The following parameters of ofd_seq_last_oid(struct ofd_seq *oseq) are not documented: parameter 'oseq' </pre> </div></div> <p>Warnings addressed in patch: <a href="http://review.whamcloud.com/12665" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/12665</a></p> <p>Oleg Drokin (oleg.drokin@intel.com) merged in patch <a href="http://review.whamcloud.com/12665/" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/12665/</a><br/> Subject: <a href="https://jira.whamcloud.com/browse/LU-4975" title="Doxygen comments - ofd module" class="issue-link" data-issue-key="LU-4975"><del>LU-4975</del></a> ofd: Fix Doxygen warnings for ofd files<br/> Project: fs/lustre-release<br/> Branch: master<br/> Current Patch Set: <br/> Commit: 422ea5a9a0ef7677ed01b69cd3a5f0e324cd069f</p> Development Rank 1|hzwldr: Rank (Obsolete) 13788