|
 |
52bf73 |
From 9ae2a531042f3ad9cbc4ed773657ed99555ca3c7 Mon Sep 17 00:00:00 2001
|
|
|
52bf73 |
From: Nalin Dahyabhai <nalin@redhat.com>
|
|
|
52bf73 |
Date: Tue, 27 Oct 2015 16:41:09 -0400
|
|
|
52bf73 |
Subject: [PATCH 29/29] Document -R/-N/-o in dogtag-ipa-renew-agent-submit
|
|
|
52bf73 |
|
|
|
52bf73 |
Add notes about the -R, -N, and -o flags to the man page for
|
|
|
52bf73 |
dogtag-ipa-renew-agent-submit.
|
|
|
52bf73 |
|
|
|
52bf73 |
It's really just a version of dogtag-submit with different defaults
|
|
|
52bf73 |
compiled in, and that should already be reflected in the --help output,
|
|
|
52bf73 |
but overriding key behaviors while still using those defaults can be a
|
|
|
52bf73 |
useful thing in troubleshooting situations, so we should document them.
|
|
|
52bf73 |
Heads-up from Marco Rhodes.
|
|
|
52bf73 |
---
|
|
|
52bf73 |
...tmonger-dogtag-ipa-renew-agent-submit.8.in | 19 ++++++++++++++++++-
|
|
|
52bf73 |
src/certmonger-dogtag-submit.8.in | 3 ++-
|
|
|
52bf73 |
2 files changed, 20 insertions(+), 2 deletions(-)
|
|
|
52bf73 |
|
|
|
52bf73 |
diff --git a/src/certmonger-dogtag-ipa-renew-agent-submit.8.in b/src/certmonger-dogtag-ipa-renew-agent-submit.8.in
|
|
|
52bf73 |
index 481e396..3863b2a 100644
|
|
|
52bf73 |
--- a/src/certmonger-dogtag-ipa-renew-agent-submit.8.in
|
|
|
52bf73 |
+++ b/src/certmonger-dogtag-ipa-renew-agent-submit.8.in
|
|
|
52bf73 |
@@ -1,4 +1,4 @@
|
|
|
52bf73 |
-.TH certmonger 8 "18 Nov 2014" "certmonger Manual"
|
|
|
52bf73 |
+.TH certmonger 8 "27 Oct 2015" "certmonger Manual"
|
|
|
52bf73 |
|
|
|
52bf73 |
.SH NAME
|
|
|
52bf73 |
dogtag-ipa-renew-agent-submit
|
|
|
52bf73 |
@@ -18,6 +18,8 @@ dogtag-ipa-renew-agent-submit -E EE-URL -A AGENT-URL
|
|
|
52bf73 |
[-S state]
|
|
|
52bf73 |
[-T profile]
|
|
|
52bf73 |
[-O param=value]
|
|
|
52bf73 |
+[-N | -R]
|
|
|
52bf73 |
+[-o option=value]
|
|
|
52bf73 |
[-v]
|
|
|
52bf73 |
[csrfile]
|
|
|
52bf73 |
|
|
|
52bf73 |
@@ -134,6 +136,21 @@ settings are applied. This option can be used either to override a
|
|
|
52bf73 |
server-supplied default setting, or to supply one which would otherwise have
|
|
|
52bf73 |
not been used.
|
|
|
52bf73 |
.TP
|
|
|
52bf73 |
+\fB-N\fR
|
|
|
52bf73 |
+Even if an already-issued certificate is available in the
|
|
|
52bf73 |
+\fICERTMONGER_CERTIFICATE\fR environment variable, or a serial number has been
|
|
|
52bf73 |
+provided, don't attempt to renew a certificate using its serial number.
|
|
|
52bf73 |
+Instead, attempt to obtain a new certificate using the signing request.
|
|
|
52bf73 |
+The default behavior is to request a renewal if possible.
|
|
|
52bf73 |
+.TP
|
|
|
52bf73 |
+\fB-R\fR
|
|
|
52bf73 |
+Negates the effect of the \fB-N\fR flag.
|
|
|
52bf73 |
+.TP
|
|
|
52bf73 |
+\fB-o\fR param=value
|
|
|
52bf73 |
+When initially submitting a request to the CA, add the specified parameter and
|
|
|
52bf73 |
+value along with any request parameters which would otherwise be sent. This
|
|
|
52bf73 |
+option is not typically used.
|
|
|
52bf73 |
+.TP
|
|
|
52bf73 |
\fB-v\fR
|
|
|
52bf73 |
Increases the logging level. Use twice for more logging. This option is mainly
|
|
|
52bf73 |
useful for troubleshooting.
|
|
|
52bf73 |
diff --git a/src/certmonger-dogtag-submit.8.in b/src/certmonger-dogtag-submit.8.in
|
|
|
52bf73 |
index 54cd1b1..3a8fc87 100644
|
|
|
52bf73 |
--- a/src/certmonger-dogtag-submit.8.in
|
|
|
52bf73 |
+++ b/src/certmonger-dogtag-submit.8.in
|
|
|
52bf73 |
@@ -1,4 +1,4 @@
|
|
|
52bf73 |
-.TH certmonger 8 "13 Apr 2015" "certmonger Manual"
|
|
|
52bf73 |
+.TH certmonger 8 "27 Oct 2015" "certmonger Manual"
|
|
|
52bf73 |
|
|
|
52bf73 |
.SH NAME
|
|
|
52bf73 |
dogtag-submit
|
|
|
52bf73 |
@@ -108,6 +108,7 @@ Even if an already-issued certificate is available in the
|
|
|
52bf73 |
\fICERTMONGER_CERTIFICATE\fR environment variable, or a serial number has been
|
|
|
52bf73 |
provided, don't attempt to renew a certificate using its serial number.
|
|
|
52bf73 |
Instead, attempt to obtain a new certificate using the signing request.
|
|
|
52bf73 |
+The default behavior is to request a renewal if possible.
|
|
|
52bf73 |
.TP
|
|
|
52bf73 |
\fB-R\fR
|
|
|
52bf73 |
Negates the effect of the \fB-N\fR flag.
|
|
|
52bf73 |
--
|
|
|
52bf73 |
2.17.2
|
|
|
52bf73 |
|