Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
rtprio(1)		    General Commands Manual		     rtprio(1)

NAME
       rtprio -	execute	process	with real-time priority

SYNOPSIS
       priority	command	[arguments]

       priority

       command [arguments]

DESCRIPTION
       executes	 command  with	a real-time priority, or changes the real-time
       priority	of currently  executing	 process  pid.	 Real-time  priorities
       range from zero (highest) to 127	(lowest).  Real-time processes are not
       subject to priority degradation,	and are	all  of	 greater  (scheduling)
       importance  than	 non-real-time	processes.  See	rtprio(2) for more de-
       tails.

       If is specified instead of a real-time priority,	executes command  with
       a  timeshare (non-real-time) priority, or changes the currently execut-
       ing process pid from a possibly real-time priority to a timeshare  pri-
       ority.  The former is useful to spawn a timeshare priority command from
       a real-time priority shell.

       If is not specified, command is not scheduled, or pid's real-time  pri-
       ority is	not changed, if	the user is not	a member of a group having ac-
       cess and	is not the user	with appropriate  privileges.	When  changing
       the  real-time priority of a currently executing	process, the effective
       user ID of the calling process must be the user with appropriate	privi-
       leges,  or  the	real or	effective user ID must match the real or saved
       user ID of the process to be modified.

RETURN VALUE
       returns exit status 0 if	command	is successfully	scheduled or if	 pid's
       real-time  priority  is	successfully changed, 1	if command is not exe-
       cutable or pid does not exist, and 2 if command (pid)  lacks  real-time
       capability,  or	the  invoker's effective user ID is not	a user who has
       appropriate privileges, or the real or effective	user or	 the  real  or
       effective  user	ID  does  not  match  the real or saved	user ID	of the
       process being changed.

EXAMPLES
       Execute file at a real-time priority of 100:

       Set the currently running process pid 24217 to a	real-time priority  of
       40:

AUTHOR
       was developed by	HP.

SEE ALSO
       setprivgrp(1M), getprivgrp(2), rtprio(2).

								     rtprio(1)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLES | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=rtprio&sektion=1&manpath=HP-UX+11.22>

home | help