packages: apache/apache.spec - better description (from docs)
adamg
adamg at pld-linux.org
Sun Feb 26 16:42:09 CET 2012
Author: adamg Date: Sun Feb 26 15:42:09 2012 GMT
Module: packages Tag: HEAD
---- Log message:
- better description (from docs)
---- Files affected:
packages/apache:
apache.spec (1.663 -> 1.664)
---- Diffs:
================================================================
Index: packages/apache/apache.spec
diff -u packages/apache/apache.spec:1.663 packages/apache/apache.spec:1.664
--- packages/apache/apache.spec:1.663 Sun Feb 26 16:17:37 2012
+++ packages/apache/apache.spec Sun Feb 26 16:42:00 2012
@@ -337,14 +337,22 @@
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
@@ -419,7 +427,8 @@
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
@@ -535,7 +544,11 @@
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
@@ -650,7 +663,8 @@
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
@@ -702,7 +716,19 @@
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
@@ -849,7 +875,21 @@
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
@@ -1024,7 +1064,14 @@
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
@@ -1093,7 +1140,9 @@
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
@@ -1310,7 +1359,14 @@
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
@@ -1320,7 +1376,14 @@
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
@@ -1408,7 +1471,8 @@
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
@@ -1418,7 +1482,8 @@
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
@@ -1428,7 +1493,8 @@
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
@@ -1438,7 +1504,8 @@
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
@@ -1492,7 +1559,7 @@
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
@@ -1633,7 +1700,9 @@
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.
@@ -1643,7 +1712,11 @@
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.
@@ -1653,7 +1726,20 @@
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
@@ -1706,7 +1792,25 @@
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
@@ -1716,7 +1820,22 @@
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
@@ -1726,7 +1845,13 @@
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
@@ -1736,7 +1861,13 @@
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
@@ -1746,7 +1877,18 @@
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
@@ -1776,7 +1918,12 @@
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.
@@ -1786,7 +1933,13 @@
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.
@@ -1796,7 +1949,8 @@
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.
@@ -1806,7 +1960,9 @@
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.
@@ -1816,7 +1972,9 @@
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
@@ -2016,7 +2174,14 @@
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
@@ -2026,7 +2191,13 @@
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
@@ -3335,6 +3506,9 @@
All persons listed below can be reached at <cvs_login>@pld-linux.org
$Log$
+Revision 1.664 2012/02/26 15:42:00 adamg
+- better description (from docs)
+
Revision 1.663 2012/02/26 15:17:37 adamg
- triggers to ease upgrade to 2.4 (handles simple configuration properly)
================================================================
---- CVS-web:
http://cvs.pld-linux.org/cgi-bin/cvsweb.cgi/packages/apache/apache.spec?r1=1.663&r2=1.664&f=u
More information about the pld-cvs-commit
mailing list