aboutsummaryrefslogtreecommitdiff
path: root/doc/guide.tex
diff options
context:
space:
mode:
Diffstat (limited to 'doc/guide.tex')
-rw-r--r--doc/guide.tex112
1 files changed, 53 insertions, 59 deletions
diff --git a/doc/guide.tex b/doc/guide.tex
index 60ef308c0..88ced141b 100644
--- a/doc/guide.tex
+++ b/doc/guide.tex
@@ -660,31 +660,26 @@ tuple with the following elements:
\ind{modules!ejabberd\_c2s}\ind{modules!ejabberd\_s2s\_in}\ind{modules!ejabberd\_service}\ind{modules!ejabberd\_http}\ind{protocols!XEP-0114: Jabber Component Protocol}
The available modules, their purpose and the options allowed by each one are:
-\begin{table}[H]
- \centering
- \def\arraystretch{1.4}
- \begin{tabular}{|l|l|p{87mm}|}
- \hline \texttt{ejabberd\_c2s}& Description& Handles c2s connections.\\
- \cline{2-3} & Options& \texttt{access}, \texttt{certfile}, \texttt{inet6},
+\begin{description}
+ \titem{\texttt{ejabberd\_c2s}}
+ Handles c2s connections.\\
+ Options: \texttt{access}, \texttt{certfile}, \texttt{inet6},
\texttt{ip}, \texttt{max\_stanza\_size}, \texttt{shaper},
\texttt{starttls}, \texttt{starttls\_required}, \texttt{tls},
- \texttt{zlib}\\
- \hline \texttt{ejabberd\_s2s\_in}& Description& Handles incoming s2s
- connections.\\
- \cline{2-3} & Options& \texttt{inet6}, \texttt{ip},
- \texttt{max\_stanza\_size}\\
- \hline \texttt{ejabberd\_service}& Description& Interacts with
- \footahref{http://www.ejabberd.im/tutorials-transports}{external components}
+ \texttt{zlib}
+ \titem{\texttt{ejabberd\_s2s\_in}}
+ Handles incoming s2s connections.\\
+ Options: \texttt{inet6}, \texttt{ip}, \texttt{max\_stanza\_size}
+ \titem{\texttt{ejabberd\_service}}
+ Interacts with \footahref{http://www.ejabberd.im/tutorials-transports}{external components}
(as defined in the Jabber Component Protocol (\xepref{0114}).\\
- \cline{2-3} & Options& \texttt{access}, \texttt{hosts}, \texttt{inet6},
- \texttt{ip}, \texttt{shaper}, \texttt{service\_check\_from}\\
- \hline \texttt{ejabberd\_http}& Description& Handles incoming HTTP
- connections.\\
- \cline{2-3} & Options& \texttt{certfile}, \texttt{http\_bind}, \texttt{http\_poll},
+ Options: \texttt{access}, \texttt{hosts}, \texttt{inet6},
+ \texttt{ip}, \texttt{shaper}, \texttt{service\_check\_from}
+ \titem{\texttt{ejabberd\_http}}
+ Handles incoming HTTP connections.\\
+ Options: \texttt{certfile}, \texttt{http\_bind}, \texttt{http\_poll},
\texttt{inet6}, \texttt{ip}, \texttt{request\_handlers}, \texttt{tls}, \texttt{web\_admin}\\
- \hline
- \end{tabular}
-\end{table}
+\end{description}
This is a detailed description of each option allowed by the listening modules:
\begin{description}
@@ -2061,54 +2056,53 @@ Examples:
\end{verbatim}
\end{itemize}
-\makesubsection{modoverview}{Overview}
+\makesubsection{modoverview}{Modules Overview}
\ind{modules!overview}\ind{XMPP compliancy}
The following table lists all modules included in \ejabberd{}.
\begin{table}[H]
\centering
- \begin{tabular}{|l|l|l|l|}
- \hline Module & Feature & Dependencies & Needed for XMPP? \\
- \hline \hline \modadhoc{} & Ad-Hoc Commands (\xepref{0050}) & & No \\
- \hline \modannounce{} & Manage announcements & recommends \modadhoc{} & No \\
- \hline \modcaps{} & Request and cache Entity Capabilities (\xepref{0115}) & & No \\
- \hline \modconfigure{} & Server configuration using Ad-Hoc & \modadhoc{} & No \\
- \hline \moddisco{} & Service Discovery (\xepref{0030}) & & No \\
- \hline \modecho{} & Echoes Jabber packets & & No \\
- \hline \modirc{} & IRC transport & & No \\
- \hline \modlast{} & Last Activity (\xepref{0012}) & & No \\
- \hline \modlastodbc{} & Last Activity (\xepref{0012}) & supported database (*) & No \\
- \hline \modmuc{} & Multi-User Chat (\xepref{0045}) & & No \\
- \hline \modmuclog{} & Multi-User Chat room logging & \modmuc{} & No \\
- \hline \modoffline{} & Offline message storage & & No \\
- \hline \modofflineodbc{} & Offline message storage & supported database (*) & No \\
- \hline \modprivacy{} & Blocking Communications & & Yes \\
- \hline \modprivacyodbc{} & Blocking Communications & supported database (*) & Yes \\
- \hline \modprivate{} & Private XML Storage (\xepref{0049}) & & No \\
- \hline \modprivateodbc{} & Private XML Storage (\xepref{0049}) & supported database (*) & No \\
- \hline \modproxy{} & SOCKS5 Bytestreams (\xepref{0065}) & & No\\
- \hline \modpubsub{} & Publish-Subscribe (\xepref{0060}) and PEP (\xepref{0163}) & \modcaps{} & No \\
- \hline \modregister{} & In-Band Registration (\xepref{0077}) & & No \\
- \hline \modroster{} & Roster management & & Yes (**) \\
- \hline \modrosterodbc{} & Roster management & supported database (*) & Yes (**) \\
- \hline \modservicelog{} & Copy user messages to logger service & & No \\
- \hline \modsharedroster{} & Shared roster management & \modroster{} or & No \\
- & & \modrosterodbc{} & \\
- \hline \modstats{} & Statistics Gathering (\xepref{0039}) & & No \\
- \hline \modtime{} & Entity Time (\xepref{0090}) & & No \\
- \hline \modvcard{} & vcard-temp (\xepref{0054}) & & No \\
- \hline \modvcardldap{} & vcard-temp (\xepref{0054}) & LDAP server & No \\
- \hline \modvcardodbc{} & vcard-temp (\xepref{0054}) & supported database (*) & No \\
- \hline \modversion{} & Software Version (\xepref{0092}) & & No\\
+ \begin{tabular}{|l|l|l|}
+ \hline {\bf Module} & {\bf Feature} & {\bf Dependencies} \\
+ \hline
+ \hline \modadhoc{} & Ad-Hoc Commands (\xepref{0050}) & \\
+ \hline \ahrefloc{modannounce}{\modannounce{}} & Manage announcements & recommends \modadhoc{} \\
+ \hline \modcaps{} & Entity Capabilities (\xepref{0115}) & \\
+ \hline \modconfigure{} & Server configuration using Ad-Hoc & \modadhoc{} \\
+ \hline \ahrefloc{moddisco}{\moddisco{}} & Service Discovery (\xepref{0030}) & \\
+ \hline \ahrefloc{modecho}{\modecho{}} & Echoes Jabber packets & \\
+ \hline \ahrefloc{modirc}{\modirc{}} & IRC transport & \\
+ \hline \ahrefloc{modlast}{\modlast{}} & Last Activity (\xepref{0012}) & \\
+ \hline \ahrefloc{modlast}{\modlastodbc{}} & Last Activity (\xepref{0012}) & supported DB (*) \\
+ \hline \ahrefloc{modmuc}{\modmuc{}} & Multi-User Chat (\xepref{0045}) & \\
+ \hline \ahrefloc{modmuclog}{\modmuclog{}} & Multi-User Chat room logging & \modmuc{} \\
+ \hline \ahrefloc{modoffline}{\modoffline{}} & Offline message storage (\xepref{0160}) & \\
+ \hline \ahrefloc{modoffline}{\modofflineodbc{}} & Offline message storage (\xepref{0160}) & supported DB (*) \\
+ \hline \ahrefloc{modprivacy}{\modprivacy{}} & Blocking Communication (XMPP IM) & \\
+ \hline \ahrefloc{modprivacy}{\modprivacyodbc{}} & Blocking Communication (XMPP IM) & supported DB (*) \\
+ \hline \ahrefloc{modprivate}{\modprivate{}} & Private XML Storage (\xepref{0049}) & \\
+ \hline \ahrefloc{modprivate}{\modprivateodbc{}} & Private XML Storage (\xepref{0049}) & supported DB (*) \\
+ \hline \ahrefloc{modproxy}{\modproxy{}} & SOCKS5 Bytestreams (\xepref{0065}) & \\
+ \hline \ahrefloc{modpubsub}{\modpubsub{}} & Pub-Sub (\xepref{0060}), PEP (\xepref{0163}) & \modcaps{} \\
+ \hline \ahrefloc{modregister}{\modregister{}} & In-Band Registration (\xepref{0077}) & \\
+ \hline \ahrefloc{modroster}{\modroster{}} & Roster management (XMPP IM) & \\
+ \hline \ahrefloc{modroster}{\modrosterodbc{}} & Roster management (XMPP IM) & supported DB (*) \\
+ \hline \ahrefloc{modservicelog}{\modservicelog{}} & Copy user messages to logger service & \\
+ \hline \ahrefloc{modsharedroster}{\modsharedroster{}} & Shared roster management & \modroster{} or \\
+ & & \modrosterodbc\\
+ \hline \ahrefloc{modstats}{\modstats{}} & Statistics Gathering (\xepref{0039}) & \\
+ \hline \ahrefloc{modtime}{\modtime{}} & Entity Time (\xepref{0090}) & \\
+ \hline \ahrefloc{modvcard}{\modvcard{}} & vcard-temp (\xepref{0054}) & \\
+ \hline \ahrefloc{modvcardldap}{\modvcardldap{}} & vcard-temp (\xepref{0054}) & LDAP server \\
+ \hline \ahrefloc{modvcard}{\modvcardodbc{}} & vcard-temp (\xepref{0054}) & supported DB (*) \\
+ \hline \ahrefloc{modversion}{\modversion{}} & Software Version (\xepref{0092}) & \\
\hline
\end{tabular}
\end{table}
\begin{itemize}
-\item (*) For a list of supported databases, see section~\ref{database}.
-\item (**) This module or a similar one with another database backend is needed for
-XMPP compliancy.
+\item (*) This module requires a supported database. For a list of supported databases, see section~\ref{database}.
\end{itemize}
You can see which database backend each module needs by looking at the suffix:
@@ -3792,7 +3786,7 @@ You need to take the following TCP ports in mind when configuring your firewall:
\begin{table}[H]
\centering
\begin{tabular}{|l|l|}
- \hline Port& Description\\
+ \hline {\bf Port} & {\bf Description} \\
\hline \hline 5222& Standard port for Jabber/XMPP client connections, plain or STARTTLS.\\
\hline 5223& Standard port for Jabber client connections using the old SSL method.\\
\hline 5269& Standard port for Jabber/XMPP server connections.\\