Man Linux: Main Page and Category List

NAME

       explain_setsockopt_or_die  -  get and set options on sockets and report
       errors

SYNOPSIS

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

DESCRIPTION

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

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

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

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

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

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

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

SEE ALSO

       setsockopt(2)
               get and set options on sockets

       explain_setsockopt(3)
               explain setsockopt(2) errors

       exit(2) terminate the calling process

COPYRIGHT

       libexplain version 0.19
       Copyright (C) 2009 Peter Miller

                                                  explain_setsockopt_or_die(3)