1.0.3 / 2024-01-25

• Switched to using require_relative to improve load-times.
• Added # frozen_string_literal: true to all files.

Nmap::Command

• The --mtu option now accepts an option numeric value.

1.0.2 / 2023-09-01

Nmap::Command

• Fixed a typo in the --unprivileged option mapping.
• Improved validations for port number, service name, port range, and port list String values.

1.0.1 / 2022-12-12

• Fixed an infinite loop in Nmap::XML::Script#parse_tables. (@myztique)

1.0.0 / 2022-11-11

• Switched from rprogram to command_mapper.
• Replaced Nmap::Program and Nmap::Task with Nmap::Command.
• Moved all XML classes under Nmap::XML.
• See UPGRADING for more details on how to upgrade from 0.10.0 to 1.0.0.

Nmap::Command

• Added support for the --unique option as nmap.unique.
• Added support for the --resolve-all option as nmap.resolve_all.
• Added support for the --noninteractive option as nmap.non_interactive.
• Added support for the --proxies option as nmap.proxies.
• Added support for the --data option as nmap.data.
• Added support for the --data-string option as nmap.data_string.
• Added support for the --script-help option as nmap.script_help.
• Added support for the --script-args-file option as nmap.script_args_file.
• Added support for the --script-timeout option as nmap.script_timeout.
• Added support for the --initial-rtt-timeout option as nmap.initial_rtt_timeout.
• Added support for the -vv option as nmap.extra_verbose.
• Allow passing Integer values to verbose: or nmap.verbose= for -vlevel.
• Greatly improved the validation of input values.
• Removed #script_params and #script_params= aliases for #script_args and #script_args=.

Nmap::XML

• Removed the deprecated Nmap::XML.load method in favor of Nmap::XML.parse.
• Removed the Nmap::XML#prescripts alias to Nmap::XML#prescript.
• Removed the Nmap::XML#postscripts alias to Nmap::XML#postscript.
• Removed Nmap::XML::Host#tcpsequence in favor of Nmap::XML::Host#tcp_sequence.
• Removed Nmap::XML::Host#ipidsequence in favor of Nmap::XML::Host#ip_id_sequence.
• Removed Nmap::XML::Host#tcptssequence in favor of Nmap::XML::Host#tcp_ts_sequence.
• Removed Nmap::XML#inspect method.
• Added Nmap::XML::Script.
• Removed Nmap::XML::Scripts#script_data.
• Changed Nmap::XML::Scripts#scripts to return Nmap::XML::Script objects.

0.10.0 / 2020-03-17

• Added Nmap::Task#exclude_ports for the --exclude-ports option.
• Added Nmap::Status#reason_ttl.
• Added Nmap::Port#reason_ttl.
• Added Nmap::XML#task.
• Alias Nmap::ScanTask#extra_info to Nmap::ScanTask#extrainfo.

0.9.3 / 2018-05-01

• Added missing Nmap::Task#defeat_icmp_ratelimit for the --defeat-icmp-ratelimit option.
• Added missing Nmap::Task#nsock_engine for the --nsock-engine option.
• Added the Nmap::XML#prescripts alias.
• Added the Nmap::XML#postscripts alias.
• Allow Task#sctp_init_ping to accept a port Range object.
• Fixed a typo in the Task#defeat_rst_ratelimit name.
• Fixed the option formatting of Nmap::Task#syn_discovery.
• Fixed the option formatting of Nmap::Task#ack_discovery.
• Fixed the option formatting of Nmap::Task#udp_discovery.
• Fixed the option formatting of Nmap::Task#sctp_init_ping.
• Fixed the option formatting of Nmap::Task#ip_ping.

0.9.2 / 2017-01-13

• Fix file descriptor leak in Nmap::XML#initialize by using File.open(path) { |file| ... } instead of File.new(path), which keeps the file descriptor open until GC collects the File instance.

0.9.1 / 2016-07-18

• Fixed Nmap::Host#ipv6 when there are no ipv6 type addresses.
• Fixed Nmap::OS#fingerprint when there is no osfingerprint element.

0.9.0 / 2016-07-14

• Added Nmap::Address#vendor.
• Added Nmap::Service#to_s.
• Added Nmap::HostScript.
• Added Nmap::Prescript.
• Added Nmap::Postscript.
• Added Nmap::XML#prescript.
• Added Nmap::XML#postscript.
• Added Nmap::Task#quiet (aka -v0).
• #script_data methods can now parse arbitrarily nested Arrays/Hashes.
• Fixed Nmap::CPE#each_cpe to only match child cpe elements, not all cpe elements within the document.
• Changed Nmap::Service#to_s to output product/version only if both are present.
• Changed Nmap::Task#skip_discovery to use -Pn instead of -PN, which was deprecated in nmap >= 7.00.

0.8.0 / 2014-04-16

• Added Nmap::XML#each_down_host.
• Added Nmap::XML#down_hosts.
• Added Nmap::XML#host.
• Added Nmap::XML#up_host.
• Added Nmap::XML#down_host.
• Added Nmap::Host#hostname.
• Added Nmap::Hostname#user?.
• Added Nmap::Hostname#ptr?.
• Added Nmap::Program.sudo_scan.
• Added Nmap::Program#sudo_scan.
• Renamed Nmap::XML.load to Nmap::XML.parse.
• Fixed a typo in the --privileged flag (@BrentonEarl)
• Allow multiple values in the --script flag.
• Alias Nmap::Task#script_params to script_args.

0.7.0 / 2014-05-09

• Added Nmap::CPE.
• Added Nmap::CPE::URL.
• Added Nmap::Hop.
• Added Nmap::Hostname.
• Added Nmap::Traceroute.
• Added Nmap::Host#traceroute.
• Added Nmap::Host#uptime. (@roodee)
• Added Nmap::Service#ssl?.
• Added Nmap::Service#protocol.
• Added Nmap::Service#extra_info.
• Added Nmap::Service#os_type.
• Added Nmap::Service#device_type.
• Added Nmap::Service#fingerprint. (@roodee)
• Added Nmap::Uptime. (@roodee)
• Added Nmap::RunStat. (@roodee)
• Added Nmap::XML.load. (@vzctl)
• Added Nmap::XML.open.
• Added Nmap::XML#each_run_stat.
• Added Nmap::XML#run_stats.
• Added Nmap::XML#each_task.
• Fixed xpath bug in Nmap::OS#each_class (@roodee).

0.6.0 / 2012-11-07

• Added Nmap::Service.
• Renamed Nmap::IpidSequence to Nmap::IpIdSequence.
• Renamed Nmap::Host#ipidsequence to Nmap::Host#ip_id_sequence.
• Renamed Nmap::Host#tcpsequence to Nmap::Host#tcp_sequence.
• Renamed Nmap::Host#tcptssequence to Nmap::Host#tcp_ts_sequence.

0.5.1 / 2012-05-27

• Replaced ore-tasks with rubygems-tasks.

0.5.0 / 2011-04-11

• Require nokogiri ~> 1.3.
• Require rprogram ~> 0.3.
• ip_scan in Nmap::Task should map to -sO (thanks corvus).

0.4.1 / 2010-11-23

• Fixed a bug in Nmap::XML#each where it was calling each_up_hosts, and not Nmap::XML#each_up_host.
• Nmap::OS#each_class, Nmap::OS#each_match, Nmap::XML#each_host and Nmap::XML#each_up_host now return an Enumerator object if no block is given.
• Use yield instead of block.call for a slight performance improvement.

0.4.0 / 2010-11-17

• Added new options to Nmap::Task based on nmap 5.21:
  • -PY - nmap.sctp_init_ping
  • -PR - nmap.arp_ping
  • -sY - nmap.sctp_init_scan
  • -sZ - nmap.sctp_cookie_echo_scan
  • --allports - nmap.all_ports
  • -sR - nmap.rpc_scan
  • -T - nmap.timing_template
  • -T0 - nmap.paranoid_timing
  • -T1 - nmap.sneaky_timing
  • -T2 - nmap.polite_timing
  • -T3 - nmap.normal_timing
  • -T4 - nmap.aggressive_timing
  • -T5 - nmap.insane_timing
  • --randomize-hosts - nmap.randomize_hosts
  • --adler32 - nmap.sctp_adler32
  • -oA - nmap.output_all
  • -d - nmap.debug
  • --stats-every - nmap.stats_every
  • --release-memory - nmap.release_memory
• Specify that ruby-nmap requires nmap >= 5.00.

0.3.0 / 2010-11-08

• Added Nmap::Host#scripts.
• Added Nmap::Port#scripts.

0.2.0 / 2010-10-29

• Require nokogiri >= 1.3.0.
• Require rprogram ~> 0.2.0.
• Added Nmap::XML#tasks.
• Added Nmap::Scanner#start_time.
• Added Nmap::ScanTask#duration.
• Added Nmap::Host#start_time.
• Added Nmap::Host#end_time.
• Allow Nmap::Tasks#ports= to accept port ranges.
• Omit the -p option if no ports are given to Nmap::Task.
• Have the Nmap::Host#each_* methods return an Enumerator object if no block is given.

0.1.1 / 2010-01-02

• Require RProgram >= 0.1.8.
  • Adds sudo and sudo= instance methods to Nmap::Task.

0.1.0 / 2009-11-13

• Initial release.
  • Provides a Ruby interface for running Nmap.
  • Provides a Parser for enumerating Nmap XML scan files.