libexplain/buffer/errno/lstat.h File Reference

Go to the source code of this file.

Functions
void	explain_buffer_errno_lstat (struct explain_string_buffer_t *sb, int errnum, const char *pathname, const struct stat *stp)
void	explain_buffer_errno_lstat_explanation (struct explain_string_buffer_t *sb, int errnum, const char *syscall_name, const char *pathname, const struct stat *stp)

---

Function Documentation

void explain_buffer_errno_lstat	(	struct explain_string_buffer_t *	sb,
		int	errnum,
		const char *	pathname,
		const struct stat *	stp
	)

The explain_buffer_errno_lstat function is used to obtain an explanation of an error returned by the lstat(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 in which the message is being constructed. If a safe buffer is specified, this function is thread safe.
errnum	The error value to be decoded, usually obtain 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 path, exactly has passed to the lstat(2) system call.
stp	The original stp, exactly has passed to the lstat(2) system call.

Definition at line 118 of file lstat.c.

void explain_buffer_errno_lstat_explanation	(	struct explain_string_buffer_t *	sb,
		int	errnum,
		const char *	syscall_name,
		const char *	pathname,
		const struct stat *	stp
	)

The explain_buffer_errno_lstat-explanation function is used to print an explanation of an error returned by the lstat(2) system call.

Parameters:

sb	The string buffer in which the message is being constructed.
errnum	The error value to be decoded.
syscall_name	The name of the offended system call.
pathname	The original path, exactly has passed to the lstat(2) system call.
stp	The original stp, exactly has passed to the lstat(2) system call.

Definition at line 54 of file lstat.c.