1explain_getpriority_or_die(3L)ibrary Functions Manuaelxplain_getpriority_or_die(3)
2
3
4

NAME

6       explain_getpriority_or_die - get program scheduling priority and report
7       errors
8

SYNOPSIS

10       #include <libexplain/getpriority.h>
11       int explain_getpriority_or_die(int which, int who);
12       int explain_getpriority_on_error(int which, int who);
13

DESCRIPTION

15       The explain_getpriority_or_die function is used to call  the  getprior‐
16       ity(2)  system  call.  On  failure  an  explanation  will be printed to
17       stderr, obtained from the explain_getpriority(3) function, and then the
18       process terminates by calling exit(EXIT_FAILURE).
19
20       The explain_getpriority_on_error function is used to call the getprior‐
21       ity(2) system call. On  failure  an  explanation  will  be  printed  to
22       stderr,  obtained  from  the explain_getpriority(3) function, but still
23       returns to the caller.
24
25       which   The which, exactly as to be passed to the getpriority(2) system
26               call.
27
28       who     The  who,  exactly as to be passed to the getpriority(2) system
29               call.
30

RETURN VALUE

32       The explain_getpriority_or_die function only returns  on  success,  see
33       getpriority(2)  for more information. On failure, prints an explanation
34       and exits, it does not return.
35
36       The explain_getpriority_on_error  function  always  returns  the  value
37       return by the wrapped getpriority(2) system call.
38

EXAMPLE

40       The  explain_getpriority_or_die  function  is  intended to be used in a
41       fashion similar to the following example:
42              int result = explain_getpriority_or_die(which, who);
43

SEE ALSO

45       getpriority(2)
46               get program scheduling priority
47
48       explain_getpriority(3)
49               explain getpriority(2) errors
50
51       exit(2) terminate the calling process
52

54       libexplain version 1.4
55       Copyright (C) 2013 Peter Miller
56
57
58
59                                                 explain_getpriority_or_die(3)
Impressum