Date: Tue, 27 Oct 2020 12:32:18 +0000 (UTC) From: =?UTF-8?Q?Fernando_Apestegu=c3=ada?= <fernape@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r367077 - head/usr.bin/renice Message-ID: <202010271232.09RCWI05023840@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: fernape (ports committer) Date: Tue Oct 27 12:32:17 2020 New Revision: 367077 URL: https://svnweb.freebsd.org/changeset/base/367077 Log: renice(8): Clarify "who" parameters. There was a question raised in freebsd-questions@ mail list[1] about the "who" parameters in this man page. It seems OpenBSD[2] amd NetBSD[3] both have more legible descriptions so I borrowed some of their ideas to try and make this page clearer. [1] https://lists.freebsd.org/pipermail/freebsd-questions/2020-October/291914.html [2] https://man.bsd.lv/renice [3] https://man.netbsd.org/renice.8 Approved by: manpages (bcr@) Differential Revision: https://reviews.freebsd.org/D26950 Modified: head/usr.bin/renice/renice.8 Modified: head/usr.bin/renice/renice.8 ============================================================================== --- head/usr.bin/renice/renice.8 Tue Oct 27 12:27:26 2020 (r367076) +++ head/usr.bin/renice/renice.8 Tue Oct 27 12:32:17 2020 (r367077) @@ -28,7 +28,7 @@ .\" @(#)renice.8 8.1 (Berkeley) 6/9/93 .\" $FreeBSD$ .\" -.Dd June 9, 1993 +.Dd October 27, 2020 .Dt RENICE 8 .Os .Sh NAME @@ -37,22 +37,18 @@ .Sh SYNOPSIS .Nm .Ar priority -.Op Oo Fl p Oc Ar pid ... -.Op Oo Fl g Oc Ar pgrp ... -.Op Oo Fl u Oc Ar user ... +.Op Oo Fl gpu Oc Ar target .Nm .Fl n Ar increment -.Op Oo Fl p Oc Ar pid ... -.Op Oo Fl g Oc Ar pgrp ... -.Op Oo Fl u Oc Ar user ... +.Op Oo Fl gpu Oc Ar target .Sh DESCRIPTION The .Nm utility alters the scheduling priority of one or more running processes. The following -.Ar who -parameters are interpreted as process ID's, process group +.Ar target +parameters are interpreted as process ID's (the default), process group ID's, user ID's or user names. The .Nm Ns 'ing @@ -62,27 +58,25 @@ The .Nm Ns 'ing of a user causes all processes owned by the user to have their scheduling priority altered. -By default, the processes to be affected are specified by -their process ID's. .Pp The following options are available: .Bl -tag -width indent -.It Fl g -Force -.Ar who -parameters to be interpreted as process group ID's. .It Fl n Instead of changing the specified processes to the given priority, interpret the following argument as an increment to be applied to the current priority of each process. -.It Fl u -Force the -.Ar who -parameters to be interpreted as user names or user ID's. +.It Fl g +Interpret +.Ar target +parameters as process group ID's. .It Fl p -Reset the -.Ar who -interpretation to be (the default) process ID's. +Interpret +.Ar target +parameters as process ID's (the default). +.It Fl u +Interpret +.Ar target +parameters as user names or user ID's. .El .Pp Users other than the super-user may only alter the priority of
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202010271232.09RCWI05023840>