libIO.3x (2010 09)

l
libIO(3X) libIO(3X)
See the LIBIO_ERRORS section below for an explanation of each error value.
The printed message has the form:
str
:libIO error message <cr>
If str is NULL, the message has the form:
libIO error message
<cr>
io_strerror()
returns a pointer to the string containing the libIO error message which maps to the
passed argument errnum.
Arguments
str Caller specified string to print along with error status
errnum Caller specified error number to map to error message string
Return Value
io_strerror()
:
Pointer to the message string - Upon success.
NULL - Otherwise.
io_error() has no return value.
Errors
None.
libIO FUNCTION
Name
io_dev_to_dsf() - returns device special file of a device corresponding to the given
dev_t
Synopsis
#include <sys/types.h>
io_dev_to_dsf(dev_t dev,int dev_type, char *buffer);
Description
This API returns a device special file corresponding to the specified
dev_t. This API will be faster than
devnm(), when the specified dev_t corresponds to either the default persistent or the legacy device
special file of an existing device. See devnm (3). Default device special files are those device special files
which are created by insf (see insf(1M)). This API uses the services of devnm() in case the given
dev_t does not correspond to either the default persistent or the legacy device special file or the file that
is not found on its default location.
Arguments
dev_t The
dev_t corresponding to a device special file.
dev_type The device special file type:
0 for character special file.
1 for block device file.
buffer A pointer to a buffer to store the returned device special file. The buffer is allocated by
the caller. By default, the size of the buffer should be
MAXPATHLEN.
Return Value
IO_SUCCESS - Upon success.
IO_ERROR - Otherwise. io_errno is set to indicate the error.
Errors
[IO_E_DCONF_OPEN]
[IO_E_MATCH]
[IO_E_PARM]
[IO_E_BUF_TOO_SMALL]
[IO_E_SYSCALL]
4 Hewlett-Packard Company − 4 − HP-UX 11i Version 3: September 2010