t
 Title: nbp_name
 Author: [FIXME: author] [see http://docbook.sf.net/el/author]
 Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
 Date: 12 Jan 1994
 Manual: Netatalk 2.2
 Source: Netatalk 2.2
 Language: English

 "NBP_NAME" "3" "12 Jan 1994" "Netatalk 2.2" "Netatalk 2.2"
 -----------------------------------------------------------------
 * set default formatting
 -----------------------------------------------------------------
 disable hyphenation
 disable justification (adjust text to left margin only)
 -----------------------------------------------------------------
 * MAIN CONTENT STARTS HERE *
 -----------------------------------------------------------------
 "NAME"
nbp_name - NBP name parsing

 "SYNOPSIS"
 \w'int nbp_name('u
 "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.