Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

RHEL Engineering is moving the tracking of its product development work on RHEL 6 through RHEL 9 to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "RHEL project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs in the statuses "NEW", "ASSIGNED", and "POST" are being migrated throughout September 2023. Bugs of Red Hat partners with an assigned Engineering Partner Manager (EPM) are migrated in late September as per pre-agreed dates. Bugs against components "kernel", "kernel-rt", and "kpatch" are only migrated if still in "NEW" or "ASSIGNED". If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "RHEL project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/RHEL-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.

Bug 1545388

Summary:	[MAN] Missing Man pages for tools CMCRequest, CMCResponse, CMCSharedToken
Product:	Red Hat Enterprise Linux 7	Reporter:	Christina Fu <cfu>
Component:	pki-core	Assignee:	Christina Fu <cfu>
Status:	CLOSED ERRATA	QA Contact:	Asha Akkiangady <aakkiang>
Severity:	urgent	Docs Contact:
Priority:	urgent
Version:	7.5	CC:	gkapoor, mharmsen, msauton
Target Milestone:	rc	Keywords:	TestCaseProvided, ZStream
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	No Doc Update
Doc Text:	undefined	Story Points:	---
Clone Of:
Clones:	1557880 (view as bug list)		Environment:
Last Closed:	2018-10-30 11:05:22 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	1557880, 1570916

Description Christina Fu 2018-02-14 19:48:55 UTC

RHCS 9.3 Common Criteria evaluation requires adequate documentation. 

CMC is the core feature required by the CA Protection Profile.  We are missing man pages for the following tools: CMCRequest, CMCRevoke, and CMCResponse

In addition, the existing tool CMCEnroll has not been updated to support the latest CMC feature update, and yet its man page exists.  Should probably add a note in there to state the fact.

Comment 3 Christina Fu 2018-03-15 02:10:26 UTC

up for review:
https://review.gerrithub.io/403908

Comment 4 Christina Fu 2018-03-16 16:46:08 UTC

pushed to master

Author: Christina Fu <cfu>
Date:   Mon Feb 26 13:16:01 2018 -0800

    Ticket #2940 [MAN] Missing Man pages for tools CMCRequest, CMCResponse, CMCSharedToken, and CMCRevoke
    
    This patch adds man pages for CMCRequest, CMCResponse, and CMCSharedToken.
    In addition, the usage in CMCResponse has been enhanced to include a
    verbose mode which will output certs in Base64 encoding individually.
    A "note" has been added to CMCRevoke --help to direct users to CMCRequest
    for better usability. The man page for CMCRevoke is intentionaly left out
    for this reason.
    
    The URL in CMCRequest.1 is a placeholder for the follow-up patch.  It will
    be replaced once the examples are complete.
    
    This patch addresses https://pagure.io/dogtagpki/issue/2940
    
    Change-Id: Id1df31a29207a0d12d50b7a3b959a3abcd9748d0

Comment 6 Matthew Harmsen 2018-04-05 22:05:10 UTC

commit 3ce3ae9bd73a906beb0254a7488b15e11ddcf905
Author: Christina Fu <cfu>
Date:   Mon Mar 26 10:09:42 2018 -0700

    reflect dogtagpki url change in CMCRequest man page.
    
    Change-Id: I8eb5884a26850b87f378c4417939c873c27fd409

Comment 8 Matthew Harmsen 2018-06-26 00:59:42 UTC

Test Procedure:

Verify man pages are correct.

Comment 9 Geetika Kapoor 2018-08-16 12:14:13 UTC

Test Env:

rpm -qa pki-ca
pki-ca-10.5.9-5.el7.noarch


Test Steps:

Man pages looks good.

Comment 11 errata-xmlrpc 2018-10-30 11:05:22 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2018:3195