From a05cc4f346011697b3a4b49abad809b00bc1105c Mon Sep 17 00:00:00 2001 From: Rob Crittenden Date: Mon, 20 May 2019 16:37:23 -0400 Subject: [PATCH 26/29] Document key/cert file owner and mode options The owner and permission options were available but not documented either on the command-line or in the man page. Affects request, resubmit and start-tracking commands. https://bugzilla.redhat.com/show_bug.cgi?id=1549585 --- src/getcert-request.1.in | 8 ++++++++ src/getcert-resubmit.1.in | 8 ++++++++ src/getcert-start-tracking.1.in | 8 ++++++++ src/getcert.c | 12 ++++++++++++ 4 files changed, 36 insertions(+) diff --git a/src/getcert-request.1.in b/src/getcert-request.1.in index 8269b78..691ba35 100644 --- a/src/getcert-request.1.in +++ b/src/getcert-request.1.in @@ -208,6 +208,14 @@ one to fail. \fB\-v\fR 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. +\fB\-o\fR OWNER, --key-owner=OWNER +After generation set the owner on the private key file or database to OWNER. +\fB\-m\fR MODE, --key-perms=MODE +After generation set the file permissions on the private key file or database to MODE. +\fB\-O\fR OWNER, --cert-owner=OWNER +After generation set the owner on the certificate file or database to OWNER. +\fB\-M\fR MODE, --cert-perms=MODE +After generation set the file permissions on the certificate file or database to MODE. .SH NOTES Locations specified for key and certificate storage need to be diff --git a/src/getcert-resubmit.1.in b/src/getcert-resubmit.1.in index 62d5f28..89ea609 100644 --- a/src/getcert-resubmit.1.in +++ b/src/getcert-resubmit.1.in @@ -145,6 +145,14 @@ one to fail. \fB\-v\fR 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. +\fB\-o\fR OWNER, --key-owner=OWNER +After generation set the owner on the private key file or database to OWNER. +\fB\-m\fR MODE, --key-perms=MODE +After generation set the file permissions on the private key file or database to MODE. +\fB\-O\fR OWNER, --cert-owner=OWNER +After generation set the owner on the certificate file or database to OWNER. +\fB\-M\fR MODE, --cert-perms=MODE +After generation set the file permissions on the certificate file or database to MODE. .SH BUGS Please file tickets for any that you find at https://fedorahosted.org/certmonger/ diff --git a/src/getcert-start-tracking.1.in b/src/getcert-start-tracking.1.in index 9daeed3..e1c9dd4 100644 --- a/src/getcert-start-tracking.1.in +++ b/src/getcert-start-tracking.1.in @@ -181,6 +181,14 @@ the attempt to obtain a new one to fail. \fB\-v\fR 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. +\fB\-o\fR OWNER, --key-owner=OWNER +After generation set the owner on the private key file or database to OWNER. +\fB\-m\fR MODE, --key-perms=MODE +After generation set the file permissions on the private key file or database to MODE. +\fB\-O\fR OWNER, --cert-owner=OWNER +After generation set the owner on the certificate file or database to OWNER. +\fB\-M\fR MODE, --cert-perms=MODE +After generation set the file permissions on the certificate file or database to MODE. .SH NOTES Locations specified for key and certificate storage need to be diff --git a/src/getcert.c b/src/getcert.c index 03af587..bddba29 100644 --- a/src/getcert.c +++ b/src/getcert.c @@ -4743,6 +4743,10 @@ help(const char *twopartcmd, const char *category) N_(" -a NSS database in which to store the CA's certificates\n"), N_(" -w try to wait for the certificate to be issued\n"), N_(" -v report all details of errors\n"), + N_(" -o OWNER owner information for private key\n"), + N_(" -m MODE file permissions for private key\n"), + N_(" -O OWNER owner information for certificate\n"), + N_(" -M MODE file permissions for certificate\n"), NULL, }; const char *start_tracking_help[] = { @@ -4793,6 +4797,10 @@ help(const char *twopartcmd, const char *category) N_(" -a NSS database in which to store the CA's certificates\n"), N_(" -w try to wait for the certificate to be issued\n"), N_(" -v report all details of errors\n"), + N_(" -o OWNER owner information for private key\n"), + N_(" -m MODE file permissions for private key\n"), + N_(" -O OWNER owner information for certificate\n"), + N_(" -M MODE file permissions for certificate\n"), NULL, }; const char *stop_tracking_help[] = { @@ -4865,6 +4873,10 @@ help(const char *twopartcmd, const char *category) N_(" -a NSS database in which to store the CA's certificates\n"), N_(" -w try to wait for the certificate to be issued\n"), N_(" -v report all details of errors\n"), + N_(" -o OWNER owner information for private key\n"), + N_(" -m MODE file permissions for private key\n"), + N_(" -O OWNER owner information for certificate\n"), + N_(" -M MODE file permissions for certificate\n"), NULL, }; const char *rekey_help[] = { -- 2.17.2