libexplain/mknod_on_error.c File Reference

#include <libexplain/ac/errno.h>
#include <libexplain/ac/fcntl.h>
#include <libexplain/ac/sys/types.h>
#include <libexplain/ac/sys/stat.h>
#include <libexplain/ac/unistd.h>
#include <libexplain/mknod.h>
#include <libexplain/output.h>

Go to the source code of this file.

Functions
int	explain_mknod_on_error (const char *pathname, mode_t mode, dev_t dev)

---

Function Documentation

int explain_mknod_on_error	(	const char *	pathname,
		mode_t	mode,
		dev_t	dev
	)

The explain_mknod_on_error function is used to call the mknod(2) system call. On failure an explanation will be printed to stderr, obtained from the explain_mknod(3) function.

Parameters:

pathname	The pathname, exactly as to be passed to the mknod(2) system call.
mode	The mode, exactly as to be passed to the mknod(2) system call.
dev	The dev, exactly as to be passed to the mknod(2) system call.

Returns:

The value returned by the wrapped mknod(2) system call.

Example:

This function is intended to be used in a fashion similar to the following example:

 if (explain_mknod_on_error(pathname, mode, dev) < 0)
 {
     ...cope with error
     ...no need to print error message
 }

Definition at line 30 of file mknod_on_error.c.