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