iofdinfo()

Retrieve server attributes

Synopsis:

#include <sys/iomgr.h>

int iofdinfo( int filedes,
              unsigned flags, 
              struct _fdinfo * info, 
              char * path, 
              int maxlen );

Arguments:

filedes: A file descriptor for the connection that you want to query.
flags: Specify _FDINFO_FLAG_LOCALPATH to return only the local path info (i.e. exclude the network path info).
info: NULL, or a pointer to an _fdinfo structure that contains the connection information defined in <sys/iomgr.h>. Specify NULL if it's not required.
path: A pointer to a buffer where the function can store the path associated with the file descriptor. Specify NULL if it's not required.
maxlen: The length of the buffer pointed to path.

Library:

libc

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

Description:

The iofdinfo() function retrieves the server's attribute information for the connection referred to by filedes.

Returns:

The length of the associated filedes pathname, or -1 if an error occurs (errno is set).

Errors:

EFAULT: A fault occurred in a server's address space when it tried to access the caller's message buffers.
EMSGSIZE: Insufficient space available in the server's buffer for the fdinfo data structure.

Classification:

QNX Neutrino

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