Date: Wed, 30 Jun 1999 20:46:01 +0100 From: Nik Clayton <nik@nothing-going-on.demon.co.uk> To: Jesus Monroy <jesus.monroy@usa.net> Cc: doc@freebsd.org Subject: Re: pstat -k; pstat -n Message-ID: <19990630204601.B68144@catkin.nothing-going-on.org> In-Reply-To: <19990629195146.16016.qmail@nwcst285.netaddress.usa.net>; from Jesus Monroy on Tue, Jun 29, 1999 at 12:51:45PM -0700 References: <19990629195146.16016.qmail@nwcst285.netaddress.usa.net>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Jun 29, 1999 at 12:51:45PM -0700, Jesus Monroy wrote:
> Both options for pstat(8) seem not
> to function. Either option will return:
>
> vidi: {121} pstat -k
> usage: pstat [-Tfknstv] [-M core] [-N system]
> vidi: {122} pstat -n
> usage: pstat [-Tfknstv] [-M core] [-N system]
Right, but wrong. Both of those options should be run in conjunction with
other options, as my cursory reading of the man page makes clear. Perhaps
you skipped it in your haste to point out non-existant flaws?
Specifically;
# echo $BLOCKSIZE
BLOCKSIZE: Undefined variable
# pstat -s
Device 512-blocks Used Avail Capacity Type
/dev/da0s1b 262144 61760 200128 24% Interleaved
/dev/da1s1b 262144 57992 203896 22% Interleaved
Total 523776 119752 404024 23%
# pstat -sk
Device 1K-blocks Used Avail Capacity Type
/dev/da0s1b 131072 30880 100064 24% Interleaved
/dev/da1s1b 131072 28996 101948 22% Interleaved
Total 261888 59876 202012 23%
As you can see, in the second example -k has caused the output to be
reported in kilobyte blocks and not 512 byte blocks. -n works in a
similar fashion.
> As a seperate question, I see this quite often.
Perhaps not as often as you think.
> What is the issue? Aren't the writers of
> these utils making changes to the man pages?
Yes they are, by and large. Sometimes they forget, and we try and remind
them. Reading the cvs-all mailing list for any length of time should
show this.
> Are they supposed to make the changes?
Yes.
> If not, who is responsible for these changes?
People that notice problems. Either by sending a PR, or, if they're a
committer themselves, taking it up with the last person to change that
utility, confirming that it was an oversight, and fixing the problem.
N
--
[intentional self-reference] can be easily accommodated using a blessed,
non-self-referential dummy head-node whose own object destructor severs
the links.
-- Tom Christiansen in <375143b5@cs.colorado.edu>
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19990630204601.B68144>