Bug 509318

Summary: Differences in documentation of ipsec showhostkey between manual page and --help options
Product: Red Hat Enterprise Linux 5 Reporter: Miroslav Vadkerti <mvadkert>
Component: openswanAssignee: Avesh Agarwal <avagarwa>
Status: CLOSED DUPLICATE QA Contact: BaseOS QE Security Team <qe-baseos-security>
Severity: medium Docs Contact:
Priority: medium    
Version: 5.4CC: amarecek, ebenes, jiabwang, jyang, llim, ohudlick, sghosh, sgrubb, tis
Target Milestone: rcKeywords: Regression
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-08-24 14:04:48 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Miroslav Vadkerti 2009-07-02 07:40:42 UTC
Description of problem:

The help of ipsec showhostkey shows:
.qa.[root@i386-5c-m1 tps]# ipsec showhostkey --help
Usage: ipsec showhostkey [--ipseckey {gateway}] [--left ] [--right ]
                         [--dump ] [--list ] [--x509self]
                         [--x509req ] [--x509cert ]      
                         [ --txt gateway ] [--dhclient ] 
                         [ --file secretfile ] 
                         [ --keynum count ] [ --id identity ]
                         [ --rsaid keyid ] [--verbose] [--version]

But the manual page lists:
SYNOPSIS
       ipsec showhostkey [--file secretfile] [--id identity]
              --dhclient | --left | --right | --txt gateway |
             --ipseckey <@fqdn|ip-addr> | --key | --help

Version-Release number of selected component (if applicable):
openswan-2.6.14-1.el5_3.3

How reproducible:
always

Steps to Reproduce:
# ipsec showhostkey --help
# info ipsec_showhostkey
  
Actual results:
Differences in options help <> manual page. There are various unexplained options in manual page (e.g. --dump- --keynun, --x509req, x509cert)

Expected results:
No differences in options

Comment 1 Eduard Benes 2009-07-03 11:56:15 UTC
Also the list of commands provided by the --help option, prints the list twice.

Version:
openswan-2.6.21-4.el5

Steps to reproduce:
1. run:
# ipsec --help
Usage: ipsec command argument ...
where command is one of:
	addconn
	auto
        ...
	whack
	addconn
	auto
	...
	whack

Actual results:
Commands are listed twice ...

Expected results: 
Print it just once ...

Additional info:
Both issues are easy to fix and test.

Comment 3 Eduard Benes 2009-10-15 13:13:55 UTC
*** Bug 524146 has been marked as a duplicate of this bug. ***

Comment 5 Avesh Agarwal 2009-12-23 22:07:00 UTC
The patch is already sent to upstream and should not be a problem to do backporting.

Comment 7 Osier Yang 2010-03-04 09:18:25 UTC
jiabwang, please help about this, I don't have then enviroment currently.

Thanks 
osier

Comment 14 Avesh Agarwal 2011-08-23 14:50:08 UTC
This will be covered by the rebase bz 698248.

Comment 15 Avesh Agarwal 2011-08-24 14:04:48 UTC
Closing it as duplicate of 698248.

*** This bug has been marked as a duplicate of bug 698248 ***