iofunc_readlink()

Verify the attributes being used to read a link

Synopsis:

#include <sys/iofunc.h>

int iofunc_readlink( resmgr_context_t *ctp,
                     io_readlink_t *msg,
                     iofunc_attr_t *attr,
                     struct _client_info *info );

Arguments:

ctp
A pointer to a resmgr_context_t structure that the resource-manager library uses to pass context information between functions.
msg
A pointer to the io_readlink_t structure that contains the message that the resource manager received.
attr
A pointer to the iofunc_attr_t structure that describes the characteristics of the device that's associated with your resource manager.
info
A pointer to a _client_info structure that contains the information about a client connection. For information about this structure, see ConnectClientInfo().

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The iofunc_readlink() helper function supports readlink() requests by verifying that attr isn't NULL, and that it refers to a symbolic link.

Returns:

EBADFSYS
The attr argument is NULL.
EINVAL
The iofunc_attr_t structure doesn't refer to a symbolic link.
EOK
Successful completion.

Classification:

QNX Neutrino

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

_io_connect, _io_connect_link_reply, _io_connect_ftype_reply, iofunc_open(), readlink()

Writing a Resource Manager

Resource Managers chapter of Getting Started with QNX Neutrino