2019-10-18 07:30:30 -04:00
|
|
|
.Dd Oct 18, 2019
|
2019-05-24 07:35:49 -04:00
|
|
|
.Dt PANTALAIMON 8
|
|
|
|
|
.Os
|
|
|
|
|
.\" ---------------------------------------------------------------------------
|
|
|
|
|
.Sh NAME
|
|
|
|
|
.Nm pantalaimon
|
|
|
|
|
.Nd End-to-end encryption aware Matrix reverse proxy daemon.
|
|
|
|
|
.\" ---------------------------------------------------------------------------
|
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
|
.Nm
|
|
|
|
|
.Op Fl c Ar config
|
2019-10-18 07:30:30 -04:00
|
|
|
.Op Fl -log-level Ar level
|
|
|
|
|
.Op Fl -data-path Ar path
|
|
|
|
|
.Op Fl -version
|
|
|
|
|
.Op Fl -help
|
2019-05-24 07:35:49 -04:00
|
|
|
.\" ---------------------------------------------------------------------------
|
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
.Nm
|
|
|
|
|
is a daemon that acts as a reverse proxy between a Matrix homeserver and a
|
|
|
|
|
Matrix client. The daemon transparently handles end-to-end encryption tasks on
|
|
|
|
|
behalf of the client.
|
|
|
|
|
.Pp
|
|
|
|
|
.Nm
|
|
|
|
|
is supposed to run as your own user and listen to connections on a
|
|
|
|
|
non-privileged port. A client needs to log in using the standard Matrix HTTP
|
|
|
|
|
calls to register itself to the daemon, such a registered user is called a pan
|
2020-01-31 17:05:47 -05:00
|
|
|
user and will have it's own sync loop to keep up with the server. Multiple matrix
|
2019-05-24 07:35:49 -04:00
|
|
|
clients can connect and use the same pan user.
|
|
|
|
|
.Pp
|
|
|
|
|
If user interaction is required
|
|
|
|
|
.Nm
|
|
|
|
|
will send out OS notifications which the user can react to.
|
|
|
|
|
.Nm
|
|
|
|
|
also provides a D-Bus API that is used for encryption related tasks that
|
|
|
|
|
require user interference (e.g. device verification).
|
|
|
|
|
.Pp
|
|
|
|
|
.Nm
|
|
|
|
|
requires a homeserver to be configured. Multiple homeservers can be configured,
|
|
|
|
|
each configured homeserver needs to listen on a separate port. Each homeserver
|
|
|
|
|
can handle end-to-end encryption for multiple users. The configuration file
|
|
|
|
|
format is specified in
|
|
|
|
|
.Xr pantalaimon 5 ,
|
|
|
|
|
the default location of the configuration file can be found in the
|
|
|
|
|
.Sx FILES
|
|
|
|
|
section.
|
|
|
|
|
.\" ---------------------------------------------------------------------------
|
|
|
|
|
.Ss Options
|
|
|
|
|
The command line flags to change the behaviour of
|
|
|
|
|
.Nm
|
|
|
|
|
are as follows:
|
|
|
|
|
.Bl -tag -width Ds
|
|
|
|
|
.It Fl c , Fl -config Ar file
|
|
|
|
|
Use the supplied
|
|
|
|
|
.Ar file
|
|
|
|
|
as the configuration file instead of the default one.
|
|
|
|
|
.It Fl -log-level Ar level
|
|
|
|
|
Set the log level of the daemon, can be one of
|
|
|
|
|
.Ar error ,
|
|
|
|
|
.Ar warning ,
|
|
|
|
|
.Ar info ,
|
|
|
|
|
.Ar debug .
|
|
|
|
|
Defaults to
|
|
|
|
|
.Ar warning .
|
2019-10-18 07:30:30 -04:00
|
|
|
.It Fl -data-path Ar path
|
|
|
|
|
Set the directory for the pantalaimon database. This config option takes
|
|
|
|
|
precedence over the XDG environment variables.
|
|
|
|
|
.It Fl -version
|
|
|
|
|
Display the version number and exit.
|
|
|
|
|
.It Fl -help
|
|
|
|
|
Display the help and exit.
|
2019-05-24 07:35:49 -04:00
|
|
|
.El
|
|
|
|
|
.\" ---------------------------------------------------------------------------
|
|
|
|
|
.Sh FILES
|
|
|
|
|
.Nm
|
|
|
|
|
supports the XDG Base Directory Specification, the default locations can be
|
|
|
|
|
overridden using appropriate environment variables.
|
|
|
|
|
.Pp
|
|
|
|
|
.Bl -tag -width DS -compact
|
|
|
|
|
.It Pa ~/.config/pantalaimon/pantalaimon.conf
|
|
|
|
|
Default location of the configuration file.
|
|
|
|
|
The format of the configuration file is described in
|
|
|
|
|
.Xr pantalaimon 5 .
|
|
|
|
|
.Pp
|
|
|
|
|
.It Pa ~/.local/share/pantalaimon/pan.db
|
|
|
|
|
Default location of the pantalaimon database.
|
|
|
|
|
This file is used to store a sqlite database holding daemon state and encryption
|
|
|
|
|
keys.
|
|
|
|
|
.El
|
|
|
|
|
.\" ---------------------------------------------------------------------------
|
|
|
|
|
.Sh EXIT STATUS
|
|
|
|
|
.Ex -std
|
|
|
|
|
.\" ---------------------------------------------------------------------------
|
|
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr panctl 1
|
|
|
|
|
.Xr pantalaimon 5
|
|
|
|
|
.\" ---------------------------------------------------------------------------
|
|
|
|
|
.Sh AUTHORS
|
|
|
|
|
.Nm
|
|
|
|
|
was written by
|
|
|
|
|
.An Damir Jelić Aq Mt poljar@termina.org.uk .
|
