Man Linux: Main Page and Category List

NAME

       explain_getsockopt_or_die  -  get and set options on sockets and report
       errors

SYNOPSIS

       #include <libexplain/getsockopt.h>
       void explain_getsockopt_or_die(int fildes, int level,  int  name,  void
       *data, socklen_t *data_size);

DESCRIPTION

       The   explain_getsockopt_or_die   function   is   used   to   call  the
       getsockopt(2) system call.  On failure an explanation will  be  printed
       to  stderr,  obtained  from explain_getsockopt(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:
              explain_getsockopt_or_die(fildes, level, name, data, data_size);

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

       level   The level, exactly as to be passed to the getsockopt(2)  system
               call.

       name    The  name,  exactly as to be passed to the getsockopt(2) system
               call.

       data    The data, exactly as to be passed to the  getsockopt(2)  system
               call.

       data_size
               The  data_size,  exactly  as  to be passed to the getsockopt(2)
               system call.

       Returns:
               This function only returns on success.  On failure,  prints  an
               explanation and exits.

SEE ALSO

       getsockopt(2)
               get and set options on sockets

       explain_getsockopt(3)
               explain getsockopt(2) errors

       exit(2) terminate the calling process

COPYRIGHT

       libexplain version 0.19
       Copyright (C) 2009 Peter Miller

                                                  explain_getsockopt_or_die(3)