rbb 00/11/16 09:28:14 Modified: . index.html Added: docs APR File handling.html APR I18N translation library.html APR MD5 Library.html APR MMAP library.html APR Network library.html APR Process library.html APR Random Functions.html APR Table library.html APR Thread library.html APR Time library.html APR UUID Handling.html APR command arguments.html APR general-purpose library.html APR lock library.html APR memory allocation.html APR portability Routines.html APR strings library.html Dynamic Object Handling.html Error Codes.html Fnmatch functions.html General.html Hash Tables.html Shared Memory library.html canonical_filenames.html index.html master.html packages.html to-do.html images ball1.gif ball2.gif bug.gif caution.gif master.gif tip.gif warning.gif Log: Start putting together a site with documentation. this is just a start, and it will need to be modified and added to as we go. In order to get the docs to look good (without broken images or ScanDoc images), I had to hand-edit the html to remove an img tag. This can be fixed by getting an APR logo and creating an gif for it. Revision Changes Path 1.4 +11 -4 apr-site/index.html Index: index.html =================================================================== RCS file: /home/cvs/apr-site/index.html,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- index.html 2000/11/16 17:17:18 1.3 +++ index.html 2000/11/16 17:27:44 1.4 @@ -13,10 +13,17 @@

- This project is currently being split off from Version 2.0 work of the - Apache HTTP server project. - More information will be forthcoming as the situation develops and - the split progresses. + This is a new Apache Software Foundation project that hopes to create a + library of routines that can be used on any platform to create stable + programs.

+ The project was started as a part of the Apache Web Server almost two years + ago, and has been growing ever since. Currently, it is in use by the + Subversion Source Code Repository System and Apache 2.0. +

+ +

The Library API

+ APR uses ScanDoc to generate all of the API docs in + HTML format. No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision No revision 1.1 apr-site/docs/General.html Index: General.html =================================================================== [Apache Portable RunTime] -- General
[Apache Portable RunTime]

Package Name: General

Global Functions

APR_DECLARE(rettype) apr_func(args);;
APR_DECLARE_EXPORT is defined when building the APR dynamic library, so that all public symbols are exported. APR_DECLARE_STATIC is defined when including the APR public headers, to provide static linkage when the dynamic library may be unavailable. APR_DECLARE_STATIC and APR_DECLARE_EXPORT are left undefined when including the APR public headers, to import and link the symbols from the dynamic APR library and assure appropriate indirection and calling conventions at compile time. The public APR functions are declared with APR_DECLARE(), so they may use the most appropriate calling convention. Public APR functions with variable arguments must use APR_DECLARE_NONSTD().

APR_DECLARE_DATA type apr_variable;;
The public APR variables are declared with AP_MODULE_DECLARE_DATA. This assures the appropriate indirection is invoked at compile time.

APR_DECLARE_NONSTD(rettype) apr_func(args, ...);;
The public APR functions using variable arguments are declared with AP_DECLARE(), as they must use the C language calling convention.

Sigfunc *apr_signal(int signo, Sigfunc * func);

extern APR_DECLARE_DATA type apr_variable; syntax is required for declarations within headers to properly import the variable.

© 2000 [Apache Software Foundation]
Generated by ScanDoc 0.12
Last Updated: Wed Nov 15 6:34:47 2000
No revision No revision No revision No revision No revision 1.1 apr-site/docs/canonical_filenames.html Index: canonical_filenames.html =================================================================== APR Canonical Filenames

APR Canonical Filename


APR porters need to address the underlying discrepancies between file systems. To achieve a reasonable degree of security, the program depending upon APR needs to know that two paths may be compared, and that a mismatch is guarenteed to reflect that the two paths do not return the same resource


The first discrepancy is in volume roots. Unix and pure deriviates have only one root path, "/". Win32 and OS2 share root paths of the form "D:/", D: is the volume designation. However, this can be specified as "//./D:/" as well, indicating D: volume of the 'this' machine. Win32 and OS2 also may employ a UNC root path, of the form "//server/share/" where share is a share-point of the specified network server. Finally, NetWare root paths are of the form "server/volume:/", or the simpler "volume:/" syntax for 'this' machine. All these non-Unix file systems accept volume:path, without a slash following the colon, as a path relative to the current working directory, which APR will treat as ambigious, that is, neither an absolute nor a relative path per se.

The second discrepancy is in the meaning of the 'this' directory. In general, 'this' must be eliminated from the path where it occurs. The syntax "path/./" and "path/" are both aliases to path. However, this isn't file system independent, since the double slash "//" has a special meaning on OS2 and Win32 at the start of the path name, and is invalid on those platforms before the "//server/share/" UNC root path is completed. Finally, as noted above, "//./volume/" is legal root syntax on WinNT, and perhaps others.

The third discrepancy is in the context of the 'parent' directory. When "parent/path/.." occurs, the path must be unwound to "parent". It's also critical to simply truncate leading "/../" paths to "/", since the parent of the root is root. This gets tricky on the Win32 and OS2 platforms, since the ".." element is invalid before the "//server/share/" is complete, and the "//server/share/../" seqence is the complete UNC root "//server/share/". In relative paths, leading ".." elements are significant, until they are merged with an absolute path. The relative form must only retain the ".." segments as leading segments, to be resolved once merged to another relative or an absolute path.

The fourth discrepancy occurs with acceptance of alternate character codes for the same element. Path seperators are not retained within the APR canonical forms. The OS filesystem and APR (slashed) forms can both be returned as strings, to be used in the proper context. Unix, Win32 and Netware all accept slashes and backslashes as the same path seperator symbol, although unix strictly accepts slashes. While the APR form of the name strictly uses slashes, always consider that there could be a platform that actually accepts slashes as a character within a segment name.

The fifth and worst discrepancy plauges Win32, OS2, Netware, and some filesystems mounted in Unix. Case insensitivity can permit the same file to slip through in both it's proper case and alternate cases. Simply changing the case is insufficient for any character set beyond ASCII, since various dilectic forms of characters suffer from one to many or many to one translations. An example would be u-umlaut, which might be accepted as a single character u-umlaut, a two character sequence u and the zero-width umlaut, the upper case form of the same, or perhaps even a captial U alone. This can be handled in different ways depending on the purposes of the APR based program, but the one requirement is that the path must be absolute in order to resolve these ambiguities. Methods employed include comparison of device and inode file uniqifiers, which is a fairly fast operation, or quering the OS for the true form of the name, which can be much slower. Only the acknowledgement of the file names by the OS can validate the equality of two different cases of the same filename.

The sixth discrepancy, illegal or insignificant characters, is especially significant in non-unix file systems. Trailing periods are accepted but never stored, therefore trailing periods must be ignored for any form of comparison. And all OS's have certain expectations of what characters are illegal (or undesireable due to confusion.)

A final warning, canonical functions don't transform or resolve case or character ambiguity issues until they are resolved into an absolute path. The relative canonical path, while useful, while useful for URL or similar identifiers, cannot be used for testing or comparison of file system objects.

Canonical API

Functions to manipulate the apr_canon_file_t (an opaque type) include:

The path is corrected to the file system case only if is in absolute form. The apr_canon_file_t should be preserved as long as possible and used as the parent to create child entries to reduce the number of expensive stat and case canonicalization calls to the OS.

The comparison operation provides that the APR can postpone correction of case by simply relying upon the device and inode for equivilance. The stat implementation provides that two files are the same, while their strings are not equivilant, and eliminates the need for the operating system to return the proper form of the name.

In any case, returning the char* path, with a flag to request the proper case, forces the OS calls to resolve the true names of each segment. Where there is a penality for this operation and the stat device and inode test is faster, case correction is postponed until the char* result is requested. On platforms that identify the inode, device, or proper name interchangably with no penalities, this may occur when the name is initially processed.

Unix Example

First the simplest case:

  Parse Canonical Name 
  accepts parent path as canonical_t
          this path as string
  Split this path Segments on '/'
  For each of this path Segments
    If first Segment
      If this Segment is Empty ([nothing]/)
        Append this Root Segment (don't merge)
        Continue to next Segment
      Else is relative
        Append parent Segments (to merge)
        Continue with this Segment
    If Segment is '.' or empty (2 slashes)
      Discard this Segment
      Continue with next Segment
    If Segment is '..'
      If no previous Segment or previous Segment is '..'
        Append this Segment
        Continue with next Segment
      If previous Segment and previous is not Root Segment
        Discard previous Segment
      Discard this Segment
      Continue with next Segment
    Append this Relative Segment
    Continue with next Segment        
1.1 apr-site/docs/index.html Index: index.html =================================================================== [Apache Portable RunTime] <body bgcolor="#FFFFFF" stylesrc="index.html"> <p>Some Documentation</p> </body> 1.1 apr-site/docs/master.html Index: master.html =================================================================== Master Index

Master Index


  • APR_DECLARE(rettype) apr_func(args);
  • APR_DECLARE_DATA type apr_variable;
  • APR_DECLARE_NONSTD(rettype) apr_func(args, ...);
  • Sigfunc *apr_signal(int signo, Sigfunc * func)
  • APR File handling
  • struct apr_finfo_t
  • apr_status_t apr_close(apr_file_t *file)
  • apr_status_t apr_closedir(apr_dir_t *thedir)
  • apr_status_t apr_create_namedpipe(const char *filename, apr_fileperms_t perm, apr_pool_t *cont)
  • apr_status_t apr_create_pipe(apr_file_t **in, apr_file_t **out, apr_pool_t *cont)
  • apr_status_t apr_dir_entry_ftype(apr_filetype_e *type, apr_dir_t *thedir)
  • apr_status_t apr_dir_entry_mtime(apr_time_t *mtime, apr_dir_t *thedir)
  • apr_status_t apr_dir_entry_size(apr_size_t *size, apr_dir_t *thedir)
  • apr_status_t apr_dupfile(apr_file_t **new_file, apr_file_t *old_file, apr_pool_t *p)
  • apr_status_t apr_eof(apr_file_t *fptr)
  • apr_status_t apr_ferror(apr_file_t *fptr)
  • apr_status_t apr_fgets(char *str, int len, apr_file_t *thefile)
  • apr_status_t apr_flush(apr_file_t *thefile)
  • apr_status_t apr_full_read(apr_file_t *thefile, void *buf, apr_size_t nbytes, apr_size_t *bytes_read)
  • apr_status_t apr_full_write(apr_file_t *thefile, const void *buf, apr_size_t nbytes, apr_size_t *bytes_written)
  • apr_status_t apr_get_dir_filename(char **new_path, apr_dir_t *thedir)
  • apr_status_t apr_get_filedata(void **data, const char *key, apr_file_t *file)
  • apr_status_t apr_get_filename(char **new_path, apr_file_t *thefile)
  • apr_status_t apr_get_pipe_timeout(apr_file_t *thepipe, apr_interval_time_t *timeout)
  • apr_status_t apr_getc(char *ch, apr_file_t *thefile)
  • apr_status_t apr_getfileinfo(apr_finfo_t *finfo, apr_file_t *thefile)
  • apr_status_t apr_is_absolute(apr_canon_t **path)
  • apr_status_t apr_is_relative(apr_canon_t **path)
  • apr_status_t apr_is_virtualroot(apr_canon_t **path, int elements)
  • apr_status_t apr_lstat(apr_finfo_t *finfo, const char *fname, apr_pool_t *cont)
  • apr_status_t apr_make_canonical_name(apr_canon_t **new_name, const apr_canon_t *trusted_name, const char *child_name, int options, apr_pool_t *pool)
  • apr_status_t apr_make_dir(const char *path, apr_fileperms_t perm, apr_pool_t *cont)
  • apr_status_t apr_open(apr_file_t **new_file, const char *fname, apr_int32_t flag, apr_fileperms_t perm, apr_pool_t *cont)
  • apr_status_t apr_open_stderr(apr_file_t **thefile, apr_pool_t *cont)
  • apr_status_t apr_opendir(apr_dir_t **new_dir, const char *dirname, apr_pool_t *cont)
  • apr_status_t apr_putc(char ch, apr_file_t *thefile)
  • apr_status_t apr_puts(const char *str, apr_file_t *thefile)
  • apr_status_t apr_read(apr_file_t *thefile, void *buf, apr_size_t *nbytes)
  • apr_status_t apr_readdir(apr_dir_t *thedir)
  • apr_status_t apr_remove_dir(const char *path, apr_pool_t *cont)
  • apr_status_t apr_remove_file(const char *path, apr_pool_t *cont)
  • apr_status_t apr_rename_file(const char *from_path, const char *to_path, apr_pool_t *pool)
  • apr_status_t apr_rewinddir(apr_dir_t *thedir)
  • apr_status_t apr_seek(apr_file_t *thefile, apr_seek_where_t where,apr_off_t *offset)
  • apr_status_t apr_set_filedata(apr_file_t *file, void *data, const char *key, apr_status_t (*cleanup) (void *))
  • apr_status_t apr_set_pipe_timeout(apr_file_t *thepipe, apr_interval_time_t timeout)
  • apr_status_t apr_setfileperms(const char *fname, apr_fileperms_t perms)
  • apr_status_t apr_stat(apr_finfo_t *finfo, const char *fname, apr_pool_t *cont)
  • apr_status_t apr_ungetc(char ch, apr_file_t *thefile)
  • apr_status_t apr_write(apr_file_t *thefile, const void *buf, apr_size_t *nbytes)
  • apr_status_t apr_writev(apr_file_t *thefile, const struct iovec *vec, apr_size_t nvec, apr_size_t *nbytes)
  • int apr_fprintf(apr_file_t *fptr, const char *format, ...)
  • APR I18N translation library
  • apr_status_t apr_xlate_close(apr_xlate_t *convset)
  • apr_status_t apr_xlate_conv_buffer(apr_xlate_t *convset, const char *inbuf, apr_size_t *inbytes_left, char *outbuf, apr_size_t *outbytes_left)
  • apr_int32_t apr_xlate_conv_byte(apr_xlate_t *convset, unsigned char inchar)
  • apr_status_t apr_xlate_conv_char(apr_xlate_t *convset, char inchar, char outchar)
  • apr_status_t apr_xlate_get_sb(apr_xlate_t *convset, int *onoff)
  • apr_status_t apr_xlate_open(apr_xlate_t **convset, const char *topage, const char *frompage, apr_pool_t *pool)
  • APR MD5 Library
  • struct apr_md5_ctx_t
  • apr_status_t apr_MD5Encode(const char *password, const char *salt, char *result, size_t nbytes)
  • apr_status_t apr_MD5Init(apr_md5_ctx_t *context)
  • apr_status_t apr_MD5SetXlate(apr_md5_ctx_t *context, apr_xlate_t *xlate)
  • apr_status_t apr_MD5Update(apr_md5_ctx_t *context, const unsigned char *input, unsigned int inputLen)
  • apr_status_t apr_MD5Final(unsigned char digest[MD5_DIGESTSIZE], apr_md5_ctx_t *context)
  • APR MMAP library
  • struct apr_mmap_t
  • apr_status_t apr_mmap_create(apr_mmap_t ** newmmap, apr_file_t *file, apr_off_t offset, apr_size_t size, apr_pool_t *cntxt)
  • apr_status_t apr_mmap_delete(apr_mmap_t *mmap)
  • apr_status_t apr_mmap_offset(void **addr, apr_mmap_t *mmap, apr_off_t offset)
  • APR Network library
  • struct apr_hdtr_t
  • apr_status_t apr_accept(apr_socket_t **new_sock, apr_socket_t *sock, apr_pool_t *connection_pool)
  • apr_status_t apr_add_poll_socket(apr_pollfd_t *aprset, apr_socket_t *socket, apr_int16_t event)
  • apr_status_t apr_bind(apr_socket_t *sock)
  • apr_status_t apr_clear_poll_sockets(apr_pollfd_t *aprset, apr_int16_t events)
  • apr_status_t apr_close_socket(apr_socket_t *thesocket)
  • apr_status_t apr_connect(apr_socket_t *sock, const char *hostname)
  • apr_status_t apr_create_tcp_socket(apr_socket_t **new_sock, apr_pool_t *cont)
  • apr_status_t apr_get_hostname(char **name, apr_interface_e which, apr_socket_t *sock)
  • apr_status_t apr_get_inaddr(apr_in_addr_t *addr, char *hostname)
  • apr_status_t apr_get_ipaddr(char **addr, apr_interface_e which, apr_socket_t *sock)
  • apr_status_t apr_get_local_name(struct sockaddr_in **name, apr_socket_t *sock)
  • apr_status_t apr_get_polldata(apr_pollfd_t *pollfd, const char *key, void *data)
  • apr_status_t apr_get_port(apr_port_t *port, apr_interface_e which, apr_socket_t *sock)
  • apr_status_t apr_get_remote_name(struct sockaddr_in **name, apr_socket_t *sock)
  • apr_status_t apr_get_revents(apr_int16_t *event, apr_socket_t *sock, apr_pollfd_t *aprset)
  • apr_status_t apr_get_socket_inaddr(apr_in_addr_t *addr, apr_interface_e which, apr_socket_t *sock)
  • apr_status_t apr_get_socketdata(void **data, const char *key, apr_socket_t *sock)
  • apr_status_t apr_gethostname(char *buf, int len, apr_pool_t *cont)
  • apr_status_t apr_getsocketopt(apr_socket_t *sock, apr_int32_t opt, apr_int32_t* on)
  • apr_status_t apr_listen(apr_socket_t *sock, apr_int32_t backlog)
  • apr_status_t apr_mask_poll_socket(apr_pollfd_t *aprset, apr_socket_t *sock, apr_int16_t events)
  • apr_status_t apr_poll(apr_pollfd_t *aprset, apr_int32_t *nsds, apr_interval_time_t timeout)
  • apr_status_t apr_recv(apr_socket_t *sock, char *buf, apr_size_t *len)
  • apr_status_t apr_remove_poll_socket(apr_pollfd_t *aprset, apr_socket_t *sock)
  • apr_status_t apr_send(apr_socket_t *sock, const char *buf, apr_size_t *len)
  • apr_status_t apr_sendfile(apr_socket_t *sock, apr_file_t *file, apr_hdtr_t *hdtr, apr_off_t *offset, apr_size_t *len, apr_int32_t flags)
  • apr_status_t apr_sendv(apr_socket_t *sock, const struct iovec *vec, apr_int32_t nvec, apr_size_t *len)
  • apr_status_t apr_set_ipaddr(apr_socket_t *sock, apr_interface_e which, const char *addr)
  • apr_status_t apr_set_polldata(apr_pollfd_t *pollfd, void *data, const char *key, apr_status_t (*cleanup) (void *))
  • apr_status_t apr_set_port(apr_socket_t *sock, apr_interface_e which, apr_port_t port)
  • apr_status_t apr_set_socketdata(apr_socket_t *sock, void *data, const char *key, apr_status_t (*cleanup) (void*))
  • apr_status_t apr_setsocketopt(apr_socket_t *sock, apr_int32_t opt, apr_int32_t on)
  • apr_status_t apr_setup_poll(apr_pollfd_t **new_poll, apr_int32_t num, apr_pool_t *cont)
  • apr_status_t apr_shutdown(apr_socket_t *thesocket, apr_shutdown_how_e how)
  • apr_status_t apr_socket_from_file(apr_socket_t **newsock, apr_file_t *file)
  • APR Process library
  • void apr_check_other_child(void)
  • apr_status_t apr_create_process(apr_proc_t *new_proc, const char *progname, char *const *args, char **env, apr_procattr_t *attr, apr_pool_t *cont)
  • apr_status_t apr_createprocattr_init(apr_procattr_t **new_attr, apr_pool_t *cont)
  • apr_status_t apr_detach(void)
  • apr_status_t apr_fork(apr_proc_t *proc, apr_pool_t *cont)
  • apr_status_t apr_kill(apr_proc_t *proc, int sig)
  • void apr_probe_writable_fds(void)
  • apr_status_t apr_reap_other_child(apr_proc_t *pid, int status)
  • void apr_register_other_child(apr_proc_t *pid, void (*maintenance) (int reason, void *, int status), void *data, apr_file_t *write_fd, apr_pool_t *p)
  • apr_status_t apr_setprocattr_childerr(struct apr_procattr_t *attr, apr_file_t *child_err, apr_file_t *parent_err)
  • apr_status_t apr_setprocattr_childin(struct apr_procattr_t *attr, apr_file_t *child_in, apr_file_t *parent_in)
  • apr_status_t apr_setprocattr_childout(struct apr_procattr_t *attr, apr_file_t *child_out, apr_file_t *parent_out)
  • apr_status_t apr_setprocattr_cmdtype(apr_procattr_t *attr, apr_cmdtype_e cmd)
  • apr_status_t apr_setprocattr_detach(apr_procattr_t *attr, apr_int32_t detach)
  • apr_status_t apr_setprocattr_dir(apr_procattr_t *attr, const char *dir)
  • apr_status_t apr_setprocattr_io(apr_procattr_t *attr, apr_int32_t in, apr_int32_t out, apr_int32_t err)
  • apr_status_t apr_setprocattr_limit(apr_procattr_t *attr, apr_int32_t what, struct rlimit *limit)
  • void apr_unregister_other_child(void *data)
  • apr_status_t apr_wait_all_procs(apr_proc_t *proc, apr_wait_t *status, apr_wait_how_e waithow, apr_pool_t *p)
  • apr_status_t apr_wait_proc(apr_proc_t *proc, apr_wait_how_e waithow)
  • APR Random Functions
  • apr_status_t apr_generate_random_bytes(unsigned char * buf, int length)
  • APR Table library
  • struct apr_array_header_t
  • struct apr_btable_entry_t
  • struct apr_btable_t
  • struct apr_table_entry_t
  • struct apr_table_t
  • apr_item_t
  • APR Thread library
  • struct apr_proc_t
  • apr_status_t apr_create_thread(apr_thread_t **new_thread, apr_threadattr_t *attr, apr_thread_start_t func, void *data, apr_pool_t *cont)
  • apr_status_t apr_create_thread_private(apr_threadkey_t **key, void (*dest)(void *), apr_pool_t *cont)
  • apr_status_t apr_create_threadattr(apr_threadattr_t **new_attr, apr_pool_t *cont)
  • apr_status_t apr_delete_thread_private(apr_threadkey_t *key)
  • apr_status_t apr_get_thread_private(void **new_mem, apr_threadkey_t *key)
  • apr_status_t apr_get_threaddata(void **data, const char *key, apr_thread_t *thread)
  • apr_status_t apr_get_threadkeydata(void **data, const char *key, apr_threadkey_t *threadkey)
  • apr_status_t apr_getthreadattr_detach(apr_threadattr_t *attr)
  • apr_status_t apr_set_thread_private(void *priv, apr_threadkey_t *key)
  • apr_status_t apr_set_threaddata(void *data, const char *key, apr_status_t (*cleanup) (void *), apr_thread_t *thread)
  • apr_status_t apr_set_threadkeydata(void *data, const char *key, apr_status_t (*cleanup) (void *), apr_threadkey_t *threadkey)
  • apr_status_t apr_setthreadattr_detach(apr_threadattr_t *attr, apr_int32_t on)
  • apr_status_t apr_thread_detach(apr_thread_t *thd)
  • apr_status_t apr_thread_exit(apr_thread_t *thd, apr_status_t *retval)
  • apr_status_t apr_thread_join(apr_status_t *retval, apr_thread_t *thd)
  • APR Time library
  • struct apr_exploded_time_t
  • apr_status_t apr_ansi_time_to_apr_time(apr_time_t *result, time_t input)
  • apr_status_t apr_ctime(char *date_str, apr_time_t t)
  • apr_status_t apr_explode_gmt(apr_exploded_time_t *result, apr_time_t input)
  • apr_status_t apr_explode_localtime(apr_exploded_time_t *result, apr_time_t input)
  • apr_status_t apr_implode_time(apr_time_t *result, apr_exploded_time_t *input)
  • apr_time_t apr_now(void)
  • apr_status_t apr_rfc822_date(char *date_str, apr_time_t t)
  • void apr_sleep(apr_interval_time_t t)
  • apr_status_t apr_strftime(char *s, apr_size_t *retsize, apr_size_t max, const char *format, apr_exploded_time_t *tm)
  • APR UUID Handling
  • apr_status_t apr_parse_uuid(apr_uuid_t *uuid, const char *uuid_str)
  • void apr_get_uuid(apr_uuid_t *uuid)
  • void apr_format_uuid(apr_pool_t *p, const apr_uuid_t *uuid)
  • APR command arguments
  • struct apr_getopt_t
  • apr_status_t apr_initopt(apr_getopt_t **os, apr_pool_t *cont,int argc, char *const *argv)
  • apr_status_t apr_getopt(apr_getopt_t *os, const char *opts, char *optch, const char **optarg)
  • APR general-purpose library
  • apr_status_t apr_validate_password(const char *passwd, const char *hash)
  • apr_status_t apr_getpass(const char *prompt, char *pwbuf, size_t *bufsize)
  • const char * apr_filename_of_pathname(const char *pathname)
  • int apr_vformatter(int (*flush_func)(apr_vformatter_buff_t *b), apr_vformatter_buff_t *c, const char *fmt, va_list ap)
  • int apr_snprintf(char *buf, size_t len, const char *format, ...)
  • int apr_vsnprintf(char *buf, size_t len, const char *format, va_list ap)
  • void apr_note_subprocess(struct apr_pool_t *a, apr_proc_t *pid, enum kill_conditions how)
  • APR lock library
  • apr_status_t apr_child_init_lock(apr_lock_t **lock, const char *fname, apr_pool_t *cont)
  • apr_status_t apr_create_lock(apr_lock_t **lock, apr_locktype_e type, apr_lockscope_e scope, const char *fname, apr_pool_t *cont)
  • apr_status_t apr_destroy_lock(apr_lock_t *lock)
  • apr_status_t apr_get_lockdata(apr_lock_t *lock, const char *key, void *data)
  • apr_status_t apr_lock(apr_lock_t *lock)
  • apr_status_t apr_set_lockdata(apr_lock_t *lock, void *data, const char *key, apr_status_t (*cleanup) (void *))
  • apr_status_t apr_unlock(apr_lock_t *lock)
  • APR memory allocation
  • struct apr_pool_t
  • struct apr_pool_t
  • struct cleanup
  • struct process_chain
  • struct process_chain
  • apr_status_t apr_create_pool(apr_pool_t **newcont, apr_pool_t *cont)
  • apr_status_t apr_get_userdata(void **data, const char *key, apr_pool_t *cont)
  • apr_status_t apr_init_alloc(void)
  • apr_status_t apr_initialize(void)
  • apr_pool_t *apr_make_sub_pool(apr_pool_t *p, int (*apr_abort)(int retcode))
  • apr_status_t apr_set_abort(int (*apr_abort)(int retcode), apr_pool_t *cont)
  • apr_status_t apr_set_userdata(const void *data, const char *key, apr_status_t (*cleanup) (void *), apr_pool_t *cont)
  • apr_size_t apr_bytes_in_pool(apr_pool_t *p)
  • apr_size_t apr_bytes_in_free_blocks(void)
  • apr_status_t apr_run_cleanup(apr_pool_t *p, void *data, apr_status_t (*cleanup) (void *))
  • apr_status_t apr_null_cleanup(void *data)
  • char *apr_strerror(apr_status_t statcode, char *buf, apr_size_t bufsize)
  • void apr_term_alloc(void)
  • void apr_terminate(void)
  • int apr_pool_is_ancestor(apr_pool_t *a, apr_pool_t *b)
  • void apr_kill_cleanup(apr_pool_t *p, const void *data, apr_status_t (*cleanup) (void *))
  • void apr_cleanup_for_exec(void)
  • void apr_clear_pool(apr_pool_t *p)
  • void apr_destroy_pool(apr_pool_t *p)
  • void *apr_palloc(apr_pool_t *c, apr_size_t reqsize)
  • void *apr_pcalloc(apr_pool_t *p, apr_size_t size)
  • void apr_register_cleanup(apr_pool_t *p, const void *data, apr_status_t (*plain_cleanup) (void *), apr_status_t (*child_cleanup) (void *))
  • APR portability Routines
  • apr_status_t apr_get_os_dir(apr_os_dir_t **thedir, apr_dir_t *dir)
  • apr_status_t apr_get_os_exp_time(apr_os_exp_time_t **ostime, apr_exploded_time_t *aprtime)
  • apr_status_t apr_get_os_file(apr_os_file_t *thefile, apr_file_t *file)
  • apr_status_t apr_get_os_imp_time(apr_os_imp_time_t **ostime, apr_time_t *aprtime)
  • apr_status_t apr_get_os_lock(apr_os_lock_t *oslock, apr_lock_t *lock)
  • apr_status_t apr_get_os_sock(apr_os_sock_t *thesock, apr_socket_t *sock)
  • apr_status_t apr_get_os_thread(apr_os_thread_t **thethd, apr_thread_t *thd)
  • apr_status_t apr_get_os_threadkey(apr_os_threadkey_t *thekey, apr_threadkey_t *key)
  • apr_status_t apr_put_os_dir(apr_dir_t **dir, apr_os_dir_t *thedir, apr_pool_t *cont)
  • apr_status_t apr_put_os_exp_time(apr_exploded_time_t *aprtime, apr_os_exp_time_t **ostime, apr_pool_t *cont)
  • apr_status_t apr_put_os_file(apr_file_t **file, apr_os_file_t *thefile, apr_pool_t *cont)
  • apr_status_t apr_put_os_imp_time(apr_time_t *aprtime, apr_os_imp_time_t **ostime, apr_pool_t *cont)
  • apr_status_t apr_put_os_lock(apr_lock_t **lock, apr_os_lock_t *thelock, apr_pool_t *cont)
  • apr_status_t apr_put_os_sock(apr_socket_t **sock, apr_os_sock_t *thesock, apr_pool_t *cont)
  • apr_status_t apr_put_os_thread(apr_thread_t **thd, apr_os_thread_t *thethd, apr_pool_t *cont)
  • apr_status_t apr_put_os_threadkey(apr_threadkey_t **key, apr_os_threadkey_t *thekey, apr_pool_t *cont)
  • APR strings library
  • apr_status_t apr_tokenize_to_argv(const char *arg_str, char ***argv_out, apr_pool_t *token_context);
  • int apr_strnatcasecmp(char const *a, char const *b)
  • int apr_strnatcmp(char const *a, char const *b)
  • char *apr_pstrdup(apr_pool_t *p, const char *s)
  • char *apr_pstrndup(apr_pool_t *p, const char *s, apr_size_t n)
  • char *apr_pstrcat(apr_pool_t *p, ...)
  • char *apr_pvsprintf(apr_pool_t *p, const char *fmt, va_list ap)
  • char *apr_psprintf(apr_pool_t *p, const char *fmt, ...)
  • char *apr_cpystrn(char *dst, const char *src, size_t dst_size)
  • char *apr_collapse_spaces(char *dest, const char *src)
  • Dynamic Object Handling
  • const char *apr_dso_error(apr_dso_handle_t *dso, char *buf, apr_size_t bufsize)
  • apr_status_t apr_dso_load(apr_dso_handle_t **res_handle, const char *path, apr_pool_t *ctx)
  • apr_status_t apr_dso_sym(apr_dso_handle_sym_t *ressym, apr_dso_handle_t *handle, const char *symname)
  • apr_status_t apr_dso_unload(apr_dso_handle_t *handle)
  • Error Codes
  • int apr_canonical_error(apr_status_t err)
  • Fnmatch functions
  • apr_status_t apr_fnmatch(const char *pattern, const char *strings, int flags)
  • int apr_is_fnmatch(const char *pattern)
  • Hash Tables
  • apr_hash_index_t * apr_hash_first(apr_hash_t *ht)
  • apr_hash_index_t * apr_hash_next(apr_hash_index_t *hi)
  • apr_hash_t *apr_make_hash(apr_pool_t *pool)
  • void apr_hash_set(apr_hash_t *ht, const void *key, apr_size_t klen, const void *val)
  • void *apr_hash_get(apr_hash_t *ht, const void *key, apr_size_t klen)
  • void apr_hash_this(apr_hash_index_t *hi, const void **key, apr_size_t *klen, void **val);
  • Shared Memory library
  • apr_status_t apr_get_shm_name(apr_shmem_t *c, apr_shm_name_t **name)
  • apr_status_t apr_open_shmem(apr_shmem_t *c)
  • apr_status_t apr_set_shm_name(apr_shmem_t *c, apr_shm_name_t *name)
  • apr_status_t apr_shm_avail(apr_shmem_t *c, apr_size_t *avail)
  • void *apr_shm_calloc(apr_shmem_t *shared, apr_size_t size)
  • apr_status_t apr_shm_destroy(apr_shmem_t *m)
  • apr_status_t apr_shm_free(apr_shmem_t *shared, void *entity)
  • apr_status_t apr_shm_init(apr_shmem_t **m, apr_size_t reqsize, const char *file, apr_pool_t *cont)
  • void *apr_shm_malloc(apr_shmem_t *c, apr_size_t reqsize)
  • To-Do List

    1.1 apr-site/docs/packages.html Index: packages.html =================================================================== [Apache Portable RunTime] -- Packages

    Documentation for [Apache Portable RunTime]

    Package List

    APR File handling
    APR I18N translation library
    APR MD5 Library
    APR MMAP library
    APR Network library
    APR Process library
    APR Random Functions
    APR Table library
    APR Thread library
    APR Time library
    APR UUID Handling
    APR command arguments
    APR general-purpose library
    APR lock library
    APR memory allocation
    APR portability Routines
    APR strings library
    Dynamic Object Handling
    Error Codes
    Fnmatch functions
    Hash Tables
    Shared Memory library

    © 2000 [Apache Software Foundation]
    Generated by ScanDoc 0.12
    Last Updated: Wed Nov 15 6:34:47 2000
    1.1 apr-site/docs/to-do.html Index: to-do.html =================================================================== [Apache Portable RunTime] -- To-Do list

    To-do list for [Apache Portable RunTime]

    © 2000 [Apache Software Foundation]
    Generated by ScanDoc 0.12
    Last Updated: Wed Nov 15 6:34:47 2000
    1.1 apr-site/images/ball1.gif <> 1.1 apr-site/images/ball2.gif <> 1.1 apr-site/images/bug.gif <> 1.1 apr-site/images/caution.gif <> 1.1 apr-site/images/master.gif <> 1.1 apr-site/images/tip.gif <> 1.1 apr-site/images/warning.gif <>