339 lines
8.9 KiB
Plaintext
339 lines
8.9 KiB
Plaintext
.TH nwerrors 3NCP 04/13/1999 "libncp (>= 2.2.0.14)" "Netware Calls Library"
|
|
.SH NAME
|
|
nwerrors \- list of error codes returned by libncp calls
|
|
.SH SYNOPSIS
|
|
.B #include <nwcalls.h>
|
|
|
|
.B "NWE_*"
|
|
|
|
|
|
.B #include <nwnet.h>
|
|
|
|
.B "ERR_*"
|
|
|
|
.SH DESCRIPTION
|
|
This is list of codes returned by functions in \fBlibncp\fP. Error codes
|
|
are split into several groups:
|
|
|
|
.B OK
|
|
.RS 3
|
|
When \fIzero\fP is returned, call was processed without problems.
|
|
.RE
|
|
|
|
.B libc errors
|
|
.RS 3
|
|
These values are same as \fIerrno\fP values and they are listed in
|
|
\fIerrno\fP(3). Return value is \fBlibc error\fP if it is in range
|
|
\fI1\-511\fP.
|
|
.RE
|
|
|
|
.B RPC errors (obsolete)
|
|
.RS 3
|
|
These error codes are returned only by \fINWSM*\fP group of functions.
|
|
They are in range \fI512\-524\fP.
|
|
.RE
|
|
|
|
.B libncp specific errors
|
|
.RS 3
|
|
These error codes are in range \fI0x8700\-0x87FF\fP and are used
|
|
for reporting non-standard problems in \fBlibncp\fP.
|
|
.RE
|
|
|
|
.B requester errors
|
|
.RS 3
|
|
These error codes are in range \fI0x8800\-0x88FF\fP and are used
|
|
for reporting standard problems in \fBlibncp\fP.
|
|
.RE
|
|
|
|
.B server errors
|
|
.RS 3
|
|
These error codes in range \fI0x8900\-0x89FF\fP are error codes
|
|
returned by server when calling \fBNCP\fP functions.
|
|
.RE
|
|
|
|
.B NDS errors
|
|
.RS 3
|
|
Error codes in range \fI\-1000 ... \-256\fP are returned by NDS server
|
|
system (\fI\-600 ... -799\fP), by local NDS system (\fI\-300 ... -399\fP)
|
|
and by other subsystems (\fIother\fP).
|
|
.RE
|
|
|
|
.B reserved errors
|
|
.RS 3
|
|
Range \fI\-255 ... \-1\fP is reserved. If some function returns this value,
|
|
it is bug (this is probably forgotten \fBlibc\fP return value (\fI\-1\fP)
|
|
or negative \fIerrno\fP value)). Other ranges, not mentioned in this document,
|
|
are reserved for future expansion.
|
|
.RE
|
|
|
|
.SH "LIBNCP SPECIFIC ERRORS"
|
|
|
|
.TP
|
|
.IB "0x8701 " NCPLIB_INVALID_MODE
|
|
~/.nwclient file has not mode 0600 or 0400 \fIor\fP
|
|
.br
|
|
~/.nwclient file is readable or writeable by group or world
|
|
|
|
.SH "REQUESTER ERRORS"
|
|
|
|
.TP
|
|
.IB "0x880E " NWE_BUFFER_OVERFLOW
|
|
Requested information is larger than supplied buffer.
|
|
|
|
.TP
|
|
.IB "0x880F " NWE_SERVER_NO_CONN
|
|
You have no connection to server (at this time, if ~/.nwclient is empty,
|
|
this error is returned).
|
|
|
|
.TP
|
|
.IB "0x8816 " NWE_INVALID_NCP_PACKET_LENGTH
|
|
Reply returned by server fails in some consistency check (reply is shorter
|
|
than expected).
|
|
|
|
.TP
|
|
.IB "0x8834 " NWE_USER_NO_NAME
|
|
User name not specified (returned by ncp_find_conn_spec if user name was
|
|
not found).
|
|
|
|
.TP
|
|
.IB "0x8836 " NWE_PARAM_INVALID
|
|
Invalid parameter (\fINULL\fP, out of range...) was passed into some
|
|
function.
|
|
|
|
.TP
|
|
.IB "0x8847 " NWE_SERVER_NOT_FOUND
|
|
Specified server was not found (see also \fI0x89FC\fP:\fBNWE_SERVER_UNKNOWN\fP).
|
|
This error is returned, if ANY server was not found on the network
|
|
(no response from SAP resolver).
|
|
|
|
.TP
|
|
.IB "0x8861 " NWE_SIGNATURE_LEVEL_CONFLICT
|
|
Requested signature level is not compatible with server setting.
|
|
|
|
.TP
|
|
.IB "0x8870 " NWE_INVALID_LEVEL
|
|
Unknown information type was requested from \fBNWCCGetConnInfo\fP.
|
|
|
|
.TP
|
|
.IB "0x88FF " NWE_REQUESTER_FAILURE
|
|
Unspecified \fBlibncp\fP error, \fBncp\fP unavailable and so on.
|
|
|
|
.SH "SERVER ERRORS"
|
|
|
|
.TP
|
|
.IB "0x89D3 " NWE_Q_NO_RIGHTS
|
|
You have not rights to specified (print) queue.
|
|
|
|
.TP
|
|
.IB "0x89DF " NWE_PASSWORD_EXPIRED
|
|
Your password has expired, this login was `grace' login.
|
|
|
|
.TP
|
|
.IB "0x89E9 " NWE_BIND_MEMBER_ALREADY_EXISTS
|
|
Object is already in set.
|
|
|
|
.TP
|
|
.IB "0x89FB " NWE_NCP_NOT_SUPPORTED
|
|
Attempted function is not available on this version of NetWare.
|
|
|
|
.TP
|
|
.IB "0x89FC " NWE_SERVER_UNKNOWN
|
|
Server was not found.
|
|
|
|
.TP
|
|
.IB "0x89FD " NWE_CONN_NUM_INVALID
|
|
Operation attempted on invalid connection (\fBNWClearConnection\fP(3ncp),
|
|
\fBNWGetConnInfo\fP(3ncp), ...) or your own connection timed out
|
|
(\fBnds4linux\fP).
|
|
|
|
.TP
|
|
.IB "0x89FF " NWE_SERVER_FAILURE
|
|
Unspecified server error (bad parameters passed, LinWare/Mars/Windows on
|
|
other end of wire, bad password, ...).
|
|
|
|
.SH "NDS/UNICODE ERRORS"
|
|
|
|
.TP
|
|
.IB "\-301 " ERR_NOT_ENOUGH_MEMORY
|
|
Not enough memory (see also \fBerrno\fP(3):\fIENOMEM\fP).
|
|
|
|
.TP
|
|
.IB "\-302 " ERR_BAD_KEY
|
|
Invalid key value DCK_* passed to \fBNWDSGetContext\fP or \fBNWDSSetContext\fP.
|
|
|
|
.TP
|
|
.IB "\-303 " ERR_BAD_CONTEXT
|
|
Invalid \fBNWDSContextHandle\fP was passed to some of \fBNWDS*\fP functions.
|
|
|
|
.TP
|
|
.IB "\-304 " ERR_BUFFER_FULL
|
|
Information is larger than passed buffer.
|
|
|
|
.TP
|
|
.IB "\-307 " ERR_BUFFER_EMPTY
|
|
Requested information does not exist in buffer. It can be programmer's error
|
|
or unexpected reply from server.
|
|
|
|
.TP
|
|
.IB "\-308 " ERR_BAD_VERB
|
|
Operation attempted with buffer prepared for something else or buffer cannot
|
|
contain requested information.
|
|
|
|
.TP
|
|
.IB "\-309 " ERR_EXPECTED_IDENTIFIER
|
|
Object name fails on some check (multiple dots, two equals or plus signs,
|
|
backslash at the end of name...)
|
|
|
|
.TP
|
|
.IB "\-311 " ERR_ATTR_TYPE_EXPECTED
|
|
If object has multiple naming attributes, you must specify all with or
|
|
without types, you must not mix it.
|
|
|
|
.TP
|
|
.IB "\-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.
|
|
|
|
.TP
|
|
.IB "\-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 (\fI.object.tree.\fP)).
|
|
|
|
.TP
|
|
.IB "\-315 " ERR_EXPECTED_RDN_DELIMITER
|
|
Something is wrong with object name (multiple equal signs without intervening
|
|
dot or plus sign).
|
|
|
|
.TP
|
|
.IB "\-316 " ERR_TOO_MANY_TOKENS
|
|
Something is wrong with object name (there is more dots at the end of object
|
|
name than levels in current context name).
|
|
|
|
.TP
|
|
.IB "\-317 " ERR_INCONSISTENT_MULTIAVA
|
|
You are trying to apply default naming rule on typeless name with multiple
|
|
naming attributes.
|
|
|
|
.TP
|
|
.IB "\-318 " ERR_COUNTRY_NAME_TOO_LONG
|
|
Country name must not exceed two characters.
|
|
|
|
.TP
|
|
.IB "\-319 " ERR_SYSTEM_ERROR
|
|
Something went wrong.
|
|
|
|
.TP
|
|
.IB "\-322 " ERR_INVALID_HANDLE
|
|
Application passed invalid iteration handle to one of NWDS* functions.
|
|
It is bug in application.
|
|
|
|
.TP
|
|
.IB "\-323 " ERR_BUFFER_ZERO_LENGTH
|
|
Application passed empty request buffer to one of NWDS* functions. It is
|
|
bug in application.
|
|
|
|
.TP
|
|
.IB "\-328 " ERR_CONTEXT_CREATION
|
|
An error occured in \fBNWDSCreateContext\fP. You should use
|
|
\fBNWDSCreateContextHandle\fP, which has better error reporting.
|
|
|
|
.TP
|
|
.IB "\-330 " ERR_INVALID_SERVER_RESPONSE
|
|
Unexpected reply was returned from server.
|
|
|
|
.TP
|
|
.IB "\-331 " ERR_NULL_POINTER
|
|
NULL pointer was passed to some function. Only (some) output parameters can
|
|
be NULL.
|
|
|
|
.TP
|
|
.IB "\-333 " ERR_NO_CONNECTION
|
|
You have not any connection for this context handle. At this moment (2.2.0.17),
|
|
call NWDSAddConnection(NWDSContextHandle, NWCONN_HANDLE).
|
|
|
|
.TP
|
|
.IB "\-335 " ERR_DUPLICATE_TYPE
|
|
If object has multiple naming attributes, they must not have same name.
|
|
|
|
.TP
|
|
.IB "\-337 " ERR_NOT_LOGGED_IN
|
|
You are trying to authenticate connection before you logged in. You must
|
|
first do \fBNWDSLogin\fP before call to \fBNWDSAuthenticate\fP.
|
|
|
|
.TP
|
|
.IB "\-338 " ERR_INVALID_PASSWORD_CHARS
|
|
Invalid characters in password.
|
|
|
|
.TP
|
|
.IB "\-340 " ERR_TRANSPORT
|
|
Transport not supported / referral addresses does not include any supported
|
|
protocol.
|
|
|
|
.TP
|
|
.IB "\-341 " ERR_NO_SUCH_SYNTAX
|
|
Invalid Syntax ID was passed to NWDSGet/NWDSPut/NWDSCompute function.
|
|
|
|
.TP
|
|
.IB "\-342 " ERR_INVALID_DS_NAME
|
|
Multiple dots or some other problem (currently only in \fBRemoveAllTypes\fP).
|
|
|
|
.TP
|
|
.IB "\-348 " ERR_UNICODE_FILE_NOT_FOUND
|
|
Tables required for local<->unicode translation were not found (system
|
|
defaults to \fIISO_8859-1\fP).
|
|
|
|
.TP
|
|
.IB "\-353 " ERR_DN_TOO_LONG
|
|
Object name is too long.
|
|
|
|
.TP
|
|
.IB "\-354 " ERR_RENAME_NOT_ALLOWED
|
|
\fBNWDSMoveObject\fP cannot be used to rename object. Use either \fBNWDSModifyRDN\fP
|
|
or \fBNWDSModifyDN\fP function calls.
|
|
|
|
.TP
|
|
.IB "\-601 " ERR_NO_SUCH_ENTRY
|
|
Specified object does not exist.
|
|
|
|
.TP
|
|
.IB "\-603 " ERR_NO_SUCH_ATTRIBUTE
|
|
None of requested attributes exists.
|
|
|
|
.TP
|
|
.IB "\-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.
|
|
|
|
.TP
|
|
.IB "\-656 " ERR_CRUCIAL_REPLICA
|
|
Replica cannot be removed (or type cannot be changed) because of it is last master
|
|
replica of an partition.
|
|
|
|
.TP
|
|
.IB "\-659 " ERR_TIME_NOT_SYNCHRONIZED
|
|
Server time is not synchronized with rest of tree.
|
|
|
|
.TP
|
|
.IB "\-669 " ERR_FAILED_AUTHENTICATION
|
|
Invalid password or authentication time window exceeded.
|
|
|
|
.TP
|
|
.IB "\-683 " ERR_INVALID_API_VERSION
|
|
Server does not support this API version - it is too old.
|
|
One of examples is \fBNWDSAddObject\fP if server does
|
|
not support fragmented \fBDSV_ENTRY_ADD\fP, but you asked for it.
|
|
Another example is \fBNWDSListPartitionsExtInfo\fP.
|
|
|
|
.TP
|
|
.IB "\-700 " ERR_OBSOLETE_API
|
|
Server does not support this API version - this API call is no
|
|
longer supported. One of examples is \fBNWDSRemovePartition\fP if
|
|
server runs NDS8.
|
|
|
|
.SH BUGS
|
|
This manual page is incomplete and some error descriptions are confusing.
|
|
|
|
.SH SEE ALSO
|
|
.BR "NWCallsInit" (3ncp), " NWCallsTerm"(3ncp)
|