Description of problem: Running "ceph -h" shows several options for ceph, such as "-s" for status, which are not documented in the man page. Version-Release number of selected component (if applicable): ceph-0.80.6-0.el7.centos.x86_64
Created attachment 985389 [details] ceph -h output on firefly
I created a pull request for firefly with cherry picked man page changes which don't appear to include any newer changes. Pull request #3521 Backport doc fixes that appear to apply to firefly https://github.com/ceph/ceph/pull/3521 Nilamdyuti Goswami could you go over the documentation and compare with the ceph -h output attached to this bug.
(In reply to Brad Hubbard from comment #0) > Description of problem: > > Running "ceph -h" shows several options for ceph, such as "-s" for status, > which are not documented in the man page. > > Version-Release number of selected component (if applicable): > ceph-0.80.6-0.el7.centos.x86_64 The initial man page for Ceph was in a rudimentary stage and there was no description for it's commands. When I updated the man page based on the output of "ceph -h", I did it for ceph-0.87 which was merged to master and can be found here http://docs.ceph.com/docs/master/man/8/ceph/ It has everything from the output of "ceph -h" including "-s" for status. I have two Ceph clusters deployed in my machine using RHEL7 nodes, one with version 0.80 and other one with version 0.87. Both of them give the same output for "ceph -h". The reason output of "ceph -h" command in your ceph-0.80.6-0.el7.centos.x86_64 cluster is different from "man ceph" is probably because the updated ceph man page hasn't been included in "ceph-common" package neither for master nor for firefly.
(In reply to David Zafman from comment #2) > I created a pull request for firefly with cherry picked man page changes > which don't appear to include any newer changes. > > Pull request #3521 > Backport doc fixes that appear to apply to firefly > https://github.com/ceph/ceph/pull/3521 > > Nilamdyuti Goswami could you go over the documentation and compare with the > ceph -h output attached to this bug. I compared the documentation with the attached output, both have the same contents. I also checked again by taking a output of "ceph -h" in my ceph-0.80 cluster and found it to be the same as in master. If you are back porting the changes in master to firefly, kindly use the commits from https://github.com/ceph/ceph/pull/3201 as it has better style formatting for improved readability.
Please confirm this is resolved.
Please confirm this is resolved, and close the bug.
Tracker 10676 marked resolved. This should be part of the next Firefly point release v0.80.10 Closing this bug.
Reopening until patch is downstream.
(In reply to Federico Lucifredi from comment #6) > Please confirm this is resolved, and close the bug. As said by David and Brad in their comments, this will be resolved in the next downstream release i.e, v1.2.4 (v0.80.10 upstream).
Understood. Flagging 1.3 as well, as that will ship first.
The fixed man page shipped in Ceph v0.80.10 upstream, so we'll take in in as part of the RHCS 1.2 rebase to Ceph v0.80.11 (bz 1271774)
Closing all RHCS 1.2 bugs, since we are not planning to do a formal RHCS 1.2.4 release. This particular issue was already fixed in the initial RHCS 1.3.0 release.