Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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. 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