libexplain/buffer/errno/mount.h File Reference

#include <libexplain/ac/sys/mount.h>
#include <libexplain/string_buffer.h>

Go to the source code of this file.

Functions
void	explain_buffer_errno_mount (explain_string_buffer_t *sb, int errnum, const char *source, const char *target, const char *file_systems_type, unsigned long flags, const void *data)
void	explain_buffer_errno_mount_explanation (explain_string_buffer_t *sb, int errnum, const char *syscall_name, const char *source, const char *target, const char *file_systems_type, unsigned long flags, const void *data)

---

Function Documentation

void explain_buffer_errno_mount	(	explain_string_buffer_t *	sb,
		int	errnum,
		const char *	source,
		const char *	target,
		const char *	file_systems_type,
		unsigned long	flags,
		const void *	data
	)

The explain_buffer_errno_mount function is used to obtain an explanation of an error returned by the mount(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 suitable 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.
source	The original source, exactly as passed to the mount(2) system call.
target	The original target, exactly as passed to the mount(2) system call.
file_systems_type	The original file_systems_type, exactly as passed to the mount(2) system call.
flags	The original flags, exactly as passed to the mount(2) system call.
data	The original data, exactly as passed to the mount(2) system call.

Definition at line 909 of file mount.c.

void explain_buffer_errno_mount_explanation	(	explain_string_buffer_t *	sb,
		int	errnum,
		const char *	syscall_name,
		const char *	source,
		const char *	target,
		const char *	file_systems_type,
		unsigned long	flags,
		const void *	data
	)

The explain_buffer_errno_mount_explanation function is used to obtain the explanation (the part after "because") of an error returned by the mount(2) system call (and similar).

Parameters:

sb	The string buffer to print the message into. If a suitable 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.
syscall_name	The name of the offending system call.
source	The original source, exactly as passed to the mount(2) system call.
target	The original target, exactly as passed to the mount(2) system call.
file_systems_type	The original file_systems_type, exactly as passed to the mount(2) system call.
flags	The original flags, exactly as passed to the mount(2) system call.
data	The original data, exactly as passed to the mount(2) system call.

Definition at line 371 of file mount.c.