NAME
nbp_name - NBP name parsing
SYNOPSIS
int nbp_name(char *name, char **obj, char **type, char **zone);
DESCRIPTION
nbp_name() parses user supplied names into their component object,
type, and zone. obj, type, and zone should be passed by reference, and
should point to the caller´s default values. nbp_name() will change
the pointers to the parsed-out values. name is of the form
object:type@zone, where each of object, :type, and @zone replace obj,
type, and zone, respectively. type must be proceeded by ‘:´, and zone
must be preceded by ‘@´.
EXAMPLE
The argument of afpd(8)´s -n option is parsed with nbp_name(). The
default value of obj is the first component of the machine´s hostname
(as returned by gethostbyname(3)). The default value of type is
‘‘AFPServer´´, and of zone is ‘‘*´´, the default zone. To cause afpd to
register itself in some zone other than the default, one would invoke
it as
afpd -n @some-other-zone
obj and type would retain their default values.
BUGS
obj, type, and zone return pointers into static area which may be
over-written on each call.