home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 November / CMCD1104.ISO / Software / Complet / Apache / apache_2.0.52-win32-x86-no_ssl.msi / Data.Cab / F277201_apr_errno.h < prev    next >
C/C++ Source or Header  |  2004-03-15  |  52KB  |  1,209 lines

  1. /* Copyright 2000-2004 The Apache Software Foundation
  2.  *
  3.  * Licensed under the Apache License, Version 2.0 (the "License");
  4.  * you may not use this file except in compliance with the License.
  5.  * You may obtain a copy of the License at
  6.  *
  7.  *     http://www.apache.org/licenses/LICENSE-2.0
  8.  *
  9.  * Unless required by applicable law or agreed to in writing, software
  10.  * distributed under the License is distributed on an "AS IS" BASIS,
  11.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12.  * See the License for the specific language governing permissions and
  13.  * limitations under the License.
  14.  */
  15.  
  16. #ifndef APR_ERRNO_H
  17. #define APR_ERRNO_H
  18.  
  19. /**
  20.  * @file apr_errno.h
  21.  * @brief APR Error Codes
  22.  */
  23.  
  24. #include "apr.h"
  25.  
  26. #if APR_HAVE_ERRNO_H
  27. #include <errno.h>
  28. #endif
  29.  
  30. #ifdef __cplusplus
  31. extern "C" {
  32. #endif /* __cplusplus */
  33.  
  34. /**
  35.  * @defgroup apr_errno Error Codes
  36.  * @ingroup APR 
  37.  * @{
  38.  */
  39.  
  40. /**
  41.  * Type for specifying an error or status code.
  42.  */
  43. typedef int apr_status_t;
  44.  
  45. /**
  46.  * Return a human readable string describing the specified error.
  47.  * @param statcode The error code the get a string for.
  48.  * @param buf A buffer to hold the error string.
  49.  * @param bufsize Size of the buffer to hold the string.
  50.  */
  51. APR_DECLARE(char *) apr_strerror(apr_status_t statcode, char *buf, 
  52.                                  apr_size_t bufsize);
  53.  
  54. #if defined(DOXYGEN)
  55. /**
  56.  * @def APR_FROM_OS_ERROR(os_err_type syserr)
  57.  * Fold a platform specific error into an apr_status_t code.
  58.  * @return apr_status_t
  59.  * @param e The platform os error code.
  60.  * @warning  macro implementation; the syserr argument may be evaluated
  61.  *      multiple times.
  62.  */
  63. #define APR_FROM_OS_ERROR(e) (e == 0 ? APR_SUCCESS : e + APR_OS_START_SYSERR)
  64.  
  65. /**
  66.  * @def APR_TO_OS_ERROR(apr_status_t statcode)
  67.  * @return os_err_type
  68.  * Fold an apr_status_t code back to the native platform defined error.
  69.  * @param e The apr_status_t folded platform os error code.
  70.  * @warning  macro implementation; the statcode argument may be evaluated
  71.  *      multiple times.  If the statcode was not created by apr_get_os_error 
  72.  *      or APR_FROM_OS_ERROR, the results are undefined.
  73.  */
  74. #define APR_TO_OS_ERROR(e) (e == 0 ? APR_SUCCESS : e - APR_OS_START_SYSERR)
  75.  
  76. /** @def apr_get_os_error()
  77.  * @return apr_status_t the last platform error, folded into apr_status_t, on most platforms
  78.  * @remark This retrieves errno, or calls a GetLastError() style function, and
  79.  *      folds it with APR_FROM_OS_ERROR.  Some platforms (such as OS2) have no
  80.  *      such mechanism, so this call may be unsupported.  Do NOT use this
  81.  *      call for socket errors from socket, send, recv etc!
  82.  */
  83.  
  84. /** @def apr_set_os_error(e)
  85.  * Reset the last platform error, unfolded from an apr_status_t, on some platforms
  86.  * @param e The OS error folded in a prior call to APR_FROM_OS_ERROR()
  87.  * @warning This is a macro implementation; the statcode argument may be evaluated
  88.  *      multiple times.  If the statcode was not created by apr_get_os_error
  89.  *      or APR_FROM_OS_ERROR, the results are undefined.  This macro sets
  90.  *      errno, or calls a SetLastError() style function, unfolding statcode
  91.  *      with APR_TO_OS_ERROR.  Some platforms (such as OS2) have no such
  92.  *      mechanism, so this call may be unsupported.
  93.  */
  94.  
  95. /** @def apr_get_netos_error()
  96.  * Return the last socket error, folded into apr_status_t, on all platforms
  97.  * @remark This retrieves errno or calls a GetLastSocketError() style function,
  98.  *      and folds it with APR_FROM_OS_ERROR.
  99.  */
  100.  
  101. /** @def apr_set_netos_error(e)
  102.  * Reset the last socket error, unfolded from an apr_status_t
  103.  * @param e The socket error folded in a prior call to APR_FROM_OS_ERROR()
  104.  * @warning This is a macro implementation; the statcode argument may be evaluated
  105.  *      multiple times.  If the statcode was not created by apr_get_os_error
  106.  *      or APR_FROM_OS_ERROR, the results are undefined.  This macro sets
  107.  *      errno, or calls a WSASetLastError() style function, unfolding 
  108.  *      socketcode with APR_TO_OS_ERROR.
  109.  */
  110.  
  111. #endif /* defined(DOXYGEN) */
  112.  
  113. /**
  114.  * APR_OS_START_ERROR is where the APR specific error values start.
  115.  */
  116. #define APR_OS_START_ERROR     20000
  117. /**
  118.  * APR_OS_ERRSPACE_SIZE is the maximum number of errors you can fit
  119.  *    into one of the error/status ranges below -- except for
  120.  *    APR_OS_START_USERERR, which see.
  121.  */
  122. #define APR_OS_ERRSPACE_SIZE 50000
  123. /**
  124.  * APR_OS_START_STATUS is where the APR specific status codes start.
  125.  */
  126. #define APR_OS_START_STATUS    (APR_OS_START_ERROR + APR_OS_ERRSPACE_SIZE)
  127. /**
  128.  * APR_OS_START_USERERR are reserved for applications that use APR that
  129.  *     layer their own error codes along with APR's.  Note that the
  130.  *     error immediately following this one is set ten times farther
  131.  *     away than usual, so that users of apr have a lot of room in
  132.  *     which to declare custom error codes.
  133.  */
  134. #define APR_OS_START_USERERR    (APR_OS_START_STATUS + APR_OS_ERRSPACE_SIZE)
  135. /**
  136.  * APR_OS_START_USEERR is obsolete, defined for compatibility only.
  137.  * Use APR_OS_START_USERERR instead.
  138.  */
  139. #define APR_OS_START_USEERR     APR_OS_START_USERERR
  140. /**
  141.  * APR_OS_START_CANONERR is where APR versions of errno values are defined
  142.  *     on systems which don't have the corresponding errno.
  143.  */
  144. #define APR_OS_START_CANONERR  (APR_OS_START_USERERR \
  145.                                  + (APR_OS_ERRSPACE_SIZE * 10))
  146. /**
  147.  * APR_OS_START_EAIERR folds EAI_ error codes from getaddrinfo() into 
  148.  *     apr_status_t values.
  149.  */
  150. #define APR_OS_START_EAIERR    (APR_OS_START_CANONERR + APR_OS_ERRSPACE_SIZE)
  151. /**
  152.  * APR_OS_START_SYSERR folds platform-specific system error values into 
  153.  *     apr_status_t values.
  154.  */
  155. #define APR_OS_START_SYSERR    (APR_OS_START_EAIERR + APR_OS_ERRSPACE_SIZE)
  156.  
  157. /** no error. @see APR_STATUS_IS_SUCCESS */
  158. #define APR_SUCCESS 0
  159.  
  160. /** 
  161.  * @defgroup APR_Error APR Error Values
  162.  * <PRE>
  163.  * <b>APR ERROR VALUES</b>
  164.  * APR_ENOSTAT      APR was unable to perform a stat on the file 
  165.  * APR_ENOPOOL      APR was not provided a pool with which to allocate memory
  166.  * APR_EBADDATE     APR was given an invalid date 
  167.  * APR_EINVALSOCK   APR was given an invalid socket
  168.  * APR_ENOPROC      APR was not given a process structure
  169.  * APR_ENOTIME      APR was not given a time structure
  170.  * APR_ENODIR       APR was not given a directory structure
  171.  * APR_ENOLOCK      APR was not given a lock structure
  172.  * APR_ENOPOLL      APR was not given a poll structure
  173.  * APR_ENOSOCKET    APR was not given a socket
  174.  * APR_ENOTHREAD    APR was not given a thread structure
  175.  * APR_ENOTHDKEY    APR was not given a thread key structure
  176.  * APR_ENOSHMAVAIL  There is no more shared memory available
  177.  * APR_EDSOOPEN     APR was unable to open the dso object.  For more 
  178.  *                  information call apr_dso_error().
  179.  * APR_EGENERAL     General failure (specific information not available)
  180.  * APR_EBADIP       The specified IP address is invalid
  181.  * APR_EBADMASK     The specified netmask is invalid
  182.  * APR_ESYMNOTFOUND Could not find the requested symbol
  183.  * </PRE>
  184.  *
  185.  * <PRE>
  186.  * <b>APR STATUS VALUES</b>
  187.  * APR_INCHILD        Program is currently executing in the child
  188.  * APR_INPARENT       Program is currently executing in the parent
  189.  * APR_DETACH         The thread is detached
  190.  * APR_NOTDETACH      The thread is not detached
  191.  * APR_CHILD_DONE     The child has finished executing
  192.  * APR_CHILD_NOTDONE  The child has not finished executing
  193.  * APR_TIMEUP         The operation did not finish before the timeout
  194.  * APR_INCOMPLETE     The operation was incomplete although some processing
  195.  *                    was performed and the results are partially valid
  196.  * APR_BADCH          Getopt found an option not in the option string
  197.  * APR_BADARG         Getopt found an option that is missing an argument 
  198.  *                    and an argument was specified in the option string
  199.  * APR_EOF            APR has encountered the end of the file
  200.  * APR_NOTFOUND       APR was unable to find the socket in the poll structure
  201.  * APR_ANONYMOUS      APR is using anonymous shared memory
  202.  * APR_FILEBASED      APR is using a file name as the key to the shared memory
  203.  * APR_KEYBASED       APR is using a shared key as the key to the shared memory
  204.  * APR_EINIT          Ininitalizer value.  If no option has been found, but 
  205.  *                    the status variable requires a value, this should be used
  206.  * APR_ENOTIMPL       The APR function has not been implemented on this 
  207.  *                    platform, either because nobody has gotten to it yet, 
  208.  *                    or the function is impossible on this platform.
  209.  * APR_EMISMATCH      Two passwords do not match.
  210.  * APR_EABSOLUTE      The given path was absolute.
  211.  * APR_ERELATIVE      The given path was relative.
  212.  * APR_EINCOMPLETE    The given path was neither relative nor absolute.
  213.  * APR_EABOVEROOT     The given path was above the root path.
  214.  * APR_EBUSY          The given lock was busy.
  215.  * APR_EPROC_UNKNOWN  The given process wasn't recognized by APR
  216.  * </PRE>
  217.  * @{
  218.  */
  219. /** @see APR_STATUS_IS_ENOSTAT */
  220. #define APR_ENOSTAT        (APR_OS_START_ERROR + 1)
  221. /** @see APR_STATUS_IS_ENOPOOL */
  222. #define APR_ENOPOOL        (APR_OS_START_ERROR + 2)
  223. /* empty slot: +3 */
  224. /** @see APR_STATUS_IS_EBADDATE */
  225. #define APR_EBADDATE       (APR_OS_START_ERROR + 4)
  226. /** @see APR_STATUS_IS_EINVALSOCK */
  227. #define APR_EINVALSOCK     (APR_OS_START_ERROR + 5)
  228. /** @see APR_STATUS_IS_ENOPROC */
  229. #define APR_ENOPROC        (APR_OS_START_ERROR + 6)
  230. /** @see APR_STATUS_IS_ENOTIME */
  231. #define APR_ENOTIME        (APR_OS_START_ERROR + 7)
  232. /** @see APR_STATUS_IS_ENODIR */
  233. #define APR_ENODIR         (APR_OS_START_ERROR + 8)
  234. /** @see APR_STATUS_IS_ENOLOCK */
  235. #define APR_ENOLOCK        (APR_OS_START_ERROR + 9)
  236. /** @see APR_STATUS_IS_ENOPOLL */
  237. #define APR_ENOPOLL        (APR_OS_START_ERROR + 10)
  238. /** @see APR_STATUS_IS_ENOSOCKET */
  239. #define APR_ENOSOCKET      (APR_OS_START_ERROR + 11)
  240. /** @see APR_STATUS_IS_ENOTHREAD */
  241. #define APR_ENOTHREAD      (APR_OS_START_ERROR + 12)
  242. /** @see APR_STATUS_IS_ENOTHDKEY */
  243. #define APR_ENOTHDKEY      (APR_OS_START_ERROR + 13)
  244. /** @see APR_STATUS_IS_EGENERAL */
  245. #define APR_EGENERAL       (APR_OS_START_ERROR + 14)
  246. /** @see APR_STATUS_IS_ENOSHMAVAIL */
  247. #define APR_ENOSHMAVAIL    (APR_OS_START_ERROR + 15)
  248. /** @see APR_STATUS_IS_EBADIP */
  249. #define APR_EBADIP         (APR_OS_START_ERROR + 16)
  250. /** @see APR_STATUS_IS_EBADMASK */
  251. #define APR_EBADMASK       (APR_OS_START_ERROR + 17)
  252. /* empty slot: +18 */
  253. /** @see APR_STATUS_IS_EDSOPEN */
  254. #define APR_EDSOOPEN       (APR_OS_START_ERROR + 19)
  255. /** @see APR_STATUS_IS_EABSOLUTE */
  256. #define APR_EABSOLUTE      (APR_OS_START_ERROR + 20)
  257. /** @see APR_STATUS_IS_ERELATIVE */
  258. #define APR_ERELATIVE      (APR_OS_START_ERROR + 21)
  259. /** @see APR_STATUS_IS_EINCOMPLETE */
  260. #define APR_EINCOMPLETE    (APR_OS_START_ERROR + 22)
  261. /** @see APR_STATUS_IS_EABOVEROOT */
  262. #define APR_EABOVEROOT     (APR_OS_START_ERROR + 23)
  263. /** @see APR_STATUS_IS_EBADPATH */
  264. #define APR_EBADPATH       (APR_OS_START_ERROR + 24)
  265. /** @see APR_STATUS_IS_EPATHWILD */
  266. #define APR_EPATHWILD      (APR_OS_START_ERROR + 25)
  267. /** @see APR_STATUS_IS_ESYMNOTFOUND */
  268. #define APR_ESYMNOTFOUND   (APR_OS_START_ERROR + 26)
  269. /** @see APR_STATUS_IS_EPROC_UNKNOWN */
  270. #define APR_EPROC_UNKNOWN  (APR_OS_START_ERROR + 27)
  271. /** @} */
  272.  
  273. /** 
  274.  * @defgroup APR_STATUS_IS Status Value Tests
  275.  * @warning For any particular error condition, more than one of these tests
  276.  *      may match. This is because platform-specific error codes may not
  277.  *      always match the semantics of the POSIX codes these tests (and the
  278.  *      correcponding APR error codes) are named after. A notable example
  279.  *      are the APR_STATUS_IS_ENOENT and APR_STATUS_IS_ENOTDIR tests on
  280.  *      Win32 platforms. The programmer should always be aware of this and
  281.  *      adjust the order of the tests accordingly.
  282.  * @{
  283.  */
  284. /** 
  285.  * APR was unable to perform a stat on the file 
  286.  * @warning always use this test, as platform-specific variances may meet this
  287.  * more than one error code 
  288.  */
  289. #define APR_STATUS_IS_ENOSTAT(s)        ((s) == APR_ENOSTAT)
  290. /** 
  291.  * APR was not provided a pool with which to allocate memory 
  292.  * @warning always use this test, as platform-specific variances may meet this
  293.  * more than one error code 
  294.  */
  295. #define APR_STATUS_IS_ENOPOOL(s)        ((s) == APR_ENOPOOL)
  296. /** APR was given an invalid date  */
  297. #define APR_STATUS_IS_EBADDATE(s)       ((s) == APR_EBADDATE)
  298. /** APR was given an invalid socket */
  299. #define APR_STATUS_IS_EINVALSOCK(s)     ((s) == APR_EINVALSOCK)
  300. /** APR was not given a process structure */
  301. #define APR_STATUS_IS_ENOPROC(s)        ((s) == APR_ENOPROC)
  302. /** APR was not given a time structure */
  303. #define APR_STATUS_IS_ENOTIME(s)        ((s) == APR_ENOTIME)
  304. /** APR was not given a directory structure */
  305. #define APR_STATUS_IS_ENODIR(s)         ((s) == APR_ENODIR)
  306. /** APR was not given a lock structure */
  307. #define APR_STATUS_IS_ENOLOCK(s)        ((s) == APR_ENOLOCK)
  308. /** APR was not given a poll structure */
  309. #define APR_STATUS_IS_ENOPOLL(s)        ((s) == APR_ENOPOLL)
  310. /** APR was not given a socket */
  311. #define APR_STATUS_IS_ENOSOCKET(s)      ((s) == APR_ENOSOCKET)
  312. /** APR was not given a thread structure */
  313. #define APR_STATUS_IS_ENOTHREAD(s)      ((s) == APR_ENOTHREAD)
  314. /** APR was not given a thread key structure */
  315. #define APR_STATUS_IS_ENOTHDKEY(s)      ((s) == APR_ENOTHDKEY)
  316. /** Generic Error which can not be put into another spot */
  317. #define APR_STATUS_IS_EGENERAL(s)       ((s) == APR_EGENERAL)
  318. /** There is no more shared memory available */
  319. #define APR_STATUS_IS_ENOSHMAVAIL(s)    ((s) == APR_ENOSHMAVAIL)
  320. /** The specified IP address is invalid */
  321. #define APR_STATUS_IS_EBADIP(s)         ((s) == APR_EBADIP)
  322. /** The specified netmask is invalid */
  323. #define APR_STATUS_IS_EBADMASK(s)       ((s) == APR_EBADMASK)
  324. /* empty slot: +18 */
  325. /** 
  326.  * APR was unable to open the dso object.  
  327.  * For more information call apr_dso_error().
  328.  */
  329. #if defined(WIN32)
  330. #define APR_STATUS_IS_EDSOOPEN(s)       ((s) == APR_EDSOOPEN \
  331.                        || APR_TO_OS_ERROR(s) == ERROR_MOD_NOT_FOUND)
  332. #else
  333. #define APR_STATUS_IS_EDSOOPEN(s)       ((s) == APR_EDSOOPEN)
  334. #endif
  335. /** The given path was absolute. */
  336. #define APR_STATUS_IS_EABSOLUTE(s)      ((s) == APR_EABSOLUTE)
  337. /** The given path was relative. */
  338. #define APR_STATUS_IS_ERELATIVE(s)      ((s) == APR_ERELATIVE)
  339. /** The given path was neither relative nor absolute. */
  340. #define APR_STATUS_IS_EINCOMPLETE(s)    ((s) == APR_EINCOMPLETE)
  341. /** The given path was above the root path. */
  342. #define APR_STATUS_IS_EABOVEROOT(s)     ((s) == APR_EABOVEROOT)
  343. /** The given path was bad. */
  344. #define APR_STATUS_IS_EBADPATH(s)       ((s) == APR_EBADPATH)
  345. /** The given path contained wildcards. */
  346. #define APR_STATUS_IS_EPATHWILD(s)      ((s) == APR_EPATHWILD)
  347. /** Could not find the requested symbol.
  348.  * For more information call apr_dso_error().
  349.  */
  350. #if defined(WIN32)
  351. #define APR_STATUS_IS_ESYMNOTFOUND(s)   ((s) == APR_ESYMNOTFOUND \
  352.                        || APR_TO_OS_ERROR(s) == ERROR_PROC_NOT_FOUND)
  353. #else
  354. #define APR_STATUS_IS_ESYMNOTFOUND(s)   ((s) == APR_ESYMNOTFOUND)
  355. #endif
  356. /** The given process was not recognized by APR. */
  357. #define APR_STATUS_IS_EPROC_UNKNOWN(s)  ((s) == APR_EPROC_UNKNOWN)
  358.  
  359. /** @} */
  360.  
  361. /** 
  362.  * @addtogroup APR_Error
  363.  * @{
  364.  */
  365. /** @see APR_STATUS_IS_INCHILD */
  366. #define APR_INCHILD        (APR_OS_START_STATUS + 1)
  367. /** @see APR_STATUS_IS_INPARENT */
  368. #define APR_INPARENT       (APR_OS_START_STATUS + 2)
  369. /** @see APR_STATUS_IS_DETACH */
  370. #define APR_DETACH         (APR_OS_START_STATUS + 3)
  371. /** @see APR_STATUS_IS_NOTDETACH */
  372. #define APR_NOTDETACH      (APR_OS_START_STATUS + 4)
  373. /** @see APR_STATUS_IS_CHILD_DONE */
  374. #define APR_CHILD_DONE     (APR_OS_START_STATUS + 5)
  375. /** @see APR_STATUS_IS_CHILD_NOTDONE */
  376. #define APR_CHILD_NOTDONE  (APR_OS_START_STATUS + 6)
  377. /** @see APR_STATUS_IS_TIMEUP */
  378. #define APR_TIMEUP         (APR_OS_START_STATUS + 7)
  379. /** @see APR_STATUS_IS_INCOMPLETE */
  380. #define APR_INCOMPLETE     (APR_OS_START_STATUS + 8)
  381. /* empty slot: +9 */
  382. /* empty slot: +10 */
  383. /* empty slot: +11 */
  384. /** @see APR_STATUS_IS_BADCH */
  385. #define APR_BADCH          (APR_OS_START_STATUS + 12)
  386. /** @see APR_STATUS_IS_BADARG */
  387. #define APR_BADARG         (APR_OS_START_STATUS + 13)
  388. /** @see APR_STATUS_IS_EOF */
  389. #define APR_EOF            (APR_OS_START_STATUS + 14)
  390. /** @see APR_STATUS_IS_NOTFOUND */
  391. #define APR_NOTFOUND       (APR_OS_START_STATUS + 15)
  392. /* empty slot: +16 */
  393. /* empty slot: +17 */
  394. /* empty slot: +18 */
  395. /** @see APR_STATUS_IS_ANONYMOUS */
  396. #define APR_ANONYMOUS      (APR_OS_START_STATUS + 19)
  397. /** @see APR_STATUS_IS_FILEBASED */
  398. #define APR_FILEBASED      (APR_OS_START_STATUS + 20)
  399. /** @see APR_STATUS_IS_KEYBASED */
  400. #define APR_KEYBASED       (APR_OS_START_STATUS + 21)
  401. /** @see APR_STATUS_IS_EINIT */
  402. #define APR_EINIT          (APR_OS_START_STATUS + 22)  
  403. /** @see APR_STATUS_IS_ENOTIMPL */
  404. #define APR_ENOTIMPL       (APR_OS_START_STATUS + 23)
  405. /** @see APR_STATUS_IS_EMISMATCH */
  406. #define APR_EMISMATCH      (APR_OS_START_STATUS + 24)
  407. /** @see APR_STATUS_IS_EBUSY */
  408. #define APR_EBUSY          (APR_OS_START_STATUS + 25)
  409. /** @} */
  410.  
  411. /** 
  412.  * @addtogroup APR_STATUS_IS
  413.  * @{
  414.  */
  415. /** 
  416.  * Program is currently executing in the child 
  417.  * @warning
  418.  * always use this test, as platform-specific variances may meet this
  419.  * more than one error code */
  420. #define APR_STATUS_IS_INCHILD(s)        ((s) == APR_INCHILD)
  421. /** 
  422.  * Program is currently executing in the parent 
  423.  * @warning
  424.  * always use this test, as platform-specific variances may meet this
  425.  * more than one error code 
  426.  */
  427. #define APR_STATUS_IS_INPARENT(s)       ((s) == APR_INPARENT)
  428. /** 
  429.  * The thread is detached 
  430.  * @warning
  431.  * always use this test, as platform-specific variances may meet this
  432.  * more than one error code 
  433.  */
  434. #define APR_STATUS_IS_DETACH(s)         ((s) == APR_DETACH)
  435. /** 
  436.  * The thread is not detached 
  437.  * @warning
  438.  * always use this test, as platform-specific variances may meet this
  439.  * more than one error code 
  440.  */
  441. #define APR_STATUS_IS_NOTDETACH(s)      ((s) == APR_NOTDETACH)
  442. /** 
  443.  * The child has finished executing
  444.  * @warning
  445.  * always use this test, as platform-specific variances may meet this
  446.  * more than one error code 
  447.  */
  448. #define APR_STATUS_IS_CHILD_DONE(s)     ((s) == APR_CHILD_DONE)
  449. /** 
  450.  * The child has not finished executing
  451.  * @warning
  452.  * always use this test, as platform-specific variances may meet this
  453.  * more than one error code 
  454.  */
  455. #define APR_STATUS_IS_CHILD_NOTDONE(s)  ((s) == APR_CHILD_NOTDONE)
  456. /** 
  457.  * The operation did not finish before the timeout
  458.  * @warning
  459.  * always use this test, as platform-specific variances may meet this
  460.  * more than one error code 
  461.  */
  462. #define APR_STATUS_IS_TIMEUP(s)         ((s) == APR_TIMEUP)
  463. /** 
  464.  * The character conversion stopped because of an incomplete character or 
  465.  * shift sequence at the end  of the input buffer.
  466.  * @warning
  467.  * always use this test, as platform-specific variances may meet this
  468.  * more than one error code 
  469.  */
  470. #define APR_STATUS_IS_INCOMPLETE(s)     ((s) == APR_INCOMPLETE)
  471. /* empty slot: +9 */
  472. /* empty slot: +10 */
  473. /* empty slot: +11 */
  474. /** 
  475.  * Getopt found an option not in the option string
  476.  * @warning
  477.  * always use this test, as platform-specific variances may meet this
  478.  * more than one error code 
  479.  */
  480. #define APR_STATUS_IS_BADCH(s)          ((s) == APR_BADCH)
  481. /** 
  482.  * Getopt found an option not in the option string and an argument was 
  483.  * specified in the option string
  484.  * @warning
  485.  * always use this test, as platform-specific variances may meet this
  486.  * more than one error code 
  487.  */
  488. #define APR_STATUS_IS_BADARG(s)         ((s) == APR_BADARG)
  489. /** 
  490.  * APR has encountered the end of the file
  491.  * @warning
  492.  * always use this test, as platform-specific variances may meet this
  493.  * more than one error code 
  494.  */
  495. #define APR_STATUS_IS_EOF(s)            ((s) == APR_EOF)
  496. /** 
  497.  * APR was unable to find the socket in the poll structure
  498.  * @warning
  499.  * always use this test, as platform-specific variances may meet this
  500.  * more than one error code 
  501.  */
  502. #define APR_STATUS_IS_NOTFOUND(s)       ((s) == APR_NOTFOUND)
  503. /* empty slot: +16 */
  504. /* empty slot: +17 */
  505. /* empty slot: +18 */
  506. /** 
  507.  * APR is using anonymous shared memory
  508.  * @warning
  509.  * always use this test, as platform-specific variances may meet this
  510.  * more than one error code 
  511.  */
  512. #define APR_STATUS_IS_ANONYMOUS(s)      ((s) == APR_ANONYMOUS)
  513. /** 
  514.  * APR is using a file name as the key to the shared memory
  515.  * @warning
  516.  * always use this test, as platform-specific variances may meet this
  517.  * more than one error code 
  518.  */
  519. #define APR_STATUS_IS_FILEBASED(s)      ((s) == APR_FILEBASED)
  520. /** 
  521.  * APR is using a shared key as the key to the shared memory
  522.  * @warning
  523.  * always use this test, as platform-specific variances may meet this
  524.  * more than one error code 
  525.  */
  526. #define APR_STATUS_IS_KEYBASED(s)       ((s) == APR_KEYBASED)
  527. /** 
  528.  * Ininitalizer value.  If no option has been found, but 
  529.  * the status variable requires a value, this should be used
  530.  * @warning
  531.  * always use this test, as platform-specific variances may meet this
  532.  * more than one error code 
  533.  */
  534. #define APR_STATUS_IS_EINIT(s)          ((s) == APR_EINIT)
  535. /** 
  536.  * The APR function has not been implemented on this 
  537.  * platform, either because nobody has gotten to it yet, 
  538.  * or the function is impossible on this platform.
  539.  * @warning
  540.  * always use this test, as platform-specific variances may meet this
  541.  * more than one error code 
  542.  */
  543. #define APR_STATUS_IS_ENOTIMPL(s)       ((s) == APR_ENOTIMPL)
  544. /** 
  545.  * Two passwords do not match.
  546.  * @warning
  547.  * always use this test, as platform-specific variances may meet this
  548.  * more than one error code 
  549.  */
  550. #define APR_STATUS_IS_EMISMATCH(s)      ((s) == APR_EMISMATCH)
  551. /** 
  552.  * The given lock was busy
  553.  * @warning always use this test, as platform-specific variances may meet this
  554.  * more than one error code 
  555.  */
  556. #define APR_STATUS_IS_EBUSY(s)          ((s) == APR_EBUSY)
  557.  
  558. /** @} */
  559.  
  560. /** 
  561.  * @addtogroup APR_Error APR Error Values
  562.  * @{
  563.  */
  564. /* APR CANONICAL ERROR VALUES */
  565. /** @see APR_STATUS_IS_EACCES */
  566. #ifdef EACCES
  567. #define APR_EACCES EACCES
  568. #else
  569. #define APR_EACCES         (APR_OS_START_CANONERR + 1)
  570. #endif
  571.  
  572. /** @see APR_STATUS_IS_EXIST */
  573. #ifdef EEXIST
  574. #define APR_EEXIST EEXIST
  575. #else
  576. #define APR_EEXIST         (APR_OS_START_CANONERR + 2)
  577. #endif
  578.  
  579. /** @see APR_STATUS_IS_ENAMETOOLONG */
  580. #ifdef ENAMETOOLONG
  581. #define APR_ENAMETOOLONG ENAMETOOLONG
  582. #else
  583. #define APR_ENAMETOOLONG   (APR_OS_START_CANONERR + 3)
  584. #endif
  585.  
  586. /** @see APR_STATUS_IS_ENOENT */
  587. #ifdef ENOENT
  588. #define APR_ENOENT ENOENT
  589. #else
  590. #define APR_ENOENT         (APR_OS_START_CANONERR + 4)
  591. #endif
  592.  
  593. /** @see APR_STATUS_IS_ENOTDIR */
  594. #ifdef ENOTDIR
  595. #define APR_ENOTDIR ENOTDIR
  596. #else
  597. #define APR_ENOTDIR        (APR_OS_START_CANONERR + 5)
  598. #endif
  599.  
  600. /** @see APR_STATUS_IS_ENOSPC */
  601. #ifdef ENOSPC
  602. #define APR_ENOSPC ENOSPC
  603. #else
  604. #define APR_ENOSPC         (APR_OS_START_CANONERR + 6)
  605. #endif
  606.  
  607. /** @see APR_STATUS_IS_ENOMEM */
  608. #ifdef ENOMEM
  609. #define APR_ENOMEM ENOMEM
  610. #else
  611. #define APR_ENOMEM         (APR_OS_START_CANONERR + 7)
  612. #endif
  613.  
  614. /** @see APR_STATUS_IS_EMFILE */
  615. #ifdef EMFILE
  616. #define APR_EMFILE EMFILE
  617. #else
  618. #define APR_EMFILE         (APR_OS_START_CANONERR + 8)
  619. #endif
  620.  
  621. /** @see APR_STATUS_IS_ENFILE */
  622. #ifdef ENFILE
  623. #define APR_ENFILE ENFILE
  624. #else
  625. #define APR_ENFILE         (APR_OS_START_CANONERR + 9)
  626. #endif
  627.  
  628. /** @see APR_STATUS_IS_EBADF */
  629. #ifdef EBADF
  630. #define APR_EBADF EBADF
  631. #else
  632. #define APR_EBADF          (APR_OS_START_CANONERR + 10)
  633. #endif
  634.  
  635. /** @see APR_STATUS_IS_EINVAL */
  636. #ifdef EINVAL
  637. #define APR_EINVAL EINVAL
  638. #else
  639. #define APR_EINVAL         (APR_OS_START_CANONERR + 11)
  640. #endif
  641.  
  642. /** @see APR_STATUS_IS_ESPIPE */
  643. #ifdef ESPIPE
  644. #define APR_ESPIPE ESPIPE
  645. #else
  646. #define APR_ESPIPE         (APR_OS_START_CANONERR + 12)
  647. #endif
  648.  
  649. /** 
  650.  * @see APR_STATUS_IS_EAGAIN 
  651.  * @warning use APR_STATUS_IS_EAGAIN instead of just testing this value
  652.  */
  653. #ifdef EAGAIN
  654. #define APR_EAGAIN EAGAIN
  655. #elif defined(EWOULDBLOCK)
  656. #define APR_EAGAIN EWOULDBLOCK
  657. #else
  658. #define APR_EAGAIN         (APR_OS_START_CANONERR + 13)
  659. #endif
  660.  
  661. /** @see APR_STATUS_IS_EINTR */
  662. #ifdef EINTR
  663. #define APR_EINTR EINTR
  664. #else
  665. #define APR_EINTR          (APR_OS_START_CANONERR + 14)
  666. #endif
  667.  
  668. /** @see APR_STATUS_IS_ENOTSOCK */
  669. #ifdef ENOTSOCK
  670. #define APR_ENOTSOCK ENOTSOCK
  671. #else
  672. #define APR_ENOTSOCK       (APR_OS_START_CANONERR + 15)
  673. #endif
  674.  
  675. /** @see APR_STATUS_IS_ECONNREFUSED */
  676. #ifdef ECONNREFUSED
  677. #define APR_ECONNREFUSED ECONNREFUSED
  678. #else
  679. #define APR_ECONNREFUSED   (APR_OS_START_CANONERR + 16)
  680. #endif
  681.  
  682. /** @see APR_STATUS_IS_EINPROGRESS */
  683. #ifdef EINPROGRESS
  684. #define APR_EINPROGRESS EINPROGRESS
  685. #else
  686. #define APR_EINPROGRESS    (APR_OS_START_CANONERR + 17)
  687. #endif
  688.  
  689. /** 
  690.  * @see APR_STATUS_IS_ECONNABORTED
  691.  * @warning use APR_STATUS_IS_ECONNABORTED instead of just testing this value
  692.  */
  693.  
  694. #ifdef ECONNABORTED
  695. #define APR_ECONNABORTED ECONNABORTED
  696. #else
  697. #define APR_ECONNABORTED   (APR_OS_START_CANONERR + 18)
  698. #endif
  699.  
  700. /** @see APR_STATUS_IS_ECONNRESET */
  701. #ifdef ECONNRESET
  702. #define APR_ECONNRESET ECONNRESET
  703. #else
  704. #define APR_ECONNRESET     (APR_OS_START_CANONERR + 19)
  705. #endif
  706.  
  707. /** @see APR_STATUS_IS_ETIMEDOUT */
  708. #ifdef ETIMEDOUT
  709. #define APR_ETIMEDOUT ETIMEDOUT
  710. #else
  711. #define APR_ETIMEDOUT      (APR_OS_START_CANONERR + 20)
  712. #endif
  713.  
  714. /** @see APR_STATUS_IS_EHOSTUNREACH */
  715. #ifdef EHOSTUNREACH
  716. #define APR_EHOSTUNREACH EHOSTUNREACH
  717. #else
  718. #define APR_EHOSTUNREACH   (APR_OS_START_CANONERR + 21)
  719. #endif
  720.  
  721. /** @see APR_STATUS_IS_ENETUNREACH */
  722. #ifdef ENETUNREACH
  723. #define APR_ENETUNREACH ENETUNREACH
  724. #else
  725. #define APR_ENETUNREACH    (APR_OS_START_CANONERR + 22)
  726. #endif
  727.  
  728. /** @see APR_STATUS_IS_EFTYPE */
  729. #ifdef EFTYPE
  730. #define APR_EFTYPE EFTYPE
  731. #else
  732. #define APR_EFTYPE        (APR_OS_START_CANONERR + 23)
  733. #endif
  734.  
  735. /** @see APR_STATUS_IS_EPIPE */
  736. #ifdef EPIPE
  737. #define APR_EPIPE EPIPE
  738. #else
  739. #define APR_EPIPE         (APR_OS_START_CANONERR + 24)
  740. #endif
  741.  
  742. /** @see APR_STATUS_IS_EXDEV */
  743. #ifdef EXDEV
  744. #define APR_EXDEV EXDEV
  745. #else
  746. #define APR_EXDEV         (APR_OS_START_CANONERR + 25)
  747. #endif
  748.  
  749. /** @see APR_STATUS_IS_ENOTEMPTY */
  750. #ifdef ENOTEMPTY
  751. #define APR_ENOTEMPTY ENOTEMPTY
  752. #else
  753. #define APR_ENOTEMPTY     (APR_OS_START_CANONERR + 26)
  754. #endif
  755.  
  756. /** @} */
  757.  
  758. #if defined(OS2) && !defined(DOXYGEN)
  759.  
  760. #define APR_FROM_OS_ERROR(e) (e == 0 ? APR_SUCCESS : e + APR_OS_START_SYSERR)
  761. #define APR_TO_OS_ERROR(e)   (e == 0 ? APR_SUCCESS : e - APR_OS_START_SYSERR)
  762.  
  763. #define INCL_DOSERRORS
  764. #define INCL_DOS
  765.  
  766. /* Leave these undefined.
  767.  * OS2 doesn't rely on the errno concept.
  768.  * The API calls always return a result codes which
  769.  * should be filtered through APR_FROM_OS_ERROR().
  770.  *
  771.  * #define apr_get_os_error()   (APR_FROM_OS_ERROR(GetLastError()))
  772.  * #define apr_set_os_error(e)  (SetLastError(APR_TO_OS_ERROR(e)))
  773.  */
  774.  
  775. /* A special case, only socket calls require this;
  776.  */
  777. #define apr_get_netos_error()   (APR_FROM_OS_ERROR(errno))
  778. #define apr_set_netos_error(e)  (errno = APR_TO_OS_ERROR(e))
  779.  
  780. /* And this needs to be greped away for good:
  781.  */
  782. #define APR_OS2_STATUS(e) (APR_FROM_OS_ERROR(e))
  783.  
  784. #define APR_STATUS_IS_SUCCESS(s)           ((s) == APR_SUCCESS \
  785.                 || (s) == APR_OS_START_SYSERR + NO_ERROR)
  786.  
  787. /* These can't sit in a private header, so in spite of the extra size, 
  788.  * they need to be made available here.
  789.  */
  790. #define SOCBASEERR              10000
  791. #define SOCEPERM                (SOCBASEERR+1)             /* Not owner */
  792. #define SOCESRCH                (SOCBASEERR+3)             /* No such process */
  793. #define SOCEINTR                (SOCBASEERR+4)             /* Interrupted system call */
  794. #define SOCENXIO                (SOCBASEERR+6)             /* No such device or address */
  795. #define SOCEBADF                (SOCBASEERR+9)             /* Bad file number */
  796. #define SOCEACCES               (SOCBASEERR+13)            /* Permission denied */
  797. #define SOCEFAULT               (SOCBASEERR+14)            /* Bad address */
  798. #define SOCEINVAL               (SOCBASEERR+22)            /* Invalid argument */
  799. #define SOCEMFILE               (SOCBASEERR+24)            /* Too many open files */
  800. #define SOCEPIPE                (SOCBASEERR+32)            /* Broken pipe */
  801. #define SOCEOS2ERR              (SOCBASEERR+100)           /* OS/2 Error */
  802. #define SOCEWOULDBLOCK          (SOCBASEERR+35)            /* Operation would block */
  803. #define SOCEINPROGRESS          (SOCBASEERR+36)            /* Operation now in progress */
  804. #define SOCEALREADY             (SOCBASEERR+37)            /* Operation already in progress */
  805. #define SOCENOTSOCK             (SOCBASEERR+38)            /* Socket operation on non-socket */
  806. #define SOCEDESTADDRREQ         (SOCBASEERR+39)            /* Destination address required */
  807. #define SOCEMSGSIZE             (SOCBASEERR+40)            /* Message too long */
  808. #define SOCEPROTOTYPE           (SOCBASEERR+41)            /* Protocol wrong type for socket */
  809. #define SOCENOPROTOOPT          (SOCBASEERR+42)            /* Protocol not available */
  810. #define SOCEPROTONOSUPPORT      (SOCBASEERR+43)            /* Protocol not supported */
  811. #define SOCESOCKTNOSUPPORT      (SOCBASEERR+44)            /* Socket type not supported */
  812. #define SOCEOPNOTSUPP           (SOCBASEERR+45)            /* Operation not supported on socket */
  813. #define SOCEPFNOSUPPORT         (SOCBASEERR+46)            /* Protocol family not supported */
  814. #define SOCEAFNOSUPPORT         (SOCBASEERR+47)            /* Address family not supported by protocol family */
  815. #define SOCEADDRINUSE           (SOCBASEERR+48)            /* Address already in use */
  816. #define SOCEADDRNOTAVAIL        (SOCBASEERR+49)            /* Can't assign requested address */
  817. #define SOCENETDOWN             (SOCBASEERR+50)            /* Network is down */
  818. #define SOCENETUNREACH          (SOCBASEERR+51)            /* Network is unreachable */
  819. #define SOCENETRESET            (SOCBASEERR+52)            /* Network dropped connection on reset */
  820. #define SOCECONNABORTED         (SOCBASEERR+53)            /* Software caused connection abort */
  821. #define SOCECONNRESET           (SOCBASEERR+54)            /* Connection reset by peer */
  822. #define SOCENOBUFS              (SOCBASEERR+55)            /* No buffer space available */
  823. #define SOCEISCONN              (SOCBASEERR+56)            /* Socket is already connected */
  824. #define SOCENOTCONN             (SOCBASEERR+57)            /* Socket is not connected */
  825. #define SOCESHUTDOWN            (SOCBASEERR+58)            /* Can't send after socket shutdown */
  826. #define SOCETOOMANYREFS         (SOCBASEERR+59)            /* Too many references: can't splice */
  827. #define SOCETIMEDOUT            (SOCBASEERR+60)            /* Connection timed out */
  828. #define SOCECONNREFUSED         (SOCBASEERR+61)            /* Connection refused */
  829. #define SOCELOOP                (SOCBASEERR+62)            /* Too many levels of symbolic links */
  830. #define SOCENAMETOOLONG         (SOCBASEERR+63)            /* File name too long */
  831. #define SOCEHOSTDOWN            (SOCBASEERR+64)            /* Host is down */
  832. #define SOCEHOSTUNREACH         (SOCBASEERR+65)            /* No route to host */
  833. #define SOCENOTEMPTY            (SOCBASEERR+66)            /* Directory not empty */
  834.  
  835. /* APR CANONICAL ERROR TESTS */
  836. #define APR_STATUS_IS_EACCES(s)         ((s) == APR_EACCES \
  837.                 || (s) == APR_OS_START_SYSERR + ERROR_ACCESS_DENIED \
  838.                 || (s) == APR_OS_START_SYSERR + ERROR_SHARING_VIOLATION)
  839. #define APR_STATUS_IS_EEXIST(s)         ((s) == APR_EEXIST \
  840.                 || (s) == APR_OS_START_SYSERR + ERROR_OPEN_FAILED \
  841.                 || (s) == APR_OS_START_SYSERR + ERROR_FILE_EXISTS \
  842.                 || (s) == APR_OS_START_SYSERR + ERROR_ALREADY_EXISTS \
  843.                 || (s) == APR_OS_START_SYSERR + ERROR_ACCESS_DENIED)
  844. #define APR_STATUS_IS_ENAMETOOLONG(s)   ((s) == APR_ENAMETOOLONG \
  845.                 || (s) == APR_OS_START_SYSERR + ERROR_FILENAME_EXCED_RANGE \
  846.                 || (s) == APR_OS_START_SYSERR + SOCENAMETOOLONG)
  847. #define APR_STATUS_IS_ENOENT(s)         ((s) == APR_ENOENT \
  848.                 || (s) == APR_OS_START_SYSERR + ERROR_FILE_NOT_FOUND \
  849.                 || (s) == APR_OS_START_SYSERR + ERROR_PATH_NOT_FOUND \
  850.                 || (s) == APR_OS_START_SYSERR + ERROR_NO_MORE_FILES \
  851.                 || (s) == APR_OS_START_SYSERR + ERROR_OPEN_FAILED)
  852. #define APR_STATUS_IS_ENOTDIR(s)        ((s) == APR_ENOTDIR)
  853. #define APR_STATUS_IS_ENOSPC(s)         ((s) == APR_ENOSPC \
  854.                 || (s) == APR_OS_START_SYSERR + ERROR_DISK_FULL)
  855. #define APR_STATUS_IS_ENOMEM(s)         ((s) == APR_ENOMEM)
  856. #define APR_STATUS_IS_EMFILE(s)         ((s) == APR_EMFILE \
  857.                 || (s) == APR_OS_START_SYSERR + ERROR_TOO_MANY_OPEN_FILES)
  858. #define APR_STATUS_IS_ENFILE(s)         ((s) == APR_ENFILE)
  859. #define APR_STATUS_IS_EBADF(s)          ((s) == APR_EBADF \
  860.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_HANDLE)
  861. #define APR_STATUS_IS_EINVAL(s)         ((s) == APR_EINVAL \
  862.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_PARAMETER \
  863.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_FUNCTION)
  864. #define APR_STATUS_IS_ESPIPE(s)         ((s) == APR_ESPIPE \
  865.                 || (s) == APR_OS_START_SYSERR + ERROR_NEGATIVE_SEEK)
  866. #define APR_STATUS_IS_EAGAIN(s)         ((s) == APR_EAGAIN \
  867.                 || (s) == APR_OS_START_SYSERR + ERROR_NO_DATA \
  868.                 || (s) == APR_OS_START_SYSERR + SOCEWOULDBLOCK \
  869.                 || (s) == APR_OS_START_SYSERR + ERROR_LOCK_VIOLATION)
  870. #define APR_STATUS_IS_EINTR(s)          ((s) == APR_EINTR \
  871.                 || (s) == APR_OS_START_SYSERR + SOCEINTR)
  872. #define APR_STATUS_IS_ENOTSOCK(s)       ((s) == APR_ENOTSOCK \
  873.                 || (s) == APR_OS_START_SYSERR + SOCENOTSOCK)
  874. #define APR_STATUS_IS_ECONNREFUSED(s)   ((s) == APR_ECONNREFUSED \
  875.                 || (s) == APR_OS_START_SYSERR + SOCECONNREFUSED)
  876. #define APR_STATUS_IS_EINPROGRESS(s)    ((s) == APR_EINPROGRESS \
  877.                 || (s) == APR_OS_START_SYSERR + SOCEINPROGRESS)
  878. #define APR_STATUS_IS_ECONNABORTED(s)   ((s) == APR_ECONNABORTED \
  879.                 || (s) == APR_OS_START_SYSERR + SOCECONNABORTED)
  880. #define APR_STATUS_IS_ECONNRESET(s)     ((s) == APR_ECONNRESET \
  881.                 || (s) == APR_OS_START_SYSERR + SOCECONNRESET)
  882. #define APR_STATUS_IS_ETIMEDOUT(s)      ((s) == APR_ETIMEDOUT \
  883.                 || (s) == APR_OS_START_SYSERR + SOCETIMEDOUT)    
  884. #define APR_STATUS_IS_EHOSTUNREACH(s)   ((s) == APR_EHOSTUNREACH \
  885.                 || (s) == APR_OS_START_SYSERR + SOCEHOSTUNREACH)
  886. #define APR_STATUS_IS_ENETUNREACH(s)    ((s) == APR_ENETUNREACH \
  887.                 || (s) == APR_OS_START_SYSERR + SOCENETUNREACH)
  888. #define APR_STATUS_IS_EFTYPE(s)         ((s) == APR_EFTYPE)
  889. #define APR_STATUS_IS_EPIPE(s)          ((s) == APR_EPIPE \
  890.                 || (s) == APR_OS_START_SYSERR + ERROR_BROKEN_PIPE \
  891.                 || (s) == APR_OS_START_SYSERR + SOCEPIPE)
  892. #define APR_STATUS_IS_EXDEV(s)          ((s) == APR_EXDEV \
  893.                 || (s) == APR_OS_START_SYSERR + ERROR_NOT_SAME_DEVICE)
  894. #define APR_STATUS_IS_ENOTEMPTY(s)      ((s) == APR_ENOTEMPTY \
  895.                 || (s) == APR_OS_START_SYSERR + ERROR_DIR_NOT_EMPTY \
  896.                 || (s) == APR_OS_START_SYSERR + ERROR_ACCESS_DENIED)
  897.  
  898. /*
  899.     Sorry, too tired to wrap this up for OS2... feel free to
  900.     fit the following into their best matches.
  901.  
  902.     { ERROR_NO_SIGNAL_SENT,     ESRCH           },
  903.     { SOCEALREADY,              EALREADY        },
  904.     { SOCEDESTADDRREQ,          EDESTADDRREQ    },
  905.     { SOCEMSGSIZE,              EMSGSIZE        },
  906.     { SOCEPROTOTYPE,            EPROTOTYPE      },
  907.     { SOCENOPROTOOPT,           ENOPROTOOPT     },
  908.     { SOCEPROTONOSUPPORT,       EPROTONOSUPPORT },
  909.     { SOCESOCKTNOSUPPORT,       ESOCKTNOSUPPORT },
  910.     { SOCEOPNOTSUPP,            EOPNOTSUPP      },
  911.     { SOCEPFNOSUPPORT,          EPFNOSUPPORT    },
  912.     { SOCEAFNOSUPPORT,          EAFNOSUPPORT    },
  913.     { SOCEADDRINUSE,            EADDRINUSE      },
  914.     { SOCEADDRNOTAVAIL,         EADDRNOTAVAIL   },
  915.     { SOCENETDOWN,              ENETDOWN        },
  916.     { SOCENETRESET,             ENETRESET       },
  917.     { SOCENOBUFS,               ENOBUFS         },
  918.     { SOCEISCONN,               EISCONN         },
  919.     { SOCENOTCONN,              ENOTCONN        },
  920.     { SOCESHUTDOWN,             ESHUTDOWN       },
  921.     { SOCETOOMANYREFS,          ETOOMANYREFS    },
  922.     { SOCELOOP,                 ELOOP           },
  923.     { SOCEHOSTDOWN,             EHOSTDOWN       },
  924.     { SOCENOTEMPTY,             ENOTEMPTY       },
  925.     { SOCEPIPE,                 EPIPE           }
  926. */
  927.  
  928. #elif defined(WIN32) && !defined(DOXYGEN) /* !defined(OS2) */
  929.  
  930. #define APR_FROM_OS_ERROR(e) (e == 0 ? APR_SUCCESS : e + APR_OS_START_SYSERR)
  931. #define APR_TO_OS_ERROR(e)   (e == 0 ? APR_SUCCESS : e - APR_OS_START_SYSERR)
  932.  
  933. #define apr_get_os_error()   (APR_FROM_OS_ERROR(GetLastError()))
  934. #define apr_set_os_error(e)  (SetLastError(APR_TO_OS_ERROR(e)))
  935.  
  936. /* A special case, only socket calls require this:
  937.  */
  938. #define apr_get_netos_error()   (APR_FROM_OS_ERROR(WSAGetLastError()))
  939. #define apr_set_netos_error(e)   (WSASetLastError(APR_TO_OS_ERROR(e)))
  940.  
  941. #define APR_STATUS_IS_SUCCESS(s)           ((s) == APR_SUCCESS \
  942.                 || (s) == APR_OS_START_SYSERR + ERROR_SUCCESS)
  943.  
  944. /* APR CANONICAL ERROR TESTS */
  945. #define APR_STATUS_IS_EACCES(s)         ((s) == APR_EACCES \
  946.                 || (s) == APR_OS_START_SYSERR + ERROR_ACCESS_DENIED \
  947.                 || (s) == APR_OS_START_SYSERR + ERROR_CANNOT_MAKE \
  948.                 || (s) == APR_OS_START_SYSERR + ERROR_CURRENT_DIRECTORY \
  949.                 || (s) == APR_OS_START_SYSERR + ERROR_DRIVE_LOCKED \
  950.                 || (s) == APR_OS_START_SYSERR + ERROR_FAIL_I24 \
  951.                 || (s) == APR_OS_START_SYSERR + ERROR_LOCK_VIOLATION \
  952.                 || (s) == APR_OS_START_SYSERR + ERROR_LOCK_FAILED \
  953.                 || (s) == APR_OS_START_SYSERR + ERROR_NOT_LOCKED \
  954.                 || (s) == APR_OS_START_SYSERR + ERROR_NETWORK_ACCESS_DENIED \
  955.                 || (s) == APR_OS_START_SYSERR + ERROR_SHARING_VIOLATION)
  956. #define APR_STATUS_IS_EEXIST(s)         ((s) == APR_EEXIST \
  957.                 || (s) == APR_OS_START_SYSERR + ERROR_FILE_EXISTS \
  958.                 || (s) == APR_OS_START_SYSERR + ERROR_ALREADY_EXISTS)
  959. #define APR_STATUS_IS_ENAMETOOLONG(s)   ((s) == APR_ENAMETOOLONG \
  960.                 || (s) == APR_OS_START_SYSERR + ERROR_FILENAME_EXCED_RANGE \
  961.                 || (s) == APR_OS_START_SYSERR + WSAENAMETOOLONG)
  962. #define APR_STATUS_IS_ENOENT(s)         ((s) == APR_ENOENT \
  963.                 || (s) == APR_OS_START_SYSERR + ERROR_FILE_NOT_FOUND \
  964.                 || (s) == APR_OS_START_SYSERR + ERROR_PATH_NOT_FOUND \
  965.                 || (s) == APR_OS_START_SYSERR + ERROR_OPEN_FAILED \
  966.                 || (s) == APR_OS_START_SYSERR + ERROR_NO_MORE_FILES)
  967. #define APR_STATUS_IS_ENOTDIR(s)        ((s) == APR_ENOTDIR \
  968.                 || (s) == APR_OS_START_SYSERR + ERROR_PATH_NOT_FOUND \
  969.                 || (s) == APR_OS_START_SYSERR + ERROR_BAD_NETPATH \
  970.                 || (s) == APR_OS_START_SYSERR + ERROR_BAD_NET_NAME \
  971.                 || (s) == APR_OS_START_SYSERR + ERROR_BAD_PATHNAME \
  972.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_DRIVE)
  973. #define APR_STATUS_IS_ENOSPC(s)         ((s) == APR_ENOSPC \
  974.                 || (s) == APR_OS_START_SYSERR + ERROR_DISK_FULL)
  975. #define APR_STATUS_IS_ENOMEM(s)         ((s) == APR_ENOMEM \
  976.                 || (s) == APR_OS_START_SYSERR + ERROR_ARENA_TRASHED \
  977.                 || (s) == APR_OS_START_SYSERR + ERROR_NOT_ENOUGH_MEMORY \
  978.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_BLOCK \
  979.                 || (s) == APR_OS_START_SYSERR + ERROR_NOT_ENOUGH_QUOTA \
  980.                 || (s) == APR_OS_START_SYSERR + ERROR_OUTOFMEMORY)
  981. #define APR_STATUS_IS_EMFILE(s)         ((s) == APR_EMFILE \
  982.                 || (s) == APR_OS_START_SYSERR + ERROR_TOO_MANY_OPEN_FILES)
  983. #define APR_STATUS_IS_ENFILE(s)         ((s) == APR_ENFILE)
  984. #define APR_STATUS_IS_EBADF(s)          ((s) == APR_EBADF \
  985.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_HANDLE \
  986.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_TARGET_HANDLE)
  987. #define APR_STATUS_IS_EINVAL(s)         ((s) == APR_EINVAL \
  988.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_ACCESS \
  989.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_DATA \
  990.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_FUNCTION \
  991.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_HANDLE \
  992.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_PARAMETER \
  993.                 || (s) == APR_OS_START_SYSERR + ERROR_NEGATIVE_SEEK)
  994. #define APR_STATUS_IS_ESPIPE(s)         ((s) == APR_ESPIPE \
  995.                 || (s) == APR_OS_START_SYSERR + ERROR_SEEK_ON_DEVICE \
  996.                 || (s) == APR_OS_START_SYSERR + ERROR_NEGATIVE_SEEK)
  997. #define APR_STATUS_IS_EAGAIN(s)         ((s) == APR_EAGAIN \
  998.                 || (s) == APR_OS_START_SYSERR + ERROR_NO_DATA \
  999.                 || (s) == APR_OS_START_SYSERR + ERROR_NO_PROC_SLOTS \
  1000.                 || (s) == APR_OS_START_SYSERR + ERROR_NESTING_NOT_ALLOWED \
  1001.                 || (s) == APR_OS_START_SYSERR + ERROR_MAX_THRDS_REACHED \
  1002.                 || (s) == APR_OS_START_SYSERR + ERROR_LOCK_VIOLATION \
  1003.                 || (s) == APR_OS_START_SYSERR + WSAEWOULDBLOCK)
  1004. #define APR_STATUS_IS_EINTR(s)          ((s) == APR_EINTR \
  1005.                 || (s) == APR_OS_START_SYSERR + WSAEINTR)
  1006. #define APR_STATUS_IS_ENOTSOCK(s)       ((s) == APR_ENOTSOCK \
  1007.                 || (s) == APR_OS_START_SYSERR + WSAENOTSOCK)
  1008. #define APR_STATUS_IS_ECONNREFUSED(s)   ((s) == APR_ECONNREFUSED \
  1009.                 || (s) == APR_OS_START_SYSERR + WSAECONNREFUSED)
  1010. #define APR_STATUS_IS_EINPROGRESS(s)    ((s) == APR_EINPROGRESS \
  1011.                 || (s) == APR_OS_START_SYSERR + WSAEINPROGRESS)
  1012. #define APR_STATUS_IS_ECONNABORTED(s)   ((s) == APR_ECONNABORTED \
  1013.                 || (s) == APR_OS_START_SYSERR + WSAECONNABORTED)
  1014. #define APR_STATUS_IS_ECONNRESET(s)     ((s) == APR_ECONNRESET \
  1015.                 || (s) == APR_OS_START_SYSERR + ERROR_NETNAME_DELETED \
  1016.                 || (s) == APR_OS_START_SYSERR + WSAECONNRESET)
  1017. #define APR_STATUS_IS_ETIMEDOUT(s)      ((s) == APR_ETIMEDOUT \
  1018.                 || (s) == APR_OS_START_SYSERR + WSAETIMEDOUT \
  1019.                 || (s) == APR_OS_START_SYSERR + WAIT_TIMEOUT)
  1020. #define APR_STATUS_IS_EHOSTUNREACH(s)   ((s) == APR_EHOSTUNREACH \
  1021.                 || (s) == APR_OS_START_SYSERR + WSAEHOSTUNREACH)
  1022. #define APR_STATUS_IS_ENETUNREACH(s)    ((s) == APR_ENETUNREACH \
  1023.                 || (s) == APR_OS_START_SYSERR + WSAENETUNREACH)
  1024. #define APR_STATUS_IS_EFTYPE(s)         ((s) == APR_EFTYPE \
  1025.                 || (s) == APR_OS_START_SYSERR + ERROR_EXE_MACHINE_TYPE_MISMATCH \
  1026.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_DLL \
  1027.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_MODULETYPE \
  1028.                 || (s) == APR_OS_START_SYSERR + ERROR_BAD_EXE_FORMAT \
  1029.                 || (s) == APR_OS_START_SYSERR + ERROR_INVALID_EXE_SIGNATURE \
  1030.                 || (s) == APR_OS_START_SYSERR + ERROR_FILE_CORRUPT \
  1031.                 || (s) == APR_OS_START_SYSERR + ERROR_BAD_FORMAT)
  1032. #define APR_STATUS_IS_EPIPE(s)          ((s) == APR_EPIPE \
  1033.                 || (s) == APR_OS_START_SYSERR + ERROR_BROKEN_PIPE)
  1034. #define APR_STATUS_IS_EXDEV(s)          ((s) == APR_EXDEV \
  1035.                 || (s) == APR_OS_START_SYSERR + ERROR_NOT_SAME_DEVICE)
  1036. #define APR_STATUS_IS_ENOTEMPTY(s)      ((s) == APR_ENOTEMPTY \
  1037.                 || (s) == APR_OS_START_SYSERR + ERROR_DIR_NOT_EMPTY)
  1038.  
  1039. #elif defined(NETWARE) && !defined(DOXYGEN) /* !defined(OS2) && !defined(WIN32) */
  1040.  
  1041. #define APR_FROM_OS_ERROR(e) (e == 0 ? APR_SUCCESS : e + APR_OS_START_SYSERR)
  1042. #define APR_TO_OS_ERROR(e)   (e == 0 ? APR_SUCCESS : e - APR_OS_START_SYSERR)
  1043.  
  1044. #define apr_get_os_error()    (errno)
  1045. #define apr_set_os_error(e)   (errno = (e))
  1046.  
  1047. /* A special case, only socket calls require this: */
  1048. #define apr_get_netos_error()   (APR_FROM_OS_ERROR(WSAGetLastError()))
  1049. #define apr_set_netos_error(e)  (WSASetLastError(APR_TO_OS_ERROR(e)))
  1050.  
  1051. #define APR_STATUS_IS_SUCCESS(s)           ((s) == APR_SUCCESS)
  1052.  
  1053. /* APR CANONICAL ERROR TESTS */
  1054. #define APR_STATUS_IS_EACCES(s)         ((s) == APR_EACCES)
  1055. #define APR_STATUS_IS_EEXIST(s)         ((s) == APR_EEXIST)
  1056. #define APR_STATUS_IS_ENAMETOOLONG(s)   ((s) == APR_ENAMETOOLONG)
  1057. #define APR_STATUS_IS_ENOENT(s)         ((s) == APR_ENOENT)
  1058. #define APR_STATUS_IS_ENOTDIR(s)        ((s) == APR_ENOTDIR)
  1059. #define APR_STATUS_IS_ENOSPC(s)         ((s) == APR_ENOSPC)
  1060. #define APR_STATUS_IS_ENOMEM(s)         ((s) == APR_ENOMEM)
  1061. #define APR_STATUS_IS_EMFILE(s)         ((s) == APR_EMFILE)
  1062. #define APR_STATUS_IS_ENFILE(s)         ((s) == APR_ENFILE)
  1063. #define APR_STATUS_IS_EBADF(s)          ((s) == APR_EBADF)
  1064. #define APR_STATUS_IS_EINVAL(s)         ((s) == APR_EINVAL)
  1065. #define APR_STATUS_IS_ESPIPE(s)         ((s) == APR_ESPIPE)
  1066.  
  1067. #define APR_STATUS_IS_EAGAIN(s)         ((s) == APR_EAGAIN \
  1068.                 || (s) ==                       EWOULDBLOCK \
  1069.                 || (s) == APR_OS_START_SYSERR + WSAEWOULDBLOCK)
  1070. #define APR_STATUS_IS_EINTR(s)          ((s) == APR_EINTR \
  1071.                 || (s) == APR_OS_START_SYSERR + WSAEINTR)
  1072. #define APR_STATUS_IS_ENOTSOCK(s)       ((s) == APR_ENOTSOCK \
  1073.                 || (s) == APR_OS_START_SYSERR + WSAENOTSOCK)
  1074. #define APR_STATUS_IS_ECONNREFUSED(s)   ((s) == APR_ECONNREFUSED \
  1075.                 || (s) == APR_OS_START_SYSERR + WSAECONNREFUSED)
  1076. #define APR_STATUS_IS_EINPROGRESS(s)    ((s) == APR_EINPROGRESS \
  1077.                 || (s) == APR_OS_START_SYSERR + WSAEINPROGRESS)
  1078. #define APR_STATUS_IS_ECONNABORTED(s)   ((s) == APR_ECONNABORTED \
  1079.                 || (s) == APR_OS_START_SYSERR + WSAECONNABORTED)
  1080. #define APR_STATUS_IS_ECONNRESET(s)     ((s) == APR_ECONNRESET \
  1081.                 || (s) == APR_OS_START_SYSERR + WSAECONNRESET)
  1082. #define APR_STATUS_IS_ETIMEDOUT(s)      ((s) == APR_ETIMEDOUT \
  1083.                 || (s) == APR_OS_START_SYSERR + WSAETIMEDOUT \
  1084.                 || (s) == APR_OS_START_SYSERR + WAIT_TIMEOUT)
  1085. #define APR_STATUS_IS_EHOSTUNREACH(s)   ((s) == APR_EHOSTUNREACH \
  1086.                 || (s) == APR_OS_START_SYSERR + WSAEHOSTUNREACH)
  1087. #define APR_STATUS_IS_ENETUNREACH(s)    ((s) == APR_ENETUNREACH \
  1088.                 || (s) == APR_OS_START_SYSERR + WSAENETUNREACH)
  1089. #define APR_STATUS_IS_ENETDOWN(s)       ((s) == APR_OS_START_SYSERR + WSAENETDOWN)
  1090. #define APR_STATUS_IS_EFTYPE(s)         ((s) == APR_EFTYPE)
  1091. #define APR_STATUS_IS_EPIPE(s)          ((s) == APR_EPIPE)
  1092. #define APR_STATUS_IS_EXDEV(s)          ((s) == APR_EXDEV)
  1093. #define APR_STATUS_IS_ENOTEMPTY(s)      ((s) == APR_ENOTEMPTY)
  1094.  
  1095. #else /* !defined(NETWARE) && !defined(OS2) && !defined(WIN32) */
  1096.  
  1097. /*
  1098.  *  os error codes are clib error codes
  1099.  */
  1100. #define APR_FROM_OS_ERROR(e)  (e)
  1101. #define APR_TO_OS_ERROR(e)    (e)
  1102.  
  1103. #define apr_get_os_error()    (errno)
  1104. #define apr_set_os_error(e)   (errno = (e))
  1105.  
  1106. /* A special case, only socket calls require this:
  1107.  */
  1108. #define apr_get_netos_error() (errno)
  1109. #define apr_set_netos_error(e) (errno = (e))
  1110. /** @} */
  1111.  
  1112. /** 
  1113.  * @addtogroup APR_STATUS_IS
  1114.  * @{
  1115.  */
  1116. /** no error */
  1117. #define APR_STATUS_IS_SUCCESS(s)        ((s) == APR_SUCCESS)
  1118.  
  1119. /** permission denied */
  1120. #define APR_STATUS_IS_EACCES(s)         ((s) == APR_EACCES)
  1121. /** file exists */
  1122. #define APR_STATUS_IS_EEXIST(s)         ((s) == APR_EEXIST)
  1123. /** path name is too long */
  1124. #define APR_STATUS_IS_ENAMETOOLONG(s)   ((s) == APR_ENAMETOOLONG)
  1125. /** no such file or directory */
  1126. #define APR_STATUS_IS_ENOENT(s)         ((s) == APR_ENOENT)
  1127. /** not a directory */
  1128. #define APR_STATUS_IS_ENOTDIR(s)        ((s) == APR_ENOTDIR)
  1129. /** no space left on device */
  1130. #define APR_STATUS_IS_ENOSPC(s)         ((s) == APR_ENOSPC)
  1131. /** not enough memory */
  1132. #define APR_STATUS_IS_ENOMEM(s)         ((s) == APR_ENOMEM)
  1133. /** too many open files */
  1134. #define APR_STATUS_IS_EMFILE(s)         ((s) == APR_EMFILE)
  1135. /** file table overflow */
  1136. #define APR_STATUS_IS_ENFILE(s)         ((s) == APR_ENFILE)
  1137. /** bad file # */
  1138. #define APR_STATUS_IS_EBADF(s)          ((s) == APR_EBADF)
  1139. /** invalid argument */
  1140. #define APR_STATUS_IS_EINVAL(s)         ((s) == APR_EINVAL)
  1141. /** illegal seek */
  1142. #define APR_STATUS_IS_ESPIPE(s)         ((s) == APR_ESPIPE)
  1143.  
  1144. /** operation would block */
  1145. #if !defined(EWOULDBLOCK) || !defined(EAGAIN)
  1146. #define APR_STATUS_IS_EAGAIN(s)         ((s) == APR_EAGAIN)
  1147. #elif (EWOULDBLOCK == EAGAIN)
  1148. #define APR_STATUS_IS_EAGAIN(s)         ((s) == APR_EAGAIN)
  1149. #else
  1150. #define APR_STATUS_IS_EAGAIN(s)         ((s) == APR_EAGAIN \
  1151.                                       || (s) == EWOULDBLOCK)
  1152. #endif
  1153.  
  1154. /** interrupted system call */
  1155. #define APR_STATUS_IS_EINTR(s)          ((s) == APR_EINTR)
  1156. /** socket operation on a non-socket */
  1157. #define APR_STATUS_IS_ENOTSOCK(s)       ((s) == APR_ENOTSOCK)
  1158. /** Connection Refused */
  1159. #define APR_STATUS_IS_ECONNREFUSED(s)   ((s) == APR_ECONNREFUSED)
  1160. /** operation now in progress */
  1161. #define APR_STATUS_IS_EINPROGRESS(s)    ((s) == APR_EINPROGRESS)
  1162.  
  1163. /** 
  1164.  * Software caused connection abort 
  1165.  * @remark
  1166.  * EPROTO on certain older kernels really means ECONNABORTED, so we need to 
  1167.  * ignore it for them.  See discussion in new-httpd archives nh.9701 & nh.9603
  1168.  *
  1169.  * There is potentially a bug in Solaris 2.x x<6, and other boxes that 
  1170.  * implement tcp sockets in userland (i.e. on top of STREAMS).  On these
  1171.  * systems, EPROTO can actually result in a fatal loop.  See PR#981 for 
  1172.  * example.  It's hard to handle both uses of EPROTO.
  1173.  */
  1174. #ifdef EPROTO
  1175. #define APR_STATUS_IS_ECONNABORTED(s)    ((s) == APR_ECONNABORTED \
  1176.                                        || (s) == EPROTO)
  1177. #else
  1178. #define APR_STATUS_IS_ECONNABORTED(s)    ((s) == APR_ECONNABORTED)
  1179. #endif
  1180.  
  1181. /** Connection Reset by peer */
  1182. #define APR_STATUS_IS_ECONNRESET(s)      ((s) == APR_ECONNRESET)
  1183. /** Operation timed out */
  1184. #define APR_STATUS_IS_ETIMEDOUT(s)       ((s) == APR_ETIMEDOUT)    
  1185. /** no route to host */
  1186. #define APR_STATUS_IS_EHOSTUNREACH(s)    ((s) == APR_EHOSTUNREACH)
  1187. /** network is unreachable */
  1188. #define APR_STATUS_IS_ENETUNREACH(s)     ((s) == APR_ENETUNREACH)
  1189. /** inappropiate file type or format */
  1190. #define APR_STATUS_IS_EFTYPE(s)          ((s) == APR_EFTYPE)
  1191. /** broken pipe */
  1192. #define APR_STATUS_IS_EPIPE(s)           ((s) == APR_EPIPE)
  1193. /** cross device link */
  1194. #define APR_STATUS_IS_EXDEV(s)           ((s) == APR_EXDEV)
  1195. /** Directory Not Empty */
  1196. #define APR_STATUS_IS_ENOTEMPTY(s)       ((s) == APR_ENOTEMPTY || \
  1197.                                           (s) == APR_EEXIST)
  1198. /** @} */
  1199.  
  1200. #endif /* !defined(NETWARE) && !defined(OS2) && !defined(WIN32) */
  1201.  
  1202. /** @} */
  1203.  
  1204. #ifdef __cplusplus
  1205. }
  1206. #endif
  1207.  
  1208. #endif  /* ! APR_ERRNO_H */
  1209.