What are "who parameters"? (man 8 renice)

[Ottavio Caruso via freebsd-questions]

Can manual pages be more arcane and esoteric than this?

% man 8 renice

https://man.bsd.lv/FreeBSD-12.0/renice

"The following who parameters are interpreted as ..."

"-g
Force who parameters to be interpreted as process group ID's."

"-u
Force the who parameters to be interpreted as user names or user ID's"

"who" is underlined. Is it an acronym? I've seen this mentioned only in
this man page on FreeBSD and NetBSD.

The OpenBSD manual page seems to to be saner:
https://man.bsd.lv/renice

--
Ottavio Caruso
_______________________________________________
freebsd-...@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-questions
To unsubscribe, send any mail to "freebsd-questi...@freebsd.org"

[Fernando Apesteguía]

On Thu, Oct 22, 2020 at 9:02 PM Ottavio Caruso via freebsd-questions <
freebsd-...@freebsd.org> wrote:

> Can manual pages be more arcane and esoteric than this?
>
> % man 8 renice
>
> https://man.bsd.lv/FreeBSD-12.0/renice
>
> "The following who parameters are interpreted as ..."
>
> "-g
> Force who parameters to be interpreted as process group ID's."
>
> "-u
> Force the who parameters to be interpreted as user names or user ID's"
>
> "who" is underlined. Is it an acronym? I've seen this mentioned only in
> this man page on FreeBSD and NetBSD.
>

I would say it has the same interpretation as in chmod(1).

[Erwan David]

Le 22/10/2020 à 21:02, Ottavio Caruso via freebsd-questions a écrit :
> Can manual pages be more arcane and esoteric than this?
>
> % man 8 renice
>
> https://man.bsd.lv/FreeBSD-12.0/renice
>
> "The following who parameters are interpreted as ..."
>
> "-g
>     Force who parameters to be interpreted as process group ID's."
>
> "-u
>     Force the who parameters to be interpreted as user names or user ID's"
>
> "who" is underlined. Is it an acronym? I've seen this mentioned only in
> this man page on FreeBSD and NetBSD.
>
> The OpenBSD manual page seems to to be saner:
> https://man.bsd.lv/renice
>

who is defined in the first paragraph...

[Bob Proulx]

Ottavio Caruso via freebsd-questions wrote:
> Can manual pages be more arcane and esoteric than this?

Yes. But they don't know how! :-)

However the wording on that man page days *way* back many, many
years. It's very old. It appears to have arrived sometime between
2.9 BSD and 2.10 BSD sometime in the mid 1980's.

Compare this 2.9.1 BSD man page:

https://www.freebsd.org/cgi/man.cgi?query=renice&manpath=2.9.1+BSD

With this 2.10 BSD man page:

https://www.freebsd.org/cgi/man.cgi?query=renice&manpath=2.10+BSD

> % man 8 renice
>
> https://man.bsd.lv/FreeBSD-12.0/renice

The synopsys line is always useful.

renice priority [[-p] pid ...] [[-g] pgrp ...] [[-u] user ...]
renice -n increment [[-p] pid ...] [[-g] pgrp ...] [[-u] user ...]

> "The following who parameters are interpreted as ..."
>
> "-g
> Force who parameters to be interpreted as process group ID's."
>
> "-u
> Force the who parameters to be interpreted as user names or user ID's"

And then there is an example.

Change the priority of process ID's 987 and 32, and all processes
owned by users daemon and root.

renice +1 987 -u daemon root -p 32

> "who" is underlined. Is it an acronym? I've seen this mentioned only in this
> man page on FreeBSD and NetBSD.

I think the original intention one was always affecting *other*
processes. Some other target. But back then one had a deeply
emotional bond with processes before renicing them. First there was
coffee and then later maybe dinner. Processes were humanized. They
were not an "it" but a "who". And so the document is asking "who" is
getting reniced? Who being what process. But here it is who is being
reniced. And that is why it was worded that way.

> The OpenBSD manual page seems to to be saner:
> https://man.bsd.lv/renice

For the most part newer manuals mostly do rewrite that considerably
and now refer to those as process identifiers.

Bob

[Ottavio Caruso via freebsd-questions]

On 25/10/2020 02:15, Bob Proulx wrote:
> For the most part newer manuals mostly do rewrite that considerably
> and now refer to those as process identifiers.

NetBSD renice(8) man page has been reworked recently:
https://man.netbsd.org/renice.8

http://cvsweb.netbsd.org/bsdweb.cgi/src/usr.bin/renice/renice.8?rev=1.16&content-type=text/x-cvsweb-markup&only_with_tag=MAIN

--
Ottavio Caruso