unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 rtprio(1)							   rtprio(1)




 NAME
      rtprio - execute process with real-time priority

 SYNOPSIS
      rtprio priority command [arguments]

      rtprio priority -pid

      rtprio -t command [arguments]

      rtprio -t -pid

 DESCRIPTION
      rtprio 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 details.

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

      If -t is not specified, command is not scheduled, or pid's real-time
      priority is not changed, if the user is not a member of a group having
      PRIV_RTPRIO access 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 privileges, or the real or effective user ID must match
      the real or saved user ID of the process to be modified.

 RETURN VALUE
      rtprio returns exit status 0 if command is successfully scheduled or
      if pid's real-time priority is successfully changed, 1 if command is
      not executable 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 a.out at a real-time priority of 100:

	   rtprio 100 a.out

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




 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 rtprio(1)							   rtprio(1)




	   rtprio 40 -24217

 AUTHOR
      rtprio was developed by HP.

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















































 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000