HP-UX Reference (11i v2 03/08) - 3 Library Functions N-Z (vol 7)

n
nis_tables(3N) nis_tables(3N)
dticks
The time spent in the database backend, this time is measured from the time a database call starts,
until a result is returned. If the request results in multiple calls to the database, this is the sum of
all the time spent in those calls.
aticks
The time spent in any ‘‘accelerators’’ or caches. This includes the time required to locate the server
needed to resolve the request.
cticks
The total time spent in the request, this clock starts when you enter the client library and stops
when a result is returned. By subtracting the sum of the other ticks values from this value you can
obtain the local overhead of generating a NIS+ request.
Subtracting the value in dticks from the value in zticks will yield the time spent in the service code itself.
Subtracting the sum of the values in zticks and aticks from the value in cticks will yield the time spent in
the client library itself. Note: all of the tick times are measured in microseconds.
ERRORS
The client library can return a variety of error returns and diagnostics. The more salient ones are docu-
mented below.
NIS_BADATTRIBUTE
The name of an attribute did not match up with a named column in the table, or the
attribute did not have an associated value.
NIS_BADNAME The name passed to the function is not a legal NIS+ name.
NIS_BADREQUEST A problem was detected in the request structure passed to the client library.
NIS_CACHEEXPIRED
The entry returned came from an object cache that has expired. This means that
the time to live value has gone to zero and the entry may have changed. If the flag
NO_CACHE was passed to the lookup function then the lookup function will retry
the operation to get an unexpired copy of the object.
NIS_CBERROR An RPC error occurred on the server while it was calling back to the client. The
transaction was aborted at that time and any unsent data was discarded.
NIS_CBRESULTS Even though the request was successful, all of the entries have been sent to your
callback function and are thus not included in this result.
NIS_FOREIGNNS The name could not be completely resolved. When the name passed to the function
would resolve in a namespace that is outside the NIS+ name tree, this error is
returned with a NIS+ object of type DIRECTORY. The returned object contains the
type of namespace and contact information for a server within that namespace.
NIS_INVALIDOBJ The object pointed to by object is not a valid NIS+ entry object for the given table.
This could occur if it had a mismatched number of columns, or a different data type
(for example, binary or text) than the associated column in the table.
NIS_LINKNAMEERROR
The name passed resolved to a LINK type object and the contents of the object
pointed to an invalid name.
NIS_MODFAIL The attempted modification failed for some reason.
NIS_NAMEEXISTS An attempt was made to add a name that already exists. To add the name, first
remove the existing name and then add the new name or modify the existing named
object.
NIS_NAMEUNREACHABLE
This soft error indicates that a server for the desired directory of the named table
object could not be reached. This can occur when there is a network partition or the
server has crashed. Attempting the operation again may succeed. See the
HARD_LOOKUP flag.
NIS_NOCALLBACK The server was unable to contact the callback service on your machine. This results
in no data being returned.
Section 3−−666 Hewlett-Packard Company − 4 − HP-UX 11i Version 2: August 2003