LinuxReviws.org --get your your Linux knowledge
> Linux Reviews > Manual Pages (man) >

bitlbee

bitlbee

BitlBee IRC gateway to IM chat networks


  1. bitlbee.8.man


You can read more about using BitlBee on our irc clients page page.

1. bitlbee.8.man

Manpage of bitlbee

bitlbee

Section: Maintenance Commands (8)
Updated: 07 March 2004
Index Return to Main Contents
 

NAME

BitlBee - IRC gateway to IM chat networks  

SYNOPSIS

bitlbee [-I] [-c configuration file] [-d configuration directory]

bitlbee -D [-i address] [-p port number] [-n] [-v] [-c configuration file] [-d configuration directory]

bitlbee -h .SHDESCRIPTION BitlBee is an IRC daemon that can talk to instant messaging networks and acts as a gateway. Users can connect to the server with any normal IRC client and see their 'buddy list' in &bitlbee. BitlBee's protocol support is based on the gaim protocol plugins. BitlBee currently supports Oscar (aim and icq), MSN, Jabber and Yahoo.

bitlbee should be called by inetd(8). (Or bitlbeed, if you can't run and/or configure inetd.) There is an experimental daemon mode too, in which BitlBee will serve all clients in one process (and does not require inetd), but this mode is still experimental. There are still some bugs left in BitlBee, and if they cause a crash, that would terminate the BitlBee connection for all clients.

 

OPTIONS

-I
Run in inetd(8) mode. This is the default setting, you usually don't have to specify this option.
-D
Run in daemon mode. In this mode, BitlBee forks to the background and waits for new connections. All clients will be served from one process. This is still experimental. See the note above for more information.
-F
Run in ForkDaemon mode. This is similar to ordinary daemon mode, but every client gets its own process. Easier to set up than inetd mode, but without the possible stability issues.
-i address
Only useful when running in daemon mode, to specify the network interface (identified by IP address) to which the daemon should attach. Use this if you don't want BitlBee to listen on every interface (which is the default behaviour).
-p port number
Only useful when running in daemon mode, to specify the port number on which BitlBee should listen for connections. 6667 is the default value.
-n
Only useful when running in daemon mode. This option prevents BitlBee from forking into the background.
-v
Be more verbose. This only works together with the -n flag.
-c path to other configuration file
Use a different configuration file.
-d path to user settings directory
BitlBee normally saves every user's settings in /var/lib/bitlbee/. If you want the settings to be stored somewhere else (for example, if you don't have write permissions in the default location), use this option.
-h
Show help information.
 

COMMANDS

To get a complete list of commands, please use the help commands command in the &bitlbee channel.  

SEE ALSO

ircd(8), inetd(8), inetd.conf(5), gaim(1).

http://www.bitlbee.org/

For more information on using BitlBee, once connected, you should use the on-line help system.  

BUGS

Of course there are bugs. If you find some, please report them at http://bugs.bitlbee.org/.  

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 2 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  

AUTHORS


 Wilmer van der Gaast <wilmer@gaast.net> JelmerVernooij<jelmer@vernstok.nl> MauritsDijkstra<mauritsd@xs4all.nl>


 

Index

NAME
SYNOPSIS
OPTIONS
COMMANDS
SEE ALSO
BUGS
LICENSE
AUTHORS

This document was created by man2html using the manual pages.
Time: 23:20:39 GMT, July 09, 2008
BitlBee - News
  • The bugs we've been hunting

    With all the noise around "the bug" behind us a little bit, I guess it's now time to stop being so vague about the "account hijacking" bugs we've fixed. I didn't want to give all details right away, to give public server maintainers some time to upgrade. Only a few maintainers picked up the fixes, and I don't want to wait any longer.

    A few weeks ago, while redoing the "set" command a little bit, I discovered something I didn't really like. When you connect to a BitlBee server and immediately use "set password" to change your password, even though you haven't used identify/register yet to get yourself authenticated, BitlBee just said "Password changed successfully". Although it didn't actually create an account file yet, one could then use "save" to then get this done. While the "register" command checks if an account exists before writing to disk, the "save" command doesn't (and shouldn't). Quickly, 1.2.2 was released. Why did this happen? It turns out that this problem was with us for some time already. Previously, the "password" setting was disabled until the user registers/identifies. This was changed in this bzr revision.

    Unfortunately, this wasn't the only problem. It turned out the "register" command was also not working very well. Although it checked for the existence of an account before creating it, it did leave a password set in the BitlBee state structure. This allowed for a very similar exploit, where after failing to register an account, one could use the "save" command to get his account saved anyway. This problem was introduced somewhere in the migration to the storage abstraction layer.

    All these issues should be gone now, and I'm working on a blackbox testing system that will continuously check for bugs like this (and also test other various pieces of BitlBee functionality) to (hopefully) prevent nasty bugs in the future.

    Also, I see security advisories about this issue are often wrong about the "hijacking" part, so I have to repeat this once more: Although this exploit indeed allows one to create an account on a BitlBee, bypassing all safety checks (including AuthMode=Registered), it is not possible to use this bug to gain access to other people's accounts! When someone performs this attack, he will simply get the victim's account deleted. IM passwords in BitlBee configuration files are encrypted using the user's password. There is absolutely no way to figure out these passwords without cracking the person's BitlBee password.

  • BitlBee 1.2.3, unfortunately another important bugfix

    Unfortunately 1.2.2 did not fix all possible account hijacking loopholes. Another very similar flaw was found by Tero Marttila. In the migration to the user configuration storage abstraction layer, a few safeguards that prevent overwriting existing accounts disappeared. Over the week I went over all the related code to make sure that everything's done in a sane, safe and consistent way.

    It looks like not all public servers are up to date yet. If you own one, please update it as soon as you can to save your users any inconvenience from losing their account.

  • BitlBee 1.2.2 fixes security bug

    I just released BitlBee 1.2.2, and I advice public server maintainers to upgrade their BitlBee daemons as soon as possible, since this release fixes a security bug that was probably there for a long time already.

    It's not a serious bug, it doesn't allow anyone to compromise your server. It does allow people to hijack accounts, though. Not with gaining access to the IM accounts or settings of the existing user, it only allows people to recreate an existing account.

    Again, your machine (and for the users, your privacy) is not in danger. But please upgrade anyway to make sure this gap is closed.

    Update (2008-08-30 14:23 (UTC)): Some testing showed that the bug does not exist in any 1.0.x release or older. BitlBee 1.1dev/1.2 were the first releases with this vulnerability.

  • MSN issues - resolved

    Both testing.bitlbee.org and im.bitlbee.org are now running a bzr snapshot version of BitlBee that does MSN Passport authentication the old way. This should resolve the login problems. A 1.2.2 release will probably come soon, I want this to be stable on the public servers for a few days first.

    Update (2008-08-02 11:04 (UTC)): Actually, I rolled back in vain, just hours after I did this, Microsoft fixed their bug. 1.2.x users should be fine again.

  • MSN issues

    This is known for a few days already, but a post on the webpage still can't hurt, I think. Apparently BitlBee has issues logging into the MSN Messenger network these days, if your password contains non-alphanumeric characters or even capitals. It affects some people, others can still log in. The problem is discussed in the bug tracker.

    This seems to affect other clients too. There's one easy fix, which is reverting to the old non-SOAP authentication method. I'm trying to avoid doing that since that code was messy. If I can't find any better solution soon, I'll probably do that and roll it out to the public servers.

    If you absolutely need MSN to work, you can change your password or switch back to BitlBeee 1.1.1dev for a while.

  • Happy birthday, BitlBee 1.2.1!

    Today (on my watch this day is going to end in five minutes already, actually..) BitlBee reached the age of six years! Since it's been a while since the 1.2 release and since there are fixes for a lot of bugs in bzr by now, I decided to make this a release.

    This code is running on testing for a while already, with not too many changes, and it's extremely stable. For the first time, we're actually running BitlBee in daemon mode for all SSL connections. It's serving thirty users from just one process, running without any issues for weeks in a row. This is quite an improvement over the unstable unreliable program the Bee once used to be!

    Of course I'm not saying that the program is perfect now, please keep sending those bug reports. :-) But first, enjoy BitlBee 1.2.1!

Resources

Wikis

Package Search

Meet new people