nwerrors - list of error codes returned by libncp calls
SYNOPSIS
#include <nwcalls.h>
NWE_*
#include <nwnet.h>
ERR_*
DESCRIPTION
This is list of codes returned by functions in libncp.
Error codes are split into several groups:
OK
When zero is returned, call was processed without prob
lems.
libc errors
These values are same as errno values and they are
listed in errno(3). Return value is libc error if it is
in range 1-511.
RPC errors (obsolete)
These error codes are returned only by NWSM* group of
functions. They are in range 512-524.
libncp specific errors
These error codes are in range 0x8700-0x87FF and are
used for reporting non-standard problems in libncp.
requester errors
These error codes are in range 0x8800-0x88FF and are
used for reporting standard problems in libncp.
server errors
These error codes in range 0x8900-0x89FF are error
codes returned by server when calling NCP functions.
NDS errors
Error codes in range -1000 ... -256 are returned by NDS
server system (-600 ... -799), by local NDS system
(-300 ... -399) and by other subsystems (other).
reserved errors
Range -255 ... -1 is reserved. If some function returns
this value, it is bug (this is probably forgotten libc
return value (-1) or negative errno value)). Other
ranges, not mentioned in this document, are reserved
for future expansion.
0x8701 NCPLIB_INVALID_MODE
~/.nwclient file has not mode 0600 or 0400 or
~/.nwclient file is readable or writeable by group
or world
REQUESTER ERRORS
0x880E NWE_BUFFER_OVERFLOW
Requested information is larger than supplied
buffer.
0x880F NWE_SERVER_NO_CONN
You have no connection to server (at this time, if
~/.nwclient is empty, this error is returned).
0x8816 NWE_INVALID_NCP_PACKET_LENGTH
Reply returned by server fails in some consistency
check (reply is shorter than expected).
0x8834 NWE_USER_NO_NAME
User name not specified (returned by
ncp_find_conn_spec if user name was not found).
0x8836 NWE_PARAM_INVALID
Invalid parameter (NULL, out of range...) was
passed into some function.
0x8847 NWE_SERVER_NOT_FOUND
Specified server was not found (see also
0x89FC:NWE_SERVER_UNKNOWN). This error is
returned, if ANY server was not found on the net
work (no response from SAP resolver).
0x8861 NWE_SIGNATURE_LEVEL_CONFLICT
Requested signature level is not compatible with
server setting.
0x8870 NWE_INVALID_LEVEL
Unknown information type was requested from NWC
CGetConnInfo.
0x88FF NWE_REQUESTER_FAILURE
Unspecified libncp error, ncp unavailable and so
on.
0x89D3 NWE_Q_NO_RIGHTS
You have not rights to specified (print) queue.
0x89DF NWE_PASSWORD_EXPIRED
Your password has expired, this login was `grace'
login.
0x89E9 NWE_BIND_MEMBER_ALREADY_EXISTS
Object is already in set.
0x89FB NWE_NCP_NOT_SUPPORTED
Attempted function is not available on this version
of NetWare.
0x89FC NWE_SERVER_UNKNOWN
Server was not found.
0x89FD NWE_CONN_NUM_INVALID
Operation attempted on invalid connection
(NWClearConnection(3ncp), NWGetConnInfo(3ncp), ...)
or your own connection timed out (nds4linux).
0x89FF NWE_SERVER_FAILURE
Unspecified server error (bad parameters passed,
LinWare/Mars/Windows on other end of wire, bad
password, ...).
NDS/UNICODE ERRORS
-301 ERR_NOT_ENOUGH_MEMORY
Not enough memory (see also errno(3):ENOMEM).
-302 ERR_BAD_KEY
Invalid key value DCK_* passed to NWDSGetContext or
NWDSSetContext.
-303 ERR_BAD_CONTEXT
Invalid NWDSContextHandle was passed to some of
NWDS* functions.
-304 ERR_BUFFER_FULL
Information is larger than passed buffer.
Requested information does not exist in buffer. It
can be programmer's error or unexpected reply from
server.
-308 ERR_BAD_VERB
Operation attempted with buffer prepared for some
thing else or buffer cannot contain requested
information.
-309 ERR_EXPECTED_IDENTIFIER
Object name fails on some check (multiple dots, two
equals or plus signs, backslash at the end of
name...)
-311 ERR_ATTR_TYPE_EXPECTED
If object has multiple naming attributes, you must
specify all with or without types, you must not mix
it.
-312 ERR_ATTR_TYPE_NOT_EXPECTED
If object has multiple naming attributes, you must
specify all without or with types, you must not mix
it.
-314 ERR_INVALID_OBJECT_NAME
Something is wrong with object name (odd length
returned by server, string returned from server is
not zero terminated, object name is absolute, but
has dot(s) at the end (.object.tree.)).
-315 ERR_EXPECTED_RDN_DELIMITER
Something is wrong with object name (multiple equal
signs without intervening dot or plus sign).
-316 ERR_TOO_MANY_TOKENS
Something is wrong with object name (there is more
dots at the end of object name than levels in cur
rent context name).
-317 ERR_INCONSISTENT_MULTIAVA
You are trying to apply default naming rule on
typeless name with multiple naming attributes.
Country name must not exceed two characters.
-319 ERR_SYSTEM_ERROR
Something went wrong.
-322 ERR_INVALID_HANDLE
Application passed invalid iteration handle to one
of NWDS* functions. It is bug in application.
-323 ERR_BUFFER_ZERO_LENGTH
Application passed empty request buffer to one of
NWDS* functions. It is bug in application.
-328 ERR_CONTEXT_CREATION
An error occured in NWDSCreateContext. You should
use NWDSCreateContextHandle, which has better error
reporting.
-330 ERR_INVALID_SERVER_RESPONSE
Unexpected reply was returned from server.
-331 ERR_NULL_POINTER
NULL pointer was passed to some function. Only
(some) output parameters can be NULL.
-333 ERR_NO_CONNECTION
You have not any connection for this context han
dle. At this moment (2.2.0.17), call NWDSAddConnec
tion(NWDSContextHandle, NWCONN_HANDLE).
-335 ERR_DUPLICATE_TYPE
If object has multiple naming attributes, they must
not have same name.
-337 ERR_NOT_LOGGED_IN
You are trying to authenticate connection before
you logged in. You must first do NWDSLogin before
call to NWDSAuthenticate.
-338 ERR_INVALID_PASSWORD_CHARS
Invalid characters in password.
Transport not supported / referral addresses does
not include any supported protocol.
-341 ERR_NO_SUCH_SYNTAX
Invalid Syntax ID was passed to NWDSGet/NWD
SPut/NWDSCompute function.
-342 ERR_INVALID_DS_NAME
Multiple dots or some other problem (currently only
in RemoveAllTypes).
-348 ERR_UNICODE_FILE_NOT_FOUND
Tables required for local<->unicode translation
were not found (system defaults to ISO_8859-1).
-353 ERR_DN_TOO_LONG
Object name is too long.
-354 ERR_RENAME_NOT_ALLOWED
NWDSMoveObject cannot be used to rename object. Use
either NWDSModifyRDN or NWDSModifyDN function
calls.
-601 ERR_NO_SUCH_ENTRY
Specified object does not exist.
-641 ERR_INVALID_REQUEST
Server did not understand your request. Either your
program did not fill up request buffer properly or
server DS is too old.
-656 ERR_CRUCIAL_REPLICA
Replica cannot be removed (or type cannot be
changed) because of it is last master replica of an
partition.
-659 ERR_TIME_NOT_SYNCHRONIZED
Server time is not synchronized with rest of tree.
-669 ERR_FAILED_AUTHENTICATION
Invalid password or authentication time window
exceeded.
Server does not support this API version - it is
too old. One of examples is NWDSAddObject if
server does not support fragmented DSV_ENTRY_ADD,
but you asked for it. Another example is NWDSList
PartitionsExtInfo.
-700 ERR_OBSOLETE_API
Server does not support this API version - this API
call is no longer supported. One of examples is
NWDSRemovePartition if server runs NDS8.
BUGS
This manual page is incomplete and some error descriptions
are confusing.
SEE ALSO
NWCallsInit(3ncp), NWCallsTerm(3ncp)
Man(1) output converted with
man2html