Przeglądaj źródła

ctl Update docs

Olle E. Johansson 9 lat temu
rodzic
commit
88947cc64a

+ 18 - 6
modules/ctl/README

@@ -24,7 +24,7 @@ Andrei Pelinescu-Onciul
               3.7. binrpc_max_body_size (integer)
               3.7. binrpc_max_body_size (integer)
               3.8. binrpc_struct_max_body_size (integer)
               3.8. binrpc_struct_max_body_size (integer)
 
 
-        4. SIP-router RPC Functions
+        4. RPC Functions
 
 
               4.1. ctl.listen
               4.1. ctl.listen
               4.2. ctl.connections
               4.2. ctl.connections
@@ -62,7 +62,7 @@ Chapter 1. Admin Guide
         3.7. binrpc_max_body_size (integer)
         3.7. binrpc_max_body_size (integer)
         3.8. binrpc_struct_max_body_size (integer)
         3.8. binrpc_struct_max_body_size (integer)
 
 
-   4. SIP-router RPC Functions
+   4. RPC Functions
 
 
         4.1. ctl.listen
         4.1. ctl.listen
         4.2. ctl.connections
         4.2. ctl.connections
@@ -103,9 +103,9 @@ $ kamcmd ps
 
 
 2. BINRPC
 2. BINRPC
 
 
-   binrpc is a ser proprietary binary protocol for invoking rpcs. It was
-   designed such that it would minimize the packet sizes and it would be
-   very fast to parse (as opposed to XML-rpc).
+   binrpc is a Kamailio proprietary binary protocol for invoking rpcs. It
+   was designed such that it would minimize the packet sizes and it would
+   be very fast to parse (as opposed to XML-rpc).
 
 
    The binrpc encoding format is fully documented inside
    The binrpc encoding format is fully documented inside
    modules/ctl/binrpc.h.
    modules/ctl/binrpc.h.
@@ -183,7 +183,9 @@ modparam("ctl", "mode", 0600) # permissions
    Default: not set (the user under which SER runs).
    Default: not set (the user under which SER runs).
 
 
    Example 1.4. Set user parameter
    Example 1.4. Set user parameter
+...
 modparam("ctl", "user", "andrei")
 modparam("ctl", "user", "andrei")
+...
 
 
 3.4. group (integer or string)
 3.4. group (integer or string)
 
 
@@ -192,7 +194,9 @@ modparam("ctl", "user", "andrei")
    Default: not set (the group under which SER runs).
    Default: not set (the group under which SER runs).
 
 
    Example 1.5. Set group parameter
    Example 1.5. Set group parameter
+...
 modparam("ctl", "group", 100)
 modparam("ctl", "group", 100)
+...
 
 
 3.5. fifo (integer)
 3.5. fifo (integer)
 
 
@@ -207,11 +211,13 @@ modparam("ctl", "group", 100)
    Default: not set (no fifo will be used).
    Default: not set (no fifo will be used).
 
 
    Example 1.6. Set fifo parameter
    Example 1.6. Set fifo parameter
+...
 # old fifo support
 # old fifo support
 modparam("ctl", "fifo", "fifo:/tmp/ser_fifo")      # clasic fifo
 modparam("ctl", "fifo", "fifo:/tmp/ser_fifo")      # clasic fifo
 modparam("ctl", "fifo", "/tmp/ser_fifo2")
 modparam("ctl", "fifo", "/tmp/ser_fifo2")
 modparam("ctl", "fifo", "udp:*:2050")              # fifo protocol over udp
 modparam("ctl", "fifo", "udp:*:2050")              # fifo protocol over udp
 modparam("ctl", "fifo", "tcp:*:2050")              # fifo over tcp
 modparam("ctl", "fifo", "tcp:*:2050")              # fifo over tcp
+...
 
 
 3.6. autoconversion (integer)
 3.6. autoconversion (integer)
 
 
@@ -228,7 +234,9 @@ modparam("ctl", "fifo", "tcp:*:2050")              # fifo over tcp
    modifier).
    modifier).
 
 
    Example 1.7. Set the autoconversion parameter
    Example 1.7. Set the autoconversion parameter
+...
 modparam("ctl", "autoconversion", 1)
 modparam("ctl", "autoconversion", 1)
+...
 
 
 3.7. binrpc_max_body_size (integer)
 3.7. binrpc_max_body_size (integer)
 
 
@@ -238,7 +246,9 @@ modparam("ctl", "autoconversion", 1)
    Default: 32 (meaning 32KB);
    Default: 32 (meaning 32KB);
 
 
    Example 1.8. Set the binrpc_max_body_size parameter
    Example 1.8. Set the binrpc_max_body_size parameter
+...
 modparam("ctl", "binrpc_max_body_size", 16)
 modparam("ctl", "binrpc_max_body_size", 16)
+...
 
 
 3.8. binrpc_struct_max_body_size (integer)
 3.8. binrpc_struct_max_body_size (integer)
 
 
@@ -248,9 +258,11 @@ modparam("ctl", "binrpc_max_body_size", 16)
    Default: 8 (meaning 8KB);
    Default: 8 (meaning 8KB);
 
 
    Example 1.9. Set the binrpc_struct_max_body_size parameter
    Example 1.9. Set the binrpc_struct_max_body_size parameter
+...
 modparam("ctl", "binrpc_struct_max_body_size", 4)
 modparam("ctl", "binrpc_struct_max_body_size", 4)
+...
 
 
-4. SIP-router RPC Functions
+4. RPC Functions
 
 
    4.1. ctl.listen
    4.1. ctl.listen
    4.2. ctl.connections
    4.2. ctl.connections

+ 3 - 2
modules/ctl/doc/ctl.xml

@@ -51,7 +51,7 @@
 		line mode.
 		line mode.
 		<example>
 		<example>
 		<title><function>&sercmd; example</function> usage</title>
 		<title><function>&sercmd; example</function> usage</title>
-		<programlisting>
+		<programlisting format="linespecific">
 
 
 $ &sercmd; ps
 $ &sercmd; ps
 11262	attendant
 11262	attendant
@@ -65,6 +65,7 @@ $ &sercmd; ps
 11275	tcp receiver child=0
 11275	tcp receiver child=0
 11276	tcp receiver child=1
 11276	tcp receiver child=1
 11277	tcp main process
 11277	tcp main process
+
 		</programlisting>
 		</programlisting>
 		</example>
 		</example>
 	See <ulink url='http://git.sip-router.org/cgi-bin/gitweb.cgi?p=sip-router;a=blob;f=utils/sercmd/EXAMPLES' >utils/&sercmd;/EXAMPLES</ulink>
 	See <ulink url='http://git.sip-router.org/cgi-bin/gitweb.cgi?p=sip-router;a=blob;f=utils/sercmd/EXAMPLES' >utils/&sercmd;/EXAMPLES</ulink>
@@ -74,7 +75,7 @@ $ &sercmd; ps
 	<section id="ctl.binrpc">
 	<section id="ctl.binrpc">
 	<title>BINRPC</title>
 	<title>BINRPC</title>
 	<para>
 	<para>
-		binrpc is a ser proprietary binary protocol for invoking rpcs.
+		binrpc is a &kamailio; proprietary binary protocol for invoking rpcs.
 		It was designed such that it would minimize the packet sizes and it
 		It was designed such that it would minimize the packet sizes and it
 		would be very fast to parse (as opposed to XML-rpc).
 		would be very fast to parse (as opposed to XML-rpc).
 	</para>
 	</para>

+ 12 - 0
modules/ctl/doc/ctl_params.xml

@@ -116,7 +116,9 @@ modparam("ctl", "mode", 0600) # permissions
 	<example>
 	<example>
 		<title>Set <varname>user</varname> parameter</title>
 		<title>Set <varname>user</varname> parameter</title>
 		<programlisting>
 		<programlisting>
+...
 modparam("ctl", "user", "andrei")
 modparam("ctl", "user", "andrei")
+...
 		</programlisting>
 		</programlisting>
 	</example>
 	</example>
 	</section>
 	</section>
@@ -132,7 +134,9 @@ modparam("ctl", "user", "andrei")
 	<example>
 	<example>
 		<title>Set <varname>group</varname> parameter</title>
 		<title>Set <varname>group</varname> parameter</title>
 		<programlisting>
 		<programlisting>
+...
 modparam("ctl", "group", 100)
 modparam("ctl", "group", 100)
+...
 		</programlisting>
 		</programlisting>
 	</example>
 	</example>
 	</section>
 	</section>
@@ -158,11 +162,13 @@ modparam("ctl", "group", 100)
 	<example>
 	<example>
 		<title>Set <varname>fifo</varname> parameter</title>
 		<title>Set <varname>fifo</varname> parameter</title>
 		<programlisting>
 		<programlisting>
+...
 # old fifo support
 # old fifo support
 modparam("ctl", "fifo", "fifo:/tmp/ser_fifo")      # clasic fifo
 modparam("ctl", "fifo", "fifo:/tmp/ser_fifo")      # clasic fifo
 modparam("ctl", "fifo", "/tmp/ser_fifo2")       
 modparam("ctl", "fifo", "/tmp/ser_fifo2")       
 modparam("ctl", "fifo", "udp:*:2050")              # fifo protocol over udp
 modparam("ctl", "fifo", "udp:*:2050")              # fifo protocol over udp
 modparam("ctl", "fifo", "tcp:*:2050")              # fifo over tcp
 modparam("ctl", "fifo", "tcp:*:2050")              # fifo over tcp
+...
 		</programlisting>
 		</programlisting>
 	</example>
 	</example>
 	</section>
 	</section>
@@ -188,7 +194,9 @@ modparam("ctl", "fifo", "tcp:*:2050")              # fifo over tcp
 		<title>Set the <varname>autoconversion</varname> parameter
 		<title>Set the <varname>autoconversion</varname> parameter
 		</title>
 		</title>
 		<programlisting>
 		<programlisting>
+...
 modparam("ctl", "autoconversion", 1)
 modparam("ctl", "autoconversion", 1)
+...
 		</programlisting>
 		</programlisting>
 	</example>
 	</example>
 	</section>
 	</section>
@@ -206,7 +214,9 @@ modparam("ctl", "autoconversion", 1)
 		<title>Set the <varname>binrpc_max_body_size</varname> parameter
 		<title>Set the <varname>binrpc_max_body_size</varname> parameter
 		</title>
 		</title>
 		<programlisting>
 		<programlisting>
+...
 modparam("ctl", "binrpc_max_body_size", 16)
 modparam("ctl", "binrpc_max_body_size", 16)
+...
 		</programlisting>
 		</programlisting>
 	</example>
 	</example>
 	</section>
 	</section>
@@ -224,7 +234,9 @@ modparam("ctl", "binrpc_max_body_size", 16)
 		<title>Set the <varname>binrpc_struct_max_body_size</varname> parameter
 		<title>Set the <varname>binrpc_struct_max_body_size</varname> parameter
 		</title>
 		</title>
 		<programlisting>
 		<programlisting>
+...
 modparam("ctl", "binrpc_struct_max_body_size", 4)
 modparam("ctl", "binrpc_struct_max_body_size", 4)
+...
 		</programlisting>
 		</programlisting>
 	</example>
 	</example>
 	</section>
 	</section>

+ 1 - 1
modules/ctl/doc/ctl_rpc.xml

@@ -12,7 +12,7 @@
 	<sectioninfo>
 	<sectioninfo>
 	</sectioninfo>
 	</sectioninfo>
 
 
-	<title>SIP-router RPC Functions</title>
+	<title>RPC Functions</title>
 
 
 	<section id="ctl.listen">
 	<section id="ctl.listen">
 	<title> <function>ctl.listen</function></title>
 	<title> <function>ctl.listen</function></title>