summary refs log tree commit diff
path: root/catgirl.1
diff options
context:
space:
mode:
authorJune McEnroe <june@causal.agency>2021-01-09 19:11:57 -0500
committerJune McEnroe <june@causal.agency>2021-01-09 19:11:57 -0500
commite42b3aa08e3706ecb87ca76254fbab51cccf3390 (patch)
treeab0232c0962f1f7ca6649ff1b0767b5c2f2ee120 /catgirl.1
parentAllow configuring the upper bound of the hash function (diff)
downloadcatgirl-e42b3aa08e3706ecb87ca76254fbab51cccf3390.tar.gz
catgirl-e42b3aa08e3706ecb87ca76254fbab51cccf3390.zip
Add -o and -t options to trust self-signed certificates
Diffstat (limited to 'catgirl.1')
-rw-r--r--catgirl.137
1 files changed, 37 insertions, 0 deletions
diff --git a/catgirl.1 b/catgirl.1
index 04216a6..7912831 100644
--- a/catgirl.1
+++ b/catgirl.1
@@ -21,9 +21,11 @@
 .Op Fl j Ar join
 .Op Fl k Ar priv
 .Op Fl n Ar nick
+.Op Fl o Ar chain
 .Op Fl p Ar port
 .Op Fl r Ar real
 .Op Fl s Ar save
+.Op Fl t Ar trust
 .Op Fl u Ar user
 .Op Fl w Ar pass
 .Op Ar config ...
@@ -216,6 +218,12 @@ Set nickname to
 .Ar nick .
 The default nickname is the user's name.
 .
+.It Fl o Ar chain
+Write the server certificate chain to
+.Ar chain
+in PEM format.
+This temporarily disables certificate verification!
+.
 .It Fl p Ar port , Cm port = Ar port
 Connect to
 .Ar port .
@@ -238,6 +246,17 @@ starts with
 or
 .Ql \&. .
 .
+.It Fl t Ar path , Cm trust = Ar path
+Trust the certificate loaded from
+.Ar path .
+Server name verification is disabled.
+The
+.Ar path
+is searched for in the same manner
+as configuration files.
+See
+.Sx Connecting to Servers with Self-signed Certificates .
+.
 .It Fl u Ar user , Cm user = Ar user
 Set username to
 .Ar user .
@@ -287,6 +306,24 @@ sasl-external
 .Ed
 .El
 .
+.Ss Connecting to Servers with Self-signed Certificates
+.Bl -enum
+.It
+Connect to the server
+and write its certificate to a file:
+.Bd -literal -offset indent
+catgirl -h irc.example.org -o ~/.config/catgirl/example.pem
+.Ed
+.It
+Configure
+.Nm
+to trust the certificate:
+.Bd -literal -offset indent
+trust = example.pem
+# or: catgirl -t example.pem
+.Ed
+.El
+.
 .Sh COMMANDS
 Any unique prefix can be used to abbreviate a command.
 For example,