devname_r(3) [osx man page]

DEVNAME(3)						   BSD Library Functions Manual 						DEVNAME(3)

NAME

     devname, devname_r -- get device name

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <sys/stat.h>
     #include <stdlib.h>

     char *
     devname(dev_t dev, mode_t type);

     char *
     devname_r(dev_t dev, mode_t type, char *buf, int len);

DESCRIPTION

     The devname() function returns a pointer to the name of the block or character device in ``/dev'' with a device number of dev, and a file
     type matching the one encoded in type which must be one of S_IFBLK or S_IFCHR.  If no device matches the specified values, or no information
     is available, NULL is returned.

     The devname() function uses a static buffer, which will be overwritten on subsequent calls.  The devname_r() functions takes a buffer and
     length as arguments to avoid this problem.

     The traditional display for applications when no device is found is the string ``??''.

SEE ALSO

     stat(2), dev_mkdb(8)

HISTORY

     The devname() function call appeared in 4.4BSD.

BSD
								 October 25, 2004							       BSD

GETDEVMAJOR(3)						   BSD Library Functions Manual 					    GETDEVMAJOR(3)

NAME

     getdevmajor -- get block or character device major number

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <stdlib.h>
     #include <sys/stat.h>

     devmajor_t
     getdevmajor(const char *name, mode_t type);

DESCRIPTION

     The getdevmajor() function returns the major device number of the block or character device specified by name and a file type matching the
     one encoded in type which must be one of S_IFBLK or S_IFCHR.

RETURN VALUES

     If no device matches the specified values, no information is available, or an error occurs, NODEVMAJOR is returned and errno is set to indi-
     cate the error.

EXAMPLES

     To retrieve the major number for pty(4) slave devices (aka pts devices):

	   #include <stdlib.h>
	   #include <sys/stat.h>

	   devmajor_t pts;
	   pts = getdevmajor("pts", S_IFCHR);

     To retrieve the major numbers for the block and character wd(4) devices:

	   #include <stdlib.h>
	   #include <sys/stat.h>

	   devmajor_t c, b;
	   c = getdevmajor("wd", S_IFCHR);
	   b = getdevmajor("wd", S_IFBLK);

ERRORS

     The getdevmajor() function may fail and set errno for any of the errors specified for the library functions malloc(3) and sysctlbyname(3).
     In addition, the following errors may be reported:

     [EINVAL]		The value of the type argument is not S_IFCHR or S_IFBLK.

     [ENOENT]		The named device is not found.

SEE ALSO

     stat(2), devname(3), malloc(3), sysctlbyname(3)

HISTORY

     The getdevmajor() function call appeared in NetBSD 3.0.

BSD
								 January 20, 2009							       BSD