iofdinfo()

Retrieve server attributes

Synopsis:

#include <sys/iomgr.h>

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

Library:

libc

Description:

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

The arguments are as follows:

filedes

Connection to be queried.

flags

Specify _FDINFO_FLAG_LOCALPATH to return only the local path info (i.e. exclude the network path info).

info

Structure that contains the connection information defined in <sys/iomgr.h>. Specify NULL if it's not required.

path

Buffer used to store the path associated with the file descriptor. Specify NULL if it's not required.

maxlen

Length of the buffer pointed to path.

Returns:

EOK on success, 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 6

See also:

iofunc_fdinfo(), iofunc_fdinfo_default(), resmgr_pathname()