From 5d23c9b1d40bd4421ef4b19df9426d68db0cdcf7 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Adam=20Go=C5=82=C4=99biowski?= Date: Sun, 26 Feb 2012 15:42:00 +0000 Subject: [PATCH] - better description (from docs) Changed files: apache.spec -> 1.664 --- apache.spec | 233 +++++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 202 insertions(+), 31 deletions(-) diff --git a/apache.spec b/apache.spec index 104fdd0..2b75dc9 100644 --- a/apache.spec +++ b/apache.spec @@ -336,14 +336,22 @@ utilitário apxs para a construção de objetos compartilhados dinâmicos desenvolver módulos adicionais para o Apache. %package mod_access_compat -Summary: Group authorizations based on host (name or IPaddress) +Summary: Group authorizations based on host (name or IP address) Group: Networking/Daemons/HTTP URL: http://httpd.apache.org/docs/2.4/mod/mod_access_compat.html Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_access_compat) = %{version}-%{release} %description mod_access_compat -Group authorizations based on host (name or IPaddress) +The directives provided by mod_access_compat are used in , +, and sections as well as .htaccess files to control +access to particular parts of the server. Access can be controlled +based on the client hostname, IP address, or other characteristics of +the client request, as captured in environment variables. The Allow +and Deny directives are used to specify which clients are or are not +allowed access to the server, while the Order directive sets the +default access state, and configures how the Allow and Deny directives +interact with each other. %package mod_actions Summary: Apache module for executing CGI scripts based on media type or request method @@ -418,7 +426,8 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_allowmethods) = %{version}-%{release} %description mod_allowmethods -Easily restrict what HTTP methods can be used on the server +This module makes it easy to restrict what HTTP methods can used on an +server. %package mod_asis Summary: Sends files that contain their own HTTP headers @@ -534,7 +543,11 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_auth_form) = %{version}-%{release} %description mod_auth_form -Form authentication +This module allows the use of an HTML login form to restrict access by +looking up users in the given providers. HTML forms require +significantly more configuration than the alternatives, +however an HTML login form can provide a much friendlier experience +for end users. %package mod_authn_anon Summary: Apache module that allows "anonymous" user access to authenticated areas @@ -649,7 +662,8 @@ Requires: %{name}-mod_authn_core = %{version}-%{release} Provides: apache(mod_authn_socache) = %{version}-%{release} %description mod_authn_socache -Manages a cache of authentication credentials to relievethe load on backends +This module maintains a cache of authentication credentials, so that a +new backend lookup is not required for every authenticated request. %package mod_authnz_ldap Summary: Apache module that allows an LDAP directory to be used to store the database for HTTP Basic authentication @@ -701,7 +715,19 @@ Requires: %{name}-mod_authz_core = %{version}-%{release} Provides: apache(mod_authz_dbd) = %{version}-%{release} %description mod_authz_dbd -Group Authorization and Login using SQL +This module provides authorization capabilities so that authenticated +users can be allowed or denied access to portions of the web site by +group membership. Similar functionality is provided by +mod_authz_groupfile and mod_authz_dbm, with the exception that this +module queries a SQL database to determine whether a user is a member +of a group. + +This module can also provide database-backed user login/logout +capabilities. These are likely to be of most value when used in +conjunction with mod_authn_dbd. + +This module relies on mod_dbd to specify the backend database driver +and connection parameters, and manage the database connections. %package mod_authz_dbm Summary: Apache module that allows group authorization using DBM files @@ -848,7 +874,21 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_buffer) = %{version}-%{release} %description mod_buffer -Support for request buffering +This module provides the ability to buffer the input and output filter +stacks. + +Under certain circumstances, content generators might create content +in small chunks. In order to promote memory reuse, in memory chunks +are always 8k in size, regardless of the size of the chunk itself. +When many small chunks are generated by a request, this can create a +large memory footprint while the request is being processed, and an +unnecessarily large amount of data on the wire. The addition of a +buffer collapses the response into the fewest chunks possible. + +When httpd is used in front of an expensive content generator, +buffering the response may allow the backend to complete processing +and release resources sooner, depending on how the backend is +designed. %package mod_cache Summary: Content cache keyed to URIs @@ -1023,7 +1063,14 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_data) = %{version}-%{release} %description mod_data -Convert response body into an RFC2397 data URL +This module provides the ability to convert a response into an RFC2397 +data URL. + +Data URLs can be embedded inline within web pages using something like +the mod_include module, to remove the need for clients to make +separate connections to fetch what may potentially be many small +images. Data URLs may also be included into pages generated by +scripting languages such as PHP. %package mod_dav Summary: Apache module - Distributed Authoring and Versioning @@ -1092,7 +1139,9 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_dialup) = %{version}-%{release} %description mod_dialup -Send static content at a bandwidth rate limit, defined by the various old modem standards +t is a module that sends static content at a bandwidth rate limit, +defined by the various old modem standards. So, you can browse your +site with a 56k V.92 modem. %package mod_dir Summary: Apache module for "trailing slash" redirects and serving directory index files @@ -1309,7 +1358,14 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_heartbeat) = %{version}-%{release} %description mod_heartbeat -sends messages with server status to frontend proxy +mod_heartbeat sends multicast messages to a mod_heartmonitor listener +that advertises the servers current connection count. Usually, +mod_heartmonitor will be running on a proxy server with +mod_lbmethod_heartbeat loaded, which allows ProxyPass to use the +"heartbeat" lbmethod inside of ProxyPass. + +mod_heartbeat itself is loaded on the origin server(s) that serve +requests through the proxy server(s). %package mod_heartmonitor Summary: centralized monitor for mod_heartbeat origin servers @@ -1319,7 +1375,14 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_heartmonitor) = %{version}-%{release} %description mod_heartmonitor -centralized monitor for mod_heartbeat origin servers +mod_heartmonitor listens for server status messages generated by +mod_heartbeat enabled origin servers and makes their status available +to mod_lbmethod_heartbeat. This allows ProxyPass to use the +"heartbeat" lbmethod inside of ProxyPass. + +This module uses the services of mod_slotmem_shm when available +instead of flat-file storage. No configuration is required to use +mod_slotmem_shm. %package mod_ident Summary: RFC 1413 ident lookups @@ -1407,7 +1470,8 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_lbmethod_bybusyness) = %{version}-%{release} %description mod_lbmethod_bybusyness -Pending Request Counting load balancer scheduler algorithm for mod_proxy_balancer +Pending Request Counting load balancer scheduler algorithm for +mod_proxy_balancer. %package mod_lbmethod_byrequests Summary: Request Counting load balancer scheduler algorithm for mod_proxy_balancer @@ -1417,7 +1481,8 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_lbmethod_byrequests) = %{version}-%{release} %description mod_lbmethod_byrequests -Request Counting load balancer scheduler algorithm for mod_proxy_balancer +Request Counting load balancer scheduler algorithm for +mod_proxy_balancer. %package mod_lbmethod_bytraffic Summary: Weighted Traffic Counting load balancer scheduler algorithm for mod_proxy_balancer @@ -1427,7 +1492,8 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_lbmethod_bytraffic) = %{version}-%{release} %description mod_lbmethod_bytraffic -Weighted Traffic Counting load balancer scheduler algorithm for mod_proxy_balancer +Weighted Traffic Counting load balancer scheduler algorithm for +mod_proxy_balancer. %package mod_lbmethod_heartbeat Summary: Heartbeat Traffic Counting load balancer scheduler algorithm for mod_proxy_balancer @@ -1437,7 +1503,8 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_lbmethod_heartbeat) = %{version}-%{release} %description mod_lbmethod_heartbeat -Heartbeat Traffic Counting load balancer scheduler algorithm for mod_proxy_balancer +Heartbeat Traffic Counting load balancer scheduler algorithm for +mod_proxy_balancer. %package mod_ldap Summary: Apache module for LDAP connection pooling and result caching services for other LDAP modules @@ -1491,7 +1558,7 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_log_debug) = %{version}-%{release} %description mod_log_debug -Additional configurable debug logging +Additional configurable debug logging. %package mod_log_forensic Summary: Forensic Logging of the requests made to the server @@ -1632,7 +1699,9 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_ratelimit) = %{version}-%{release} %description mod_ratelimit -Bandwidth Rate Limiting for Clients +Provides a filter named RATE_LIMIT to limit client bandwidth. The +connection speed to be simulated is specified, in KiB/s, using the +environment variable rate-limit. %package mod_reflector Summary: Reflect a request body as a response via the output filter stack. @@ -1642,7 +1711,11 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_reflector) = %{version}-%{release} %description mod_reflector -Reflect a request body as a response via the output filter stack. +This module allows request bodies to be reflected back to the client, +in the process passing the request through the output filter stack. A +suitably configured chain of filters can be used to transform the +request into a response. This module can be used to turn an output +filter into an HTTP service. %package mod_remoteip Summary: Replaces the original client IP address for the connectionwith the useragent IP address list presented by a proxies or a load balancervia the request headers. @@ -1652,7 +1725,20 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_remoteip) = %{version}-%{release} %description mod_remoteip -Replaces the original client IP address for the connectionwith the useragent IP address list presented by a proxies or a load balancervia the request headers. +This module is used to treat the useragent which initiated the request +as the originating useragent as identified by httpd for the purposes +of authorization and logging, even where that useragent is behind a +load balancer, front end server, or proxy server. + +The module overrides the client IP address for the connection with the +useragent IP address reported in the request header configured with +the RemoteIPHeader directive. + +Once replaced as instructed, this overridden useragent IP address is +then used for the mod_authz_host feature, is reported by +mod_status, and is recorded by mod_log_config %a and core %a format +strings. The underlying client IP of the connection is available in +the %{c}a format string. %package mod_reqtimeout Summary: Apache module to set timeout and minimum data rate for receiving requests @@ -1705,7 +1791,25 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_sed) = %{version}-%{release} %description mod_sed -Filter Input (request) and Output (response) content using sed syntax +mod_sed is an in-process content filter. The mod_sed filter implements +the sed editing commands implemented by the Solaris 10 sed program as +described in the manual page. However, unlike sed, mod_sed doesn't +take data from standard input. Instead, the filter acts on the entity +data sent between client and server. mod_sed can be used as an input +or output filter. mod_sed is a content filter, which means that it +cannot be used to modify client or server http headers. + +The mod_sed output filter accepts a chunk of data, executes the sed +scripts on the data, and generates the output which is passed to the +next filter in the chain. + +The mod_sed input filter reads the data from the next filter in the +chain, executes the sed scripts, and returns the generated data to the +caller filter in the filter chain. + +Both the input and output filters only process the data if newline +characters are seen in the content. At the end of the data, the rest +of the data is treated as the last line. %package mod_session Summary: Session support @@ -1715,7 +1819,22 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_session) = %{version}-%{release} %description mod_session -Session support +This module provides support for a server wide per user session +interface. Sessions can be used for keeping track of whether a user +has been logged in, or for other per user information that should be +kept available across requests. + +Sessions may be stored on the server, or may be stored on the browser. +Sessions may also be optionally encrypted for added security. These +features are divided into several modules in addition to mod_session; +mod_session_crypto, mod_session_cookie and mod_session_dbd. Depending +on the server requirements, load the appropriate modules into the +server (either statically at compile time or dynamically via the +LoadModule directive). + +Sessions may be manipulated from other modules that depend on the +session, or the session may be read from and written to using +environment variables and HTTP headers, as appropriate. %package mod_session_cookie Summary: Cookie based session support @@ -1725,7 +1844,13 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_session_cookie) = %{version}-%{release} %description mod_session_cookie -Cookie based session support +This submodule of mod_session provides support for the storage of user +sessions on the remote browser within HTTP cookies. + +Using cookies to store a session removes the need for the server or a +group of servers to store the session locally, or collaborate to share +a session, and can be useful for high traffic environments where a +server based session might be too resource intensive. %package mod_session_crypto Summary: Session encryption support @@ -1735,7 +1860,13 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_session_crypto) = %{version}-%{release} %description mod_session_crypto -Session encryption support +This submodule of mod_session provides support for the encryption of +user sessions before being written to a local database, or written to +a remote browser via an HTTP cookie. + +This can help provide privacy to user sessions where the contents of +the session should be kept private from the user, or where protection +is needed against the effects of cross site scripting attacks. %package mod_session_dbd Summary: DBD/SQL based session support @@ -1745,7 +1876,18 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_session_dbd) = %{version}-%{release} %description mod_session_dbd -DBD/SQL based session support +This submodule of mod_session provides support for the storage of user +sessions within a SQL database using the mod_dbd module. + +Sessions can either be anonymous, where the session is keyed by a +unique UUID string stored on the browser in a cookie, or per user, +where the session is keyed against the userid of the logged in user. + +SQL based sessions are hidden from the browser, and so offer a measure +of privacy without the need for encryption. + +Different webservers within a server farm may choose to share a +database, and so share sessions with one another. %package mod_setenvif Summary: Allows the setting of environment variables based on characteristics of the request @@ -1775,7 +1917,12 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_slotmem_plain) = %{version}-%{release} %description mod_slotmem_plain -Slot-based shared memory provider. +mod_slotmem_plain is a memory provider which provides for creation and +access to a plain memory segment in which the datasets are organized +in "slots." + +If the memory needs to be shared between threads and processes, a +better provider would be mod_slotmem_shm. %package mod_slotmem_shm Summary: Slot-based shared memory provider. @@ -1785,7 +1932,13 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_slotmem_shm) = %{version}-%{release} %description mod_slotmem_shm -Slot-based shared memory provider. +mod_slotmem_shm is a memory provider which provides for creation and +access to a shared memory segment in which the datasets are organized +in "slots." + +All shared memory is cleared and cleaned with each restart, whether +graceful or not. The data itself is stored and restored within a file +noted by the name parameter in the create and attach calls. %package mod_socache_dbm Summary: DBM based shared object cache provider. @@ -1795,7 +1948,8 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_socache_dbm) = %{version}-%{release} %description mod_socache_dbm -DBM based shared object cache provider. +mod_socache_dbm is a shared object cache provider which provides for +creation and access to a cache backed by a DBM database. %package mod_socache_memcache Summary: Memcache based shared object cache provider. @@ -1805,7 +1959,9 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_socache_memcache) = %{version}-%{release} %description mod_socache_memcache -Memcache based shared object cache provider. +mod_socache_memcache is a shared object cache provider which provides +for creation and access to a cache backed by the memcached +high-performance, distributed memory object caching system. %package mod_socache_shmcb Summary: shmcb based shared object cache provider. @@ -1815,7 +1971,9 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_socache_shmcb) = %{version}-%{release} %description mod_socache_shmcb -shmcb based shared object cache provider. +mod_socache_shmcb is a shared object cache provider which provides for +creation and access to a cache backed by a high-performance cyclic +buffer inside a shared memory segment. %package mod_speling Summary: Attempts to correct mistaken URLs by ignoring capitalization and by allowing up to one misspelling @@ -2015,7 +2173,14 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_watchdog) = %{version}-%{release} %description mod_watchdog -provides infrastructure for other modules to periodically run tasks +mod_watchdog defines programmatic hooks for other modules to +periodically run tasks. These modules can register handlers for +mod_watchdog hooks. + +Currently, the following modules in the Apache distribution use this +functionality: +- mod_heartbeat +- mod_heartmonitor %package mod_xml2enc Summary: Enhanced charset/internationalisation support for libxml2-basedfilter modules @@ -2025,7 +2190,13 @@ Requires: %{name}-base = %{version}-%{release} Provides: apache(mod_xml2enc) = %{version}-%{release} %description mod_xml2enc -Enhanced charset/internationalisation support for libxml2-basedfilter modules +This module provides enhanced internationalisation support for +markup-aware filter modules such as mod_proxy_html. It can +automatically detect the encoding of input data and ensure they are +correctly processed by the libxml2 parser, including converting to +Unicode (UTF-8) where necessary. It can also convert data to an +encoding of choice after markup processing, and will ensure the +correct charset value is set in the HTTP Content-Type header. %package -n htpasswd-%{name} Summary: Apache 2 htpasswd utility: manage user files for basic authentication -- 2.44.0