aboutsummaryrefslogtreecommitdiff
path: root/share/man/man1/nwatch.1
diff options
context:
space:
mode:
Diffstat (limited to 'share/man/man1/nwatch.1')
-rw-r--r--share/man/man1/nwatch.132
1 files changed, 32 insertions, 0 deletions
diff --git a/share/man/man1/nwatch.1 b/share/man/man1/nwatch.1
new file mode 100644
index 0000000..90b60f8
--- /dev/null
+++ b/share/man/man1/nwatch.1
@@ -0,0 +1,32 @@
+.TH NWATCH 1 "May 2014" "Manual page for nwatch"
+.SH NAME
+.B nwatch
+\- slightly nicer Nmap ndiff(1) wrapper
+.SH USAGE
+.B nwatch
+.I HOSTLIST
+.I CACHEDIR
+.SH SYNOPSIS
+.B nwatch
+/etc/nwatch.mynet
+/var/cachedir/nwatch/mynet
+.SH DESCRIPTION
+.B nwatch
+reads a list of hosts from
+.I HOSTLIST
+and runs an nmap(1) command suitable for running through ndiff(1) against those
+hosts. It caches the scan output in plain text, greppable, and XML formats in
+.I CACHEDIR
+and then runs ndiff(1) between the last scan it can find and the current scan,
+storing the output in CACHEDIR and printing it to stdout. This makes it useful
+for running from cron(8):
+.PP
+ 0 0 * * 0 nwatch /etc/nwatch.mynet /var/log/nwatch/mynet
+.PP
+I recommend you use croncrypt, so you don't leak your network information
+in plain text in your email: https://github.com/tejr/croncrypt
+.SH SEE ALSO
+nmap(1), ndiff(1)
+.SH AUTHOR
+Tom Ryder <tom@sanctum.geek.nz>
+