#include <libexplain/string_buffer.h>

Functions
void	explain_buffer_errno_chown (explain_string_buffer_t sb, int errnum, const char pathname, int uid, int gid)
void	explain_buffer_errno_chown_explanation_fc (explain_string_buffer_t sb, int errnum, const char syscall_name, const char pathname, int uid, int gid, const char pathname_caption, struct explain_final_t *final_component)
void	explain_buffer_errno_fchown_explanation (explain_string_buffer_t sb, int errnum, const char syscall_name, int fildes, int uid, int gid, const char *fildes_caption)
void	explain_buffer_errno_chown_explanation (explain_string_buffer_t sb, int errnum, const char syscall_name, const char pathname, int owner, int group, const char pathname_caption)

Function Documentation

void explain_buffer_errno_chown	(	explain_string_buffer_t *	sb,
		int	errnum,
		const char *	pathname,
		int	uid,
		int	gid
	)

The explain_buffer_errno_chown function is used to obtain an explanation of an error returned by the chown(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:

sb	The string buffer to print the message into. If a safe buffer is specified, this function is thread safe.
errnum	The 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.
pathname	The original pathname, exactly as passed to the chown(2) system call.
uid	The original owner, exactly as passed to the chown(2) system call.
gid	The original group, exactly as passed to the chown(2) system call.

Definition at line 634 of file chown.c.

void explain_buffer_errno_chown_explanation	(	explain_string_buffer_t *	sb,
		int	errnum,
		const char *	syscall_name,
		const char *	pathname,
		int	owner,
		int	group,
		const char *	pathname_caption
	)

The explain_buffer_errno_fchown_explanation function factors out code common to both several hown systcall foms.

Parameters:

sb	The string buffer to print the message into.
errnum	The error value to be decoded.
syscall_name	The name of the offending system call.
pathname	The original fildes, exactly as passed to the fchown(2) system call.
owner	The original owner, exactly as passed to the fchown(2) system call.
group	The original group, exactly as passed to the fchown(2) system call.
pathname_caption	The name of the offending system call argument.

Definition at line 455 of file chown.c.

void explain_buffer_errno_chown_explanation_fc	(	explain_string_buffer_t *	sb,
		int	errnum,
		const char *	syscall_name,
		const char *	pathname,
		int	uid,
		int	gid,
		const char *	pathname_caption,
		struct explain_final_t *	final_component
	)

The explain_buffer_errno_chown_explanation_fc function factors out code common to both the explain_buffer_errno_chown_explanation and explain_buffer_errno_lchown_explanation functions.

Parameters:

sb	The string buffer to print the message into.
errnum	The error value to be decoded.
syscall_name	The name of the offending system call.
pathname	The original pathname, exactly as passed to the chown(2) system call.
uid	The original owner, exactly as passed to the chown(2) system call.
gid	The original group, exactly as passed to the chown(2) system call.
pathname_caption	The name of the offending syscall argument.
final_component	The designed properties of the final component.

Definition at line 496 of file chown.c.

void explain_buffer_errno_fchown_explanation	(	explain_string_buffer_t *	sb,
		int	errnum,
		const char *	syscall_name,
		int	fildes,
		int	uid,
		int	gid,
		const char *	fildes_caption
	)

The explain_buffer_errno_fchown_explanation function factors out code common to both it and the explain_buffer_errno_chown_explanation function.

Parameters:

sb	The string buffer to print the message into.
errnum	The error value to be decoded.
syscall_name	The name of the offending system call.
fildes	The original fildes, exactly as passed to the fchown(2) system call.
uid	The original owner, exactly as passed to the fchown(2) system call.
gid	The original group, exactly as passed to the fchown(2) system call.
fildes_caption	The name of the offending syscall argument.

Definition at line 570 of file chown.c.

Functions

Function Documentation