mirror of
https://github.com/matrix-org/pantalaimon.git
synced 2024-10-01 03:35:38 -04:00
74 lines
3.2 KiB
Groff
74 lines
3.2 KiB
Groff
.Dd May 23, 2019
|
|
.Dt PANCTL 1
|
|
.Os
|
|
.\" ---------------------------------------------------------------------------
|
|
.Sh NAME
|
|
.Nm panctl
|
|
.Nd Control the Matrix reverse proxy daemon pantalaimon.
|
|
.\" ---------------------------------------------------------------------------
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
is a small utility to control and introspect the state of pantalaimon.
|
|
.Pp
|
|
.Ss Commands
|
|
The commands accepted by
|
|
.Nm
|
|
are as follows:
|
|
.Bl -tag -width 3n
|
|
.It Cm list-servers
|
|
List the configured homeservers and pan users on each homeserver.
|
|
.It Cm list-devices Ar pan-user Ar user-id
|
|
List the devices of a user that are known to the
|
|
.Ar pan-user .
|
|
.It Cm start-verification Ar pan-user Ar user-id
|
|
Start an interactive key verification between the given pan-user and user.
|
|
.It Cm accept-verification Ar pan-user Ar user-id
|
|
Accept an interactive key verification that the given user has started with our
|
|
given pan-user.
|
|
.It Cm cancel-verification Ar pan-user Ar user-id
|
|
Cancel an interactive key verification between the given pan-user and user.
|
|
.It Cm confirm-verification Ar pan-user Ar user-id
|
|
Confirm that the short authentication string of the interactive key verification
|
|
with the given pan-user and user is matching.
|
|
.It Cm verify-device Ar pan-user Ar user-id Ar device-id
|
|
Manually mark the given device as verified. The device will be marked as verified
|
|
only for the given pan-user.
|
|
.It Cm unverify-device Ar pan-user Ar user-id Ar device-id
|
|
Mark a previously verified device of the given user as unverified.
|
|
.It Cm blacklist-device Ar pan-user Ar user-id Ar device-id
|
|
Manually mark the given device of the given user as blacklisted.
|
|
.It Cm unblacklist-device Ar pan-user Ar user-id Ar device-id
|
|
Mark a previously blacklisted device of the given user as unblacklisted.
|
|
.It Cm send-anyways Ar pan-user Ar room-id
|
|
If a encrypted room contains unverified devices and a connected Matrix client
|
|
tries to send an message to such a room
|
|
.Nm pantalaimon
|
|
will send a notification that the room contains unverified users. Using this
|
|
command the user can choose to mark all unverified devices as ignored. Ignored
|
|
devices will receive encryption keys but will be left marked as unverified.
|
|
The message will be sent away after all devices are marked as ignored.
|
|
.It Cm cancel-sending Ar pan-user Ar room-id
|
|
In contrast to the
|
|
.Cm send-anyways
|
|
command this command cancels the sending of a message to an encrypted room with
|
|
unverified devices and gives the user the oportunity to verify or blacklist
|
|
devices as they see fit.
|
|
.It Cm import-keys Ar pan-user Ar file Ar passphrase
|
|
Import end-to-end encryption keys from the given file for the given pan-user.
|
|
.It Cm export-keys Ar pan-user Ar file Ar passphrase
|
|
Export end-to-end encryption keys to the given file for the given pan-user. The
|
|
provided passphrase is used to encrypt the file containing the keys.
|
|
.El
|
|
.\" ---------------------------------------------------------------------------
|
|
.Sh EXIT STATUS
|
|
.Ex -std
|
|
.\" ---------------------------------------------------------------------------
|
|
.Sh SEE ALSO
|
|
.Xr pantalaimon 8
|
|
.Xr pantalaimon 5
|
|
.\" ---------------------------------------------------------------------------
|
|
.Sh AUTHORS
|
|
.Nm
|
|
was written by
|
|
.An Damir Jelić Aq Mt poljar@termina.org.uk .
|