NAME

dnet_htoa − return ASCII node name or node address

SYNTAX

#include <netdnet/dn.h>

char *dnet_htoa (add)

struct dn_naddr *add;

ARGUMENTS

Input Argument

add Specifies a pointer to a structure of the type dn_naddr, which contains the node address.

Return Argument

dn_naddr
Specifies the node address structure. The following fields are filled in by this subroutine:

a_len Specifies the length of the returned node address. 

a_add Specifies the node address. 

DESCRIPTION

The dnet_htoa subroutine searches the node database for a node by address. If the node name is found, the ASCII node name string is returned. If the node name is not found, the 16-bit binary node address is converted to the ASCII string representation (area.number). 

RETURN VALUE

If the node name is found, the ASCII node name string is returned.  Otherwise, the ASCII node address string is returned. 

RESTRICTIONS

If you plan to call this function again before you finish using the data, you must copy the data into a local structure.