Status Value Tests
Overview
// macros #define APR_STATUS_IS_ANONYMOUS(s) #define APR_STATUS_IS_BADARG(s) #define APR_STATUS_IS_BADCH(s) #define APR_STATUS_IS_CHILD_DONE(s) #define APR_STATUS_IS_CHILD_NOTDONE(s) #define APR_STATUS_IS_DETACH(s) #define APR_STATUS_IS_EABOVEROOT(s) #define APR_STATUS_IS_EABSOLUTE(s) #define APR_STATUS_IS_EACCES(s) #define APR_STATUS_IS_EAFNOSUPPORT(s) #define APR_STATUS_IS_EAGAIN(s) #define APR_STATUS_IS_EBADDATE(s) #define APR_STATUS_IS_EBADF(s) #define APR_STATUS_IS_EBADIP(s) #define APR_STATUS_IS_EBADMASK(s) #define APR_STATUS_IS_EBADPATH(s) #define APR_STATUS_IS_EBUSY(s) #define APR_STATUS_IS_ECONNABORTED(s) #define APR_STATUS_IS_ECONNREFUSED(s) #define APR_STATUS_IS_ECONNRESET(s) #define APR_STATUS_IS_EDSOOPEN(s) #define APR_STATUS_IS_EEXIST(s) #define APR_STATUS_IS_EFTYPE(s) #define APR_STATUS_IS_EGENERAL(s) #define APR_STATUS_IS_EHOSTUNREACH(s) #define APR_STATUS_IS_EINCOMPLETE(s) #define APR_STATUS_IS_EINIT(s) #define APR_STATUS_IS_EINPROGRESS(s) #define APR_STATUS_IS_EINTR(s) #define APR_STATUS_IS_EINVAL(s) #define APR_STATUS_IS_EINVALSOCK(s) #define APR_STATUS_IS_EMFILE(s) #define APR_STATUS_IS_EMISMATCH(s) #define APR_STATUS_IS_ENAMETOOLONG(s) #define APR_STATUS_IS_ENETUNREACH(s) #define APR_STATUS_IS_ENFILE(s) #define APR_STATUS_IS_ENODIR(s) #define APR_STATUS_IS_ENOENT(s) #define APR_STATUS_IS_ENOLOCK(s) #define APR_STATUS_IS_ENOMEM(s) #define APR_STATUS_IS_ENOPOLL(s) #define APR_STATUS_IS_ENOPOOL(s) #define APR_STATUS_IS_ENOPROC(s) #define APR_STATUS_IS_ENOSHMAVAIL(s) #define APR_STATUS_IS_ENOSOCKET(s) #define APR_STATUS_IS_ENOSPC(s) #define APR_STATUS_IS_ENOSTAT(s) #define APR_STATUS_IS_ENOTDIR(s) #define APR_STATUS_IS_ENOTEMPTY(s) #define APR_STATUS_IS_ENOTENOUGHENTROPY(s) #define APR_STATUS_IS_ENOTHDKEY(s) #define APR_STATUS_IS_ENOTHREAD(s) #define APR_STATUS_IS_ENOTIME(s) #define APR_STATUS_IS_ENOTIMPL(s) #define APR_STATUS_IS_ENOTSOCK(s) #define APR_STATUS_IS_EOF(s) #define APR_STATUS_IS_EPATHWILD(s) #define APR_STATUS_IS_EPIPE(s) #define APR_STATUS_IS_EPROC_UNKNOWN(s) #define APR_STATUS_IS_ERELATIVE(s) #define APR_STATUS_IS_ESPIPE(s) #define APR_STATUS_IS_ESYMNOTFOUND(s) #define APR_STATUS_IS_ETIMEDOUT(s) #define APR_STATUS_IS_EXDEV(s) #define APR_STATUS_IS_FILEBASED(s) #define APR_STATUS_IS_INCHILD(s) #define APR_STATUS_IS_INCOMPLETE(s) #define APR_STATUS_IS_INPARENT(s) #define APR_STATUS_IS_KEYBASED(s) #define APR_STATUS_IS_NOTDETACH(s) #define APR_STATUS_IS_NOTFOUND(s) #define APR_STATUS_IS_TIMEUP(s)
Detailed Documentation
Warning
For any particular error condition, more than one of these tests may match. This is because platform-specific error codes may not always match the semantics of the POSIX codes these tests (and the corresponding APR error codes) are named after. A notable example are the APR_STATUS_IS_ENOENT and APR_STATUS_IS_ENOTDIR tests on Win32 platforms. The programmer should always be aware of this and adjust the order of the tests accordingly.
Macros
#define APR_STATUS_IS_ANONYMOUS(s)
APR is using anonymous shared memory
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_BADARG(s)
Getopt found an option not in the option string and an argument was specified in the option string
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_BADCH(s)
Getopt found an option not in the option string
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_CHILD_DONE(s)
The child has finished executing
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_CHILD_NOTDONE(s)
The child has not finished executing
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_DETACH(s)
The thread is detached
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_EABOVEROOT(s)
The given path was above the root path.
#define APR_STATUS_IS_EABSOLUTE(s)
The given path was absolute.
#define APR_STATUS_IS_EACCES(s)
permission denied
#define APR_STATUS_IS_EAFNOSUPPORT(s)
Address Family not supported
#define APR_STATUS_IS_EAGAIN(s)
operation would block
#define APR_STATUS_IS_EBADDATE(s)
APR was given an invalid date
#define APR_STATUS_IS_EBADF(s)
bad file #
#define APR_STATUS_IS_EBADIP(s)
The specified IP address is invalid
#define APR_STATUS_IS_EBADMASK(s)
The specified netmask is invalid
#define APR_STATUS_IS_EBADPATH(s)
The given path was bad.
#define APR_STATUS_IS_EBUSY(s)
The given lock was busy
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_ECONNABORTED(s)
Software caused connection abort EPROTO on certain older kernels really means ECONNABORTED, so we need to ignore it for them. See discussion in new-httpd archives nh.9701 & nh.9603
There is potentially a bug in Solaris 2.x x<6, and other boxes that implement tcp sockets in userland (i.e. on top of STREAMS). On these systems, EPROTO can actually result in a fatal loop. See PR#981 for example. It’s hard to handle both uses of EPROTO.
#define APR_STATUS_IS_ECONNREFUSED(s)
Connection Refused
#define APR_STATUS_IS_ECONNRESET(s)
Connection Reset by peer
#define APR_STATUS_IS_EDSOOPEN(s)
APR was unable to open the dso object. For more information call apr_dso_error().
#define APR_STATUS_IS_EEXIST(s)
file exists
#define APR_STATUS_IS_EFTYPE(s)
inappropiate file type or format
#define APR_STATUS_IS_EGENERAL(s)
Generic Error which can not be put into another spot
#define APR_STATUS_IS_EHOSTUNREACH(s)
no route to host
#define APR_STATUS_IS_EINCOMPLETE(s)
The given path was neither relative nor absolute.
#define APR_STATUS_IS_EINIT(s)
Ininitalizer value. If no option has been found, but the status variable requires a value, this should be used
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_EINPROGRESS(s)
operation now in progress
#define APR_STATUS_IS_EINTR(s)
interrupted system call
#define APR_STATUS_IS_EINVAL(s)
invalid argument
#define APR_STATUS_IS_EINVALSOCK(s)
APR was given an invalid socket
#define APR_STATUS_IS_EMFILE(s)
too many open files
#define APR_STATUS_IS_EMISMATCH(s)
Two passwords do not match.
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_ENAMETOOLONG(s)
path name is too long
#define APR_STATUS_IS_ENETUNREACH(s)
network is unreachable
#define APR_STATUS_IS_ENFILE(s)
file table overflow
#define APR_STATUS_IS_ENODIR(s)
APR was not given a directory structure
#define APR_STATUS_IS_ENOENT(s)
no such file or directory EMVSCATLG can be returned by the automounter on z/OS for paths which do not exist.
#define APR_STATUS_IS_ENOLOCK(s)
APR was not given a lock structure
#define APR_STATUS_IS_ENOMEM(s)
not enough memory
#define APR_STATUS_IS_ENOPOLL(s)
APR was not given a poll structure
#define APR_STATUS_IS_ENOPOOL(s)
APR was not provided a pool with which to allocate memory
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_ENOPROC(s)
APR was not given a process structure
#define APR_STATUS_IS_ENOSHMAVAIL(s)
There is no more shared memory available
#define APR_STATUS_IS_ENOSOCKET(s)
APR was not given a socket
#define APR_STATUS_IS_ENOSPC(s)
no space left on device
#define APR_STATUS_IS_ENOSTAT(s)
APR was unable to perform a stat on the file
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_ENOTDIR(s)
not a directory
#define APR_STATUS_IS_ENOTEMPTY(s)
Directory Not Empty
#define APR_STATUS_IS_ENOTENOUGHENTROPY(s)
APR could not gather enough entropy to continue.
#define APR_STATUS_IS_ENOTHDKEY(s)
APR was not given a thread key structure
#define APR_STATUS_IS_ENOTHREAD(s)
APR was not given a thread structure
#define APR_STATUS_IS_ENOTIME(s)
APR was not given a time structure
#define APR_STATUS_IS_ENOTIMPL(s)
The APR function has not been implemented on this platform, either because nobody has gotten to it yet, or the function is impossible on this platform.
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_ENOTSOCK(s)
socket operation on a non-socket
#define APR_STATUS_IS_EOF(s)
APR has encountered the end of the file
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_EPATHWILD(s)
The given path contained wildcards.
#define APR_STATUS_IS_EPIPE(s)
broken pipe
#define APR_STATUS_IS_EPROC_UNKNOWN(s)
The given process was not recognized by APR.
#define APR_STATUS_IS_ERELATIVE(s)
The given path was relative.
#define APR_STATUS_IS_ESPIPE(s)
illegal seek
#define APR_STATUS_IS_ESYMNOTFOUND(s)
Could not find the requested symbol. For more information call apr_dso_error().
#define APR_STATUS_IS_ETIMEDOUT(s)
Operation timed out Deprecated
#define APR_STATUS_IS_EXDEV(s)
cross device link
#define APR_STATUS_IS_FILEBASED(s)
APR is using a file name as the key to the shared memory
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_INCHILD(s)
Program is currently executing in the child
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_INCOMPLETE(s)
The operation was incomplete although some processing was performed and the results are partially valid.
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_INPARENT(s)
Program is currently executing in the parent
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_KEYBASED(s)
APR is using a shared key as the key to the shared memory
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_NOTDETACH(s)
The thread is not detached
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_NOTFOUND(s)
APR was unable to find the socket in the poll structure
Warning
always use this test, as platform-specific variances may meet this more than one error code
#define APR_STATUS_IS_TIMEUP(s)
The operation did not finish before the timeout
Warning
always use this test, as platform-specific variances may meet this more than one error code