Chapter 5. Using ZoneCheck

Table of Contents

Input
Command Line Interface (CLI)
Common Gateway Interface (CGI)
Graphical User Interface (GUI)
Output
Text
HTML
GTK

Input

Command Line Interface (CLI)

  • -q, --quiet

    don't display extra titles

  • -h, --help

    show an help message and exit

  • -V, --version

    print the ZoneCheck version and exit

  • -B where, --batch where

    read data from the file specified by where (stdin is used if '-' is specified)

  • -c cfgfile, --config cfgfile

    specify the location of the configuration file (default is etc/zc.conf)

  • --testdir directory

    specify the directory where all the tests are located

  • -C catlist, --category catlist

    limit the test to the specified category list (catlist); the list is comma separeted and we stop on the first match. If the category start with - or ! the test should not belong to that category, if it starts with nothing or + the test should belong to it. It is possible to have subcategories which are delimited by :. Here is an example that says don't perform DNS tests that are not SOA related: dns:soa,!dns,+

  • -T testname, --test testname

    only the test testname will be performed and its severity will default to fatal

  • -r host, --resolver host

    the nameserver running on host will be used as the local resolver instead of taking this information from /etc/resolv.conf

  • -n nameservers, --ns nameservers

    nameservers is the exhaustive list of nameservers that are primary or secondary for the zone, they are separated by a semicolon, if IP addresses should be specified the hostname must be followed by the equal sign and a coma separated list of IP addresses. For example: ns1.toto.fr=192.168.1.5,192.168.1.6;ns2.toto.fr

  • -1, --one

    only display the most relevant message, particularly useful for batch mode

  • -g, --tagonly

    display tag instead of sentences, this option should be used when writing scripts

  • -e list, --error list

  • -t list, --transp list

    list

  • -v list, --verbose list

    list

  • -o list, --output list

    list

  • -4, --ipv4

    use IPv4 connectivity only

  • -6, --ipv6

    use IPv6 connectivity only

  • --testlist

    list all the available tests

  • --testdesc type

    types is one of the keyword name expl error

% zc -4 -v c,x,d,i afnic.fr
ZONE  : afnic.fr.
NS <= : ns1.nic.fr. [192.93.0.1]
NS    : ns2.nic.fr. [192.93.0.4]
NS    : ns3.nic.fr. [192.134.0.49, 2001:660:1180:1:192:134::49]

==> SUCCED

Common Gateway Interface (CGI)

  • lang = [ fr | en | ... ]

  • quiet

  • - one\n

  • - verbose = [ i|intro, n|testname, x|explain, d|details,\n\ t|testdesc, c|counter, o|reportok ]\n\

    • - intro\n\

    • - testname\n\

    • - explain\n\

    • - details\n\

    • - progress = [ t|testdesc | c|counter ]\n\

    • - reportok\n\

  • - output = [ bs|byseverity, bh|byhost, t|text, h|html ]\n\ - report = bs|byseverity | bh|byhost\n\ - format = h|html | text\n\

  • - error = [ af|allfatal, aw|allwarning, std|standard,\n\ s|stop, ns|nostop ]\n\ - errorlvl = [ af|allfatal | aw|allwarning | std|standard ]\n\ - dontstop \n\

  • - transp = [ ipv4, ipv6, udp, tcp, std ]\n\ - transp3 = [ ipv4, ipv6 ]\n\ - transp4 = [ udp | tcp | std ]\n\

  • - category = cat1,!cat2:subcat1,cat2,!cat3,+\n\ - chkmail (!mail)\n\ - chkrir (!rir)\n\ - chkzone (!dns:axfr)\n\

  • - ns = ns1=ip1,ip2;ns2=ip3;ns3\n\ (WARNING: in URL '%3b' should be used instead of ';')\n\ - ns0 .. nsX = nameserver name\n\ - ips0 .. ipsX = coma separated ip addresses\n\

  • - zone = zone to test\n\

Graphical User Interface (GUI)

toto