NAME

       ax25_aton,  ax25_aton_entry,  ax25_aton_arglist, ax25_ntoa, ax25_cmp, ax25_validate - AX25
       Address manipulation routines

SYNOPSIS

       #include <netax25/ax25.h>

       int ax25_aton(const char *cp, struct full_sockaddr_ax25 *fsap);

       int ax25_aton_arglist(const char **cp, struct full_sockaddr_ax25 *fsap);

       int ax25_aton_entry(const char *cp, char *axp);

       char *ax25_ntoa(ax25_address *axp);

       int ax25_cmp(ax25_address *ax1, ax25_address *ax2);

       int ax25_validate(char *axp);

       char *ax25_config_file(const char *filename);

DESCRIPTION

       ax25_aton() takes the ASCII string cp that is in the format callsign  [[V|VIA]callsign...]
       and stores it in fsap in network format.

       ax25_aton_entry()  takes the ASCII string of a callsign cp and stores it in network format
       in axp.

       The ax25_aton_arglist() takes a NULL terminated array of strings cp and stores it in  fsap
       in network format.

       The  ax25_ntoa()  takes a network format address axp and returns the ASCII representation.
       The string is returned in a statically  allocated  buffer,  which  subsequent  calls  will
       overwrite.

       The  ax25_cmp() function compares the two ax25 addresses, ax1 and ax2, that are in network
       format and determines whether they are identical,  differ  only  by  their  SSIDs  or  are
       different.

       The  ax25_validate()  function  checks  to  see  if the address axp in network format is a
       correctly formatted address.

RETURN VALUE

       The ax25_aton()and ax25_aton_arglist() functions return -1 if an  error  occurs  otherwise
       the length of the returned structure.

       The ax25_aton_entry() function returns -1 if an error occurs otherwise zero.

       The  ax25_cmp()  function  returns  0  if  the  two addresses are identical, 1 if they are
       different or 2 is only the SSIDs are different.

       The ax25_validate() function returns TRUE if the callsign is valid or FALSE if it is not.

SEE ALSO

       ax25(4), netrom(4), rose(4)