sullo / nikto

Nikto web server scanner
Other
8.3k stars 1.2k forks source link

Bug: manpage incorrectly says "-h" option is for help ("-help") #708

Closed ianjmacintosh closed 3 years ago

ianjmacintosh commented 3 years ago

Expected behavior

Running man nikto should yield a manpage for nikto with concise and accurate information about synopsis, usage, options, etc.

The manpage should reference the -H option and the -Help option for an extended help listing, and should not reference -help until it has been implemented. If making reference to -h, it should be within the context of the -host option, not as shorthand for -help

Actual behavior

man nikto
...
OPTIONS
       Below are all of the Nikto command line options and explanations. A
       brief version of this text is available by running Nikto with the -h
       (-help) option.

...

I'm not sure where all the references to this are, but I found a couple: https://github.com/sullo/nikto/blob/2aa550f70e53212c76693b78c6960aadcf8443f2/documentation/sections/options.xml#L3-L4 https://github.com/sullo/nikto/blob/2aa550f70e53212c76693b78c6960aadcf8443f2/program/docs/nikto_manual.html#L119-L120

NOTE: Running nikto -h yields a short help output, but only because it's invalid usage. -help, --help, and -h without a hostname are all invalid.

Steps to reproduce

  1. In shell, run man nikto
  2. Jump to the top of the options section
  3. See inaccurate info about running Nikto with the -h (-help) option

Nikto version

--------------------------------------------------------------------------
Nikto Versions
---------------------------------------------------------------------------
File                               Version      Last Mod
-----------------------------      --------     ----------
Nikto main                         2.1.6
LibWhisker                         2.5
db_404_strings                     2.003        
db_content_search                  2.000        
         nary                      1.0
db_dir_traversal                   2.1.6        
db_domino                          2.1.6        
db_drupal                          1.00         
db_embedded                        2.004        
db_favicon                         2.010        
db_headers                         2.008        
db_httpoptions                     2.002        
db_multiple_index                  2.005        
db_outdated                        2.017        
db_parked_strings                  2.001        
db_realms                          2.002        
db_server_msgs                     2.006        
db_tests                           2.021        
db_variables                       2.004        
nikto_apache_expect_xss.plugin     2.04         
nikto_apacheusers.plugin           2.06         
nikto_auth.plugin                  2.04         
nikto_cgi.plugin                   2.06         
nikto_clientaccesspolicy.plugin    1.00         
nikto_content_search.plugin        2.05         
nikto_cookies.plugin               2.05         
nikto_core.plugin                  2.1.5        
nikto_dictionary_attack.plugin     2.04         
nikto_dir_traversal.plugin         2.1.6        
nikto_dishwasher.plugin            2.20         
nikto_docker_registry.plugin       2.20         
nikto_domino.plugin                2.1.6        
nikto_drupal.plugin                1.00         
nikto_embedded.plugin              2.07         
nikto_favicon.plugin               2.09         
nikto_fileops.plugin               1.00         
nikto_headers.plugin               2.11         
nikto_httpoptions.plugin           2.10         
nikto_ms10_070.plugin              1.00         
nikto_msgs.plugin                  2.07         
nikto_multiple_index.plugin        2.03         
nikto_negotiate.plugin             2.00         
nikto_origin_reflection.plugin     2.01         
nikto_outdated.plugin              2.09         
nikto_parked.plugin                2.00         
nikto_paths.plugin                 2.00         
nikto_put_del_test.plugin          2.04         
nikto_report_csv.plugin            2.07         
nikto_report_html.plugin           2.06         
nikto_report_json.plugin           2.00         
nikto_report_nbe.plugin            2.02         
nikto_report_sqlg.plugin           2.00         
nikto_report_text.plugin           2.05         
nikto_report_xml.plugin            2.06         
nikto_robots.plugin                2.06         
nikto_shellshock.plugin            2.01         
nikto_siebel.plugin                1.00         
nikto_sitefiles.plugin             2.00         
nikto_ssl.plugin                   2.01         
nikto_strutshock.plugin            2.01         
nikto_tests.plugin                 2.04         
---------------------------------------------------------------------------
---------------------------------------------------------------------------
sullo commented 3 years ago

I have updated the Nikto.1 file for the man page--thanks. The html/xml files have been removed in favor of the new documentation location of https://github.com/sullo/nikto/wiki