SYNOPSIS¶
certmaster-submit [-h HOST] [-c FILE] [-C DIR] [-v] [csrfile]
DESCRIPTION¶
certmaster-submit is the helper which certmonger uses to make
requests to certmaster-based CAs. It is not normally run interactively, but it
can be for troubleshooting purposes. The signing request which is to be
submitted should either be in a file whose name is given as an argument, or
fed into certmaster-submit via stdin.
There is no standard authenticated method for obtaining the root
certificate from certmaster CAs, so certmonger does not support
retrieving trust information from them.
OPTIONS¶
- -h HOST, --server-host=HOST
- Submit the request to the certmaster instance running on the named host.
The default is localhost:51235 if a file named
/var/run/certmaster.pid is found on the local system, and is read
from /etc/certmaster/minion.conf if that file is not found.
- -c FILE, --cafile=FILE
- Submit the request over HTTPS instead of HTTP, and only trust the server
if its certificate was issued by the CA whose certificate is in the named
file.
- -C DIR, --capath=DIR
- Submit the request over HTTPS instead of HTTP, and only trust the server
if its certificate was issued by a CA whose certificate is in a file in
the named directory.
- -v, --verbose
- Be verbose about errors. Normally, the details of an error received from
the daemon will be suppressed if the client can make a diagnostic
suggestion.
EXIT STATUS¶
- 0
- if the certificate was issued. The certificate will be printed.
- 1
- if the CA is still thinking. A cookie value will be printed.
- 2
- if the CA rejected the request. An error message may be printed.
- 3
- if the CA was unreachable. An error message may be printed.
- 4
- if critical configuration information is missing. An error message may be
printed.
FILES¶
- /var/run/certmaster.pid
- the certmaster service's PID file. Its presence is taken to indicate that
this system is a CA, and that requests should be submitted to a certmaster
server running on the local system.
- /etc/certmaster/minion.conf
- the certmaster minion configuration file. If there is no indication that
the local system is a certmaster server, then this file is consulted to
determine the location of the certmaster server.
KNOWN BUGS¶
Checking for the existence of certmaster's PID file is a terrible way to figure
out whether we're a minion or not.
SEE ALSO¶
certmonger(8) getcert(1) getcert-add-ca(1)
getcert-add-scep-ca(1) getcert-list-cas(1)
getcert-list(1) getcert-modify-ca(1)
getcert-refresh-ca(1) getcert-refresh(1) getcert-rekey(1)
getcert-remove-ca(1) getcert-resubmit(1)
getcert-start-tracking(1) getcert-status(1)
getcert-stop-tracking(1)
certmonger-dogtag-ipa-renew-agent-submit(8)
certmonger-dogtag-submit(8) certmonger-ipa-submit(8)
certmonger-local-submit(8) certmonger-scep-submit(8)
certmonger_selinux(8)
