netmgr_strtond()

Convert a string into a node descriptor

Synopsis:

#include <sys/netmgr.h>

int netmgr_strtond( const char * nodename, 
                    char ** endstr );

Arguments:

nodename
The string that you want to convert into a node descriptor.
endstr
NULL, or the address of a location where the function can store a pointer to the character after the node name in the string.

Library:

libc

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

Description:

The netmgr_strtond() function converts a string to a node descriptor. This function accepts all three forms of node name: simple, directory, and FQNN (Fully Qualified NodeName). A FQNN identifies a QNX Neutrino node using a unique name on a network, and consists of the nodename and the node domain.

If endstr isn't NULL, it's set to point to the character after the node name in the given string.

Returns:

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

Errors:

ENOTSUP
Qnet isn't running.

Examples:

See netmgr_ndtostr().

Classification:

QNX Neutrino

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

See also:

ND_NODE_CMP(), netmgr_ndtostr(), netmgr_remote_nd()

Qnet Networking chapter of the Neutrino Programmer's Guide

Qnet Networking chapter of the System Architecture guide

Message Passing chapter of Getting Started with QNX Neutrino