Преглед изворни кода

doc: updated references to block lists

Daniel-Constantin Mierla пре 4 година
родитељ
комит
2c279c1ae0

+ 1 - 1
doc/misc/README-MODULES

@@ -52,7 +52,7 @@ auth_radius		Radius authentication
 avp			Collection of functions for handling AVP's (from SER)
 avpops			Attribute-value pair operations ("variables")
 benchmark		Development benchmark module
-blst			Blacklisting API for configuration scripts
+blst			Blocklisting API for configuration scripts
 call_control		Call timeouts and management (depends on Dialog module)
 carrierroute		A telephony routing module
 cdp			C Diameter Peer - core communication engine

+ 1 - 1
doc/tutorials/cfg.txt

@@ -191,7 +191,7 @@ structure and the handle for it. Than use the handle of the core to access
 the variable:
 
 #include "../../cfg_core.h"
-cfg_get(core, core_cfg, use_dst_blacklist)
+cfg_get(core, core_cfg, use_dst_blocklist)
 
 2) For the core, module, or script: access the variables by their group
 and variable name:

+ 14 - 14
doc/tutorials/cfg_list/cfg_core.txt

@@ -19,41 +19,41 @@ Configuration Variables for core
         Default: 4.
         Type: integer.
 
- 4. core.use_dst_blacklist
-        enable/disable destination blacklisting.
+ 4. core.use_dst_blocklist
+        enable/disable destination blocklisting.
         Default: 0.
         Range: 0 - 1.
         Type: integer.
 
- 5. core.dst_blacklist_expire
-        how much time (in s) a blacklisted destination is kept in the
+ 5. core.dst_blocklist_expire
+        how much time (in s) a blocklisted destination is kept in the
         list.
         Default: 60.
         Type: integer.
 
- 6. core.dst_blacklist_mem
+ 6. core.dst_blocklist_mem
         maximum shared memory amount (in KB) used for keeping the
-        blacklisted destinations.
+        blocklisted destinations.
         Default: 250.
         Type: integer.
 
- 7. core.dst_blacklist_udp_imask
-        blacklist event ignore mask for UDP.
+ 7. core.dst_blocklist_udp_imask
+        blocklist event ignore mask for UDP.
         Default: 0.
         Type: integer.
 
- 8. core.dst_blacklist_tcp_imask
-        blacklist event ignore mask for TCP.
+ 8. core.dst_blocklist_tcp_imask
+        blocklist event ignore mask for TCP.
         Default: 0.
         Type: integer.
 
- 9. core.dst_blacklist_tls_imask
-        blacklist event ignore mask for TLS.
+ 9. core.dst_blocklist_tls_imask
+        blocklist event ignore mask for TLS.
         Default: 0.
         Type: integer.
 
-10. core.dst_blacklist_sctp_imask
-        blacklist event ignore mask for SCTP.
+10. core.dst_blocklist_sctp_imask
+        blocklist event ignore mask for SCTP.
         Default: 0.
         Type: integer.
 

+ 6 - 6
doc/tutorials/cfg_list/cfg_tm.txt

@@ -153,35 +153,35 @@ Configuration Variables for tm
         Type: integer.
 
 25. tm.blst_503
-        if set to 1, blacklist 503 SIP response sources.
+        if set to 1, blocklist 503 SIP response sources.
         Default: 0.
         Range: 0 - 1.
         Type: integer.
 
 26. tm.blst_503_def_timeout
-        default 503 blacklist time (in s), when no Retry-After header
+        default 503 blocklist time (in s), when no Retry-After header
         is present.
         Default: 0.
         Type: integer.
 
 27. tm.blst_503_min_timeout
-        minimum 503 blacklist time (in s).
+        minimum 503 blocklist time (in s).
         Default: 0.
         Type: integer.
 
 28. tm.blst_503_max_timeout
-        maximum 503 blacklist time (in s).
+        maximum 503 blocklist time (in s).
         Default: 3600.
         Type: integer.
 
 29. tm.blst_methods_add
-        bitmap of method types that trigger blacklisting on transaction
+        bitmap of method types that trigger blocklisting on transaction
         timeouts.
         Default: 1.
         Type: integer.
 
 30. tm.blst_methods_lookup
-        Bitmap of method types that are looked-up in the blacklist
+        Bitmap of method types that are looked-up in the blocklist
         before statefull forwarding.
         Default: -9.
         Type: integer.

+ 21 - 21
doc/tutorials/cfg_list/docbook/cfg_core.xml

@@ -39,10 +39,10 @@
     </para>
 </section>
 
-<section id="core.use_dst_blacklist">
-    <title>core.use_dst_blacklist</title>
+<section id="core.use_dst_blocklist">
+    <title>core.use_dst_blocklist</title>
     <para>
-        enable/disable destination blacklisting.
+        enable/disable destination blocklisting.
     </para>
     <para>Default value: 0.</para>
     <para>Range: 0 - 1.</para>
@@ -51,10 +51,10 @@
     </para>
 </section>
 
-<section id="core.dst_blacklist_expire">
-    <title>core.dst_blacklist_expire</title>
+<section id="core.dst_blocklist_expire">
+    <title>core.dst_blocklist_expire</title>
     <para>
-        how much time (in s) a blacklisted destination is kept in the
+        how much time (in s) a blocklisted destination is kept in the
         list.
     </para>
     <para>Default value: 60.</para>
@@ -63,11 +63,11 @@
     </para>
 </section>
 
-<section id="core.dst_blacklist_mem">
-    <title>core.dst_blacklist_mem</title>
+<section id="core.dst_blocklist_mem">
+    <title>core.dst_blocklist_mem</title>
     <para>
         maximum shared memory amount (in KB) used for keeping the
-        blacklisted destinations.
+        blocklisted destinations.
     </para>
     <para>Default value: 250.</para>
     <para>Type: integer.</para>
@@ -75,10 +75,10 @@
     </para>
 </section>
 
-<section id="core.dst_blacklist_udp_imask">
-    <title>core.dst_blacklist_udp_imask</title>
+<section id="core.dst_blocklist_udp_imask">
+    <title>core.dst_blocklist_udp_imask</title>
     <para>
-        blacklist event ignore mask for UDP.
+        blocklist event ignore mask for UDP.
     </para>
     <para>Default value: 0.</para>
     <para>Type: integer.</para>
@@ -86,10 +86,10 @@
     </para>
 </section>
 
-<section id="core.dst_blacklist_tcp_imask">
-    <title>core.dst_blacklist_tcp_imask</title>
+<section id="core.dst_blocklist_tcp_imask">
+    <title>core.dst_blocklist_tcp_imask</title>
     <para>
-        blacklist event ignore mask for TCP.
+        blocklist event ignore mask for TCP.
     </para>
     <para>Default value: 0.</para>
     <para>Type: integer.</para>
@@ -97,10 +97,10 @@
     </para>
 </section>
 
-<section id="core.dst_blacklist_tls_imask">
-    <title>core.dst_blacklist_tls_imask</title>
+<section id="core.dst_blocklist_tls_imask">
+    <title>core.dst_blocklist_tls_imask</title>
     <para>
-        blacklist event ignore mask for TLS.
+        blocklist event ignore mask for TLS.
     </para>
     <para>Default value: 0.</para>
     <para>Type: integer.</para>
@@ -108,10 +108,10 @@
     </para>
 </section>
 
-<section id="core.dst_blacklist_sctp_imask">
-    <title>core.dst_blacklist_sctp_imask</title>
+<section id="core.dst_blocklist_sctp_imask">
+    <title>core.dst_blocklist_sctp_imask</title>
     <para>
-        blacklist event ignore mask for SCTP.
+        blocklist event ignore mask for SCTP.
     </para>
     <para>Default value: 0.</para>
     <para>Type: integer.</para>

+ 6 - 6
doc/tutorials/cfg_list/docbook/cfg_tm.xml

@@ -301,7 +301,7 @@
 <section id="tm.blst_503">
     <title>tm.blst_503</title>
     <para>
-        if set to 1, blacklist 503 SIP response sources.
+        if set to 1, blocklist 503 SIP response sources.
     </para>
     <para>Default value: 0.</para>
     <para>Range: 0 - 1.</para>
@@ -313,7 +313,7 @@
 <section id="tm.blst_503_def_timeout">
     <title>tm.blst_503_def_timeout</title>
     <para>
-        default 503 blacklist time (in s), when no Retry-After header
+        default 503 blocklist time (in s), when no Retry-After header
         is present.
     </para>
     <para>Default value: 0.</para>
@@ -325,7 +325,7 @@
 <section id="tm.blst_503_min_timeout">
     <title>tm.blst_503_min_timeout</title>
     <para>
-        minimum 503 blacklist time (in s).
+        minimum 503 blocklist time (in s).
     </para>
     <para>Default value: 0.</para>
     <para>Type: integer.</para>
@@ -336,7 +336,7 @@
 <section id="tm.blst_503_max_timeout">
     <title>tm.blst_503_max_timeout</title>
     <para>
-        maximum 503 blacklist time (in s).
+        maximum 503 blocklist time (in s).
     </para>
     <para>Default value: 3600.</para>
     <para>Type: integer.</para>
@@ -347,7 +347,7 @@
 <section id="tm.blst_methods_add">
     <title>tm.blst_methods_add</title>
     <para>
-        bitmap of method types that trigger blacklisting on transaction
+        bitmap of method types that trigger blocklisting on transaction
         timeouts.
     </para>
     <para>Default value: 1.</para>
@@ -359,7 +359,7 @@
 <section id="tm.blst_methods_lookup">
     <title>tm.blst_methods_lookup</title>
     <para>
-        Bitmap of method types that are looked-up in the blacklist
+        Bitmap of method types that are looked-up in the blocklist
         before statefull forwarding.
     </para>
     <para>Default value: -9.</para>

+ 3 - 3
doc/tutorials/dns.txt

@@ -44,7 +44,7 @@ DNS Cache and Failover Drawbacks
  
  On the other hand using the DNS cache saves lots of DNS queries and makes
  DNS based failover and DNS based load balancing possible. If the destination
- blacklist is enabled, Kamailio can do failover even if forwarding in stateless 
+ blocklist is enabled, Kamailio can do failover even if forwarding in stateless 
  mode.
  In the ideal case with the DNS cache enabled Kamailio will do only one query for
  a NAPTR (if enabled) or SRV lookup and then it will use the results for the
@@ -183,14 +183,14 @@ DNS Cache and Failover Config Variables
       Default: on.
 
    use_dns_failover = on |off - if on and sending a request fails (due to not
-      being allowed from an onsend_route, send failure, blacklisted destination
+      being allowed from an onsend_route, send failure, blocklisted destination
       or, when using tm, invite timeout), and the destination resolves to
       multiple ip addresses and/or multiple SRV records, the send will be
       re-tried using the next ip/record. In tm's case a new branch will be
       created for each new send attempt.
       Default: off.
    Depends on use_dns_cache being on. If tm is used along with DNS failover is
-   recommended to also turn on dst_blacklist.
+   recommended to also turn on dst_blocklist.
 
    dns_srv_lb = on | off or
    dns_srv_loadbalancing = on | off - if on instead of doing simple DNS 

+ 10 - 10
doc/tutorials/rpc_list/docbook/rpc_core.xml

@@ -341,42 +341,42 @@ RPC Exports for core
 </para>
 </section>
 
-<section id="dst_blacklist.mem_info"><title>dst_blacklist.mem_info</title>
+<section id="dst_blocklist.mem_info"><title>dst_blocklist.mem_info</title>
 <para>
-        dst blacklist memory usage info.
+        dst blocklist memory usage info.
 </para>
 <para>
 </para>
 </section>
 
-<section id="dst_blacklist.debug"><title>dst_blacklist.debug</title>
+<section id="dst_blocklist.debug"><title>dst_blocklist.debug</title>
 <para>
-        dst blacklist  debug  info.
+        dst blocklist  debug  info.
 </para>
 <para>
 </para>
 </section>
 
-<section id="dst_blacklist.view"><title>dst_blacklist.view</title>
+<section id="dst_blocklist.view"><title>dst_blocklist.view</title>
 <para>
-        dst blacklist dump in human-readable format.
+        dst blocklist dump in human-readable format.
 </para>
 <para>
 </para>
 </section>
 
-<section id="dst_blacklist.delete_all"><title>dst_blacklist.delete_all</title>
+<section id="dst_blocklist.delete_all"><title>dst_blocklist.delete_all</title>
 <para>
-        Deletes all the entries from the dst blacklist except the
+        Deletes all the entries from the dst blocklist except the
         permanent ones.
 </para>
 <para>
 </para>
 </section>
 
-<section id="dst_blacklist.add"><title>dst_blacklist.add</title>
+<section id="dst_blocklist.add"><title>dst_blocklist.add</title>
 <para>
-        Adds a new entry to the dst blacklist.
+        Adds a new entry to the dst blocklist.
 </para>
 <para>
 </para>

+ 10 - 10
doc/tutorials/rpc_list/rpc_core.txt

@@ -137,19 +137,19 @@ RPC Exports for core
 40. dns.delete_ptr
         deletes an PTR record from the DNS cache
 
-41. dst_blacklist.mem_info
-        dst blacklist memory usage info.
+41. dst_blocklist.mem_info
+        dst blocklist memory usage info.
 
-42. dst_blacklist.debug
-        dst blacklist  debug  info.
+42. dst_blocklist.debug
+        dst blocklist  debug  info.
 
-43. dst_blacklist.view
-        dst blacklist dump in human-readable format.
+43. dst_blocklist.view
+        dst blocklist dump in human-readable format.
 
-44. dst_blacklist.delete_all
-        Deletes all the entries from the dst blacklist except the
+44. dst_blocklist.delete_all
+        Deletes all the entries from the dst blocklist except the
         permanent ones.
 
-45. dst_blacklist.add
-        Adds a new entry to the dst blacklist.
+45. dst_blocklist.add
+        Adds a new entry to the dst blocklist.