ctrlproxy(1) a modular IRC proxy with multi-server support


ctrlproxy [-d file] [-l file] [-D] [--init] [-r file] [-v]



is a modular IRC proxy. It connects to a number of IRC servers and then passes data it receives on to the modules that have been loaded into it. Current modules are client_simple (for proxy support) and log (for irssi-style log file generation).

By default, ctrlproxy listens for client connections on port 6668 and any ports after that one, depending on the number of servers it is connected to.


ctrlproxy recognizes the following command-line options

-i, --inetd-client=NETWORK

Add incoming client on stdin/stdout, connected to the specified network. This can be used for inetd-like communication and testing.

-d, --debugfile=FILE

Dump IRC traffic to specified file. Only useful for debugging purposes.

-D, --daemon

Go to the background after the program has been started (daemon mode).

-c, --config-dir=DIR

Read configuration files from the specified directory DIR instead of from .ctrlproxy in the users' homedirectory.


Create a new configuration file.

-v, --version

Show copyright and version information

-?, --help

Show help message with short argument information

-l, --log=FILE

Log ctrlproxy messages to specified file.


Display brief usage message


When ctrlproxy receives a USR1 signal, it will save its current state.



Override directory that will be searched for plugins.


Probably, but none are known at the moment. Please send any you find to [email protected]


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 \fBWITHOUT ANY WARRANTY\fR; 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


Jelmer Vernooij[1] (original developer)

See the file AUTHORS for a full list of contributors.


Jelmer Vernooij
mailto:[email protected]