libexplain  1.4.D001
Functions
libexplain/buffer/errno/getsockopt.c File Reference
#include <libexplain/ac/errno.h>
#include <libexplain/buffer/ebadf.h>
#include <libexplain/buffer/efault.h>
#include <libexplain/buffer/einval.h>
#include <libexplain/buffer/enoprotoopt.h>
#include <libexplain/buffer/enotsock.h>
#include <libexplain/buffer/errno/generic.h>
#include <libexplain/buffer/errno/getsockopt.h>
#include <libexplain/buffer/fildes_to_pathname.h>
#include <libexplain/buffer/gettext.h>
#include <libexplain/buffer/pointer.h>
#include <libexplain/buffer/socklen.h>
#include <libexplain/buffer/sockopt_level.h>
#include <libexplain/buffer/sockopt_name.h>
#include <libexplain/explanation.h>
#include <libexplain/is_efault.h>

Go to the source code of this file.

Functions

static void explain_buffer_errno_getsockopt_system_call (explain_string_buffer_t *sb, int errnum, int fildes, int level, int name, void *data, socklen_t *data_size)
static void explain_buffer_errno_getsockopt_explanation (explain_string_buffer_t *sb, int errnum, int fildes, int level, int name, void *data, socklen_t *data_size)
void explain_buffer_errno_getsockopt (explain_string_buffer_t *sb, int errnum, int fildes, int level, int name, void *data, socklen_t *data_size)

Function Documentation

void explain_buffer_errno_getsockopt ( explain_string_buffer_t sb,
int  errnum,
int  fildes,
int  level,
int  name,
void *  data,
socklen_t *  data_size 
)

The explain_buffer_errno_getsockopt function is used to obtain an explanation of an error returned by the getsockopt(2) system call. The least the message will contain is the value of strerror(errnum), but usually it will do much better, and indicate the underlying cause in more detail.

Parameters:
sbThe string buffer to print the message into. If a safe buffer is specified, this function is thread safe.
errnumThe error value to be decoded, usually obtained from the errno global variable just before this function is called. This is necessary if you need to call any code between the system call to be explained and this function, because many libc functions will alter the value of errno.
fildesThe original fildes, exactly as passed to the getsockopt(2) system call.
levelThe original level, exactly as passed to the getsockopt(2) system call.
nameThe original name, exactly as passed to the getsockopt(2) system call.
dataThe original data, exactly as passed to the getsockopt(2) system call.
data_sizeThe original data_size, exactly as passed to the getsockopt(2) system call.

Definition at line 110 of file getsockopt.c.

static void explain_buffer_errno_getsockopt_explanation ( explain_string_buffer_t sb,
int  errnum,
int  fildes,
int  level,
int  name,
void *  data,
socklen_t *  data_size 
) [static]

Definition at line 59 of file getsockopt.c.

static void explain_buffer_errno_getsockopt_system_call ( explain_string_buffer_t sb,
int  errnum,
int  fildes,
int  level,
int  name,
void *  data,
socklen_t *  data_size 
) [static]

Definition at line 39 of file getsockopt.c.