Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/dnsviz/dnsviz.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCasey Deccio <casey@deccio.net>2015-08-19 17:13:26 +0300
committerCasey Deccio <casey@deccio.net>2015-08-19 17:13:26 +0300
commitb0ffba5d78f61154d3d3987bea898bdf35327163 (patch)
treefe382733fd979e008f5a4c1f83269de04b60482c
parent291fcf7fbf8a654c98cdc94f6691a9e36a322a14 (diff)
update readmev0.4.0-beta2
-rw-r--r--README.md43
1 files changed, 35 insertions, 8 deletions
diff --git a/README.md b/README.md
index dd7c7e3..ea80e46 100644
--- a/README.md
+++ b/README.md
@@ -24,13 +24,10 @@ powers the Web-based analysis available at http://dnsviz.net/
* pygraphviz (1.1 or later) - http://pygraphviz.github.io/
- pygraphviz is required if visualization is desired (e.g., via the `dnsviz`
- tool) or if security status of responses is desired (e.g., using the -t
- option with the `dnsgrok` tool). Online analysis (using `dnsget`) and
- offline analysis (e.g., using `dnsgrok` without the -t) can be performed
- without pygraphviz. Version 1.1 or greater is required because of the support
- for unicode names and HTML-like labels, both of which are utilized in the
- visual output.
+ pygraphviz is required for most functionality. `dnsget` and `dnsgrok`
+ (without the -t option) can be used without pygraphviz installed. Version 1.1
+ or greater is required because of the support for unicode names and HTML-like
+ labels, both of which are utilized in the visual output.
* M2Crypto (0.21.1 or later) - https://github.com/martinpaljak/M2Crypto
@@ -68,7 +65,7 @@ $ python setup.py --help
## Usage
DNSViz is invoked using a series of included command-line utilities: `dnsget`,
-`dnsgrok`, and `dnsviz`. Run any of the command-line tools with -h (help) to
+`dnsgrok`, `dnsviz`, and `dv`. Run any of the command-line tools with -h (help) to
display all options associated with their usage.
@@ -234,6 +231,11 @@ $ dig +noall +answer . dnskey | awk '$5 % 2 { print $0 }' > tk.txt
$ dnsviz -Thtml -O -r example.com.json -t tk.txt
```
+Output textual analysis to the terminal:
+```
+$ dnsviz -r example.com.json -t tk.txt
+```
+
Pipeline dnsget output directly to dnsviz:
```
$ dnsget example.com | \
@@ -257,3 +259,28 @@ names.
```
$ dnsviz -Thtml -r multiple.json -t tk.txt > multiple.html
```
+
+### dv
+
+`dv` is a wrapper that couples the functionality of `dnsget` and `dnsviz` into
+a tool with minimal dig-like usage, used to make analysis queries and return
+the textual output to terminal or file output in one go.
+
+
+#### Examples
+
+Analyze the domain name example.com using the first of your configured DNS
+resolvers (i.e., in /etc/resolv.conf):
+```
+$ dv example.com
+```
+
+Same, but specify a trust anchor:
+```
+$ dv +trusted-key=tk.txt example.com
+```
+
+Analyze example.com through the recurisve resolver at 192.0.2.1:
+```
+$ dv @192.0.2.1 +trusted-key=tk.txt example.com
+```