1 /* Licensed to the Apache Software Foundation (ASF) under one or more
2 * contributor license agreements. See the NOTICE file distributed with
3 * this work for additional information regarding copyright ownership.
4 * The ASF licenses this file to You under the Apache License, Version 2.0
5 * (the "License"); you may not use this file except in compliance with
6 * the License. You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
22 * @brief APR Error Codes
33 #endif /* __cplusplus */
36 * @defgroup apr_errno Error Codes
42 * Type for specifying an error or status code.
44 typedef int apr_status_t;
47 * Return a human readable string describing the specified error.
48 * @param statcode The error code to get a string for.
49 * @param buf A buffer to hold the error string.
50 * @param bufsize Size of the buffer to hold the string.
52 APR_DECLARE(char *) apr_strerror(apr_status_t statcode, char *buf,
57 * @def APR_FROM_OS_ERROR(os_err_type syserr)
58 * Fold a platform specific error into an apr_status_t code.
59 * @return apr_status_t
60 * @param e The platform os error code.
61 * @warning macro implementation; the syserr argument may be evaluated
64 #define APR_FROM_OS_ERROR(e) (e == 0 ? APR_SUCCESS : e + APR_OS_START_SYSERR)
67 * @def APR_TO_OS_ERROR(apr_status_t statcode)
69 * Fold an apr_status_t code back to the native platform defined error.
70 * @param e The apr_status_t folded platform os error code.
71 * @warning macro implementation; the statcode argument may be evaluated
72 * multiple times. If the statcode was not created by apr_get_os_error
73 * or APR_FROM_OS_ERROR, the results are undefined.
75 #define APR_TO_OS_ERROR(e) (e == 0 ? APR_SUCCESS : e - APR_OS_START_SYSERR)
77 /** @def apr_get_os_error()
78 * @return apr_status_t the last platform error, folded into apr_status_t, on most platforms
79 * @remark This retrieves errno, or calls a GetLastError() style function, and
80 * folds it with APR_FROM_OS_ERROR. Some platforms (such as OS2) have no
81 * such mechanism, so this call may be unsupported. Do NOT use this
82 * call for socket errors from socket, send, recv etc!
85 /** @def apr_set_os_error(e)
86 * Reset the last platform error, unfolded from an apr_status_t, on some platforms
87 * @param e The OS error folded in a prior call to APR_FROM_OS_ERROR()
88 * @warning This is a macro implementation; the statcode argument may be evaluated
89 * multiple times. If the statcode was not created by apr_get_os_error
90 * or APR_FROM_OS_ERROR, the results are undefined. This macro sets
91 * errno, or calls a SetLastError() style function, unfolding statcode
92 * with APR_TO_OS_ERROR. Some platforms (such as OS2) have no such
93 * mechanism, so this call may be unsupported.
96 /** @def apr_get_netos_error()
97 * Return the last socket error, folded into apr_status_t, on all platforms
98 * @remark This retrieves errno or calls a GetLastSocketError() style function,
99 * and folds it with APR_FROM_OS_ERROR.
102 /** @def apr_set_netos_error(e)
103 * Reset the last socket error, unfolded from an apr_status_t
104 * @param e The socket error folded in a prior call to APR_FROM_OS_ERROR()
105 * @warning This is a macro implementation; the statcode argument may be evaluated
106 * multiple times. If the statcode was not created by apr_get_os_error
107 * or APR_FROM_OS_ERROR, the results are undefined. This macro sets
108 * errno, or calls a WSASetLastError() style function, unfolding
109 * socketcode with APR_TO_OS_ERROR.
112 #endif /* defined(DOXYGEN) */
115 * APR_OS_START_ERROR is where the APR specific error values start.
117 #define APR_OS_START_ERROR 20000
119 * APR_OS_ERRSPACE_SIZE is the maximum number of errors you can fit
120 * into one of the error/status ranges below -- except for
121 * APR_OS_START_USERERR, which see.
123 #define APR_OS_ERRSPACE_SIZE 50000
125 * APR_UTIL_ERRSPACE_SIZE is the size of the space that is reserved for
126 * use within apr-util. This space is reserved above that used by APR
128 * @note This number MUST be smaller than APR_OS_ERRSPACE_SIZE by a
129 * large enough amount that APR has sufficient room for its
132 #define APR_UTIL_ERRSPACE_SIZE 20000
134 * APR_OS_START_STATUS is where the APR specific status codes start.
136 #define APR_OS_START_STATUS (APR_OS_START_ERROR + APR_OS_ERRSPACE_SIZE)
138 * APR_UTIL_START_STATUS is where APR-Util starts defining its
141 #define APR_UTIL_START_STATUS (APR_OS_START_STATUS + \
142 (APR_OS_ERRSPACE_SIZE - APR_UTIL_ERRSPACE_SIZE))
144 * APR_OS_START_USERERR are reserved for applications that use APR that
145 * layer their own error codes along with APR's. Note that the
146 * error immediately following this one is set ten times farther
147 * away than usual, so that users of apr have a lot of room in
148 * which to declare custom error codes.
150 * In general applications should try and create unique error codes. To try
151 * and assist in finding suitable ranges of numbers to use, the following
152 * ranges are known to be used by the listed applications. If your
153 * application defines error codes please advise the range of numbers it
154 * uses to dev@apr.apache.org for inclusion in this list.
156 * Ranges shown are in relation to APR_OS_START_USERERR
158 * Subversion - Defined ranges, of less than 100, at intervals of 5000
159 * starting at an offset of 5000, e.g.
160 * +5000 to 5100, +10000 to 10100
162 * Apache HTTPD - +2000 to 2999
164 #define APR_OS_START_USERERR (APR_OS_START_STATUS + APR_OS_ERRSPACE_SIZE)
166 * APR_OS_START_USEERR is obsolete, defined for compatibility only.
167 * Use APR_OS_START_USERERR instead.
169 #define APR_OS_START_USEERR APR_OS_START_USERERR
171 * APR_OS_START_CANONERR is where APR versions of errno values are defined
172 * on systems which don't have the corresponding errno.
174 #define APR_OS_START_CANONERR (APR_OS_START_USERERR \
175 + (APR_OS_ERRSPACE_SIZE * 10))
177 * APR_OS_START_EAIERR folds EAI_ error codes from getaddrinfo() into
178 * apr_status_t values.
180 #define APR_OS_START_EAIERR (APR_OS_START_CANONERR + APR_OS_ERRSPACE_SIZE)
182 * APR_OS_START_SYSERR folds platform-specific system error values into
183 * apr_status_t values.
185 #define APR_OS_START_SYSERR (APR_OS_START_EAIERR + APR_OS_ERRSPACE_SIZE)
188 * @defgroup APR_ERROR_map APR Error Space
190 * The following attempts to show the relation of the various constants
191 * used for mapping APR Status codes.
195 * 20,000 APR_OS_START_ERROR
197 * + APR_OS_ERRSPACE_SIZE (50,000)
199 * 70,000 APR_OS_START_STATUS
201 * + APR_OS_ERRSPACE_SIZE - APR_UTIL_ERRSPACE_SIZE (30,000)
203 * 100,000 APR_UTIL_START_STATUS
205 * + APR_UTIL_ERRSPACE_SIZE (20,000)
207 * 120,000 APR_OS_START_USERERR
209 * + 10 x APR_OS_ERRSPACE_SIZE (50,000 * 10)
211 * 620,000 APR_OS_START_CANONERR
213 * + APR_OS_ERRSPACE_SIZE (50,000)
215 * 670,000 APR_OS_START_EAIERR
217 * + APR_OS_ERRSPACE_SIZE (50,000)
219 * 720,000 APR_OS_START_SYSERR
225 #define APR_SUCCESS 0
228 * @defgroup APR_Error APR Error Values
230 * <b>APR ERROR VALUES</b>
231 * APR_ENOSTAT APR was unable to perform a stat on the file
232 * APR_ENOPOOL APR was not provided a pool with which to allocate memory
233 * APR_EBADDATE APR was given an invalid date
234 * APR_EINVALSOCK APR was given an invalid socket
235 * APR_ENOPROC APR was not given a process structure
236 * APR_ENOTIME APR was not given a time structure
237 * APR_ENODIR APR was not given a directory structure
238 * APR_ENOLOCK APR was not given a lock structure
239 * APR_ENOPOLL APR was not given a poll structure
240 * APR_ENOSOCKET APR was not given a socket
241 * APR_ENOTHREAD APR was not given a thread structure
242 * APR_ENOTHDKEY APR was not given a thread key structure
243 * APR_ENOSHMAVAIL There is no more shared memory available
244 * APR_EDSOOPEN APR was unable to open the dso object. For more
245 * information call apr_dso_error().
246 * APR_EGENERAL General failure (specific information not available)
247 * APR_EBADIP The specified IP address is invalid
248 * APR_EBADMASK The specified netmask is invalid
249 * APR_ESYMNOTFOUND Could not find the requested symbol
250 * APR_ENOTENOUGHENTROPY Not enough entropy to continue
254 * <b>APR STATUS VALUES</b>
255 * APR_INCHILD Program is currently executing in the child
256 * APR_INPARENT Program is currently executing in the parent
257 * APR_DETACH The thread is detached
258 * APR_NOTDETACH The thread is not detached
259 * APR_CHILD_DONE The child has finished executing
260 * APR_CHILD_NOTDONE The child has not finished executing
261 * APR_TIMEUP The operation did not finish before the timeout
262 * APR_INCOMPLETE The operation was incomplete although some processing
263 * was performed and the results are partially valid
264 * APR_BADCH Getopt found an option not in the option string
265 * APR_BADARG Getopt found an option that is missing an argument
266 * and an argument was specified in the option string
267 * APR_EOF APR has encountered the end of the file
268 * APR_NOTFOUND APR was unable to find the socket in the poll structure
269 * APR_ANONYMOUS APR is using anonymous shared memory
270 * APR_FILEBASED APR is using a file name as the key to the shared memory
271 * APR_KEYBASED APR is using a shared key as the key to the shared memory
272 * APR_EINIT Ininitalizer value. If no option has been found, but
273 * the status variable requires a value, this should be used
274 * APR_ENOTIMPL The APR function has not been implemented on this
275 * platform, either because nobody has gotten to it yet,
276 * or the function is impossible on this platform.
277 * APR_EMISMATCH Two passwords do not match.
278 * APR_EABSOLUTE The given path was absolute.
279 * APR_ERELATIVE The given path was relative.
280 * APR_EINCOMPLETE The given path was neither relative nor absolute.
281 * APR_EABOVEROOT The given path was above the root path.
282 * APR_EBUSY The given lock was busy.
283 * APR_EPROC_UNKNOWN The given process wasn't recognized by APR
287 /** @see APR_STATUS_IS_ENOSTAT */
288 #define APR_ENOSTAT (APR_OS_START_ERROR + 1)
289 /** @see APR_STATUS_IS_ENOPOOL */
290 #define APR_ENOPOOL (APR_OS_START_ERROR + 2)
292 /** @see APR_STATUS_IS_EBADDATE */
293 #define APR_EBADDATE (APR_OS_START_ERROR + 4)
294 /** @see APR_STATUS_IS_EINVALSOCK */
295 #define APR_EINVALSOCK (APR_OS_START_ERROR + 5)
296 /** @see APR_STATUS_IS_ENOPROC */
297 #define APR_ENOPROC (APR_OS_START_ERROR + 6)
298 /** @see APR_STATUS_IS_ENOTIME */
299 #define APR_ENOTIME (APR_OS_START_ERROR + 7)
300 /** @see APR_STATUS_IS_ENODIR */
301 #define APR_ENODIR (APR_OS_START_ERROR + 8)
302 /** @see APR_STATUS_IS_ENOLOCK */
303 #define APR_ENOLOCK (APR_OS_START_ERROR + 9)
304 /** @see APR_STATUS_IS_ENOPOLL */
305 #define APR_ENOPOLL (APR_OS_START_ERROR + 10)
306 /** @see APR_STATUS_IS_ENOSOCKET */
307 #define APR_ENOSOCKET (APR_OS_START_ERROR + 11)
308 /** @see APR_STATUS_IS_ENOTHREAD */
309 #define APR_ENOTHREAD (APR_OS_START_ERROR + 12)
310 /** @see APR_STATUS_IS_ENOTHDKEY */
311 #define APR_ENOTHDKEY (APR_OS_START_ERROR + 13)
312 /** @see APR_STATUS_IS_EGENERAL */
313 #define APR_EGENERAL (APR_OS_START_ERROR + 14)
314 /** @see APR_STATUS_IS_ENOSHMAVAIL */
315 #define APR_ENOSHMAVAIL (APR_OS_START_ERROR + 15)
316 /** @see APR_STATUS_IS_EBADIP */
317 #define APR_EBADIP (APR_OS_START_ERROR + 16)
318 /** @see APR_STATUS_IS_EBADMASK */
319 #define APR_EBADMASK (APR_OS_START_ERROR + 17)
320 /* empty slot: +18 */
321 /** @see APR_STATUS_IS_EDSOPEN */
322 #define APR_EDSOOPEN (APR_OS_START_ERROR + 19)
323 /** @see APR_STATUS_IS_EABSOLUTE */
324 #define APR_EABSOLUTE (APR_OS_START_ERROR + 20)
325 /** @see APR_STATUS_IS_ERELATIVE */
326 #define APR_ERELATIVE (APR_OS_START_ERROR + 21)
327 /** @see APR_STATUS_IS_EINCOMPLETE */
328 #define APR_EINCOMPLETE (APR_OS_START_ERROR + 22)
329 /** @see APR_STATUS_IS_EABOVEROOT */
330 #define APR_EABOVEROOT (APR_OS_START_ERROR + 23)
331 /** @see APR_STATUS_IS_EBADPATH */
332 #define APR_EBADPATH (APR_OS_START_ERROR + 24)
333 /** @see APR_STATUS_IS_EPATHWILD */
334 #define APR_EPATHWILD (APR_OS_START_ERROR + 25)
335 /** @see APR_STATUS_IS_ESYMNOTFOUND */
336 #define APR_ESYMNOTFOUND (APR_OS_START_ERROR + 26)
337 /** @see APR_STATUS_IS_EPROC_UNKNOWN */
338 #define APR_EPROC_UNKNOWN (APR_OS_START_ERROR + 27)
339 /** @see APR_STATUS_IS_ENOTENOUGHENTROPY */
340 #define APR_ENOTENOUGHENTROPY (APR_OS_START_ERROR + 28)
344 * @defgroup APR_STATUS_IS Status Value Tests
345 * @warning For any particular error condition, more than one of these tests
346 * may match. This is because platform-specific error codes may not
347 * always match the semantics of the POSIX codes these tests (and the
348 * corresponding APR error codes) are named after. A notable example
349 * are the APR_STATUS_IS_ENOENT and APR_STATUS_IS_ENOTDIR tests on
350 * Win32 platforms. The programmer should always be aware of this and
351 * adjust the order of the tests accordingly.
355 * APR was unable to perform a stat on the file
356 * @warning always use this test, as platform-specific variances may meet this
357 * more than one error code
359 #define APR_STATUS_IS_ENOSTAT(s) ((s) == APR_ENOSTAT)
361 * APR was not provided a pool with which to allocate memory
362 * @warning always use this test, as platform-specific variances may meet this
363 * more than one error code
365 #define APR_STATUS_IS_ENOPOOL(s) ((s) == APR_ENOPOOL)
366 /** APR was given an invalid date */
367 #define APR_STATUS_IS_EBADDATE(s) ((s) == APR_EBADDATE)
368 /** APR was given an invalid socket */
369 #define APR_STATUS_IS_EINVALSOCK(s) ((s) == APR_EINVALSOCK)
370 /** APR was not given a process structure */
371 #define APR_STATUS_IS_ENOPROC(s) ((s) == APR_ENOPROC)
372 /** APR was not given a time structure */
373 #define APR_STATUS_IS_ENOTIME(s) ((s) == APR_ENOTIME)
374 /** APR was not given a directory structure */
375 #define APR_STATUS_IS_ENODIR(s) ((s) == APR_ENODIR)
376 /** APR was not given a lock structure */
377 #define APR_STATUS_IS_ENOLOCK(s) ((s) == APR_ENOLOCK)
378 /** APR was not given a poll structure */
379 #define APR_STATUS_IS_ENOPOLL(s) ((s) == APR_ENOPOLL)
380 /** APR was not given a socket */
381 #define APR_STATUS_IS_ENOSOCKET(s) ((s) == APR_ENOSOCKET)
382 /** APR was not given a thread structure */
383 #define APR_STATUS_IS_ENOTHREAD(s) ((s) == APR_ENOTHREAD)
384 /** APR was not given a thread key structure */
385 #define APR_STATUS_IS_ENOTHDKEY(s) ((s) == APR_ENOTHDKEY)
386 /** Generic Error which can not be put into another spot */
387 #define APR_STATUS_IS_EGENERAL(s) ((s) == APR_EGENERAL)
388 /** There is no more shared memory available */
389 #define APR_STATUS_IS_ENOSHMAVAIL(s) ((s) == APR_ENOSHMAVAIL)
390 /** The specified IP address is invalid */
391 #define APR_STATUS_IS_EBADIP(s) ((s) == APR_EBADIP)
392 /** The specified netmask is invalid */
393 #define APR_STATUS_IS_EBADMASK(s) ((s) == APR_EBADMASK)
394 /* empty slot: +18 */
396 * APR was unable to open the dso object.
397 * For more information call apr_dso_error().
400 #define APR_STATUS_IS_EDSOOPEN(s) ((s) == APR_EDSOOPEN \
401 || APR_TO_OS_ERROR(s) == ERROR_MOD_NOT_FOUND)
403 #define APR_STATUS_IS_EDSOOPEN(s) ((s) == APR_EDSOOPEN)
405 /** The given path was absolute. */
406 #define APR_STATUS_IS_EABSOLUTE(s) ((s) == APR_EABSOLUTE)
407 /** The given path was relative. */
408 #define APR_STATUS_IS_ERELATIVE(s) ((s) == APR_ERELATIVE)
409 /** The given path was neither relative nor absolute. */
410 #define APR_STATUS_IS_EINCOMPLETE(s) ((s) == APR_EINCOMPLETE)
411 /** The given path was above the root path. */
412 #define APR_STATUS_IS_EABOVEROOT(s) ((s) == APR_EABOVEROOT)
413 /** The given path was bad. */
414 #define APR_STATUS_IS_EBADPATH(s) ((s) == APR_EBADPATH)
415 /** The given path contained wildcards. */
416 #define APR_STATUS_IS_EPATHWILD(s) ((s) == APR_EPATHWILD)
417 /** Could not find the requested symbol.
418 * For more information call apr_dso_error().
421 #define APR_STATUS_IS_ESYMNOTFOUND(s) ((s) == APR_ESYMNOTFOUND \
422 || APR_TO_OS_ERROR(s) == ERROR_PROC_NOT_FOUND)
424 #define APR_STATUS_IS_ESYMNOTFOUND(s) ((s) == APR_ESYMNOTFOUND)
426 /** The given process was not recognized by APR. */
427 #define APR_STATUS_IS_EPROC_UNKNOWN(s) ((s) == APR_EPROC_UNKNOWN)
428 /** APR could not gather enough entropy to continue. */
429 #define APR_STATUS_IS_ENOTENOUGHENTROPY(s) ((s) == APR_ENOTENOUGHENTROPY)
434 * @addtogroup APR_Error
437 /** @see APR_STATUS_IS_INCHILD */
438 #define APR_INCHILD (APR_OS_START_STATUS + 1)
439 /** @see APR_STATUS_IS_INPARENT */
440 #define APR_INPARENT (APR_OS_START_STATUS + 2)
441 /** @see APR_STATUS_IS_DETACH */
442 #define APR_DETACH (APR_OS_START_STATUS + 3)
443 /** @see APR_STATUS_IS_NOTDETACH */
444 #define APR_NOTDETACH (APR_OS_START_STATUS + 4)
445 /** @see APR_STATUS_IS_CHILD_DONE */
446 #define APR_CHILD_DONE (APR_OS_START_STATUS + 5)
447 /** @see APR_STATUS_IS_CHILD_NOTDONE */
448 #define APR_CHILD_NOTDONE (APR_OS_START_STATUS + 6)
449 /** @see APR_STATUS_IS_TIMEUP */
450 #define APR_TIMEUP (APR_OS_START_STATUS + 7)
451 /** @see APR_STATUS_IS_INCOMPLETE */
452 #define APR_INCOMPLETE (APR_OS_START_STATUS + 8)
454 /* empty slot: +10 */
455 /* empty slot: +11 */
456 /** @see APR_STATUS_IS_BADCH */
457 #define APR_BADCH (APR_OS_START_STATUS + 12)
458 /** @see APR_STATUS_IS_BADARG */
459 #define APR_BADARG (APR_OS_START_STATUS + 13)
460 /** @see APR_STATUS_IS_EOF */
461 #define APR_EOF (APR_OS_START_STATUS + 14)
462 /** @see APR_STATUS_IS_NOTFOUND */
463 #define APR_NOTFOUND (APR_OS_START_STATUS + 15)
464 /* empty slot: +16 */
465 /* empty slot: +17 */
466 /* empty slot: +18 */
467 /** @see APR_STATUS_IS_ANONYMOUS */
468 #define APR_ANONYMOUS (APR_OS_START_STATUS + 19)
469 /** @see APR_STATUS_IS_FILEBASED */
470 #define APR_FILEBASED (APR_OS_START_STATUS + 20)
471 /** @see APR_STATUS_IS_KEYBASED */
472 #define APR_KEYBASED (APR_OS_START_STATUS + 21)
473 /** @see APR_STATUS_IS_EINIT */
474 #define APR_EINIT (APR_OS_START_STATUS + 22)
475 /** @see APR_STATUS_IS_ENOTIMPL */
476 #define APR_ENOTIMPL (APR_OS_START_STATUS + 23)
477 /** @see APR_STATUS_IS_EMISMATCH */
478 #define APR_EMISMATCH (APR_OS_START_STATUS + 24)
479 /** @see APR_STATUS_IS_EBUSY */
480 #define APR_EBUSY (APR_OS_START_STATUS + 25)
484 * @addtogroup APR_STATUS_IS
488 * Program is currently executing in the child
490 * always use this test, as platform-specific variances may meet this
491 * more than one error code */
492 #define APR_STATUS_IS_INCHILD(s) ((s) == APR_INCHILD)
494 * Program is currently executing in the parent
496 * always use this test, as platform-specific variances may meet this
497 * more than one error code
499 #define APR_STATUS_IS_INPARENT(s) ((s) == APR_INPARENT)
501 * The thread is detached
503 * always use this test, as platform-specific variances may meet this
504 * more than one error code
506 #define APR_STATUS_IS_DETACH(s) ((s) == APR_DETACH)
508 * The thread is not detached
510 * always use this test, as platform-specific variances may meet this
511 * more than one error code
513 #define APR_STATUS_IS_NOTDETACH(s) ((s) == APR_NOTDETACH)
515 * The child has finished executing
517 * always use this test, as platform-specific variances may meet this
518 * more than one error code
520 #define APR_STATUS_IS_CHILD_DONE(s) ((s) == APR_CHILD_DONE)
522 * The child has not finished executing
524 * always use this test, as platform-specific variances may meet this
525 * more than one error code
527 #define APR_STATUS_IS_CHILD_NOTDONE(s) ((s) == APR_CHILD_NOTDONE)
529 * The operation did not finish before the timeout
531 * always use this test, as platform-specific variances may meet this
532 * more than one error code
534 #define APR_STATUS_IS_TIMEUP(s) ((s) == APR_TIMEUP)
536 * The operation was incomplete although some processing was performed
537 * and the results are partially valid.
539 * always use this test, as platform-specific variances may meet this
540 * more than one error code
542 #define APR_STATUS_IS_INCOMPLETE(s) ((s) == APR_INCOMPLETE)
544 /* empty slot: +10 */
545 /* empty slot: +11 */
547 * Getopt found an option not in the option string
549 * always use this test, as platform-specific variances may meet this
550 * more than one error code
552 #define APR_STATUS_IS_BADCH(s) ((s) == APR_BADCH)
554 * Getopt found an option not in the option string and an argument was
555 * specified in the option string
557 * always use this test, as platform-specific variances may meet this
558 * more than one error code
560 #define APR_STATUS_IS_BADARG(s) ((s) == APR_BADARG)
562 * APR has encountered the end of the file
564 * always use this test, as platform-specific variances may meet this
565 * more than one error code
567 #define APR_STATUS_IS_EOF(s) ((s) == APR_EOF)
569 * APR was unable to find the socket in the poll structure
571 * always use this test, as platform-specific variances may meet this
572 * more than one error code
574 #define APR_STATUS_IS_NOTFOUND(s) ((s) == APR_NOTFOUND)
575 /* empty slot: +16 */
576 /* empty slot: +17 */
577 /* empty slot: +18 */
579 * APR is using anonymous shared memory
581 * always use this test, as platform-specific variances may meet this
582 * more than one error code
584 #define APR_STATUS_IS_ANONYMOUS(s) ((s) == APR_ANONYMOUS)
586 * APR is using a file name as the key to the shared memory
588 * always use this test, as platform-specific variances may meet this
589 * more than one error code
591 #define APR_STATUS_IS_FILEBASED(s) ((s) == APR_FILEBASED)
593 * APR is using a shared key as the key to the shared memory
595 * always use this test, as platform-specific variances may meet this
596 * more than one error code
598 #define APR_STATUS_IS_KEYBASED(s) ((s) == APR_KEYBASED)
600 * Ininitalizer value. If no option has been found, but
601 * the status variable requires a value, this should be used
603 * always use this test, as platform-specific variances may meet this
604 * more than one error code
606 #define APR_STATUS_IS_EINIT(s) ((s) == APR_EINIT)
608 * The APR function has not been implemented on this
609 * platform, either because nobody has gotten to it yet,
610 * or the function is impossible on this platform.
612 * always use this test, as platform-specific variances may meet this
613 * more than one error code
615 #define APR_STATUS_IS_ENOTIMPL(s) ((s) == APR_ENOTIMPL)
617 * Two passwords do not match.
619 * always use this test, as platform-specific variances may meet this
620 * more than one error code
622 #define APR_STATUS_IS_EMISMATCH(s) ((s) == APR_EMISMATCH)
624 * The given lock was busy
625 * @warning always use this test, as platform-specific variances may meet this
626 * more than one error code
628 #define APR_STATUS_IS_EBUSY(s) ((s) == APR_EBUSY)
633 * @addtogroup APR_Error APR Error Values
636 /* APR CANONICAL ERROR VALUES */
637 /** @see APR_STATUS_IS_EACCES */
639 #define APR_EACCES EACCES
641 #define APR_EACCES (APR_OS_START_CANONERR + 1)
644 /** @see APR_STATUS_IS_EEXIST */
646 #define APR_EEXIST EEXIST
648 #define APR_EEXIST (APR_OS_START_CANONERR + 2)
651 /** @see APR_STATUS_IS_ENAMETOOLONG */
653 #define APR_ENAMETOOLONG ENAMETOOLONG
655 #define APR_ENAMETOOLONG (APR_OS_START_CANONERR + 3)
658 /** @see APR_STATUS_IS_ENOENT */
660 #define APR_ENOENT ENOENT
662 #define APR_ENOENT (APR_OS_START_CANONERR + 4)
665 /** @see APR_STATUS_IS_ENOTDIR */
667 #define APR_ENOTDIR ENOTDIR
669 #define APR_ENOTDIR (APR_OS_START_CANONERR + 5)
672 /** @see APR_STATUS_IS_ENOSPC */
674 #define APR_ENOSPC ENOSPC
676 #define APR_ENOSPC (APR_OS_START_CANONERR + 6)
679 /** @see APR_STATUS_IS_ENOMEM */
681 #define APR_ENOMEM ENOMEM
683 #define APR_ENOMEM (APR_OS_START_CANONERR + 7)
686 /** @see APR_STATUS_IS_EMFILE */
688 #define APR_EMFILE EMFILE
690 #define APR_EMFILE (APR_OS_START_CANONERR + 8)
693 /** @see APR_STATUS_IS_ENFILE */
695 #define APR_ENFILE ENFILE
697 #define APR_ENFILE (APR_OS_START_CANONERR + 9)
700 /** @see APR_STATUS_IS_EBADF */
702 #define APR_EBADF EBADF
704 #define APR_EBADF (APR_OS_START_CANONERR + 10)
707 /** @see APR_STATUS_IS_EINVAL */
709 #define APR_EINVAL EINVAL
711 #define APR_EINVAL (APR_OS_START_CANONERR + 11)
714 /** @see APR_STATUS_IS_ESPIPE */
716 #define APR_ESPIPE ESPIPE
718 #define APR_ESPIPE (APR_OS_START_CANONERR + 12)
722 * @see APR_STATUS_IS_EAGAIN
723 * @warning use APR_STATUS_IS_EAGAIN instead of just testing this value
726 #define APR_EAGAIN EAGAIN
727 #elif defined(EWOULDBLOCK)
728 #define APR_EAGAIN EWOULDBLOCK
730 #define APR_EAGAIN (APR_OS_START_CANONERR + 13)
733 /** @see APR_STATUS_IS_EINTR */
735 #define APR_EINTR EINTR
737 #define APR_EINTR (APR_OS_START_CANONERR + 14)
740 /** @see APR_STATUS_IS_ENOTSOCK */
742 #define APR_ENOTSOCK ENOTSOCK
744 #define APR_ENOTSOCK (APR_OS_START_CANONERR + 15)
747 /** @see APR_STATUS_IS_ECONNREFUSED */
749 #define APR_ECONNREFUSED ECONNREFUSED
751 #define APR_ECONNREFUSED (APR_OS_START_CANONERR + 16)
754 /** @see APR_STATUS_IS_EINPROGRESS */
756 #define APR_EINPROGRESS EINPROGRESS
758 #define APR_EINPROGRESS (APR_OS_START_CANONERR + 17)
762 * @see APR_STATUS_IS_ECONNABORTED
763 * @warning use APR_STATUS_IS_ECONNABORTED instead of just testing this value
767 #define APR_ECONNABORTED ECONNABORTED
769 #define APR_ECONNABORTED (APR_OS_START_CANONERR + 18)
772 /** @see APR_STATUS_IS_ECONNRESET */
774 #define APR_ECONNRESET ECONNRESET
776 #define APR_ECONNRESET (APR_OS_START_CANONERR + 19)
779 /** @see APR_STATUS_IS_ETIMEDOUT
782 #define APR_ETIMEDOUT ETIMEDOUT
784 #define APR_ETIMEDOUT (APR_OS_START_CANONERR + 20)
787 /** @see APR_STATUS_IS_EHOSTUNREACH */
789 #define APR_EHOSTUNREACH EHOSTUNREACH
791 #define APR_EHOSTUNREACH (APR_OS_START_CANONERR + 21)
794 /** @see APR_STATUS_IS_ENETUNREACH */
796 #define APR_ENETUNREACH ENETUNREACH
798 #define APR_ENETUNREACH (APR_OS_START_CANONERR + 22)
801 /** @see APR_STATUS_IS_EFTYPE */
803 #define APR_EFTYPE EFTYPE
805 #define APR_EFTYPE (APR_OS_START_CANONERR + 23)
808 /** @see APR_STATUS_IS_EPIPE */
810 #define APR_EPIPE EPIPE
812 #define APR_EPIPE (APR_OS_START_CANONERR + 24)
815 /** @see APR_STATUS_IS_EXDEV */
817 #define APR_EXDEV EXDEV
819 #define APR_EXDEV (APR_OS_START_CANONERR + 25)
822 /** @see APR_STATUS_IS_ENOTEMPTY */
824 #define APR_ENOTEMPTY ENOTEMPTY
826 #define APR_ENOTEMPTY (APR_OS_START_CANONERR + 26)
829 /** @see APR_STATUS_IS_EAFNOSUPPORT */
831 #define APR_EAFNOSUPPORT EAFNOSUPPORT
833 #define APR_EAFNOSUPPORT (APR_OS_START_CANONERR + 27)
838 #if defined(OS2) && !defined(DOXYGEN)
840 #define APR_FROM_OS_ERROR(e) (e == 0 ? APR_SUCCESS : e + APR_OS_START_SYSERR)
841 #define APR_TO_OS_ERROR(e) (e == 0 ? APR_SUCCESS : e - APR_OS_START_SYSERR)
843 #define INCL_DOSERRORS
846 /* Leave these undefined.
847 * OS2 doesn't rely on the errno concept.
848 * The API calls always return a result codes which
849 * should be filtered through APR_FROM_OS_ERROR().
851 * #define apr_get_os_error() (APR_FROM_OS_ERROR(GetLastError()))
852 * #define apr_set_os_error(e) (SetLastError(APR_TO_OS_ERROR(e)))
855 /* A special case, only socket calls require this;
857 #define apr_get_netos_error() (APR_FROM_OS_ERROR(errno))
858 #define apr_set_netos_error(e) (errno = APR_TO_OS_ERROR(e))
860 /* And this needs to be greped away for good:
862 #define APR_OS2_STATUS(e) (APR_FROM_OS_ERROR(e))
864 /* These can't sit in a private header, so in spite of the extra size,
865 * they need to be made available here.
867 #define SOCBASEERR 10000
868 #define SOCEPERM (SOCBASEERR+1) /* Not owner */
869 #define SOCESRCH (SOCBASEERR+3) /* No such process */
870 #define SOCEINTR (SOCBASEERR+4) /* Interrupted system call */
871 #define SOCENXIO (SOCBASEERR+6) /* No such device or address */
872 #define SOCEBADF (SOCBASEERR+9) /* Bad file number */
873 #define SOCEACCES (SOCBASEERR+13) /* Permission denied */
874 #define SOCEFAULT (SOCBASEERR+14) /* Bad address */
875 #define SOCEINVAL (SOCBASEERR+22) /* Invalid argument */
876 #define SOCEMFILE (SOCBASEERR+24) /* Too many open files */
877 #define SOCEPIPE (SOCBASEERR+32) /* Broken pipe */
878 #define SOCEOS2ERR (SOCBASEERR+100) /* OS/2 Error */
879 #define SOCEWOULDBLOCK (SOCBASEERR+35) /* Operation would block */
880 #define SOCEINPROGRESS (SOCBASEERR+36) /* Operation now in progress */
881 #define SOCEALREADY (SOCBASEERR+37) /* Operation already in progress */
882 #define SOCENOTSOCK (SOCBASEERR+38) /* Socket operation on non-socket */
883 #define SOCEDESTADDRREQ (SOCBASEERR+39) /* Destination address required */
884 #define SOCEMSGSIZE (SOCBASEERR+40) /* Message too long */
885 #define SOCEPROTOTYPE (SOCBASEERR+41) /* Protocol wrong type for socket */
886 #define SOCENOPROTOOPT (SOCBASEERR+42) /* Protocol not available */
887 #define SOCEPROTONOSUPPORT (SOCBASEERR+43) /* Protocol not supported */
888 #define SOCESOCKTNOSUPPORT (SOCBASEERR+44) /* Socket type not supported */
889 #define SOCEOPNOTSUPP (SOCBASEERR+45) /* Operation not supported on socket */
890 #define SOCEPFNOSUPPORT (SOCBASEERR+46) /* Protocol family not supported */
891 #define SOCEAFNOSUPPORT (SOCBASEERR+47) /* Address family not supported by protocol family */
892 #define SOCEADDRINUSE (SOCBASEERR+48) /* Address already in use */
893 #define SOCEADDRNOTAVAIL (SOCBASEERR+49) /* Can't assign requested address */
894 #define SOCENETDOWN (SOCBASEERR+50) /* Network is down */
895 #define SOCENETUNREACH (SOCBASEERR+51) /* Network is unreachable */
896 #define SOCENETRESET (SOCBASEERR+52) /* Network dropped connection on reset */
897 #define SOCECONNABORTED (SOCBASEERR+53) /* Software caused connection abort */
898 #define SOCECONNRESET (SOCBASEERR+54) /* Connection reset by peer */
899 #define SOCENOBUFS (SOCBASEERR+55) /* No buffer space available */
900 #define SOCEISCONN (SOCBASEERR+56) /* Socket is already connected */
901 #define SOCENOTCONN (SOCBASEERR+57) /* Socket is not connected */
902 #define SOCESHUTDOWN (SOCBASEERR+58) /* Can't send after socket shutdown */
903 #define SOCETOOMANYREFS (SOCBASEERR+59) /* Too many references: can't splice */
904 #define SOCETIMEDOUT (SOCBASEERR+60) /* Connection timed out */
905 #define SOCECONNREFUSED (SOCBASEERR+61) /* Connection refused */
906 #define SOCELOOP (SOCBASEERR+62) /* Too many levels of symbolic links */
907 #define SOCENAMETOOLONG (SOCBASEERR+63) /* File name too long */
908 #define SOCEHOSTDOWN (SOCBASEERR+64) /* Host is down */
909 #define SOCEHOSTUNREACH (SOCBASEERR+65) /* No route to host */
910 #define SOCENOTEMPTY (SOCBASEERR+66) /* Directory not empty */
912 /* APR CANONICAL ERROR TESTS */
913 #define APR_STATUS_IS_EACCES(s) ((s) == APR_EACCES \
914 || (s) == APR_OS_START_SYSERR + ERROR_ACCESS_DENIED \
915 || (s) == APR_OS_START_SYSERR + ERROR_SHARING_VIOLATION)
916 #define APR_STATUS_IS_EEXIST(s) ((s) == APR_EEXIST \
917 || (s) == APR_OS_START_SYSERR + ERROR_OPEN_FAILED \
918 || (s) == APR_OS_START_SYSERR + ERROR_FILE_EXISTS \
919 || (s) == APR_OS_START_SYSERR + ERROR_ALREADY_EXISTS \
920 || (s) == APR_OS_START_SYSERR + ERROR_ACCESS_DENIED)
921 #define APR_STATUS_IS_ENAMETOOLONG(s) ((s) == APR_ENAMETOOLONG \
922 || (s) == APR_OS_START_SYSERR + ERROR_FILENAME_EXCED_RANGE \
923 || (s) == APR_OS_START_SYSERR + SOCENAMETOOLONG)
924 #define APR_STATUS_IS_ENOENT(s) ((s) == APR_ENOENT \
925 || (s) == APR_OS_START_SYSERR + ERROR_FILE_NOT_FOUND \
926 || (s) == APR_OS_START_SYSERR + ERROR_PATH_NOT_FOUND \
927 || (s) == APR_OS_START_SYSERR + ERROR_NO_MORE_FILES \
928 || (s) == APR_OS_START_SYSERR + ERROR_OPEN_FAILED)
929 #define APR_STATUS_IS_ENOTDIR(s) ((s) == APR_ENOTDIR)
930 #define APR_STATUS_IS_ENOSPC(s) ((s) == APR_ENOSPC \
931 || (s) == APR_OS_START_SYSERR + ERROR_DISK_FULL)
932 #define APR_STATUS_IS_ENOMEM(s) ((s) == APR_ENOMEM)
933 #define APR_STATUS_IS_EMFILE(s) ((s) == APR_EMFILE \
934 || (s) == APR_OS_START_SYSERR + ERROR_TOO_MANY_OPEN_FILES)
935 #define APR_STATUS_IS_ENFILE(s) ((s) == APR_ENFILE)
936 #define APR_STATUS_IS_EBADF(s) ((s) == APR_EBADF \
937 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_HANDLE)
938 #define APR_STATUS_IS_EINVAL(s) ((s) == APR_EINVAL \
939 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_PARAMETER \
940 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_FUNCTION)
941 #define APR_STATUS_IS_ESPIPE(s) ((s) == APR_ESPIPE \
942 || (s) == APR_OS_START_SYSERR + ERROR_NEGATIVE_SEEK)
943 #define APR_STATUS_IS_EAGAIN(s) ((s) == APR_EAGAIN \
944 || (s) == APR_OS_START_SYSERR + ERROR_NO_DATA \
945 || (s) == APR_OS_START_SYSERR + SOCEWOULDBLOCK \
946 || (s) == APR_OS_START_SYSERR + ERROR_LOCK_VIOLATION)
947 #define APR_STATUS_IS_EINTR(s) ((s) == APR_EINTR \
948 || (s) == APR_OS_START_SYSERR + SOCEINTR)
949 #define APR_STATUS_IS_ENOTSOCK(s) ((s) == APR_ENOTSOCK \
950 || (s) == APR_OS_START_SYSERR + SOCENOTSOCK)
951 #define APR_STATUS_IS_ECONNREFUSED(s) ((s) == APR_ECONNREFUSED \
952 || (s) == APR_OS_START_SYSERR + SOCECONNREFUSED)
953 #define APR_STATUS_IS_EINPROGRESS(s) ((s) == APR_EINPROGRESS \
954 || (s) == APR_OS_START_SYSERR + SOCEINPROGRESS)
955 #define APR_STATUS_IS_ECONNABORTED(s) ((s) == APR_ECONNABORTED \
956 || (s) == APR_OS_START_SYSERR + SOCECONNABORTED)
957 #define APR_STATUS_IS_ECONNRESET(s) ((s) == APR_ECONNRESET \
958 || (s) == APR_OS_START_SYSERR + SOCECONNRESET)
960 #define APR_STATUS_IS_ETIMEDOUT(s) ((s) == APR_ETIMEDOUT \
961 || (s) == APR_OS_START_SYSERR + SOCETIMEDOUT)
962 #undef APR_STATUS_IS_TIMEUP
963 #define APR_STATUS_IS_TIMEUP(s) ((s) == APR_TIMEUP \
964 || (s) == APR_OS_START_SYSERR + SOCETIMEDOUT)
965 #define APR_STATUS_IS_EHOSTUNREACH(s) ((s) == APR_EHOSTUNREACH \
966 || (s) == APR_OS_START_SYSERR + SOCEHOSTUNREACH)
967 #define APR_STATUS_IS_ENETUNREACH(s) ((s) == APR_ENETUNREACH \
968 || (s) == APR_OS_START_SYSERR + SOCENETUNREACH)
969 #define APR_STATUS_IS_EFTYPE(s) ((s) == APR_EFTYPE)
970 #define APR_STATUS_IS_EPIPE(s) ((s) == APR_EPIPE \
971 || (s) == APR_OS_START_SYSERR + ERROR_BROKEN_PIPE \
972 || (s) == APR_OS_START_SYSERR + SOCEPIPE)
973 #define APR_STATUS_IS_EXDEV(s) ((s) == APR_EXDEV \
974 || (s) == APR_OS_START_SYSERR + ERROR_NOT_SAME_DEVICE)
975 #define APR_STATUS_IS_ENOTEMPTY(s) ((s) == APR_ENOTEMPTY \
976 || (s) == APR_OS_START_SYSERR + ERROR_DIR_NOT_EMPTY \
977 || (s) == APR_OS_START_SYSERR + ERROR_ACCESS_DENIED)
978 #define APR_STATUS_IS_EAFNOSUPPORT(s) ((s) == APR_AFNOSUPPORT \
979 || (s) == APR_OS_START_SYSERR + SOCEAFNOSUPPORT)
982 Sorry, too tired to wrap this up for OS2... feel free to
983 fit the following into their best matches.
985 { ERROR_NO_SIGNAL_SENT, ESRCH },
986 { SOCEALREADY, EALREADY },
987 { SOCEDESTADDRREQ, EDESTADDRREQ },
988 { SOCEMSGSIZE, EMSGSIZE },
989 { SOCEPROTOTYPE, EPROTOTYPE },
990 { SOCENOPROTOOPT, ENOPROTOOPT },
991 { SOCEPROTONOSUPPORT, EPROTONOSUPPORT },
992 { SOCESOCKTNOSUPPORT, ESOCKTNOSUPPORT },
993 { SOCEOPNOTSUPP, EOPNOTSUPP },
994 { SOCEPFNOSUPPORT, EPFNOSUPPORT },
995 { SOCEADDRINUSE, EADDRINUSE },
996 { SOCEADDRNOTAVAIL, EADDRNOTAVAIL },
997 { SOCENETDOWN, ENETDOWN },
998 { SOCENETRESET, ENETRESET },
999 { SOCENOBUFS, ENOBUFS },
1000 { SOCEISCONN, EISCONN },
1001 { SOCENOTCONN, ENOTCONN },
1002 { SOCESHUTDOWN, ESHUTDOWN },
1003 { SOCETOOMANYREFS, ETOOMANYREFS },
1004 { SOCELOOP, ELOOP },
1005 { SOCEHOSTDOWN, EHOSTDOWN },
1006 { SOCENOTEMPTY, ENOTEMPTY },
1010 #elif defined(WIN32) && !defined(DOXYGEN) /* !defined(OS2) */
1012 #define APR_FROM_OS_ERROR(e) (e == 0 ? APR_SUCCESS : e + APR_OS_START_SYSERR)
1013 #define APR_TO_OS_ERROR(e) (e == 0 ? APR_SUCCESS : e - APR_OS_START_SYSERR)
1015 #define apr_get_os_error() (APR_FROM_OS_ERROR(GetLastError()))
1016 #define apr_set_os_error(e) (SetLastError(APR_TO_OS_ERROR(e)))
1018 /* A special case, only socket calls require this:
1020 #define apr_get_netos_error() (APR_FROM_OS_ERROR(WSAGetLastError()))
1021 #define apr_set_netos_error(e) (WSASetLastError(APR_TO_OS_ERROR(e)))
1023 /* APR CANONICAL ERROR TESTS */
1024 #define APR_STATUS_IS_EACCES(s) ((s) == APR_EACCES \
1025 || (s) == APR_OS_START_SYSERR + ERROR_ACCESS_DENIED \
1026 || (s) == APR_OS_START_SYSERR + ERROR_CANNOT_MAKE \
1027 || (s) == APR_OS_START_SYSERR + ERROR_CURRENT_DIRECTORY \
1028 || (s) == APR_OS_START_SYSERR + ERROR_DRIVE_LOCKED \
1029 || (s) == APR_OS_START_SYSERR + ERROR_FAIL_I24 \
1030 || (s) == APR_OS_START_SYSERR + ERROR_LOCK_VIOLATION \
1031 || (s) == APR_OS_START_SYSERR + ERROR_LOCK_FAILED \
1032 || (s) == APR_OS_START_SYSERR + ERROR_NOT_LOCKED \
1033 || (s) == APR_OS_START_SYSERR + ERROR_NETWORK_ACCESS_DENIED \
1034 || (s) == APR_OS_START_SYSERR + ERROR_SHARING_VIOLATION)
1035 #define APR_STATUS_IS_EEXIST(s) ((s) == APR_EEXIST \
1036 || (s) == APR_OS_START_SYSERR + ERROR_FILE_EXISTS \
1037 || (s) == APR_OS_START_SYSERR + ERROR_ALREADY_EXISTS)
1038 #define APR_STATUS_IS_ENAMETOOLONG(s) ((s) == APR_ENAMETOOLONG \
1039 || (s) == APR_OS_START_SYSERR + ERROR_FILENAME_EXCED_RANGE \
1040 || (s) == APR_OS_START_SYSERR + WSAENAMETOOLONG)
1041 #define APR_STATUS_IS_ENOENT(s) ((s) == APR_ENOENT \
1042 || (s) == APR_OS_START_SYSERR + ERROR_FILE_NOT_FOUND \
1043 || (s) == APR_OS_START_SYSERR + ERROR_PATH_NOT_FOUND \
1044 || (s) == APR_OS_START_SYSERR + ERROR_OPEN_FAILED \
1045 || (s) == APR_OS_START_SYSERR + ERROR_NO_MORE_FILES)
1046 #define APR_STATUS_IS_ENOTDIR(s) ((s) == APR_ENOTDIR \
1047 || (s) == APR_OS_START_SYSERR + ERROR_PATH_NOT_FOUND \
1048 || (s) == APR_OS_START_SYSERR + ERROR_BAD_NETPATH \
1049 || (s) == APR_OS_START_SYSERR + ERROR_BAD_NET_NAME \
1050 || (s) == APR_OS_START_SYSERR + ERROR_BAD_PATHNAME \
1051 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_DRIVE \
1052 || (s) == APR_OS_START_SYSERR + ERROR_DIRECTORY)
1053 #define APR_STATUS_IS_ENOSPC(s) ((s) == APR_ENOSPC \
1054 || (s) == APR_OS_START_SYSERR + ERROR_DISK_FULL)
1055 #define APR_STATUS_IS_ENOMEM(s) ((s) == APR_ENOMEM \
1056 || (s) == APR_OS_START_SYSERR + ERROR_ARENA_TRASHED \
1057 || (s) == APR_OS_START_SYSERR + ERROR_NOT_ENOUGH_MEMORY \
1058 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_BLOCK \
1059 || (s) == APR_OS_START_SYSERR + ERROR_NOT_ENOUGH_QUOTA \
1060 || (s) == APR_OS_START_SYSERR + ERROR_OUTOFMEMORY)
1061 #define APR_STATUS_IS_EMFILE(s) ((s) == APR_EMFILE \
1062 || (s) == APR_OS_START_SYSERR + ERROR_TOO_MANY_OPEN_FILES)
1063 #define APR_STATUS_IS_ENFILE(s) ((s) == APR_ENFILE)
1064 #define APR_STATUS_IS_EBADF(s) ((s) == APR_EBADF \
1065 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_HANDLE \
1066 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_TARGET_HANDLE)
1067 #define APR_STATUS_IS_EINVAL(s) ((s) == APR_EINVAL \
1068 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_ACCESS \
1069 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_DATA \
1070 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_FUNCTION \
1071 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_HANDLE \
1072 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_PARAMETER \
1073 || (s) == APR_OS_START_SYSERR + ERROR_NEGATIVE_SEEK)
1074 #define APR_STATUS_IS_ESPIPE(s) ((s) == APR_ESPIPE \
1075 || (s) == APR_OS_START_SYSERR + ERROR_SEEK_ON_DEVICE \
1076 || (s) == APR_OS_START_SYSERR + ERROR_NEGATIVE_SEEK)
1077 #define APR_STATUS_IS_EAGAIN(s) ((s) == APR_EAGAIN \
1078 || (s) == APR_OS_START_SYSERR + ERROR_NO_DATA \
1079 || (s) == APR_OS_START_SYSERR + ERROR_NO_PROC_SLOTS \
1080 || (s) == APR_OS_START_SYSERR + ERROR_NESTING_NOT_ALLOWED \
1081 || (s) == APR_OS_START_SYSERR + ERROR_MAX_THRDS_REACHED \
1082 || (s) == APR_OS_START_SYSERR + ERROR_LOCK_VIOLATION \
1083 || (s) == APR_OS_START_SYSERR + WSAEWOULDBLOCK)
1084 #define APR_STATUS_IS_EINTR(s) ((s) == APR_EINTR \
1085 || (s) == APR_OS_START_SYSERR + WSAEINTR)
1086 #define APR_STATUS_IS_ENOTSOCK(s) ((s) == APR_ENOTSOCK \
1087 || (s) == APR_OS_START_SYSERR + WSAENOTSOCK)
1088 #define APR_STATUS_IS_ECONNREFUSED(s) ((s) == APR_ECONNREFUSED \
1089 || (s) == APR_OS_START_SYSERR + WSAECONNREFUSED)
1090 #define APR_STATUS_IS_EINPROGRESS(s) ((s) == APR_EINPROGRESS \
1091 || (s) == APR_OS_START_SYSERR + WSAEINPROGRESS)
1092 #define APR_STATUS_IS_ECONNABORTED(s) ((s) == APR_ECONNABORTED \
1093 || (s) == APR_OS_START_SYSERR + WSAECONNABORTED)
1094 #define APR_STATUS_IS_ECONNRESET(s) ((s) == APR_ECONNRESET \
1095 || (s) == APR_OS_START_SYSERR + ERROR_NETNAME_DELETED \
1096 || (s) == APR_OS_START_SYSERR + WSAECONNRESET)
1097 /* XXX deprecated */
1098 #define APR_STATUS_IS_ETIMEDOUT(s) ((s) == APR_ETIMEDOUT \
1099 || (s) == APR_OS_START_SYSERR + WSAETIMEDOUT \
1100 || (s) == APR_OS_START_SYSERR + WAIT_TIMEOUT)
1101 #undef APR_STATUS_IS_TIMEUP
1102 #define APR_STATUS_IS_TIMEUP(s) ((s) == APR_TIMEUP \
1103 || (s) == APR_OS_START_SYSERR + WSAETIMEDOUT \
1104 || (s) == APR_OS_START_SYSERR + WAIT_TIMEOUT)
1105 #define APR_STATUS_IS_EHOSTUNREACH(s) ((s) == APR_EHOSTUNREACH \
1106 || (s) == APR_OS_START_SYSERR + WSAEHOSTUNREACH)
1107 #define APR_STATUS_IS_ENETUNREACH(s) ((s) == APR_ENETUNREACH \
1108 || (s) == APR_OS_START_SYSERR + WSAENETUNREACH)
1109 #define APR_STATUS_IS_EFTYPE(s) ((s) == APR_EFTYPE \
1110 || (s) == APR_OS_START_SYSERR + ERROR_EXE_MACHINE_TYPE_MISMATCH \
1111 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_DLL \
1112 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_MODULETYPE \
1113 || (s) == APR_OS_START_SYSERR + ERROR_BAD_EXE_FORMAT \
1114 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_EXE_SIGNATURE \
1115 || (s) == APR_OS_START_SYSERR + ERROR_FILE_CORRUPT \
1116 || (s) == APR_OS_START_SYSERR + ERROR_BAD_FORMAT)
1117 #define APR_STATUS_IS_EPIPE(s) ((s) == APR_EPIPE \
1118 || (s) == APR_OS_START_SYSERR + ERROR_BROKEN_PIPE)
1119 #define APR_STATUS_IS_EXDEV(s) ((s) == APR_EXDEV \
1120 || (s) == APR_OS_START_SYSERR + ERROR_NOT_SAME_DEVICE)
1121 #define APR_STATUS_IS_ENOTEMPTY(s) ((s) == APR_ENOTEMPTY \
1122 || (s) == APR_OS_START_SYSERR + ERROR_DIR_NOT_EMPTY)
1123 #define APR_STATUS_IS_EAFNOSUPPORT(s) ((s) == APR_EAFNOSUPPORT \
1124 || (s) == APR_OS_START_SYSERR + WSAEAFNOSUPPORT)
1126 #elif defined(NETWARE) && defined(USE_WINSOCK) && !defined(DOXYGEN) /* !defined(OS2) && !defined(WIN32) */
1128 #define APR_FROM_OS_ERROR(e) (e == 0 ? APR_SUCCESS : e + APR_OS_START_SYSERR)
1129 #define APR_TO_OS_ERROR(e) (e == 0 ? APR_SUCCESS : e - APR_OS_START_SYSERR)
1131 #define apr_get_os_error() (errno)
1132 #define apr_set_os_error(e) (errno = (e))
1134 /* A special case, only socket calls require this: */
1135 #define apr_get_netos_error() (APR_FROM_OS_ERROR(WSAGetLastError()))
1136 #define apr_set_netos_error(e) (WSASetLastError(APR_TO_OS_ERROR(e)))
1138 /* APR CANONICAL ERROR TESTS */
1139 #define APR_STATUS_IS_EACCES(s) ((s) == APR_EACCES)
1140 #define APR_STATUS_IS_EEXIST(s) ((s) == APR_EEXIST)
1141 #define APR_STATUS_IS_ENAMETOOLONG(s) ((s) == APR_ENAMETOOLONG)
1142 #define APR_STATUS_IS_ENOENT(s) ((s) == APR_ENOENT)
1143 #define APR_STATUS_IS_ENOTDIR(s) ((s) == APR_ENOTDIR)
1144 #define APR_STATUS_IS_ENOSPC(s) ((s) == APR_ENOSPC)
1145 #define APR_STATUS_IS_ENOMEM(s) ((s) == APR_ENOMEM)
1146 #define APR_STATUS_IS_EMFILE(s) ((s) == APR_EMFILE)
1147 #define APR_STATUS_IS_ENFILE(s) ((s) == APR_ENFILE)
1148 #define APR_STATUS_IS_EBADF(s) ((s) == APR_EBADF)
1149 #define APR_STATUS_IS_EINVAL(s) ((s) == APR_EINVAL)
1150 #define APR_STATUS_IS_ESPIPE(s) ((s) == APR_ESPIPE)
1152 #define APR_STATUS_IS_EAGAIN(s) ((s) == APR_EAGAIN \
1153 || (s) == EWOULDBLOCK \
1154 || (s) == APR_OS_START_SYSERR + WSAEWOULDBLOCK)
1155 #define APR_STATUS_IS_EINTR(s) ((s) == APR_EINTR \
1156 || (s) == APR_OS_START_SYSERR + WSAEINTR)
1157 #define APR_STATUS_IS_ENOTSOCK(s) ((s) == APR_ENOTSOCK \
1158 || (s) == APR_OS_START_SYSERR + WSAENOTSOCK)
1159 #define APR_STATUS_IS_ECONNREFUSED(s) ((s) == APR_ECONNREFUSED \
1160 || (s) == APR_OS_START_SYSERR + WSAECONNREFUSED)
1161 #define APR_STATUS_IS_EINPROGRESS(s) ((s) == APR_EINPROGRESS \
1162 || (s) == APR_OS_START_SYSERR + WSAEINPROGRESS)
1163 #define APR_STATUS_IS_ECONNABORTED(s) ((s) == APR_ECONNABORTED \
1164 || (s) == APR_OS_START_SYSERR + WSAECONNABORTED)
1165 #define APR_STATUS_IS_ECONNRESET(s) ((s) == APR_ECONNRESET \
1166 || (s) == APR_OS_START_SYSERR + WSAECONNRESET)
1167 /* XXX deprecated */
1168 #define APR_STATUS_IS_ETIMEDOUT(s) ((s) == APR_ETIMEDOUT \
1169 || (s) == APR_OS_START_SYSERR + WSAETIMEDOUT \
1170 || (s) == APR_OS_START_SYSERR + WAIT_TIMEOUT)
1171 #undef APR_STATUS_IS_TIMEUP
1172 #define APR_STATUS_IS_TIMEUP(s) ((s) == APR_TIMEUP \
1173 || (s) == APR_OS_START_SYSERR + WSAETIMEDOUT \
1174 || (s) == APR_OS_START_SYSERR + WAIT_TIMEOUT)
1175 #define APR_STATUS_IS_EHOSTUNREACH(s) ((s) == APR_EHOSTUNREACH \
1176 || (s) == APR_OS_START_SYSERR + WSAEHOSTUNREACH)
1177 #define APR_STATUS_IS_ENETUNREACH(s) ((s) == APR_ENETUNREACH \
1178 || (s) == APR_OS_START_SYSERR + WSAENETUNREACH)
1179 #define APR_STATUS_IS_ENETDOWN(s) ((s) == APR_OS_START_SYSERR + WSAENETDOWN)
1180 #define APR_STATUS_IS_EFTYPE(s) ((s) == APR_EFTYPE)
1181 #define APR_STATUS_IS_EPIPE(s) ((s) == APR_EPIPE)
1182 #define APR_STATUS_IS_EXDEV(s) ((s) == APR_EXDEV)
1183 #define APR_STATUS_IS_ENOTEMPTY(s) ((s) == APR_ENOTEMPTY)
1184 #define APR_STATUS_IS_EAFNOSUPPORT(s) ((s) == APR_EAFNOSUPPORT \
1185 || (s) == APR_OS_START_SYSERR + WSAEAFNOSUPPORT)
1187 #else /* !defined(NETWARE) && !defined(OS2) && !defined(WIN32) */
1190 * os error codes are clib error codes
1192 #define APR_FROM_OS_ERROR(e) (e)
1193 #define APR_TO_OS_ERROR(e) (e)
1195 #define apr_get_os_error() (errno)
1196 #define apr_set_os_error(e) (errno = (e))
1198 /* A special case, only socket calls require this:
1200 #define apr_get_netos_error() (errno)
1201 #define apr_set_netos_error(e) (errno = (e))
1204 * @addtogroup APR_STATUS_IS
1208 /** permission denied */
1209 #define APR_STATUS_IS_EACCES(s) ((s) == APR_EACCES)
1211 #define APR_STATUS_IS_EEXIST(s) ((s) == APR_EEXIST)
1212 /** path name is too long */
1213 #define APR_STATUS_IS_ENAMETOOLONG(s) ((s) == APR_ENAMETOOLONG)
1215 * no such file or directory
1217 * EMVSCATLG can be returned by the automounter on z/OS for
1218 * paths which do not exist.
1221 #define APR_STATUS_IS_ENOENT(s) ((s) == APR_ENOENT \
1222 || (s) == EMVSCATLG)
1224 #define APR_STATUS_IS_ENOENT(s) ((s) == APR_ENOENT)
1226 /** not a directory */
1227 #define APR_STATUS_IS_ENOTDIR(s) ((s) == APR_ENOTDIR)
1228 /** no space left on device */
1230 #define APR_STATUS_IS_ENOSPC(s) ((s) == APR_ENOSPC \
1233 #define APR_STATUS_IS_ENOSPC(s) ((s) == APR_ENOSPC)
1235 /** not enough memory */
1236 #define APR_STATUS_IS_ENOMEM(s) ((s) == APR_ENOMEM)
1237 /** too many open files */
1238 #define APR_STATUS_IS_EMFILE(s) ((s) == APR_EMFILE)
1239 /** file table overflow */
1240 #define APR_STATUS_IS_ENFILE(s) ((s) == APR_ENFILE)
1242 #define APR_STATUS_IS_EBADF(s) ((s) == APR_EBADF)
1243 /** invalid argument */
1244 #define APR_STATUS_IS_EINVAL(s) ((s) == APR_EINVAL)
1246 #define APR_STATUS_IS_ESPIPE(s) ((s) == APR_ESPIPE)
1248 /** operation would block */
1249 #if !defined(EWOULDBLOCK) || !defined(EAGAIN)
1250 #define APR_STATUS_IS_EAGAIN(s) ((s) == APR_EAGAIN)
1251 #elif (EWOULDBLOCK == EAGAIN)
1252 #define APR_STATUS_IS_EAGAIN(s) ((s) == APR_EAGAIN)
1254 #define APR_STATUS_IS_EAGAIN(s) ((s) == APR_EAGAIN \
1255 || (s) == EWOULDBLOCK)
1258 /** interrupted system call */
1259 #define APR_STATUS_IS_EINTR(s) ((s) == APR_EINTR)
1260 /** socket operation on a non-socket */
1261 #define APR_STATUS_IS_ENOTSOCK(s) ((s) == APR_ENOTSOCK)
1262 /** Connection Refused */
1263 #define APR_STATUS_IS_ECONNREFUSED(s) ((s) == APR_ECONNREFUSED)
1264 /** operation now in progress */
1265 #define APR_STATUS_IS_EINPROGRESS(s) ((s) == APR_EINPROGRESS)
1268 * Software caused connection abort
1270 * EPROTO on certain older kernels really means ECONNABORTED, so we need to
1271 * ignore it for them. See discussion in new-httpd archives nh.9701 & nh.9603
1273 * There is potentially a bug in Solaris 2.x x<6, and other boxes that
1274 * implement tcp sockets in userland (i.e. on top of STREAMS). On these
1275 * systems, EPROTO can actually result in a fatal loop. See PR#981 for
1276 * example. It's hard to handle both uses of EPROTO.
1279 #define APR_STATUS_IS_ECONNABORTED(s) ((s) == APR_ECONNABORTED \
1282 #define APR_STATUS_IS_ECONNABORTED(s) ((s) == APR_ECONNABORTED)
1285 /** Connection Reset by peer */
1286 #define APR_STATUS_IS_ECONNRESET(s) ((s) == APR_ECONNRESET)
1287 /** Operation timed out
1289 #define APR_STATUS_IS_ETIMEDOUT(s) ((s) == APR_ETIMEDOUT)
1290 /** no route to host */
1291 #define APR_STATUS_IS_EHOSTUNREACH(s) ((s) == APR_EHOSTUNREACH)
1292 /** network is unreachable */
1293 #define APR_STATUS_IS_ENETUNREACH(s) ((s) == APR_ENETUNREACH)
1294 /** inappropiate file type or format */
1295 #define APR_STATUS_IS_EFTYPE(s) ((s) == APR_EFTYPE)
1297 #define APR_STATUS_IS_EPIPE(s) ((s) == APR_EPIPE)
1298 /** cross device link */
1299 #define APR_STATUS_IS_EXDEV(s) ((s) == APR_EXDEV)
1300 /** Directory Not Empty */
1301 #define APR_STATUS_IS_ENOTEMPTY(s) ((s) == APR_ENOTEMPTY || \
1303 /** Address Family not supported */
1304 #define APR_STATUS_IS_EAFNOSUPPORT(s) ((s) == APR_EAFNOSUPPORT)
1307 #endif /* !defined(NETWARE) && !defined(OS2) && !defined(WIN32) */
1315 #endif /* ! APR_ERRNO_H */