Bug 1869055

Summary: [doc] kvno usage not compliant with man page kvno(1)
Product: Red Hat Enterprise Linux 8 Reporter: Yongcheng Yang <yoyang>
Component: krb5Assignee: Robbie Harwood <rharwood>
Status: CLOSED ERRATA QA Contact: Filip Dvorak <fdvorak>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 8.3CC: dpal, fdvorak, xzhou
Target Milestone: rcFlags: pm-rhel: mirror+
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
URL: https://github.com/krb5/krb5/pull/1105
Whiteboard:
Fixed In Version: krb5-1.18.2-7.el8 Doc Type: No Doc Update
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2021-05-18 14:42:18 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:

Description Yongcheng Yang 2020-08-16 02:42:25 UTC
Description of problem:

The tool `kvno` usage (from command line) includes "[-k keytab]" but this is not mentioned in the corresponding man page kvno(1) and myabe not usable.
Also for the options [-C] and [-u].

Please update the doc/usage about it.


Version-Release number of selected component (if applicable):
krb5-workstation-1.18.2-5.el8

How reproducible:
always

Steps to Reproduce:
1. kvno -h 2>&1 | grep keytab
2. man kvno | grep keytab
3.

Actual results:
[root@lenovo-sr630-01 ~]# kvno -h
usage: kvno [-C] [-u] [-c ccache] [-e etype]
        [-k keytab] [-S sname] [{-I | -U} for_user | [-F cert_file] [-P]]
        [--u2u ccache] service1 service2 ...
[root@lenovo-sr630-01 ~]# echo $?
1
[root@lenovo-sr630-01 ~]#

[root@lenovo-sr630-01 ~]# man kvno | grep -A2 SYNOPSIS
SYNOPSIS
       kvno  [-c ccache] [-e etype] [-q] [-h] [-P] [-S sname] [-I for_user] [-U for_user] [-F cert_file] [--u2u ccache] ser‐
       vice1 service2 ...
[root@lenovo-sr630-01 ~]# man kvno | grep '\-k'
[root@lenovo-sr630-01 ~]# man kvno | grep '\-C'
[root@lenovo-sr630-01 ~]# man kvno | grep '\-u'
       kvno  [-c ccache] [-e etype] [-q] [-h] [-P] [-S sname] [-I for_user] [-U for_user] [-F cert_file] [--u2u ccache] ser‐
       --u2u ccache
              Requests a user-to-user ticket.  ccache must contain a local krbtgt ticket  for  the  server  principal.   The
[root@lenovo-sr630-01 ~]# rpm -qf `which kvno`
krb5-workstation-1.18.2-5.el8.x86_64
[root@lenovo-sr630-01 ~]# rpm -qf `man -w kvno`
krb5-workstation-1.18.2-5.el8.x86_64
[root@lenovo-sr630-01 ~]#

Expected results:
kvno "usage" compliant with the man page kvno(1).
I.e. options [-C] [-u] [-k keytab]

Additional info:
rhel7 has the same problem

Comment 1 Robbie Harwood 2020-08-20 22:49:40 UTC
> Additional info:
> rhel7 has the same problem

Please be aware of support lifecycles here; this will not be addressed for RHEL 7 :)

I've submitted a PR to fix a slightly larger issue upstream.  Depending on the form upstream merges the change in, we may need to adapt your checks from #c0, but we'll see.

Comment 13 errata-xmlrpc 2021-05-18 14:42:18 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 (Moderate: krb5 security update), 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-2021:1593