Description of zenmap.conf
zenmap.conf is the user-specific configuration
file for Zenmap. It is a plain text file located in the per-user
configuration directory (see the section called “Per-user Configuration Files”). The
syntax is that recognized by the Python ConfigParser
class, which is similar to that of Windows INI files. Sections are
delimited by titles in square brackets. Within sections are lines
containing
<name>=<value><name>: <value>zenmap.conf is shown.
[output_highlight] enable_highlight = True [paths] nmap_command_path = nmap ndiff_command_path = ndiff [search] search_db = 1 file_extension = xml store_results = 1 directory = save_time = 60;days
Some of these settings can be controlled from within Zenmap without editing the configuration file directly.
Sections of zenmap.conf
Boolean values are normalized from True,
true, or 1 to true or anything
else to false.
[paths]The
[paths]section defines important paths used by Zenmap.-
nmap_command_path The path to the Nmap executable. Whatever the first word is in a command line executed by Zenmap will be replaced by the value of this variable. Its default value of
nmapis appropriate for most systems. See the section called “ThenmapExecutable” for examples.-
ndiff_command_path The path to the Ndiff scan comparison utility. Zenmap uses Ndiff to do scan comparisons; see the section called “Comparing Results”.
-
[search]The
[search]section defines how the search tool (see the section called “Searching Saved Results”) behaves. The names in this section correspond to the options in the “Search options” tab of the search dialog. It has the following names defined.directoryThe directory to search for saved scan results files.
file_extensionA semicolon-separated list of file name extensions to search.
search_dbA Boolean controlling whether to search the recent scans database.
store_resultsA Boolean controlling whether to store scan results in the recent scans database. See the section called “The Recent Scans Database”.
save_timeHow long to keep scan results in the recent scans database. Results older than this are deleted when Zenmap is closed. The format is a number and a time interval separated by semicolons, for example
60;daysor1;years.
[diff]The
[diff]section defines how the comparison tool (see the section called “Comparing Results”) behaves. It has the following names defined.diff_modeControls whether comparisons are shown by default in graphical or text mode. Must be either
comparefor graphical mode ortext.colored_diffA Boolean that controls if comparisons use color.
[diff_colors]The
[diff_colors]section defines the colors used by the comparison tool. It has the following names defined:unchanged,added,not_present, andmodified, the meanings of which are defined in the section called “Comparing Results”. The value of each of these is a list of three integers in the range 0–65535 representing red, green, and blue in the format[. For example,<red>,<green>,<blue>][65535, 0, 0]specifies red.[output_highlight]The
[output_highlight]section contains a single Boolean variableenable_highlight, which enables output highlighting whenTrueand disables it ifFalse.[date_highlight],[hostname_highlight],[ip_highlight],[port_list_highlight],[open_port_highlight],[closed_port_highlight],[filtered_port_highlight],[details_highlight]These sections all define the nature of Nmap output highlighting, which is discussed in the section called “The “Nmap Output” tab”. These are best edited from within Zenmap. Within each of these sections, the following names are defined.
regexThe regular expression that matches the relevant part of the output.
boldA Boolean controlling whether to make this highlight bold.
italicA Boolean controlling whether to make this highlight italic.
underlineA Boolean controlling whether to underline this highlight.
textThe color of the text in this highlight. The syntax is a list of three integers in the range 0–65535 representing red, green, and blue in the format
[. For example,<red>,<green>,<blue>][65535, 0, 0]for a red highlight.highlightThe color of the background in this highlight. The syntax is the same as for
text.