Name

ctrlproxy_config — Configuration file for ctrlproxy

DESCRIPTION

Ctrlproxy uses a configuration directory called .ctrlproxy that lives inside the users' home directory. The main configuration file lives in this directory and is called config. It is an ini-style configuration file with sections and key-value pairs.

This manpage discusses the variables that can be set in this file in a standard ControlProxy installation.

SETTINGS

[global]

The [global] section contains some of the most important settings.

replication

Replication backend to use. See the section about replication below for details.

report-time

Set to true to prefix replicated lines with the time the line was sent.

autosave

Automatically save configuration on exit

autoconnect

Semi-colon separated list of networks or servers to connect to on startup.

motd-file

Path to the message of the day file that is sent to clients upon connect.

match

If the replication backend is set to highlight, this variable should contain a semicolon-separated list of words to search for.

port

Port at which CtrlProxy should listen for new connections Connections can be plain IRC connections or using the SOCKS protocol.

password

Password for logging in to ctrlproxy.

[admin]

If the [admin] section is present, ControlProxy will create a fake network with a control channel that can be used for administration.

no_privmsg

Don't interpret messages to the user ctrlproxy as administration commands.

This option would be needed if you want to be able to send messages to an actual user with the nickname ctrlproxy.

[log-custom]

If the [log-custom] section is present, ControlProxy will write a log to ~/.ctrlproxy/log-custom/

[log-irssi]

If the [log-irssi] section is present, ControlProxy will write irssi-style log files to ~/.ctrlproxy/log-irssi/NETWORK/CHANNEL.

logfile

Directory in which logs will be written (defaults to ~/.ctrlproxy/log-irssi/.

[auto-away]

Add this section to automatically change the state of the user to AWAY when the user is idle for a specific username.

message

Away message to set.

client_limit

Integer variable. After idle for the specified time, the connection will only be changed to away if there are not more than client_limit connected. The default is -1 (always set idle no matter how many clients there are). To achive the behavior of the old variable <term>only_noclient</term>, set client_limit to 0.

time

Number of seconds of idleness after which the connection should be set to away. Default is 10 minutes.

[socks]

If the [socks] section is present, ControlProxy will listen for SOCKS connections.

port

TCP/IP port to listen on for new connections.

allow

Semicolon-separeted list of usernames and passwords allowed to connect. Separate user name and password by a colon.

[nickserv]

learn

[listener]

auto

Automatically start a listener on a new port for each network that ctrlproxy connects to.

autoport

First port of port range used when adding new listeners.

password

Password that the user should specify to log in.

REPLICATION

When a client connects, ctrlproxy will send information about the channels the user is on. Optionally, it can also send some of the messages that were received before the client connected (replication).

The replication variable determines what kind of replication is used. At the moment, the following values are supported:

none

No replication.

highlight

Send messages that one of a set of regular expressions. The regular expressions should be specified in variable.

lastdisconnect

Send all messages since the last client disconnected.

simple

Send all messages since the last message said by the user.

SEE ALSO

ctrlproxy (1), config.example, http://ctrlproxy.vernstok.nl/

LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple PLace, Suite 330, Boston, MA 02111-1307 USA

BUGS

CtrlProxy currently does not warn about unknown configuration parameters.

AUTHOR

Jelmer Vernooij