Lustre discuss - Jan 2008 - 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

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.
>  - routerstat
This is for LNET router stats, not sure how widely it is used.
>  - ptlctl
>  - debugctl
These are obsolete commands and should just be removed entirely.  Their
functionality was moved into lctl a long time ago.
>  - wirecheck
Tests the wire format encoding, but probably not needed for a real install.
>  - llobdstat
Reports 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.

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