SYNOPSISjirc [OPTIONS] --config CONFIG
-C, --config CONFIG Load config file as specified by CONFIG
-V, --version Report version of script
-h, --help Show detailed documentation.
- -C CONFIG, --config CONFIG
- Specify the configuration file to load. Required.
- -V, --version
- Report the version of this script.
- Show detailed documentation.
DESCRIPTIONThe jirc bot logs into an IRC channel and a Jabber conference room. It will relay conversations between the two rooms, identifying each of the speakers in braces (). Actions are forwarded as well.
There are some in-room commands that jirc responds to:
!help Display summary of available jirc commands. !who Display a list of people online on the other end of the bridge. !shutdown Immediately quit the rooms and shutdown.
CONFIGURATIONThe file specified with the --config option contains field/value pairs, one per line:
The required configuration fields are:
- Can be either ``production'' or ``test''. When running in ``test'' mode, the nicks and channel names all have ``-test'' appended to them so that jirc behavior can be tested in separate channel.
- The IRC nickname to sign in with. Since this is a bridge, a short nick is recommended. To avoid confusion, it should match the jabber-alias.
- The IDENT username to sign in with. Since this is a bridge, a short name is recommended. To avoid confusion, it should match the irc-nick.
- The IRC Username to sign in with. Since this is a bridge, a description of the bridge and a contact email address is recommended.
- The IRC channel to join; the IRC side of the bridge.
- The IRC server to join.
- The Jabber protocol to use, either ``XMPP'' or ``Legacy''.
- The Jabber identifier, in the form: NAME@SERVER/RESOURCE
- Not all Jabber servers run on the same IP as the A record for their domain indicates. If your server runs like this, set the correct IP or hostname here. Note that jirc doesn't currently pay attention to SRV records.
- The password for the Jabber ID.
- Set to ``1'' to allow the password to be sent over the wire in plaintext or not - you'll need this for some servers that don't support DIGEST-MD5 with legacy authentication. (Default: 0)
- How long to wait in seconds between disconnects before attempting a reconnect. (Default: 0)
- The port to use for Jabber connections. This is normally 5222.
- The name of the Jabber conference room to join, in the form ROOM@SERVER
- The Jabber alias to use when joining the Jabber conference room. Since this is a bridge, a short nick is recommend. To avoid confusion, it should match the irc-nick.
- The email address of this bot's owner.
- The prefix used for the built-in in-room commands. This is normally ``!''.
- Suppress bridging of status messages (joins, parts and presence changes). Normally 0.
- The port to use for IRC connections. This is normally 6667.
- How many seconds to wait until reconnecting after a missed IRC ``TIME'' response. This is normally 60.
- How many seconds between ``TIME'' requests. This is normally 30.
- When set to 1, this enables verbose debugging of the IRC side of communications. This is normally 0.
- When set to 1, this enables verbose debugging of the Jabber side of communications. This is normally 0.
- When set to 1, this enable verbose debugging of the general operation of the jirc bridge. This is normally 0.
AUTHORKees Cook <[email protected]>
COPYRIGHTCopyright 2005-2009 by Kees Cook <[email protected]>. This program is licensed under the terms of the GNU General Public License.