netmgr_remote_nd()

Updated: April 19, 2023

Get a node descriptor that's relative to a remote node

Synopsis:

#include <sys/netmgr.h>

int netmgr_remote_nd( int remote_nd, 
                      int local_nd );

Arguments:

remote_nd
The node descriptor of a remote node.
local_nd
A node descriptor, relative to the local node, that you want to convert to be relative to the remote node.

Library:

libc

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

Description:

The netmgr_remote_nd() function converts a node descriptor that's relative to the local node into a node descriptor that's relative to the specified remote node. The function can return -1 in some cases (e.g., if the node represented by remote_nd can't talk to the local node).

Returns:

The node descriptor, relative to the remote node, or -1 if an error occurred (errno is set).

Examples:

See netmgr_ndtostr().

Classification:

QNX Neutrino

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