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:

domain	The domain, exactly as to be passed to the socket(2) system call.
type	The type, exactly as to be passed to the socket(2) system call.
protocol	The 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.