Code

ba64f713dce47a13010d743a306499001636cf13
[sysdb.git] / doc / sysdb.1.txt
1 sysdb(1)
2 ========
3 :doctype: manpage
5 NAME
6 ----
7 sysdb - interactive client for the system management and inventory collection
8 service
10 SYNOPSIS
11 --------
12 *sysdb* ['options']
14 DESCRIPTION
15 -----------
16 *sysdb* is a terminal-based, interactive client program for SysDB, a
17 multi-backend system management and inventory collection daemon. It connects
18 to a running daemon and then accepts commands from the user, send them to the
19 server, and display the result.
21 OPTIONS
22 -------
23 *sysdb* accepts the following command-line options.
25 Connection options:
26 ~~~~~~~~~~~~~~~~~~~
28 *-H* '<host>'::
29         The SysDB host to connect to. May be specified as the path to a UNIX
30         socket opened by the daemon. Defaults to {localstatedir}/run/sysdbd.sock.
32 *-U* '<username>'::
33         The username used to authenticate against the server. Defaults to the
34         current user.
36 *-c* '<command>'::
37         Send the specified command to the server after authenticating. This option
38         may be used multiple times. Each command will be send to the server
39         separately. Exit the process after handling the reply from the last
40         command.
42 SSL options:
43 ~~~~~~~~~~~~
45 *-K* '<keyfile>'::
46         The SSL private key file to use for SSL connections.
48 *-C* '<certfile>'::
49         The SSL certificate file to use for SSL connections.
51 *-A* '<cafile>'::
52         The certificate authority (CA) certificates file for server certificate
53         verification to use for SSL connection.
55 General options:
56 ~~~~~~~~~~~~~~~~
58 *-h*::
59         Display a usage and help summary and exit.
61 *-V*::
62         Display the version number and copyright information.
64 EXIT CODES
65 ----------
66 *0*::
67         Success.
69 *1*::
70         Failure (syntax or usage error). When using the *-c* option, sysdb exits
71         with status 1 if the specified command failed.
73 BUGS
74 ----
75 None known.
77 SEE ALSO
78 --------
79 manpage:sysdbd[1], manpage:sysdbql[7]
81 The SysDB homepage: https://sysdb.io/
83 AUTHOR
84 ------
85 SysDB was written by Sebastian "tokkee" Harl <sh@tokkee.org>.
87 COPYRIGHT
88 ---------
89 Copyright (C) 2012-2014 Sebastian "tokkee" Harl <sh@tokkee.org>
91 This is free software under the terms of the BSD license, see the source for
92 copying conditions. There is NO WARRANTY; not even for MERCHANTABILITY or
93 FITNESS FOR A PARTICULAR PURPOSE.
95 // vim: set tw=78 sw=4 ts=4 noexpandtab spell spelllang=en_us :