]> git.pld-linux.org Git - packages/apache.git/commitdiff
- better description (from docs)
authorAdam Gołębiowski <adamg@pld-linux.org>
Sun, 26 Feb 2012 15:42:00 +0000 (15:42 +0000)
committercvs2git <feedback@pld-linux.org>
Sun, 24 Jun 2012 12:13:13 +0000 (12:13 +0000)
Changed files:
    apache.spec -> 1.664

apache.spec

index 104fdd0f6e6e876ce90955a956b284ecb769ee2f..2b75dc9580c6fb0d2f0449a6f3d84e94466cf5b7 100644 (file)
@@ -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 <Directory>, 
+<Files>, and <Location> 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 <Require ip> 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
This page took 0.1301 seconds and 4 git commands to generate.