Bug 1657164

Summary:	`certutil -u I` is not documented
Product:	Red Hat Enterprise Linux 7	Reporter:	Alicja Kario <hkario>
Component:	nss	Assignee:	Bob Relyea <rrelyea>
Status:	CLOSED ERRATA	QA Contact:	Ivan Nikolchev <inikolch>
Severity:	low	Docs Contact:
Priority:	low
Version:	7.6	CC:	dueno, inikolch, omoris, rrelyea
Target Milestone:	rc	Keywords:	Reopened
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	nss-3.44.0-4.el7	Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:
Clones:	1894060 (view as bug list)		Environment:
Last Closed:	2019-08-23 10:36:40 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:	1645231

Description Alicja Kario 2018-12-07 10:11:22 UTC

Description of problem:
The `I` option for cert verification is not documented in certutil(1) man page

Version-Release number of selected component (if applicable):
nss-3.36.0-7.1.el7_6.x86_64

How reproducible:
always

Steps to Reproduce:
1. man certutil | col -b | grep IPsec

Actual results:
<no output>

Expected results:
documentation for -u I option

Additional info:
introduced with bug 1650450

Comment 1 Simo Sorce 2019-02-11 15:39:30 UTC

This issue was not selected to be included either in Red Hat Enterprise Linux 7.7 because it is seen either as low or moderate impact to a small amount of use-cases. The next release will be in Maintenance Support 1 Phase, which means that qualified Critical and Important Security errata advisories (RHSAs) and Urgent Priority Bug Fix errata advisories (RHBAs) may be released as they become available. We will now close this issue, but if you believe that it qualifies for the Maintenance Support 1 Phase, please re-open; otherwise we recommend moving the request to Red Hat Enterprise Linux 8 if applicable.

Comment 7 Bob Relyea 2019-04-04 18:56:13 UTC

resolved in nss-3.43.0-4.el7

Comment 9 Ondrej Moriš 2019-05-31 05:56:01 UTC

I still do not see it in the man page with nss-tools-3.44.0-2.el7:

# mandb -c
...
# man certutil
...
       -u certusage
           Specify a usage context to apply when validating a certificate with the -V option.

           The contexts are the following:

           ·   C (as an SSL client)

           ·   V (as an SSL server)

           ·   L (as an SSL CA)

           ·   A (as Any CA)

           ·   Y (Verify CA)

           ·   S (as an email signer)

           ·   R (as an email recipient)

           ·   O (as an OCSP status responder)

           ·   J (as an object signer)

Comment 10 Daiki Ueno 2019-06-03 11:40:22 UTC

Bob, do you want to fix this?  I think it is okay to postpone as it only affects testing behavior with -V.

Comment 11 Bob Relyea 2019-06-05 16:24:48 UTC

It's not certusage, it's extended key usage.

Comment 12 Bob Relyea 2019-06-05 16:29:45 UTC

You can find the new usages with 'man certutil | grep -i ipsec'

bob

Comment 13 Daiki Ueno 2019-06-05 16:31:27 UTC

Yes I know, but this bug is about certusage, because Kai's original patch added it (-u I).  Do you think we should remove that option?

Comment 14 Bob Relyea 2019-06-05 16:32:07 UTC

Oh, -u I was also added, I thought this bug was about the missing ipsec extendedKeyusages that were added by my latest patch. -u I was added quite a while ago.

Comment 15 Bob Relyea 2019-06-05 16:34:04 UTC

OK, my bad. Kai didn't add -I, he just added the raw IPSEC value. OK. I still need to update this.

Comment 17 Bob Relyea 2019-06-10 17:16:15 UTC

nss-3.44.0-4.el7 should have the new man page. The patch is upstream and in RHEL 8.0.z as well.

bob

Comment 18 Ondrej Moriš 2019-06-12 12:31:14 UTC

Actually, Ivan pointed out that there is a difference between --help and man page, in --help the value is "IPsec" and in man page it is "IPSEC". Is the -u option case sensitive or not? If it is, we should perhaps want to have the it the same in help and man page to avoid mistakes.

Anyway, it is not a blocking issue for RHEL-7.7

Comment 19 Ondrej Moriš 2019-06-12 12:35:15 UTC

(In reply to Ondrej Moriš from comment #18)
> Actually, Ivan pointed out that there is a difference between --help and man
> page, in --help the value is "IPsec" and in man page it is "IPSEC". Is the
> -u option case sensitive or not? If it is, we should perhaps want to have
> the it the same in help and man page to avoid mistakes.
> 
> Anyway, it is not a blocking issue for RHEL-7.7

Ah, one specifies just "I" (-u I). Sorry my bad. It is okay then. Sorry for the noise.

Comment 22 Alicja Kario 2019-08-23 10:36:40 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/RHSA-2019:2237