Code

sysdb(1), sysdbd(1): Document client authentication.
[sysdb.git] / doc / sysdb.1.txt
index ccb2e96b7de55bac1eef85cbaf000c2f173be7b9..ce73dbe0fe86117320c1e9313a2466b750c3db5c 100644 (file)
@@ -22,6 +22,9 @@ OPTIONS
 -------
 *sysdb* accepts the following command-line options.
 
+Connection options:
+~~~~~~~~~~~~~~~~~~~
+
 *-H* '<host>'::
        The SysDB host to connect to. May be specified as the path to a UNIX
        socket opened by the daemon. Defaults to {localstatedir}/run/sysdbd.sock.
@@ -36,12 +39,33 @@ OPTIONS
        separately. Exit the process after handling the reply from the last
        command.
 
+SSL options:
+~~~~~~~~~~~~
+
+*-K* '<keyfile>'::
+       The SSL private key file to use for SSL connections.
+
+*-C* '<certfile>'::
+       The SSL certificate file to use for SSL connections.
+
+*-A* '<cafile>'::
+       The certificate authority (CA) certificates file for server certificate
+       verification to use for SSL connection.
+
+General options:
+~~~~~~~~~~~~~~~~
+
 *-h*::
        Display a usage and help summary and exit.
 
 *-V*::
        Display the version number and copyright information.
 
+AUTHENTICATION
+--------------
+
+include::sysdb-auth.txt[]
+
 EXIT CODES
 ----------
 *0*::
@@ -51,6 +75,17 @@ EXIT CODES
        Failure (syntax or usage error). When using the *-c* option, sysdb exits
        with status 1 if the specified command failed.
 
+FILES
+-----
+
+*~/.config/sysdb/ssl/key.pem*::
+*~/.config/sysdb/ssl/cert.pem*::
+       The default SSL private key and certificate files to use for SSL
+       connections.
+
+*~/.sysdb_history*::
+       The command-line history is stored in this file.
+
 BUGS
 ----
 None known.
@@ -59,6 +94,8 @@ SEE ALSO
 --------
 manpage:sysdbd[1], manpage:sysdbql[7]
 
+The SysDB homepage: https://sysdb.io/
+
 AUTHOR
 ------
 SysDB was written by Sebastian "tokkee" Harl <sh@tokkee.org>.