SOCKET(7ctrlproxy)                                            SOCKET(7ctrlproxy)

       socket - Support for IPv4, IPv6 and pipes

       This module provides support for connecting to remote servers using IPv4,
       IPv6 and unix pipes, as well as listening for client connections using
       these connection types.

       As this module is currently the only module providing connection support,
       it is essential for basic use of ctrlproxy.

       Connecting or listening using SSL over IPv4 or IPv6 is supported when a
       SSL library was found at configure time.

       When acting as a SSL server (e.g. waiting for connections from clients
       and communicating with them using SSL), ctrlproxy needs to have a
       certificate file and a private key file. This can be generated using the script distributed with ctrlproxy.

       The following XML elements are supported:

              Name of file to load private SSL key from. Only required when
              acting as a server

              Name of file to load certificate from. Only required when acting
              as a server

       After this module is loaded, the following three new elements are
       supported in <listen> and <servers>: ipv4ipv6pipe

       ipv4 and ipv6 support the following attributes:

       ssl    Enable SSL

       host   Host name or IP address to connect to.

       port   Port to connect to or listen on.

       When connecting, the pipe element can contain one member element <path>
       and several <arg> elements. These should contain a program with arguments
       to execute.

       In listen mode, a file attribute (attribute, not element!) should be
       specified, containing the file name of the unix socket to create. If no
       file name is specified, one will be generated.


                           <plugin autoload="1" file="socket">
                           <network name="BEE">
                                     <ipv4 host="localhost"/>
                                     <ipv4 ssl="1" port="6667"/>
                           <network name="DSR">
                                     <ipv6 host=""/>
                                     <ipv4 host="" port="994" ssl="1"/>
                                     <ipv4 port="6668"/>
                                     <ipv6 port="6669" ssl="1"/>

       This man page is valid for version 0.1 of the plugin.

       ctrlproxyrc(5), ctrlproxy(1),

       Jelmer Vernooij: mailto: