Patrick Winnertz
2008-Jan-09 13:26 UTC
[Lustre-discuss] missing manpages - or: what sense do these programs have
Hello, as one of the debian maintainers I would like to get to know which sense these programs have (in order to write the manpages). I found nowhere informations on how to use these programs, so they are in fact atm useless for users. - lst - lstclient - ptlctl - wirecheck - routerstat - debugctl - llobdstat - ... if some programs are only needed for development purposes please tell me that... then I''ll create some kind of devel package for them. (and remove them from the lustre-utils package). Some hints to docu I didn''t find or explanation are welcome ;-) Greetings Patrick Winnertz -- Patrick Winnertz Tel.: +49 (0) 2161 / 4643 - 0 credativ GmbH, HRB M?nchengladbach 12080 Hohenzollernstr. 133, 41061 M?nchengladbach Gesch?ftsf?hrung: Dr. Michael Meskes, J?rg Folz
Andreas Dilger
2008-Jan-09 21:49 UTC
[Lustre-discuss] missing manpages - or: what sense do these programs have
On Jan 09, 2008 14:26 +0100, Patrick Winnertz wrote:> as one of the debian maintainers I would like to get to know which sense > these programs have (in order to write the manpages). > I found nowhere informations on how to use these programs, so they are in > fact atm useless for users. > > - lst > - lstclientThese are new commands for "lnet self test". They should be installed always, to allow diagnosing networking performance/configuration issues. Sorry, I don''t know the details, though you could file a documentation bug on them.> - routerstatThis is for LNET router stats, not sure how widely it is used.> - ptlctl > - debugctlThese are obsolete commands and should just be removed entirely. Their functionality was moved into lctl a long time ago.> - wirecheckTests the wire format encoding, but probably not needed for a real install.> - llobdstatReports IO statistics for Lustre, similar to llstat, so should be installed.> Some hints to docu I didn''t find or explanation are welcome ;-)If there is existing documentation in the lustre manual I''d welcome it being moved into man pages. Cheers, Andreas -- Andreas Dilger Sr. Staff Engineer, Lustre Group Sun Microsystems of Canada, Inc.
Isaac Huang
2008-Jan-16 13:17 UTC
[Lustre-discuss] missing manpages - or: what sense do these programs have
On Wed, Jan 09, 2008 at 02:49:17PM -0700, Andreas Dilger wrote:> On Jan 09, 2008 14:26 +0100, Patrick Winnertz wrote: > > as one of the debian maintainers I would like to get to know which sense > > these programs have (in order to write the manpages). > > I found nowhere informations on how to use these programs, so they are in > > fact atm useless for users. > > > > - lst > > - lstclient > > These are new commands for "lnet self test". They should be installed always, > to allow diagnosing networking performance/configuration issues. Sorry, I > don''t know the details, though you could file a documentation bug on them. >It''s already documented in the Luste I/O Kit chapter of the Lustre manual. It will appear in the next edition (v. 1_11) of the Lustre manual. Before the updated manual is released, you can get it here: https://bugzilla.lustre.org/attachment.cgi?id=14792 Isaac