Scroll to navigation

docs::api::APR::Const(3pm) User Contributed Perl Documentation docs::api::APR::Const(3pm)

NAME

APR::Const - Perl Interface for APR Constants

Synopsis

  # make the constants available but don't import them
  use APR::Const -compile => qw(constant names ...);
  
  # w/o the => syntax sugar
  use APR::Const ("-compile", qw(constant names ...));
  
  # compile and import the constants
  use APR::Const qw(constant names ...);

Description

This package contains constants specific to "APR" features.

Refer to "the Apache2::Const description section" for more information.

Constants

":common"

  use APR::Const -compile => qw(:common);

The ":common" group is for XXX constants.

"APR::Const::SUCCESS"

":error"

  use APR::Const -compile => qw(:error);

The ":error" group is for XXX constants.

"APR::Const::EABOVEROOT"

"APR::Const::EABSOLUTE"

"APR::Const::EACCES"

Due to possible variants in conditions matching "EACCES", for checking error codes against this you most likely want to use the "APR::Status::is_EACCES" function instead.

"APR::Const::EAGAIN"

The error Resource temporarily unavailable, may be returned by many different system calls, especially IO calls. Most likely you want to use the "APR::Status::is_EAGAIN" function instead.

"APR::Const::EBADDATE"

"APR::Const::EBADF"

"APR::Const::EBADIP"

"APR::Const::EBADMASK"

"APR::Const::EBADPATH"

"APR::Const::EBUSY"

"APR::Const::ECONNABORTED"

Due to possible variants in conditions matching "ECONNABORTED", for checking error codes against this you most likely want to use the "APR::Status::is_ECONNABORTED" function instead.

"APR::Const::ECONNREFUSED"

"APR::Const::ECONNRESET"

Due to possible variants in conditions matching "ECONNRESET", for checking error codes against this you most likely want to use the "APR::Status::is_ECONNRESET" function instead.

"APR::Const::EDSOOPEN"

"APR::Const::EEXIST"

"APR::Const::EFTYPE"

"APR::Const::EGENERAL"

"APR::Const::EHOSTUNREACH"

"APR::Const::EINCOMPLETE"

"APR::Const::EINIT"

"APR::Const::EINPROGRESS"

"APR::Const::EINTR"

"APR::Const::EINVAL"

"APR::Const::EINVALSOCK"

"APR::Const::EMFILE"

"APR::Const::EMISMATCH"

"APR::Const::ENAMETOOLONG"

"APR::Const::END"

"APR::Const::ENETUNREACH"

"APR::Const::ENFILE"

"APR::Const::ENODIR"

"APR::Const::ENOENT"

Due to possible variants in conditions matching "ENOENT", for checking error codes against this you most likely want to use the "APR::Status::is_ENOENT" function instead.

"APR::Const::ENOLOCK"

"APR::Const::ENOMEM"

"APR::Const::ENOPOLL"

"APR::Const::ENOPOOL"

"APR::Const::ENOPROC"

"APR::Const::ENOSHMAVAIL"

"APR::Const::ENOSOCKET"

"APR::Const::ENOSPC"

"APR::Const::ENOSTAT"

"APR::Const::ENOTDIR"

"APR::Const::ENOTEMPTY"

"APR::Const::ENOTHDKEY"

"APR::Const::ENOTHREAD"

"APR::Const::ENOTIME"

"APR::Const::ENOTIMPL"

Something is not implemented

"APR::Const::ENOTSOCK"

"APR::Const::EOF"

Due to possible variants in conditions matching "EOF", for checking error codes against this you most likely want to use the "APR::Status::is_EOF" function instead.

"APR::Const::EPATHWILD"

"APR::Const::EPIPE"

"APR::Const::EPROC_UNKNOWN"

"APR::Const::ERELATIVE"

"APR::Const::ESPIPE"

"APR::Const::ESYMNOTFOUND"

"APR::Const::ETIMEDOUT"

"APR::Const::EXDEV"

":fopen"

  use APR::Const -compile => qw(:fopen);

The ":fopen" group is for XXX constants.

"APR::Const::FOPEN_BINARY"

"APR::Const::FOPEN_BUFFERED"

"APR::Const::FOPEN_CREATE"

"APR::Const::FOPEN_DELONCLOSE"

"APR::Const::FOPEN_EXCL"

"APR::Const::FOPEN_PEND"

"APR::Const::FOPEN_READ"

"APR::Const::FOPEN_TRUNCATE"

"APR::Const::FOPEN_WRITE"

":filepath"

  use APR::Const -compile => qw(:filepath);

The ":filepath" group is for XXX constants.

"APR::Const::FILEPATH_ENCODING_LOCALE"

"APR::Const::FILEPATH_ENCODING_UNKNOWN"

"APR::Const::FILEPATH_ENCODING_UTF8"

"APR::Const::FILEPATH_NATIVE"

"APR::Const::FILEPATH_NOTABOVEROOT"

"APR::Const::FILEPATH_NOTABSOLUTE"

"APR::Const::FILEPATH_NOTRELATIVE"

"APR::Const::FILEPATH_SECUREROOT"

"APR::Const::FILEPATH_SECUREROOTTEST"

"APR::Const::FILEPATH_TRUENAME"

":fprot"

  use APR::Const -compile => qw(:fprot);

The ":fprot" group is used by "$finfo->protection".

"APR::Const::FPROT_GEXECUTE"

Execute by group

"APR::Const::FPROT_GREAD"

Read by group

"APR::Const::FPROT_GSETID"

Set group id

"APR::Const::FPROT_GWRITE"

Write by group

"APR::Const::FPROT_OS_DEFAULT"

use OS's default permissions

"APR::Const::FPROT_UEXECUTE"

Execute by user

"APR::Const::FPROT_UREAD"

Read by user

"APR::Const::FPROT_USETID"

Set user id

"APR::Const::FPROT_UWRITE"

Write by user

"APR::Const::FPROT_WEXECUTE"

Execute by others

"APR::Const::FPROT_WREAD"

Read by others

"APR::Const::FPROT_WSTICKY"

Sticky bit

"APR::Const::FPROT_WWRITE"

Write by others

":filetype"

  use APR::Const -compile => qw(:filetype);

The ":filetype" group is used by "$finfo->filetype".

"APR::Const::FILETYPE_BLK"

a file is a block device

"APR::Const::FILETYPE_CHR"

a file is a character device

"APR::Const::FILETYPE_DIR"

a file is a directory

"APR::Const::FILETYPE_LNK"

a file is a symbolic link

"APR::Const::FILETYPE_NOFILE"

the file type is undedetermined.

"APR::Const::FILETYPE_PIPE"

a file is a FIFO or a pipe.

"APR::Const::FILETYPE_REG"

a file is a regular file.

"APR::Const::FILETYPE_SOCK"

a file is a [unix domain] socket.

"APR::Const::FILETYPE_UNKFILE"

a file is of some other unknown type or the type cannot be determined.

":finfo"

  use APR::Const -compile => qw(:finfo);

The ":finfo" group is used by stat() and "$finfo->valid".

"APR::Const::FINFO_ATIME"

Access Time

"APR::Const::FINFO_CSIZE"

Storage size consumed by the file

"APR::Const::FINFO_CTIME"

Creation Time

"APR::Const::FINFO_DEV"

Device

"APR::Const::FINFO_DIRENT"

an atomic unix apr_dir_read()

"APR::Const::FINFO_GPROT"

Group protection bits

"APR::Const::FINFO_GROUP"

Group id

"APR::Const::FINFO_ICASE"

whether device is case insensitive

"APR::Const::FINFO_IDENT"

device and inode

"APR::Const::FINFO_INODE"

Inode

"APR::Const::FINFO_LINK"

Stat the link not the file itself if it is a link

"APR::Const::FINFO_MIN"

type, mtime, ctime, atime, size

"APR::Const::FINFO_MTIME"

Modification Time

"APR::Const::FINFO_NAME"

name in proper case

"APR::Const::FINFO_NLINK"

Number of links

"APR::Const::FINFO_NORM"

All fields provided by an atomic unix apr_stat()

"APR::Const::FINFO_OWNER"

user and group

"APR::Const::FINFO_PROT"

all protections

"APR::Const::FINFO_SIZE"

Size of the file

"APR::Const::FINFO_TYPE"

Type

"APR::Const::FINFO_UPROT"

User protection bits

"APR::Const::FINFO_USER"

User id

"APR::Const::FINFO_WPROT"

World protection bits

":flock"

  use APR::Const -compile => qw(:flock);

The ":flock" group is for XXX constants.

"APR::Const::FLOCK_EXCLUSIVE"

"APR::Const::FLOCK_NONBLOCK"

"APR::Const::FLOCK_SHARED"

"APR::Const::FLOCK_TYPEMASK"

":hook"

  use APR::Const -compile => qw(:hook);

The ":hook" group is for XXX constants.

"APR::Const::HOOK_FIRST"

"APR::Const::HOOK_LAST"

"APR::Const::HOOK_MIDDLE"

"APR::Const::HOOK_REALLY_FIRST"

"APR::Const::HOOK_REALLY_LAST"

":limit"

  use APR::Const -compile => qw(:limit);

The ":limit" group is for XXX constants.

"APR::Const::LIMIT_CPU"

"APR::Const::LIMIT_MEM"

"APR::Const::LIMIT_NOFILE"

"APR::Const::LIMIT_NPROC"

":lockmech"

  use APR::Const -compile => qw(:lockmech);

The ":lockmech" group is for XXX constants.

"APR::Const::LOCK_DEFAULT"

"APR::Const::LOCK_FCNTL"

"APR::Const::LOCK_FLOCK"

"APR::Const::LOCK_POSIXSEM"

"APR::Const::LOCK_PROC_PTHREAD"

"APR::Const::LOCK_SYSVSEM"

":poll"

  use APR::Const -compile => qw(:poll);

The ":poll" group is used by "poll".

"APR::Const::POLLERR"

Pending error

"APR::Const::POLLHUP"

Hangup occurred

"APR::Const::POLLIN"

Can read without blocking

"APR::Const::POLLNVAL"

Descriptor invalid

"APR::Const::POLLOUT"

Can write without blocking

"APR::Const::POLLPRI"

Priority data available

":read_type"

  use APR::Const -compile => qw(:read_type);

The ":read_type" group is for IO constants.

"APR::Const::BLOCK_READ"

the read function blocks

"APR::Const::NONBLOCK_READ"

the read function does not block

":shutdown_how"

  use APR::Const -compile => qw(:shutdown_how);

The ":shutdown_how" group is for XXX constants.

"APR::Const::SHUTDOWN_READ"

"APR::Const::SHUTDOWN_READWRITE"

"APR::Const::SHUTDOWN_WRITE"

":socket"

  use APR::Const -compile => qw(:socket);

The ":socket" group is for the "APR::Socket" object constants, in methods "opt_get" and "opt_set".

The following section discusses in detail each of the ":socket" constants.

"APR::Const::SO_DEBUG"

Possible values:

XXX

Turns on debugging information

"APR::Const::SO_DISCONNECTED"

Queries the disconnected state of the socket. (Currently only used on Windows)

Possible values:

XXX

"APR::Const::SO_KEEPALIVE"

Keeps connections active

Possible values:

XXX

"APR::Const::SO_LINGER"

Lingers on close if data is present

"APR::Const::SO_NONBLOCK"

Turns blocking IO mode on/off for socket.

Possible values:

  1 nonblocking
  0 blocking

For example, to set a socket to a blocking IO mode:

  use APR::Socket ();
  use APR::Const    -compile => qw(SO_NONBLOCK);
  ...
  if ($socket->opt_get(APR::Const::SO_NONBLOCK)) {
      $socket->opt_set(APR::Const::SO_NONBLOCK => 0);
  }

You don't have to query for this option, before setting it. It was done for the demonstration purpose.

"APR::Const::SO_RCVBUF"

Controls the "ReceiveBufferSize" setting

Possible values:

XXX

"APR::Const::SO_REUSEADDR"

The rules used in validating addresses supplied to bind should allow reuse of local addresses.

Possible values:

XXX

"APR::Const::SO_SNDBUF"

Controls the "SendBufferSize" setting

Possible values:

XXX

":status"

  use APR::Const -compile => qw(:status);

The ":status" group is for the API that return status code, or set the error variable XXXXXX.

The following section discusses in detail each of the available ":status" constants.

"APR::Const::TIMEUP"

The operation did not finish before the timeout.

Due to possible variants in conditions matching "TIMEUP", for checking error codes against this you most likely want to use the "APR::Status::is_TIMEUP" function instead.

":table"

  use APR::Const -compile => qw(:table);

The ":table" group is for overlap() and compress() constants. See "APR::Table" for details.

"APR::Const::OVERLAP_TABLES_MERGE"

See "APR::Table::compress" and "APR::Table::overlap".

"APR::Const::OVERLAP_TABLES_SET"

See "APR::Table::compress" and "APR::Table::overlap".

":uri"

  use APR::Const -compile => qw(:uri);

The ":uri" group of constants is for manipulating URIs.

"APR::Const::URI_ACAP_DEFAULT_PORT"

"APR::Const::URI_FTP_DEFAULT_PORT"

"APR::Const::URI_GOPHER_DEFAULT_PORT"

"APR::Const::URI_HTTPS_DEFAULT_PORT"

"APR::Const::URI_HTTP_DEFAULT_PORT"

"APR::Const::URI_IMAP_DEFAULT_PORT"

"APR::Const::URI_LDAP_DEFAULT_PORT"

"APR::Const::URI_NFS_DEFAULT_PORT"

"APR::Const::URI_NNTP_DEFAULT_PORT"

"APR::Const::URI_POP_DEFAULT_PORT"

"APR::Const::URI_PROSPERO_DEFAULT_PORT"

"APR::Const::URI_RTSP_DEFAULT_PORT"

"APR::Const::URI_SIP_DEFAULT_PORT"

"APR::Const::URI_SNEWS_DEFAULT_PORT"

"APR::Const::URI_SSH_DEFAULT_PORT"

"APR::Const::URI_TELNET_DEFAULT_PORT"

"APR::Const::URI_TIP_DEFAULT_PORT"

"APR::Const::URI_UNP_OMITPASSWORD"

See "APR::URI::unparse".

"APR::Const::URI_UNP_OMITPATHINFO"

See "APR::URI::unparse".

"APR::Const::URI_UNP_OMITQUERY"

See "APR::URI::unparse".

"APR::Const::URI_UNP_OMITSITEPART"

See "APR::URI::unparse".

"APR::Const::URI_UNP_OMITUSER"

See "APR::URI::unparse".

"APR::Const::URI_UNP_OMITUSERINFO"

"APR::Const::URI_UNP_REVEALPASSWORD"

See "APR::URI::unparse".

"APR::Const::URI_WAIS_DEFAULT_PORT"

Other Constants

"APR::PerlIO::PERLIO_LAYERS_ARE_ENABLED"

See "APR::PerlIO::Constants")

See Also

mod_perl 2.0 documentation.

Copyright

mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.

Authors

The mod_perl development team and numerous contributors.

2024-09-25 perl v5.38.2