a modular IRC proxy written in C++/TCL
C++ Tcl Shell C PHP Objective-C
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bncidentd Update copyright. Mar 14, 2014
bnctcl Fix special character issue in account.tcl. Jan 28, 2015
debian Bump version to 1.3.9. Mar 14, 2014
m4 * Fix 'make dist' Sep 6, 2010
php Update copyright. Mar 14, 2014
pkg Bump version to 1.3.9. Mar 14, 2014
src Fix crash in CIRCConnection::ParseLineArgV Dec 21, 2014
third-party Update copyright. Mar 14, 2014
.gitignore * Updated git ignores. Sep 9, 2010
AUTHORS * Imported thom\mey's TCL event patch May 10, 2010
COPYING git-svn-id: http://svn.beutner.name/trunk/sbnc@1080 b3a6972a-4407-041… Dec 29, 2007
ChangeLog * Shut up libtool info messages about shared libs Jun 2, 2010
GPLHeader.txt Update copyright. Mar 14, 2014
GPLHeaderTcl.txt Update copyright. Mar 14, 2014
INSTALL Updated documentation. Aug 16, 2011
LICENSE git-svn-id: http://svn.beutner.name/trunk/sbnc@1080 b3a6972a-4407-041… Dec 29, 2007
LICENSE.Exceptions git-svn-id: http://svn.beutner.name/trunk/sbnc@1080 b3a6972a-4407-041… Dec 29, 2007
Makefile.am * Copyright info about third-party code updated Sep 8, 2010
NEWS git-svn-id: http://svn.beutner.name/trunk/sbnc@380 b3a6972a-4407-0410… Jan 6, 2006
README Updated documentation. Aug 16, 2011
README.copyright * Updated copyright information Sep 10, 2010
README.faq Updated documentation. Aug 16, 2011
README.iface2 git-svn-id: http://svn.beutner.name/trunk/sbnc@1025 b3a6972a-4407-041… Jun 2, 2007
README.lean Updated documentation. Aug 16, 2011
README.motd git-svn-id: http://svn.beutner.name/trunk/sbnc@818 b3a6972a-4407-0410… Jul 3, 2006
README.settings Updated documentation. Aug 16, 2011
README.ssl Updated documentation. Aug 16, 2011
autogen.sh Fixed autogen script. Jan 6, 2011
config.h.in Bump version to 1.3beta7. Sep 19, 2013
configure.ac * Moved match/mmatch code into third-party/ directory Sep 9, 2010
sbnc-start Fixed sbnc-start. Aug 15, 2011
sbnc.sln * win32: Added Visual Project files for the 'mmatch' sub-project. Sep 10, 2010
sbnc.vcxproj Fixed DLL vs. EXE heap problem. Sep 11, 2010
sbnc.vcxproj.filters * win32: Added Visual Project files for the 'mmatch' sub-project. Sep 10, 2010
sbnc_version.h Bump version to 1.3.9. Mar 14, 2014
ssl.conf * Moved win32 resource files into src/ Sep 6, 2010
stamp-h.in git-svn-id: http://svn.beutner.name/trunk/sbnc@380 b3a6972a-4407-0410… Jan 6, 2006

README

shroudBNC 1.3
-------------

shroudBNC is a modular IRC proxy written in C++. It is capable of proxying
IRC connections for multiple users. Using TCL scripts it can be extended.

Installation
------------

Please read the INSTALL file for more details about how to install shroudBNC.

Usage
-----

Just connect to the bouncer using your favorite IRC client. You will have to set
your username (i.e. e-mail address in most clients) to the accountname you've
chosen for your bouncer account. If for some reason you can't change your
client's username you can specify the username in the password setting (of the form
username:password).

Once you're connected you should type /msg -sBNC help to get a list of available commands.

shroudBNC supports oidentd in order to provide unique idents for each bouncer
user. You will need to enable ident-spoofing for the Unix account you're using
to run shroudBNC if you want each user to have their own ident. Read oidentd's
manual or http://wiki.shroudbnc.info/en/oidentd for more details.

TCL
---

The tcl module is automatically built and installed if the configure script
was able to find the appropriate tcl libraries and headers.

If the configure script was unable to find the TCL libraries/headers and you
are sure that they are installed you might use the --with-tcl parameter to
specify the location of the tclConfig.sh file manually; e.g.:

./configure --with-tcl=/usr/local/ActiveTcl/tcl8.4

Log files
---------

shroudBNC automatically re-creates log files if they disappear during runtime. It
also re-opens them if their inode of dev numbers change. Therefore rotating logs
is as easy as moving the existing logs to a different location.

Security
--------

It is vital that you understand that any bouncer admin has access to:

a) the shell account where the bouncer is running
b) any user connections

Using the TCL module any admin can perform shell commands (using the exec
command) and send IRC commands for any user's connection. Thus you should
choose your admins wisely. Do not load arbitrary scripts and make sure you
understand any scripts you want to load.

Credits
-------

I'd like to thank all the beta testers who have been using shroudBNC so far.
Feature requests and bug reports are welcome; please use our issue tracker at
https://sourceforge.net/apps/mantisbt/sbnc/

In case you encounter problems while compiling and/or using shroudBNC you can
contact us on IRC:

Server: irc.quakenet.org / 6667
Channel: #sbnc

Third Party Software
--------------------

This product includes software developed by the OpenSSL Project
   for use in the OpenSSL Toolkit (http://www.openssl.org/)

For a more detailed list of third-party code in this project please refer to
the README.copyright file.