hpux man page for pthread_set_nice_np

pthread_get_nice_np(3T) 												   pthread_get_nice_np(3T)

NAME
       pthread_get_nice_np(), pthread_set_nice_np() - get or set the nice value of a thread

SYNOPSIS
PARAMETERS
	      thread	The thread whose nice value is to be set/retrieved.

	      nice_val	Value  of  nice  to  be  applied to the target thread is returned (get function) or it specifies the new value of nice for
			thread (set function).

DESCRIPTION
       These functions are used to set and retrieve the nice value of an individual thread.

       returns the current nice value setting of the target thread and stores it in nice_val.  adds the value of  nice_val  to	the  current  nice
       value of the target thread.

       A  thread's  nice  value is a non-negative number.  The system imposes a minimum nice value of 0 and a maximum of 39 with lower nice values
       providing more favorable scheduling.  If calling results in a nice value outside the range of 0 to 39, the value will be set to the nearest
       limit.	A  process must have appropriate privileges to lower a thread's nice value.  The function allows individual threads in the process
       to have different nice values.

       returns the current nice value less 20 and will be in the range -20 to +19.

       The nice value of only system scope threads can be changed.  An attempt to change the nice value of a process-scope thread will result in a
       return  value  of  Calling on a thread that has a scheduling policy other than will have an effect only when the thread's scheduling policy
       changes to If a thread calls the system call to create a new process, the new process inherits the process-level nice  value.   Calling	to
       create a new thread will result in the new thread inheriting the creating thread's nice value.

   Note
       If  the	nice value of the entire process is changed through or all the threads in the process will have their nice values reset to the new
       process-level nice value.  The new process's nice value setting overwrites the old thread's setting.  Thus its possible that a thread whose
       nice value had been set higher than the process-level nice value have its nice value lowered as a result of the process-level re-nicing.

RETURN VALUE
       Upon successful completion, and return zero.

       Otherwise, an error number is returned to indicate the error (the variable is not set).

ERRORS
       If any of the following occur, the and functions return the corresponding error:

	      A process-scope thread was specified.

	      The caller does not have permission to lower the nice
			     value specified in nice_val.

	      No thread could be found corresponding to
			     thread.

AUTHOR
       and were developed by HP.

SEE ALSO
       fork(2), nice(2), setpriority(2), pthread_attr_getschedpolicy(3T), pthread_setschedparam(3T).

								  Pthread Library					   pthread_get_nice_np(3T)