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