libexplain  1.4.D001
Functions
libexplain/socket_on_error.c File Reference
#include <libexplain/ac/errno.h>
#include <libexplain/ac/sys/socket.h>
#include <libexplain/socket.h>
#include <libexplain/output.h>

Go to the source code of this file.

Functions

int explain_socket_on_error (int domain, int type, int protocol)

Function Documentation

int explain_socket_on_error ( int  domain,
int  type,
int  protocol 
)

The explain_socket_on_error function is used to call the socket(2) system call. On failure an explanation will be printed to stderr, obtained from the explain_socket(3) function.

This function is intended to be used in a fashion similar to the following example:

 int fildes = explain_socket_on_error(domain, type, protocol);
 if (fildes < 0)
 {
     ...cope with error
     ...no need to print error message
 }
Parameters:
domainThe domain, exactly as to be passed to the socket(2) system call.
typeThe type, exactly as to be passed to the socket(2) system call.
protocolThe protocol, exactly as to be passed to the socket(2) system call.
Returns:
The value returned by the wrapped socket(2) system call.

Definition at line 27 of file socket_on_error.c.