libIO.3x (2010 09)

l
libIO(3X) libIO(3X)
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
using:
(sizeof (dev_t)*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_E_BUF_TOO_SMALL]
[IO_E_MEM_ALLOC]
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
(MAXPATHLEN *10) and the count should be set to 10.
OUTPUT:
The device special files returned will be copied into this array. Each device
special 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)
22 Hewlett-Packard Company − 22 − HP-UX 11i Version 3: September 2010