1nwerrors(3NCP)               Netware Calls Library              nwerrors(3NCP)
2
3
4

NAME

6       nwerrors - list of error codes returned by libncp calls
7

SYNOPSIS

9       #include <nwcalls.h>
10
11       NWE_*
12
13
14       #include <nwnet.h>
15
16       ERR_*
17
18

DESCRIPTION

20       This  is list of codes returned by functions in libncp. Error codes are
21       split into several groups:
22
23       OK
24          When zero is returned, call was processed without problems.
25
26       libc errors
27          These values are same  as  errno  values  and  they  are  listed  in
28          errno(3). Return value is libc error if it is in range 1-511.
29
30       RPC errors (obsolete)
31          These  error  codes  are  returned only by NWSM* group of functions.
32          They are in range 512-524.
33
34       libncp specific errors
35          These error codes are  in  range  0x8700-0x87FF  and  are  used  for
36          reporting non-standard problems in libncp.
37
38       requester errors
39          These  error  codes  are  in  range  0x8800-0x88FF  and are used for
40          reporting standard problems in libncp.
41
42       server errors
43          These error codes in range 0x8900-0x89FF are error codes returned by
44          server when calling NCP functions.
45
46       NDS errors
47          Error  codes in range -1000 ... -256 are returned by NDS server sys‐
48          tem (-600 ... -799), by local NDS system  (-300  ...  -399)  and  by
49          other subsystems (other).
50
51       reserved errors
52          Range  -255 ... -1 is reserved. If some function returns this value,
53          it is bug (this is probably forgotten libc return value (-1) or neg‐
54          ative  errno  value)). Other ranges, not mentioned in this document,
55          are reserved for future expansion.
56
57

LIBNCP SPECIFIC ERRORS

59       0x8701   NCPLIB_INVALID_MODE
60              ~/.nwclient file has not mode 0600 or 0400 or
61              ~/.nwclient file is readable or writeable by group or world
62
63

REQUESTER ERRORS

65       0x880E   NWE_BUFFER_OVERFLOW
66              Requested information is larger than supplied buffer.
67
68
69       0x880F   NWE_SERVER_NO_CONN
70              You have no connection to server (at this time,  if  ~/.nwclient
71              is empty, this error is returned).
72
73
74       0x8816   NWE_INVALID_NCP_PACKET_LENGTH
75              Reply  returned by server fails in some consistency check (reply
76              is shorter than expected).
77
78
79       0x8834   NWE_USER_NO_NAME
80              User name not specified (returned by ncp_find_conn_spec if  user
81              name was not found).
82
83
84       0x8836   NWE_PARAM_INVALID
85              Invalid  parameter  (NULL, out of range...) was passed into some
86              function.
87
88
89       0x8847   NWE_SERVER_NOT_FOUND
90              Specified     server     was     not     found     (see     also
91              0x89FC:NWE_SERVER_UNKNOWN).   This  error  is  returned,  if ANY
92              server was not found  on  the  network  (no  response  from  SAP
93              resolver).
94
95
96       0x8861   NWE_SIGNATURE_LEVEL_CONFLICT
97              Requested signature level is not compatible with server setting.
98
99
100       0x8870   NWE_INVALID_LEVEL
101              Unknown information type was requested from NWCCGetConnInfo.
102
103
104       0x88FF   NWE_REQUESTER_FAILURE
105              Unspecified libncp error, ncp unavailable and so on.
106
107

SERVER ERRORS

109       0x89D3   NWE_Q_NO_RIGHTS
110              You have not rights to specified (print) queue.
111
112
113       0x89DF   NWE_PASSWORD_EXPIRED
114              Your password has expired, this login was `grace' login.
115
116
117       0x89E9   NWE_BIND_MEMBER_ALREADY_EXISTS
118              Object is already in set.
119
120
121       0x89FB   NWE_NCP_NOT_SUPPORTED
122              Attempted function is not available on this version of NetWare.
123
124
125       0x89FC   NWE_SERVER_UNKNOWN
126              Server was not found.
127
128
129       0x89FD   NWE_CONN_NUM_INVALID
130              Operation   attempted   on  invalid  connection  (NWClearConnec‐
131              tion(3ncp), NWGetConnInfo(3ncp), ...)  or  your  own  connection
132              timed out (nds4linux).
133
134
135       0x89FF   NWE_SERVER_FAILURE
136              Unspecified   server   error   (bad   parameters   passed,  Lin‐
137              Ware/Mars/Windows on other end of wire, bad password, ...).
138
139

NDS/UNICODE ERRORS

141       -301     ERR_NOT_ENOUGH_MEMORY
142              Not enough memory (see also errno(3):ENOMEM).
143
144
145       -302     ERR_BAD_KEY
146              Invalid key value DCK_* passed to NWDSGetContext or  NWDSSetCon‐
147              text.
148
149
150       -303     ERR_BAD_CONTEXT
151              Invalid NWDSContextHandle was passed to some of NWDS* functions.
152
153
154       -304     ERR_BUFFER_FULL
155              Information is larger than passed buffer.
156
157
158       -307     ERR_BUFFER_EMPTY
159              Requested  information  does not exist in buffer. It can be pro‐
160              grammer's error or unexpected reply from server.
161
162
163       -308     ERR_BAD_VERB
164              Operation attempted with buffer prepared for something  else  or
165              buffer cannot contain requested information.
166
167
168       -309     ERR_EXPECTED_IDENTIFIER
169              Object  name  fails  on some check (multiple dots, two equals or
170              plus signs, backslash at the end of name...)
171
172
173       -311     ERR_ATTR_TYPE_EXPECTED
174              If object has multiple naming attributes, you must  specify  all
175              with or without types, you must not mix it.
176
177
178       -312     ERR_ATTR_TYPE_NOT_EXPECTED
179              If  object  has multiple naming attributes, you must specify all
180              without or with types, you must not mix it.
181
182
183       -314     ERR_INVALID_OBJECT_NAME
184              Something is wrong with object  name  (odd  length  returned  by
185              server,  string  returned  from  server  is not zero terminated,
186              object  name  is  absolute,  but   has   dot(s)   at   the   end
187              (.object.tree.)).
188
189
190       -315     ERR_EXPECTED_RDN_DELIMITER
191              Something  is wrong with object name (multiple equal signs with‐
192              out intervening dot or plus sign).
193
194
195       -316     ERR_TOO_MANY_TOKENS
196              Something is wrong with object name (there is more dots  at  the
197              end of object name than levels in current context name).
198
199
200       -317     ERR_INCONSISTENT_MULTIAVA
201              You  are  trying  to  apply default naming rule on typeless name
202              with multiple naming attributes.
203
204
205       -318     ERR_COUNTRY_NAME_TOO_LONG
206              Country name must not exceed two characters.
207
208
209       -319     ERR_SYSTEM_ERROR
210              Something went wrong.
211
212
213       -322     ERR_INVALID_HANDLE
214              Application passed invalid iteration  handle  to  one  of  NWDS*
215              functions.  It is bug in application.
216
217
218       -323     ERR_BUFFER_ZERO_LENGTH
219              Application  passed  empty  request buffer to one of NWDS* func‐
220              tions. It is bug in application.
221
222
223       -328     ERR_CONTEXT_CREATION
224              An error occured in NWDSCreateContext. You should  use  NWDSCre‐
225              ateContextHandle, which has better error reporting.
226
227
228       -330     ERR_INVALID_SERVER_RESPONSE
229              Unexpected reply was returned from server.
230
231
232       -331     ERR_NULL_POINTER
233              NULL  pointer  was  passed  to some function. Only (some) output
234              parameters can be NULL.
235
236
237       -333     ERR_NO_CONNECTION
238              You have not any connection for this  context  handle.  At  this
239              moment   (2.2.0.17),  call  NWDSAddConnection(NWDSContextHandle,
240              NWCONN_HANDLE).
241
242
243       -335     ERR_DUPLICATE_TYPE
244              If object has multiple naming attributes,  they  must  not  have
245              same name.
246
247
248       -337     ERR_NOT_LOGGED_IN
249              You  are trying to authenticate connection before you logged in.
250              You must first do NWDSLogin before call to NWDSAuthenticate.
251
252
253       -338     ERR_INVALID_PASSWORD_CHARS
254              Invalid characters in password.
255
256
257       -340     ERR_TRANSPORT
258              Transport not supported / referral addresses  does  not  include
259              any supported protocol.
260
261
262       -341     ERR_NO_SUCH_SYNTAX
263              Invalid  Syntax  ID  was  passed  to NWDSGet/NWDSPut/NWDSCompute
264              function.
265
266
267       -342     ERR_INVALID_DS_NAME
268              Multiple  dots  or  some  other  problem  (currently   only   in
269              RemoveAllTypes).
270
271
272       -348     ERR_UNICODE_FILE_NOT_FOUND
273              Tables  required  for local<->unicode translation were not found
274              (system defaults to ISO_8859-1).
275
276
277       -353     ERR_DN_TOO_LONG
278              Object name is too long.
279
280
281       -354     ERR_RENAME_NOT_ALLOWED
282              NWDSMoveObject cannot be  used  to  rename  object.  Use  either
283              NWDSModifyRDN or NWDSModifyDN function calls.
284
285
286       -601     ERR_NO_SUCH_ENTRY
287              Specified object does not exist.
288
289
290       -603     ERR_NO_SUCH_ATTRIBUTE
291              None of requested attributes exists.
292
293
294       -641     ERR_INVALID_REQUEST
295              Server  did not understand your request. Either your program did
296              not fill up request buffer properly or server DS is too old.
297
298
299       -656     ERR_CRUCIAL_REPLICA
300              Replica cannot be removed (or type cannot be changed) because of
301              it is last master replica of an partition.
302
303
304       -659     ERR_TIME_NOT_SYNCHRONIZED
305              Server time is not synchronized with rest of tree.
306
307
308       -669     ERR_FAILED_AUTHENTICATION
309              Invalid password or authentication time window exceeded.
310
311
312       -683     ERR_INVALID_API_VERSION
313              Server  does  not support this API version - it is too old.  One
314              of examples is NWDSAddObject if server does  not  support  frag‐
315              mented  DSV_ENTRY_ADD, but you asked for it.  Another example is
316              NWDSListPartitionsExtInfo.
317
318
319       -700     ERR_OBSOLETE_API
320              Server does not support this API version - this API call  is  no
321              longer  supported.  One  of  examples  is NWDSRemovePartition if
322              server runs NDS8.
323
324

BUGS

326       This manual page is incomplete and some error descriptions are  confus‐
327       ing.
328
329

SEE ALSO

331       NWCallsInit(3ncp), NWCallsTerm(3ncp)
332
333
334
335libncp (>= 2.2.0.14)              04/13/1999                    nwerrors(3NCP)
Impressum