Command-line Options

Being a graphical application, most of Zenmap's functionality is exposed through its graphical interface. Zenmap's command-line options are given here for completeness and because they are sometimes useful. In particular, it's good to know that the command zenmap <results file> starts Zenmap with the results in <results file> already open.

Synopsis

zenmap [ <options> ] [ <results file> ]

Options Summary

-f, --file <results file>: Open the given results file for viewing. The results file may be an Nmap XML output file (.xml, as produced by nmap -oX) or a Umit scan results file (.usr). This option may be given more than once.
-h, --help: Show a help message and exit.
-n, --nmap <Nmap command line>: Run the given Nmap command within the Zenmap interface. After -n or --nmap, every remaining command-line argument is read as the command line to execute. This means that -n or --nmap must be given last, after any other options. Note that the command line must include the nmap executable name: zenmap -n nmap -sS target.
-p, --profile <profile>: Start with the given profile selected. The profile name is just a string: "Regular scan". If combined with -t, begin a scan with the given profile against the specified target.
-t, --target <target>: Start with the given target. If combined with -p, begin a scan with the given profile against the specified target.
-v, --verbose: Increase verbosity (of Zenmap, not Nmap). This option may be given multiple times to get even more verbosity. Beware that verbose output is not shown on a terminal unless the ZENMAP_DEVELOPMENT environment variable is defined and true.

Output Redirection and Debugging

Zenmap normally redirects its standard output and standard error streams to avoid printing lots of messages to a terminal. Sometimes, especially when there's an error, you prefer to see those messages. To disable automatic output redirection, set the environment variable ZENMAP_DEVELOPMENT (the value doesn't matter). Now output will be printed to the screen while Zenmap is running. Additionally, when ZENMAP_DEVELOPMENT is defined automatic crash reporting is disabled.

Combine ZENMAP_DEVELOPMENT with the -v option to get more messages. Try ZENMAP_DEVELOPMENT=1 zenmap -v -v -v to get a useful debugging output.

On Windows, standard error is redirected to a file zenmap.exe.log in the same directory as zenmap.exe, instead of being printed on the console.