A/UX® Programmer's Reference Sections

zip(3N) zip(3N)
start
buf
The starting index for the get zone list request. The start
index is the value of the index at which to start including
zone names in the response. It is used to obtain a zone
list that may not fit into one A 1P response packet The
start index should initially be 1. While
zip_get zonelist returns a value greater than 0, the
caller must reissue zip getzonelist calls to get
more zone names from the bridge, specifying a start index
of the previous start index plus the previous return
valueof zip_getzonelist.
A buffer to hold this list of zone names. Each zone
name is an at nvestr t structure. The size of this
buffer (in bytes) must be at least ATP _DATA _ SI ZE.
Upon successful completion, this routine returns the number of
zone names in the list
When all zones in the bridge's Zone Information Table have been
returned, this routine returns O.
The use and behavior of the zip getlocal zones routine are
the same as for zip_getzonelist, except that the former returns
the list of zones on the local EtherTalk cable rather than all
the zones on the internet. On LocalTalk,
zip _getlocal zones returns only the current zone name.
DIAGNOSTICS
All routines return -Ion error, with a detailed error code stored in
errno:
[EINVAL] A parameter is invalid.
[ENE TUNREACH] A bridge node could not °be found to process
the request.
Routines also return any error codes returned by the underlying
A TP or DDP layers.
SEE ALSO
ddp(3N), atp(3N), Inside AppleTalk; "AppleTalk Programming
Guide," inA/UX Network Applications Programming.
WARNINGS
The returned zone strings are not NULL-terminated.
2
February, 1990
RevisionC