1
0
mirror of https://github.com/nmap/nmap.git synced 2025-12-09 06:01:28 +00:00
Commit Graph

266 Commits

Author SHA1 Message Date
david
8553cb3157 Merge r22026 through r22063 from /nmap-exp/david/nmap-script-help (new
--script-help option).
2011-01-27 21:44:54 +00:00
david
291ab7488d Document the "broadcast" script category. 2011-01-13 06:21:55 +00:00
fyodor
c72965c3e5 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
david
2a409301ff Rewrite the section on different script rules. 2010-09-14 04:47:38 +00:00
djalal
55d91874bc Fix a typo in the scripting.xml file. 2010-09-10 21:21:13 +00:00
david
b2350aa947 o [NSE] Host tables now have a host.traceroute member when --traceroute
is used. This array contains the IP address, reverse DNS name, and RTT
  for each traceroute hop. [Henri Doreau]
2010-08-28 15:50:10 +00:00
kris
57664a51cf Committing MTU-related changes:
* Adding path-mtu.nse for Path MTU Discovery
* Nmap now stores the MTU for interfaces (from SIOCGIFMTU or libdnet)
* Scripts can access the MTU for host.interface via host.interface_mtu
* Nmap prints the MTU for interfaces in --iflist
2010-08-24 01:47:12 +00:00
fyodor
b3bef8f7a2 Fix some syntax errors (mostly misspelled tags and wrongly closed tags) in scripting.xml to get it to compile 2010-08-13 18:49:16 +00:00
djalal
d056a97b10 Merge r19288:r19697 from nmap-exp/djalal/nse-rules-docs. This will update NSE doc to show the new prerules and postrules. 2010-08-13 00:41:54 +00:00
david
919f13738a Use literal tags around the names of keys of the host.times table. 2010-08-05 02:21:48 +00:00
kris
412fcbcca0 o [NSE] Added a "times" table to the host table passed to scripts.
This table contains Nmap's timing data (srtt, the smoothed round
  trip time; rttvar, the rtt variance; and timeout), all represented
  as floating-point seconds.  The ipidseq and qscan scripts were
  updated to utilize the host's timeout value instead of the very
  conservative guess of 3 seconds for read timeouts. [Kris]
2010-08-05 01:55:05 +00:00
david
b476797753 Use <userinput> in examples to highlight the user's typed text. 2010-07-19 20:26:36 +00:00
david
aa5d360900 Remove indextermst that are two near one another, such that they cause
duplicate page numbers to be incldued in the index.
2010-07-19 18:18:42 +00:00
david
14f314327c Fix duplicate words in documentation. 2010-07-19 16:58:52 +00:00
david
7a4efd455a Spell-check documentation. 2010-07-19 16:41:57 +00:00
david
156952fbf8 Do index canonicalization in scripting.xml. Remove ".nse" where not
needed.
2010-07-18 20:31:32 +00:00
david
121ff5cd2a Update, review, and edit scripting.xml. 2010-07-18 19:42:01 +00:00
david
a1c7d1f518 Change "Interesting ports on" to "Nmap scan report for" to correspond
with r15916.
2010-07-18 16:13:12 +00:00
david
9b69d2aeba Change the NSE output prefix in examples in scripting.xml from 3 space
to 2, to correspond to r16205.
2010-07-18 15:36:35 +00:00
david
d95ee8c15f In scripting.xml, note that the documentation is stripped down for space
reasons. State what additional information is available online.
2010-07-12 17:43:38 +00:00
david
725e6b85ac Put some indexterms inside certain elements like term and member. Having
them outside causes an error, "[warning] unresolved internal
destination" and a broken link in the index.
2010-07-12 03:54:06 +00:00
fyodor
a9a47afe3b Added a missing sect2 end tag 2010-07-11 07:42:58 +00:00
batrick
0f8946efc9 Update to Implementation section of NSE chapter to account for changes made
to NSE (Lua).
2010-07-10 07:38:12 +00:00
batrick
e55589c5cc Another change to this from r18458 that adds a note to check if you need
to escape quotes differently based on which shell you use.
2010-07-07 17:26:48 +00:00
batrick
c43576e5f2 Fix error in documentation. 2010-06-29 17:20:21 +00:00
djalal
75e6d4d5e1 C modules added to NSE must be included in the list of standard libraries in nse_main.cc 2010-05-26 01:43:23 +00:00
david
5ab63a55be Say that @usage applies to modules. Say that @usage is automatically
generated for scripts if omitted.
2010-04-08 05:26:42 +00:00
david
3b34c84de7 Add dns-fuzz script from Michael Pattrick. 2010-04-04 13:41:32 +00:00
david
48654df805 Switch to -sn and -Pn as the new preferred synonyms for -sP and -P0.
This establishes a more regular syntax for some options that disable
phases of a scan:
	-n  no reverse DNS
	-Pn no host discovery
	-sn no port scan
Also, the -sP was possibly misleading because the 'P' suggests "ping
scan," when you can now do more than just pinging when you disable port
scanning. For example, -sC -sn and -sn -Pn --traceroute make sense.
2010-03-11 01:16:06 +00:00
kris
a42ea72a97 Merge through r16884 from /nmap-exp/kris/nse-rawip plus the following changelog
entries:

o [NSE] Raw packet sending at the IP layer is now supported, in addition to
  the Ethernet sending functionality.  Packets to send start with an IPv4
  header and can be sent to arbitrary hosts. [Kris]

o [NSE] Added the ipidseq script to classify a host's IP ID sequence numbers
  in the same way Nmap does.  This can be used to test hosts' suitability for
  Nmap's Idle Scan (-sI), i.e. check if a host is an idle zombie.  This is
  the first script to use the new raw IP sending functionality in NSE. [Kris]

o [NSE] Added the function nmap.is_privileged() to tell a script if, as far
  as Nmap's concerned, it can do privileged operations.  For instance, this
  can be used to see if a script should be able to open a raw socket or
  Ethernet interface. [Kris]

o [NSE] Added the function nmap.get_ports() to allow a script to iterate
  over a host's port tables matching a certain protocol and state. [Kris,
  Patrick]
2010-02-26 20:42:10 +00:00
david
3a11dafeaa o Added a mac_addr_next_hop member to the host tables used in NSE.
[Michael Pattrick, kx].
2010-02-13 01:48:59 +00:00
batrick
92564b9b00 Merge from 16504:16554 from /nmap-exp/patrick/docs-parallelism.
Adding documentation for the various new parallelism features
NSE has recently added including mutexes, condition variables,
child coroutine support, and new threads.
2010-01-23 19:45:44 +00:00
david
1e2ebb577d Remove historical information about the runlevel variable and just
mention it in a footnote. Use a real example of the dependencies
variable from smb-os-discovery.
2009-12-31 22:42:43 +00:00
batrick
610bd0a55b Merge from Dependencies branch (nmap-exp/patrick/dependencies)
with modifications from [2].

** Short description from [1] **

I have created a patch to NSE that replaces runlevels with a table of
dependencies that clearly outlines what other scripts the script
depends on. The table is of the form:

dependences = {"script1", script2", ...}

Runlevels become an internal representation of the order of scripts
that are generated by the dependencies. Dependencies only enforce
an execution order and not a requirement for execution.

[1] http://seclists.org/nmap-dev/2009/q4/295
[2] http://seclists.org/nmap-dev/2009/q4/446
2009-12-30 02:34:05 +00:00
fyodor
78cdf4f156 We no longer recommend including email addresses in author fields 2009-11-24 08:53:07 +00:00
fyodor
fea1ab7c39 Moved a bunch of scripts to the "safe" category, and some others to "intrusive" after
discussion on nmap-dev about how best to handle these.  I also updated the docs and
am about to regenerate script.db.  See this thread for more info:
http://seclists.org/nmap-dev/2009/q3/1008.html
2009-10-01 19:07:16 +00:00
fyodor
1681e7621b Add clear warnings about using --script=all. 2009-09-13 09:36:33 +00:00
batrick
080f592e89 Fixed a typo. 2009-08-07 22:58:45 +00:00
david
32c5bbf7f4 Put "strict.lua" in a filename element. Add an indexterm for it. Put
"nil" in a literal element.
2009-08-07 22:44:30 +00:00
batrick
80555cdc60 Added a note on the presence of strict.lua and the danger
of global variables for libraries.
2009-08-04 03:26:35 +00:00
david
0746a7a28a Change -sP from "ping scan" to "don't port scan" in the documentation,
while still mentioning that "ping scan" is a common term. Mention the
use of -PN and -sP together to run NSE host scripts without ping and
port scanning.
2009-07-17 23:47:11 +00:00
david
923f03707c Revise the new --script-args documentation, tweak formatting. 2009-05-29 16:25:03 +00:00
batrick
cfc16fb6de Updated refguide and scripting chapter of book to the new syntax of the
--script-args as well as a more full account of some details. The previous text
was very vague about some features, especially array values.
2009-05-29 07:14:48 +00:00
david
bee956bf44 Make the NSE "Usage Examples" conform to the style used in the rest of
the section. Rename the subsection "Complete Examples" because there are
already a lot of other partial examples. Add some indexterms.
2009-05-05 18:10:07 +00:00
david
089f3628fa Overhaul the "Usage and Examples" section of scripting.xml for better
exposition. Add lots more examples.
2009-05-05 17:52:11 +00:00
batrick
572b6fd4c0 Updated relevant section in the book concerning the --script switch which may
now use boolean operators.
2009-05-02 05:55:59 +00:00
fyodor
3e7edc0aa2 fix a stray period caught by Tor Houghton's sharp eye 2009-03-08 06:30:58 +00:00
david
31e62d195d Fix an awkward cross-reference in scripting.xml. The generated text looked like
"These five variables are described in <versioninfo>" because the reference was
to a list item, not to its enclosing section. I changed it so it becomes 'These
five variables are the same as those described under <versioninfo> in the
section called "match Directive"'.
2009-02-14 16:26:50 +00:00
fyodor
6d88616bb7 fix a slight wording problem noted by angico 2009-02-02 10:11:42 +00:00
fyodor
47198b7159 remove a stray period 2009-01-20 09:38:22 +00:00