1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
.TH KEYBOXD "1" "March 2022" "kbxutil (GnuPG) 2.4.1" "User Commands"
.SH NAME
keyboxd \- Public key management for GnuPG
.SH SYNOPSIS
.B keyboxd
.RB [ OPTIONS ]
.RB [ COMMAND ]
.SH DESCRIPTION
keyboxd is a public key management service for GnuPG.
.SH COMMANDS
Commands are not distinguished from options except for the fact that
only one command is allowed.
.TP
.B \-\-version
Print the program version and licensing information.
.TP
.B \-\-help
Print a usage message summarizing the most useful command-line
options.
.TP
.B \-\-server
Run in server mode and wait for commands on the \fBstdin\fR. The default
mode is to create a socket and listen for commands there. This is
only used for testing.
.TP
.B \-\-daemon
Run in background daemon mode and listen for commands on a socket.
This is the way \fBkeyboxd\fR is started on demand by the other GnuPG
components. To force starting \fBkeyboxd\fR it is in general best to use
\fBgpgconf \-\-launch keyboxd\fR.
.TP
.B \-\-supervised
Run in the foreground, sending logs to stderr, and listening on file
descriptor 3, which must already be bound to a listening socket. This
is useful when running under systemd or other similar process
supervision schemes. This option is not supported on Windows.
.SH OPTIONS
Note that all long options with the exception of \fB\-\-options\fR
and \fB\-\-homedir\fR may also be given in the configuration file
after stripping off the two leading dashes.
.TP
.B \-\-options \fIfile\fR
Reads configuration from \fIfile\fR instead of from the default
per-user configuration file. The default configuration file is named
\(oq\fIkeyboxd.conf\fR\(cq and expected in the home directory.
.TP
.B \-\-homedir \fIdir\fR
Set the name of the home directory to \fIdir\fR. This option is only
effective when used on the command line. The default is
the directory named \(oq\fI.gnupg\fR\(cq directly below the home directory
of the user unless the environment variable \fBGNUPGHOME\fR has been set
in which case its value will be used. Many kinds of data are stored within
this directory.
.TP
.B \-v
.TP
.B \-\-verbose
Outputs additional information while running.
You can increase the verbosity by giving several
verbose commands to \fBkeyboxd\fR, such as \fB\-vv\fR.
.TP
.B \-\-log\-file \fIfile\fR
Append all logging output to \fIfile\fR. This is very helpful in
seeing what the agent actually does. Use \(oq\fIsocket://\fR\(cq to log to
socket.
.TP
.B \-\-debug\-level \fIlevel\fR
Select the debug level for investigating problems. \fIlevel\fR may be a
numeric value or by a keyword:
.RS
.TP
.B none
No debugging at all. A value of less than 1 may be used instead of
the keyword.
.TP
.B basic
Some basic debug messages. A value between 1 and 2 may be used
instead of the keyword.
.TP
.B advanced
More verbose debug messages. A value between 3 and 5 may be used
instead of the keyword.
.TP
.B expert
Even more detailed messages. A value between 6 and 8 may be used
instead of the keyword.
.TP
.B guru
All of the debug messages you can get. A value greater than 8 may be
used instead of the keyword. The creation of hash tracing files is
only enabled if the keyword is used.
.RE
How these messages are mapped to the actual debugging flags is not
specified and may change with newer releases of this program. They are
however carefully selected to best aid in debugging.
.TP
.B \-\-debug \fIflags\fR
Set debugging flags. This option is only useful for debugging and its
behavior may change with a new release. All flags are or-ed and may
be given in C syntax (e.g. 0x0042) or as a comma separated list of
flag names. To get a list of all supported flags the single word
"help" can be used.
.TP
.B \-\-debug\-all
Same as \fB\-\-debug=0xffffffff\fR
.SH FILES
Keyboxd uses a configuration file which controls the operation of
keyboxd. By default they may all be found in the current home
directory (see: [option \-\-homedir]).
.TP
.B keyboxd.conf
This is the standard configuration file read by \fBkeyboxd\fR on
startup. It may contain any valid long option; the leading two dashes
may not be entered and the option may not be abbreviated. This file
is also read after a \fBSIGHUP\fR however not all options will
actually have an effect. This default name may be changed on the
command line (see: [option \-\-options]). You should backup this file.
.TP
.B pubring.db
This file is a database in SQLite format, for public key material.
You should backup this file.
.SH BUGS
Please report bugs to <https://dev.gnupg.org>.
.SH COPYRIGHT
Copyright \(co 2022 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
This manpage was generated by \fBNIIBE Yutaka\fR for the Debian
distribution (but may be used by others), using man page of dirmngr.
|
