]> git.ipfire.org Git - thirdparty/freeradius-server.git/commitdiff
Fix the asciidoc title 2453/head
authorJorge Pereira <jpereiran@gmail.com>
Thu, 31 Jan 2019 01:34:33 +0000 (23:34 -0200)
committerJorge Pereira <jpereiran@gmail.com>
Thu, 31 Jan 2019 01:35:27 +0000 (23:35 -0200)
25 files changed:
raddb/mods-available/abfab_psk_sql
raddb/mods-available/always
raddb/mods-available/attr_filter
raddb/mods-available/cache
raddb/mods-available/cache_eap
raddb/mods-available/cache_tls
raddb/mods-available/chap
raddb/mods-available/cipher
raddb/mods-available/client
raddb/mods-available/couchbase
raddb/mods-available/csv
raddb/mods-available/cui
raddb/mods-available/date
raddb/mods-available/delay
raddb/mods-available/detail
raddb/mods-available/detail.example.com
raddb/mods-available/detail.log
raddb/mods-available/dhcp_sqlippool
raddb/mods-available/dhcpv4
raddb/mods-available/digest
raddb/mods-available/echo
raddb/mods-available/escape
raddb/mods-available/etc_group
raddb/mods-available/exec
raddb/mods-available/expiration

index 22a4767a005e70b963e70b3fabb779107f906146..91e387d39b5c2dd708d7cc9154ce2974f47d1adf 100644 (file)
@@ -2,15 +2,17 @@
 #
 # :toc:
 #
-#      $Id$
+# $Id$
 
 #######################################################################
 #
-# ## ADFAB PSK Module
+#  = ADFAB PSK Module
 #
-# The `abfab_psk_sql` module is used to authorize PSK from `ABFAB` trust router.
+#  The `abfab_psk_sql` module is used to authorize PSK from `ABFAB` trust router.
 #
-# ## Default instance
+
+#
+#  ## Default instance
 #
 
 #
@@ -20,7 +22,7 @@ sql psksql {
        #
        # driver:: Database driver.
        #
-       driver = "rlm_sql_sqlite"
+       driver = "rlm_sql_sqlite"
 
        #
        # sqlite { ... }:: Database statement based on `driver` setting.
index 89101f5b4b71024108ebc9f0b1abc8c6734c401d..df4d473a816fe360dbd87396f23c39b1151f03bc 100644 (file)
@@ -6,16 +6,11 @@
 
 #######################################################################
 #
-# ## Always Module
+#  = Always Module
 #
 #  The `always` module simply returns the same result, always, without
 #  doing anything else.  It is here for use in complex policies.
 #
-
-#
-# ## Sample configuration
-#
-
 #always <value> {
        #
        #  rcode:: Return code.
@@ -58,7 +53,7 @@
 #}
 
 #
-# ### Default instances
+# ## Default instances
 #
 #  The following default instances allow the use of return codes like
 #  `reject` or `ok` in `unlang` policies.
index 777fda40da7d4e2d405cf7019da70535a7234be9..af93f8b2ed75153caf79f26d77be8cd04fa59375 100644 (file)
@@ -6,15 +6,10 @@
 
 #######################################################################
 #
-# ## Attr_filter Module
+#  = Attr_filter Module
 #
 #  The `attr_filter` module defines a number of instances of the "attr_filter".
 #
-
-#
-# ## Sample configuration
-#
-
 #attr_filter attr_filter.<section> {
        #
        #  key::
@@ -31,7 +26,7 @@
 #      filename = </path/><section>
 #}
 
-# ## Default instances
+#  ## Default instances
 #
 #  The following default instances.
 
index ff40d42b8c9cd3f43bc9ccd8c1cace8a5cbcf39c..1116ae3896b692c5004d93b2683a2d3a4a725bdb 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-# ## Cache Module
+#  = Cache Module
 #
 #  The `cache` module is used to cache attributes. The idea is that you can look
 #  up information in a database, and then cache it. Repeated requests for the same
@@ -63,9 +63,10 @@ cache {
 
 #
 #  ### Memcached cache driver
+#
 #      memcached {
                #
-               # options:: Memcached configuration options.
+               #  options:: Memcached configuration options.
                #
                #  The memcached options are documented at
                #  http://docs.libmemcached.org/libmemcached_configuration.html#memcached
@@ -88,9 +89,10 @@ cache {
 
 #
 #  ### Redis cache driver
+#
 #      redis {
                #
-               # server:: Redis Server name.
+               #  server:: Redis Server name.
                #
                #  If using Redis cluster, multiple 'bootstrap' servers may be
                #  listed here (as separate config items). These will be contacted
@@ -141,12 +143,12 @@ cache {
 #      }
 
        #
-       # key:: The `key` used to index the cache. It is dynamically expanded at run time.
+       #  key:: The `key` used to index the cache. It is dynamically expanded at run time.
        #
        key = &User-Name
 
        #
-       # ttl::
+       #  ttl::
        #
        #  The TTL of cache entries, in seconds. Entries older than this
        #  will be expired.
@@ -163,7 +165,7 @@ cache {
        #  You should never set the "epoch" configuration item in this file.
 
        #
-       # add_stats::
+       #  add_stats::
        #
        #  If `yes` the following attributes will be added to the request:
        #  * `&request:Cache-Entry-Hits` - The number of times this entry
index 5df710ac73f51c8526527d2320414e4ba6d75f6d..70f0897d2d73bc16b6d07d3ab2b2fc245d6a8848 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-# ## Cache EAP Module
+#  = Cache EAP Module
 #
 #  The `cache_eap` module caches EAP replies.
 #
index 9e0b0b828c085deb21bcda9285342c7a4dc31623..cf53aa7b71f7d71ac07fa655a57137b1c8846184 100644 (file)
@@ -6,9 +6,9 @@
 
 #######################################################################
 #
-# ## Cache TLS Session Module
+#  = Cache TLS Session Module
 #
-#  The `cache_tls_session` module caches TLS sessions for resiliency.
+#  The `cache_tls` module caches TLS sessions for resiliency.
 #
 #  This module should be listed in a `send Access-Accept` section to
 #  write the cache, and in `recv Access-Request` to read the cache.
index 31ce2a82623b2073e09ee102077115329dd9b952..37b39642e3afcddde452e7bd266f697543a43197 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-# ## CHAP module
+#  = CHAP module
 #
 #  This module authenticates requests containing a `CHAP-Password`
 #  attribute.
index 7179589dc27789f0561ccfb9ade98430859d7260..ff867c8e653a5fb8c96bd71544e3d028db54728a 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-# ## Cipher Module
+#  = Cipher Module
 #
 #  The `cipher` module is used to transform plaintext in some way that is dependent
 #  on a key or key pair, producing encrypted ciphertext.
@@ -26,7 +26,7 @@
 #  You should use armouring expansions i.e. `%{base64_encode:}`, `%{base64_decode:}` if the values
 #  are to be passed outside of FreeRADIUS.
 #
-#  E.g:
+#  e.g:
 #
 #    %{base64_encode:%{cipher_encrypt:<plaintext>}}
 #    %{cipher_decrypt:%{base64_decode:<ciphertext>}}
 #
 cipher {
        #
-       # ### RSA asymmetrically keyed ciphering
-       #
-
-       #
-       # type::
+       #  type::
        #
        #  Available schemes are:
        #
@@ -71,6 +67,9 @@ cipher {
        #
        type = rsa
 
+       #
+       #  ### RSA asymmetrically keyed ciphering
+       #
        rsa {
                #  private_key_password::
                #
index 9c30b1ecf13b48a4d12dfc55ddf0e6071ec6a8a6..423a8169ee7638b1f78c6adf3877812befc5e7dc 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-#  ## Client Module
+#  = Client Module
 #
 #  The `client` module loads RADIUS clients as needed, rather than when the server
 #  starts.
 #  In addition to loading `client` definitions in from flat files, the clients module can
 #  also be used to access data from previously defined clients.
 #
-#  #### Client config item to attribute mapping.
+#  ### Client config item to attribute mapping.
 #
 #  Maps arbitrary fields from a client definition to attributes in the current request.
 #
 #  [source,unlang]
 #  ---
-#  map client [<ipaddr>] {                             // <1>
-#       &Tmp-String-0 = 'nas_type'             // <2>
-#       &Tmp-String-1 := 'shortname'   // <3>
-#       &Tmp-String-3 += 'groups'              // <4>
+#  map client [<ipaddr>] {            // <1>
+#       &Tmp-String-0 = 'nas_type'    // <2>
+#       &Tmp-String-1 := 'shortname'  // <3>
+#       &Tmp-String-3 += 'groups'     // <4>
 #  }
 #  ---
 #
 #  <2> Assigns the value of the `nas_type` field from the client definition to
 #      `&Tmp-String-0` if `&Tmp-String-0` doesn't exist.
 #  <3> Assigns the value of the `shortname` field from the client definition to
-#      `&Tmp-String-1`
+#      `&Tmp-String-1`.
 #  <4> Creates multiple `&Tmp-String-3` attributes from a custom group field associated
 #      with the client.
 #
-#  #### Client config item access expansion.
+#  ### Client config item access expansion.
 #
 #  [options="header,autowidth"]
 #  |===
 #  | XLAT                          | Description
-#  | `%{client:nas_type}`          | Expands to client's `nas_type` (or "" if nas_type not set)
+#  | `%{client:nas_type}`          | Expands to client's `nas_type` (or "" if nas_type not set).
 #  | `%{client:<ipaddr>.nas_type}` | Expands to the `nas_type` of the client specified
 #                                    by `<ipaddr>` (or "" if `nas_type` not set).
 #  |===
 #
 
+#
 #  ## Default instance
 #
 #  This module takes no configuration.
index 3a4cd69c07c11be6cf7627434e686e3b95b665a9..d507dd561f5a226bebd6af011797a8c99b7d2886 100644 (file)
@@ -3,9 +3,10 @@
 # :toc:
 #
 #  $Id$
+
 #######################################################################
 #
-# ## Couchbase Module
+# = Couchbase Module
 #
 # The `couchbase` module is used to provides connections to a Couchbase database.
 #
index c220c37f20b9ca60437f7422bb7492b501e109b2..8de5ad964356bcf469f248dacc6ccedc3a5f19b0 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-#  ## CSV Module
+#  = CSV Module
 #
 #  Read CSV files and use them in maps.
 #
index 85431e7fcdb2e5d41f30d24b14650d458236cb63..4259ca1bdbd3e09fd091947e6317f65398bbd9f8 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-#  ## CUI Module
+#  = CUI Module
 #
 #  The module `cui` (`Chargeable-User-Identity`) writes
 #  `Chargeable-User-Identity` log to an SQL database.   It uses the `sql`
index b96732397f8b502afc254487765947d985b83f28..19ed9c24f9ffeaf1b484a7ae6e867b72fa90b65b 100644 (file)
@@ -3,9 +3,10 @@
 # :toc:
 #
 #  $Id$
+
 #######################################################################
 #
-# ## Date Module
+# = Date Module
 #
 # The `date` module xlat does convert time formats.
 #
@@ -42,11 +43,11 @@ date {
        #
        #  ."Get time" mode:
        #
-       #  If the input is the string "request", the `xlat` will format the
+       #  If the input is the string `request`, the `xlat` will format the
        #  time the current request packet arrived according to the format
        #  string, and return it as a string.
        #
-       #  If the input is the string "now", the `xlat` will behave as
+       #  If the input is the string `now`, the `xlat` will behave as
        #  above, for the current time.
        #
        #  See also the core provided expansions which are equivalent to
@@ -77,7 +78,7 @@ date {
 #
 # ### ISO format
 #
-#  The core xlat, `%T` returns the request timestamp in `ISO` format
+#  The core `xlat`, `%T` returns the request timestamp in `ISO` format
 #  including milliseconds. This expansion returns it without the
 #  millisecond component.
 #
index ddea23cacc7abfb39979d5604616b7b9a8fe9997..42b0b876b54f93d5d968298f7b18e5d4b23bcbdb 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-# ## Delay Module
+# = Delay Module
 #
 #  The `delay` module delays the processing of a request in a
 #  non-blocking fashion.
index 88cce92b3e7f8b6ab6eeada484ca4f10a9071dfe..55aaa71d8076053478055ed45aa90f5e143f5175 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-#  ## Detail Module
+#  = Detail Module
 #
 #  Write a detailed log of all accounting records received.
 #
index 456d8bcbb3c893a5b4a0d9d7e2319e1ce118cf03..5f30e6aee85223e93dafe86d6f909c207f33d3af 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-#  ## Detail Module (Sample)
+#  = Detail Module (Sample)
 #
 #  Please see the `detail` module for full documentation.
 #
index 72585c8897105fa6f48c1e753c16a0c05dbb104a..145cd3a0c1affa3b32932e72cdcd46799d342806 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-#  ## Detail Module (Log Sample)
+#  = Detail Module (Log Sample)
 #
 #  More examples of doing detail logs.
 #
index 708a09c497f36aa8536d8417c7b12d9aec775af4..b83d19fdee43b4532d7d9d0579d0bf174152b7f9 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-#  ## DHCP SQL-IP-Pool Module
+#  = DHCP SQL-IP-Pool Module
 #
 #  The module `dhcp_sqlippool` provides configuration for `DHCP` to use `SQL IP Pools`.
 #
@@ -17,7 +17,7 @@
 #  * See `raddb/sites-available/dhcp` for instructions on how to configure the DHCP server.
 #  ====
 #
-#  ## Default instance
+#  # Default instance
 #
 sqlippool dhcp_sqlippool {
        #
index 2fe1d7b107152ef7b1472dc7c47674599962458b..1c59f45b463a5dc1a608d5b0d4bdcdb306813c9f 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-#  ## DHCPv4 Module
+#  = DHCPv4 Module
 #
 #  The `dhcpv4` module is useful only for `xlat`. To use it,
 #  put `dhcp` into the `instantiate { ... }` section.
@@ -28,7 +28,7 @@
 #
 
 #
-#  ## Default instance
+#  # Default instance
 #
 #  This module takes no configuration.
 #
index 7e2e55ccc4366f66b37509d3e1afbf8916f4b549..205c2323fd7258730bd6f8e33a0cde9992ed9421 100644 (file)
@@ -4,7 +4,7 @@
 
 #######################################################################
 #
-#  ## Digest Module
+#  = Digest Module
 #
 #  The `digest` module is used for performing authentication against a Cisco SIP server.
 #
index 0a23e24560af1f83772638865219d0f8ba84d09d..b80576f5d7f64f1d026e7531391bf2ce0c2d91b2 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-# ## Echo Module
+#  = Echo Module
 #
 #  The `echo` module is used for execute an external program in more than
 #  one section (e.g. `recv`, `pre_proxy`, etc), then it is probably best
index aaf5f4d810ce6a2f31475f32f5990b128939d262..4da8ef6505181d24f2d1d921583b112ea5365f1e 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-#  ## Escape Module
+#  = Escape Module
 #
 #  The `escape` module registers two `xlat` functions.
 #
@@ -23,7 +23,9 @@
 #
 escape {
        #
-       # safe_characters:: List with allowed characters.
+       #  safe_characters::
+       #
+       #  Characters that will not be encoded by the `%{escape}` `xlat` function.
        #
        safe_characters = "@abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789.-_: /äéöüàâæçèéêëîïôœùûüaÿÄÉÖÜßÀÂÆÇÈÉÊËÎÏÔŒÙÛÜŸ"
 }
index 19d38d698ef30a1f3e9b95fc2da2690593552571..80f851e9463b4afea40943644f32f963e6a4f3cc 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-#  ## etc_group Module
+#  = etc_group Module
 #
 #  The `etc_group` module provides group names from the `/etc/group` file.
 #
index 638e2b040f43d5798b378438b6449874ebdb7346..a140e3ac839a1873c719139abc57b96b10874fec 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-#  ## Exec Module
+#  = Exec Module
 #
 #  The module `exec` is used for executing external programs.
 #
index e2b4644ba7a91615e782dd4b1cf35bb110b2b664..a8cb707124e8b619fd49b947a2ecc83693630664 100644 (file)
@@ -6,7 +6,7 @@
 
 #######################################################################
 #
-# ## Expiration Module
+# = Expiration Module
 #
 # The `expiration` module manages the `Expiration` attribute.
 #
@@ -16,7 +16,7 @@
 #
 
 #
-# ## Sample configuration
+# ## Default instance
 #
 # This module takes no configuration.
 #