about summary refs log tree commit diff stats
path: root/docs/profanity-tls.1
diff options
context:
space:
mode:
Diffstat (limited to 'docs/profanity-tls.1')
-rw-r--r--docs/profanity-tls.1104
1 files changed, 104 insertions, 0 deletions
diff --git a/docs/profanity-tls.1 b/docs/profanity-tls.1
new file mode 100644
index 00000000..b0a92eaa
--- /dev/null
+++ b/docs/profanity-tls.1
@@ -0,0 +1,104 @@
+.TH man 1 "2022-10-12" "0.13.0" "Profanity XMPP client"
+
+.SH NAME
+/tls
+
+.SH DESCRIPTION
+Handle TLS certificates. 
+
+.SH SYNOPSIS
+/tls allow
+
+.LP
+/tls always
+
+.LP
+/tls deny
+
+.LP
+/tls cert [<fingerprint>]
+
+.LP
+/tls trust
+
+.LP
+/tls trusted
+
+.LP
+/tls revoke <fingerprint>
+
+.LP
+/tls certpath
+
+.LP
+/tls certpath set <path>
+
+.LP
+/tls certpath clear
+
+.LP
+/tls certpath default
+
+.LP
+
+.SH ARGUMENTS
+.PP
+\fBallow\fR
+.RS 4
+Allow connection to continue with TLS certificate.
+.RE
+.PP
+\fBalways\fR
+.RS 4
+Always allow connections with TLS certificate.
+.RE
+.PP
+\fBdeny\fR
+.RS 4
+Abort connection.
+.RE
+.PP
+\fBcert\fR
+.RS 4
+Show the current TLS certificate.
+.RE
+.PP
+\fBcert <fingerprint>\fR
+.RS 4
+Show details of trusted certificate.
+.RE
+.PP
+\fBtrust\fR
+.RS 4
+Add the current TLS certificate to manually trusted certificates.
+.RE
+.PP
+\fBtrusted\fR
+.RS 4
+List summary of manually trusted certificates (with '/tls always' or '/tls trust').
+.RE
+.PP
+\fBrevoke <fingerprint>\fR
+.RS 4
+Remove a manually trusted certificate.
+.RE
+.PP
+\fBcertpath\fR
+.RS 4
+Show the trusted certificate path.
+.RE
+.PP
+\fBcertpath set <path>\fR
+.RS 4
+Specify filesystem path containing trusted certificates.
+.RE
+.PP
+\fBcertpath clear\fR
+.RS 4
+Clear the trusted certificate path.
+.RE
+.PP
+\fBcertpath default\fR
+.RS 4
+Use default system certificate path, if it can be found.
+.RE