This repository has been archived by the owner on Jan 4, 2021. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 1
/
README
74 lines (55 loc) · 2.53 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
Minbif - IRC instant messaging gateway
**************************************
1. Abstract
===========
Minbif aims to use the libpurple library from the Pidgin project to provide an
IRC-friendly instant messaging client.
2. Installation
===============
You can provide several configuration options to make:
* PREFIX=path — Installation prefix (default=/usr/local)
* MAN_PREFIX=path — Manpages installation prefix (default=$PREFIX/share/man/man8)
* CONF_PREFIX=path — Configuration files installation prefix (default=$PREFIX/etc/minbif)
* DOC_PREFIX=path — Documentation files installation prefix (default=$PREFIX/share/doc/minbif)
* ENABLE_MINBIF=(ON|OFF) — Compile minbif (default=ON).
* ENABLE_IMLIB=(ON|OFF) — Use imlib2 (default=ON).
* ENABLE_CACA=(ON|OFF) — Do not use libcaca features to display icons (default=ON).
* ENABLE_VIDEO=(ON|OFF) — Enable the video viewer (default=OFF). Depends on ENABLE_CACA.
* ENABLE_PLUGIN=(ON|OFF) — Compile libpurple's plugins (default=OFF).
* ENABLE_PAM=(ON|OFF) — Compile with PAM support (default=OFF).
* ENABLE_TLS=(ON|OFF) — Compile with TLS support (default=OFF).
* DEBUG=(ON|OFF) — Compile with debug (default=OFF).
Run:
$ make [PREFIX=path] [MAN_PREFIX=path] [CONF_PREFIX=path] [DOC_PREFIX=path]
[ENABLE_MINBIF=ON|OFF] [ENABLE_CACA=ON|OFF] [ENABLE_VIDEO=ON|OFF]
[ENABLE_PLUGIN=ON|OFF] [ENABLE_PAM=ON|OFF] [ENABLE_TLS=ON|OFF]
[DEBUG=ON|OFF]
To install it use:
$ make install
3. Configuration
================
Copy the minbif.conf file and edit it.
3.1 Inetd
---------
Run:
# update-inetd --add '6667 stream tcp nowait username /usr/sbin/tcpd /usr/bin/minbif /etc/minbif/minbif.conf'
Then, restart inetd, and use an IRC client to connect to minbif.
3.2 Daemon Fork
---------------
Set the irc/type parameter in configuration to 2 (as daemon fork) and write a
irc/daemon block to set the address and port to bind.
Now, run the minbif daemon:
# minbif /path/to/minbif.conf
A new forked process will be created every time a new connection is established.
Note: there isn't (yet?) any fork limit. Your system is vulnerable to a fork
bomb, so set the RLIMIT_NPROC ulimit parameter to prevent that way.
4. Documentation
================
You can see an online documentation on the Minbif website at
http://minbif.im
5. Support
==========
A problem? A suggestion?
- Ask your question on the #minbif channel on the FreeNode IRC network.
- Subscribe to the mailing list at http://lists.symlink.me/mailman/listinfo/minbif
- Send an email to a developer (see the AUTHORS file).