Skip to content
GitLab
Projects
Groups
Snippets
Help
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
biboumi
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
88
Issues
88
List
Boards
Labels
Service Desk
Milestones
Merge Requests
7
Merge Requests
7
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Operations
Operations
Incidents
Environments
Packages & Registries
Packages & Registries
Container Registry
Analytics
Analytics
CI / CD
Repository
Value Stream
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
louiz’
biboumi
Commits
c5b4be0e
Commit
c5b4be0e
authored
Feb 17, 2014
by
louiz’
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Little man page update
parent
7cfc7917
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
28 additions
and
18 deletions
+28
-18
doc/biboumi.md
doc/biboumi.md
+28
-18
No files found.
doc/biboumi.md
View file @
c5b4be0e
BIBOUMI 1 "201
3-11-21
"
BIBOUMI 1 "201
4-02-17
"
======================
NAME
----
B
biboumi - XMPP gateway to IRC
biboumi - XMPP gateway to IRC
SYNOPSIS
--------
`biboumi`
[
`config_file`
]
`biboumi`
[
`config_file
name
`
]
DESCRIPTION
-----------
...
...
@@ -53,8 +53,9 @@ The configuration file uses a simple format of the form
`log_level`
Indicate what type of log messages to write in the logs. Values can be from 0 to 3.
0 is debug, 1 is info, 2 is warnig, 3 is error.
Indicate what type of log messages to write in the logs. Values can be
from 0 to 3. 0 is debug, 1 is info, 2 is warning, 3 is error. The
default is 0, but a more practical value for production use is 1.
USAGE
-----
...
...
@@ -76,7 +77,7 @@ that server. Biboumi connects once to each IRC server, for each user on it.
To cleanly shutdown the component, send the SIGINT or SIGTERM signals to it.
It will send messages to all connected IRC and XMPP servers to indicate a
reason why the users are being disconnected. Biboumi exits when all
connections are closed because the remote aknowledged the end of
connections are closed because the remote a
c
knowledged the end of
communication. If the remote server does not respond, biboumi does not
exit, unless SIGINT or SIGTERM is received again, in which case biboumi
closes the TCP connections and exits immediately.
...
...
@@ -132,7 +133,7 @@ be changed on all channels on the same server as well.
Private messages are handled differently on IRC and on XMPP. On IRC, you
talk directly to one server-user: toto on the channel #foo is the same user
than
toto on the channel #bar (as long as these two channels are on the same
as
toto on the channel #bar (as long as these two channels are on the same
IRC server). Using biboumi, there is no way to receive a message from a
room participant (from a jid like #test%irc.example.com/nickname). Instead,
private messages are received from and sent to the user (using a jid like
...
...
@@ -178,12 +179,12 @@ in XMPP), it is impossible to map all these modes to an XMPP feature. To
circumvent this problem, biboumi provides a raw notification when modes are
changed, and lets the user change the modes directly.
To change modes, simply send a message starting with “
`/mode`
” followed
by the modes and the arguments you want to send to the IRC server. For
example “/mode +aho louiz”. Note that your XMPP client may
inteprete messages begining with “/” like a command. To actually send a
message starting with a slash, you may need to start your message with
“//mode” or “/say /mode”,
depending on your client.
To change modes, simply send a message starting with “
`/mode`
” followed
by
the modes and the arguments you want to send to the IRC server. For example
“/mode +aho louiz”. Note that your XMPP client may interprete messages
begining with “/” like a command. To actually send a message starting with
a slash, you may need to start your message with “//mode” or “/say /mode”,
depending on your client.
When a mode is changed, the user is notified by a message coming from the
MUC bare JID, looking like “Mode #foo [+ov] [toto tutu]”. In addition, if
...
...
@@ -192,6 +193,10 @@ notified of this XMPP event as well. For example if a mode “+o toto” is
received, then toto’s role will be changed to moderator. The mapping
between IRC modes and XMPP features is as follow:
`+q`
Sets the participant’s role to
`moderator`
and its affiliation to
`owner`
.
`+a`
Sets the participant’s role to
`moderator`
and its affiliation to
`owner`
.
...
...
@@ -214,13 +219,18 @@ SECURITY
Biboumi does not provide any encryption mechanism: connection to the XMPP
server MUST be made on localhost. The XMPP server is not supposed to accept
non-local connection from components, thus encryption is useless. IRC
SSL/TLS is also not implemented although this could be useful for some
users, this is however not a high priority feature.
SSL/TLS is also not yet implemented.
Biboumi also does not check if JIDs are properly formatted using nodeprep.
This must be done by the XMPP server to which biboumi is directly connected.
Biboumi also does not check if received JIDs are properly formatted using
nodeprep. This must be done by the XMPP server to which biboumi is directly
connected.
AUTHORS
-------
Written by Florent Le Coz
This software and man page are both written by Florent Le Coz.
LICENSE
-------
Biboumi is released under the zlib license.
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment