Differential D26950 Diff 78807 head/usr.bin/renice/renice.8

Changeset View

Standalone View

head/usr.bin/renice/renice.8

	Show All 22 Lines
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" @(#)renice.8 8.1 (Berkeley) 6/9/93			.\" @(#)renice.8 8.1 (Berkeley) 6/9/93
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd June 9, 1993			.Dd October 27, 2020
	.Dt RENICE 8			.Dt RENICE 8
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm renice			.Nm renice
	.Nd alter priority of running processes			.Nd alter priority of running processes
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.Nm			.Nm
	.Ar priority			.Ar priority
	.Op Oo Fl p Oc Ar pid ...			.Op Oo Fl gpu Oc Ar target
	.Op Oo Fl g Oc Ar pgrp ...
	.Op Oo Fl u Oc Ar user ...
	.Nm			.Nm
	.Fl n Ar increment			.Fl n Ar increment
	.Op Oo Fl p Oc Ar pid ...			.Op Oo Fl gpu Oc Ar target
	.Op Oo Fl g Oc Ar pgrp ...
	.Op Oo Fl u Oc Ar user ...
	.Sh DESCRIPTION			.Sh DESCRIPTION
	The			The
	.Nm			.Nm
	utility alters the			utility alters the
	scheduling priority of one or more running processes.			scheduling priority of one or more running processes.
	The following			The following
	.Ar who			.Ar target
	parameters are interpreted as process ID's, process group			parameters are interpreted as process ID's (the default), process group
	ID's, user ID's or user names.			ID's, user ID's or user names.
	The			The
	.Nm Ns 'ing			.Nm Ns 'ing
	of a process group causes all processes in the process group			of a process group causes all processes in the process group
	to have their scheduling priority altered.			to have their scheduling priority altered.
	The			The
	.Nm Ns 'ing			.Nm Ns 'ing
	of a user causes all processes owned by the user to have			of a user causes all processes owned by the user to have
	their scheduling priority altered.			their scheduling priority altered.
	By default, the processes to be affected are specified by
	their process ID's.
	.Pp			.Pp
	The following options are available:			The following options are available:
	.Bl -tag -width indent			.Bl -tag -width indent
	.It Fl g
	Force
	.Ar who
	parameters to be interpreted as process group ID's.
	.It Fl n			.It Fl n
	Instead of changing the specified processes to the given priority,			Instead of changing the specified processes to the given priority,
	interpret the following argument as an increment to be applied to			interpret the following argument as an increment to be applied to
	the current priority of each process.			the current priority of each process.
	.It Fl u			.It Fl g
	Force the			Interpret
	.Ar who			.Ar target
	parameters to be interpreted as user names or user ID's.			parameters as process group ID's.
	.It Fl p			.It Fl p
	Reset the			Interpret
	.Ar who			.Ar target
	interpretation to be (the default) process ID's.			parameters as process ID's (the default).
				.It Fl u
				Interpret
				.Ar target
				parameters as user names or user ID's.
	.El			.El
	.Pp			.Pp
	Users other than the super-user may only alter the priority of			Users other than the super-user may only alter the priority of
	processes they own,			processes they own,
	and can only monotonically increase their ``nice value''			and can only monotonically increase their ``nice value''
	within the range 0 to			within the range 0 to
	.Dv PRIO_MAX			.Dv PRIO_MAX
	(20).			(20).
	▲ Show 20 Lines • Show All 41 Lines • Show Last 20 Lines