HP-UX Reference (11i v3 07/02) - 3 Library Functions A-M (vol 6)

l
libIO(3X) libIO(3X)
libIO FUNCTION
Name
io_new_to_legacy_dsfs()
- maps a agile device special file to one or more legacy device special file
Synopsis
int io_new_to_legacy_dsfs(char *new_dsf, char *legacy_dsf,int *count);
Description
This API retrieves legacy device special file(s) corresponding to a persistent device special file. There can be
one to many mappings.
Arguments
new_dsf A pointer to a persistent device special file to retrieve its legacy device special files.
legacy_arry Possible values are:
INPUT:
A pointer to a buffer to store the returned legacy device special files. The buffer
is allocated by the caller. By default the size of the buffer should be (MAX-
PATHLEN *10)
and the count should be set to 10.
OUTPUT:
The device special files returned will be copied into this array. Each device spe-
cial file is delimited by a semi-colon
count Possible values are:
INPUT:
Number of legacy device special files expected. Initial size should be 10.
OUTPUT:
Number of legacy device special files in the returned array if the array is big
enough. If the array is not big enough:
1) No token will be returned.
2) Count will be set to the real count of device special files to be returned.
3) The API will return IO_ERROR.
4) io_errno will be set to IO_E_BUF_TOO_SMALL
.
In this case, the caller needs to allocate a bigger buffer after recalculating it
(MAXPATHLEN)*count)
with the returned count value. and needs to call the API again with the new
buffer and count values.
Return Value
IO_SUCCESS - Upon success.
IO_ERROR - Otherwise. io_errno is set to indicate the error.
Errors
[IO_E_DCONF_OPEN]
[IO_E_PARM]
[IO_E_DCONF_ACCESS]
[IO_E_SYSCALL]
[IO_BUF_TOO_SMALL]
[IO_E_MEM_ALLOC]
libIO FUNCTION
Name
io_init_hw_path() - initializes the hardware path with the passed flags argument
Synopsis
int io_init_hw_path(hw_path_t *hw_path, int flags);
740 Hewlett-Packard Company − 22 − HP-UX 11i Version 3: February 2007