Man Linux: Main Page and Category List

NAME

       explain_fcntl_or_die - manipulate a file descriptor and report errors

SYNOPSIS

       #include <libexplain/fcntl.h>
       int explain_fcntl_or_die(int fildes, int command, long arg);

DESCRIPTION

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

       This function is intended to be  used  in  a  fashion  similar  to  the
       following example:
              int result = explain_fcntl_or_die(fildes, command, arg);

       fildes  The  fildes,  exactly  as  to  be passed to the fcntl(2) system
               call.

       command The command, exactly as to be passed  to  the  fcntl(2)  system
               call.

       arg     The arg, exactly as to be passed to the fcntl(2) system call.

       Returns:
               This  function only returns on success, and it returns whatever
               was returned by the fcntl(2) call; depending  on  the  command,
               this  may  have  no use.  On failure, prints an explanation and
               exits, it does not return.

SEE ALSO

       fcntl(2)
               manipulate a file descriptor

       explain_fcntl(3)
               explain fcntl(2) errors

       exit(2) terminate the calling process

COPYRIGHT

       libexplain version 0.19
       Copyright (C) 2008 Peter Miller

                                                       explain_fcntl_or_die(3)