nmap/docs
tomsellers 43d1a0516b Summary of changes to the XSL since work started on 11/11 -
General:
- Added support for Pre and Post scan NSE output.  Index links at top only appear if 
  the sections exist.

- Host that are offline are now in a collapsible div element and collapsed by default.

- Added HTML Doctype of HTML 4.01 Strict, tidies up parsing 

- The display for closed and filtered ports has been changed. By default the information 
  for closed and filtered ports is filtered from the tables if JavaScript is enabled.  
  The column header now has clickable links that will display each.  The links indicate 
  the counts of each type (closed vs filtered) in the current table so that the user 
  can see at a glance if there is anything hidden. When printing the document the 
  printout will reflect the current status (hidden vs unhidden) of the ports.  The 
  clickable links themselves are also not output when printing.

- There is also a floating box in the lower right hand corner of the display that contains
  links that will toggle showing and hiding of ports in these states for the entire 
  document.  This floating box contains a link to the top of the document as well.

- Traceroute - rearranged output, now uses a collapsible div element that is collapsed
  by default.

- Host / Ping results section has been moved to a collapsible div element named Misc 
  Results.  This element is collapsed by default.

- Remote OS Detection OS match wording is now more like Nmap normal output - 
  OS type (accuracy) instead of separate lines for os match and accuracy

- Changed how host index HTML anchors are created in order to deal with a warning about 
  the name attribute being deprecated

- Fixed a bug in the port script output that caused it to only span 5 columns instead of 
  6. Tested this with various levels of debug, verbosity, etc to make sure that the 
  number of columns does not change.

- Changed nmap_xsl_version variable from 9b to 9c, Changed the last updated date in the 
  header to be today's date (2010.12.28)

- Added Nmap version number to Scan summary section

- Wording of verbosity/debug levels changed/simplified.

- HTML title and  first header wording changed.

- Added MAC vendor to host address section

- Changed host index to the format of hostname (IP) where preference is given to the 
  user supplied hostname.


General Style Changes:
- Changed color of script output cells in port table as well as hostscript and prescan
  result tables slightly to make visual parsing easier
- First header (Nmap Scan Report..) color changed to use Nmap purple
- Closed and Filters ports - background color is now grey
- Down hosts are now denoted with a grey background in both the host index (top) and 
  body of results


OS Fingerprint:

- Fingerprint block now uses a collapsible div element.  The block is collapsed by 
  default if the OS fingerprint is only present due to increased verbosity or debugging.
- Removed referenced fingerprint data ( reference fingerprint line number: 1000 )
- Reworded some sections of text for flow and readability.


Removed elements:
- Scan info Section - code was in place but has not been visible for some time. After 
  testing a few arrangements it was decided to just remove the data and code altogether.

- Runstats section, replaced by standard nmap completion string in the Scan Summary section


Open items:
1.  Device types - currently have issues with output data consistency and formatting when
    pulling a distinct list.

2.  What criteria / counts should be used in situations described below? For example, 
    how many fingerprints are too many? How do we know if the fingerprint is high enough 
    quality to submit given that it may just be present due to the use of -v or -d?

>  o It would be great to describe the OS detection results better.
>    For example, if there are no exact matches, normal Nmap says "No
>    exact OS matches for host ", followed up with "(test conditions
>    non-ideal)" if that is the case.  I think we should give a warning
>    like this.  Also, in the case that there are too many matches,
>    normal Nmap says "Too many fingerprints match this host to give
>    specific OS details"

>  o If there are no exact matches, and Nmap feels that the quality is
>    high enough for a submission, it would be great if the OS
>    detection section would encourage the user to submit, just like
>    normal Nmap does.

3.  Does the OS fingerprint need to be printed (to paper/PDF) at all? The only scenario 
    that I could think of where this would be useful would be if the file was 'printed'
    to digital media such as PDF.

4.  Does the table of ports need to be changed so that closed and and filtered ports 
    are always printed (to paper/PDF) as opposed to printing in the format that is 
    currently displayed?  My concern here is processes that automatically convert 
    documents, for example to PDF format.
2010-12-28 23:32:29 +00:00
..
licenses Move COPYING.OpenSSL to OpenSSL.txt, update copyright notices to match. 2010-10-30 03:01:50 +00:00
man-xlate regen the chines man page nroff 2010-10-16 19:39:16 +00:00
3rd-party-licenses.txt Rearrange third-party license files. 2010-10-30 02:15:00 +00:00
committers.txt Minor change to my entry in the committers file 2010-12-14 11:13:01 +00:00
device-types.txt Finish my revisions of device-types.txt. 2009-02-25 23:32:26 +00:00
leet-nmap-ascii-art.txt Small dragon ASCII art improvements: the top line was misaligned by one 2009-11-10 17:41:10 +00:00
legal-notices.xml Update the copyright notice date from 2009 to 2010. Maybe it would have been easier to just wait 2.5 months and use 2011 :) 2010-10-18 07:59:19 +00:00
nmap-install.xml Typo and markup in nmap-install.xml. 2010-11-09 02:58:33 +00:00
nmap-man-enclosure.xml move legal-notices.xml and nmap-usage.xml to nmap docs directory since they are needed to build refguide (man page); add nmap-man-enclosures.xml which also eases building the refguide; add Nmap book details to refguide; rebuild man pages 2009-05-15 06:44:22 +00:00
nmap-usage.xml Use <screen> and not <literallayout> for the option summary output in 2010-07-16 17:35:23 +00:00
nmap.1 prepare for 5.36TEST3 test release 2010-12-28 22:02:12 +00:00
nmap.dtd Merge r18689:r19511 from /nmap-exp/djalal/nse-rules. 2010-08-06 16:40:03 +00:00
nmap.usage.txt prepare for 5.36TEST3 test release 2010-12-28 22:02:12 +00:00
nmap.xsl Summary of changes to the XSL since work started on 11/11 - 2010-12-28 23:32:29 +00:00
nmap_gpgkeys.txt URL change from http://insecure.org/nmap/* to http://nmap.org/* 2008-01-17 07:22:03 +00:00
README URL change from http://insecure.org/nmap/* to http://nmap.org/* 2008-01-17 07:22:03 +00:00
refguide.xml Document that -g doesn't work for anything that uses normal OS sockets, 2010-08-11 16:27:17 +00:00
sample-script.nse It turns out that emacs likes to have the modeline at the very top, not bottom, so I changed the sample script to accommodate 2010-11-01 19:36:06 +00:00
scripting.xml Add a section 'Script Types and Phases' to discuss and distinguish prerule, host, service, and postrule scripts (definitely has room for improvement). Removed some phase content from the front (introduction) page to keep it clean. Added a link to the Nmap NSE video 2010-10-11 23:08:04 +00:00
win32-installer-zenmap-buildguide.txt Uniformity in win32 instructions. 2010-11-10 03:04:16 +00:00
zenmap.1 prepare for 5.36TEST3 test release 2010-12-28 22:02:12 +00:00
zenmap.xml add refmiscinfo source and manual fields as they are needed for the nroff generation to prevent the xsl stylesheets from adding ugly FIXME entries 2008-10-15 10:41:11 +00:00

Here is some documentation for Nmap, but these files are much less
comprehensive than what you'll find at the actual Nmap documentation
site ( http://nmap.org ).