NAME

dnet_getalias − get extended node information

SYNTAX

char *dnet_getalias (node)

char *node;

ARGUMENTS

Input Arguments

node Character pointer to a node name. 

DESCRIPTION

The dnet_getalias subroutine searches for a .nodes file in your home directory and returns any alias definitions found in that file.  See the DECnet-ULTRIX User’s and Programmer’s Guide for information on alias node names.  The dnet_getalias subroutine returns a node name and any default access control information associated with the node name.

RETURN VALUE

If a node has default access control information associated with it, the node name followed by the access data is returned in the following format:

nodename/username/password/account

See the DECnet-ULTRIX User’s and Programmer’s Guide for definitions of these access control fields. 

If you have a .nodes file in your home directory that defines aliases, any alias definition for the specified node name is returned. 

If a matching alias entry is not found, a null pointer 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. 

SEE ALSO

DECnet-ULTRIX User’s and Programmer’s Guide