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

  
 
  

home | help
explain_se...ity_or_die(3)  Library Functions Manual  explain_se...ity_or_die(3)

NAME
     explain_setpriority_or_die - set program scheduling priority and report er-
     rors

SYNOPSIS
     #include <libexplain/setpriority.h>
     void explain_setpriority_or_die(int which, int who, int prio);
     int explain_setpriority_on_error(int which, int who, int prio);

DESCRIPTION
     The  explain_setpriority_or_die function is used to call the setpriority(2)
     system call. On failure an explanation will be printed to stderr,	obtained
     from  the	explain_setpriority(3) function, and then the process terminates
     by calling exit(EXIT_FAILURE).

     The explain_setpriority_on_error function is used	to  call  the  setprior-
     ity(2)  system  call.  On failure an explanation will be printed to stderr,
     obtained from the explain_setpriority(3) function, but still returns to the
     caller.

     which   The which, exactly as to be passed  to  the  setpriority(2)  system
	     call.

     who     The who, exactly as to be passed to the setpriority(2) system call.

     prio    The  prio,  exactly  as  to  be passed to the setpriority(2) system
	     call.

RETURN VALUE
     The explain_setpriority_or_die function only returns on success,  see  set-
     priority(2) for more information. On failure, prints an explanation and ex-
     its, it does not return.

     The  explain_setpriority_on_error	function always returns the value return
     by the wrapped setpriority(2) system call.

EXAMPLE
     The explain_setpriority_or_die function is intended to be used in a fashion
     similar to the following example:
	    explain_setpriority_or_die(which, who, prio);

SEE ALSO
     setpriority(2)
	     set program scheduling priority

     explain_setpriority(3)
	     explain setpriority(2) errors

     exit(2)
	     terminate the calling process

COPYRIGHT
     libexplain version 1.3
     Copyright (C) 2013 Peter Miller

						      explain_se...ity_or_die(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=explain_setpriority_or_die&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help