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

See also:

iofunc_fdinfo(), iofunc_fdinfo_default(), resmgr_pathname()