Changeset 42bdeec


Ignore:
Timestamp:
2005-11-18T19:22:09Z (18 years ago)
Author:
Wilmer van der Gaast <wilmer@…>
Branches:
master
Children:
0b2e843
Parents:
d908e3a
Message:

Updated the installation notes (more xinetd information, etc)

File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/README

    rd908e3a r42bdeec  
    99make install will move all the files to the right places.
    1010
     11--- inetd installation
     12
    1113After installation you have to set up inetd (you got that one running,
    1214right? If not, just take a look at utils/bitlbeed.c) to start BitlBee. You
     
    1820of just 'nobody') might be a good idea.
    1921
     22*BSD/Darwin/OSX NOTE: Most *BSD inetds are more scrict than the one that
     23comes with Linux systems. Possibly all non-Linux inetds are like this. They
     24don't allow you to specify a port number in the inetd.conf entry, instead
     25you have to put a service name there (one that is also mentioned in
     26/etc/services). So if there's no line in /services for 6667/tcp (or whatever
     27you choose), add it and use that name in the inetd.conf entry.
     28
     29-- xinetd installation
     30
     31Most machines use xinetd instead of inetd these days. If your machine runs
     32xinetd, you can copy the bitlbee.xinetd file from the doc/ directory to your
     33xinetd.d/ directory. Most likely you'll have to change a thing or two before
     34it'll work.
     35
     36After configuring your (x)inetd, send the daemon a SIGHUP and things should
     37work. If not, see your syslogs, since both daemons will complain there when
     38something's wrong.
     39
    2040Also, don't forget to create the configuration directory (/var/lib/bitlbee/
    2141by default) and chown it to the UID BitlBee is running as. Make sure this
    2242directory is read-/writable by this user only.
    23 
    24 (For xinetd users a xinetd configuration file is included: doc/bitlbee.xinetd)
    2543
    2644
     
    4866==================
    4967
    50 FreeBSD NOTE: It looks like FreeBSD does allow port numbers instead of service
    51 names in inetd.conf, as long as the service for this port exists in
    52 /etc/services. Linux isn't this strict. If you got problems in FreeBSD, just
    53 add a line for your chosen port number to /etc/services.
    54 
    55 Darwin/Mac OS X is even more strict; you should add a bitlbee service to
    56 /etc/services and use that name in inetd.conf. Not really a problem, since
    57 that's the cleanest way of doing this on any operating system anyway.
    58 
    5968Cygwin NOTE: You'll need a glib installation to run BitlBee. However, Cygwin
    6069doesn't provide a glib package. You can download a binary tar.gz from:
     
    6675Please do report them, we might be able to fix them if they're not too
    6776mysterious.
     77
     78Also, the configure script is known to not work very well with non-Bash
     79shells, so if you experience problems, make sure you use bash to run the
     80script. Same for the Makefile, it only works well with GNU make. (gmake on
     81most BSD systems)
     82
     83If someone can tell us how to write Makefiles that work with both/all
     84versions of make, we'd love to hear it, but it seems this just isn't
     85possible.
    6886
    6987
Note: See TracChangeset for help on using the changeset viewer.