testcode/streamtcp.1

   1 .TH "unbound\-streamtcp" "1" "Mar 21, 2013" "NLnet Labs" "unbound"
   2 .\"
   3 .\" unbound-streamtcp.1 -- unbound DNS lookup utility
   4 .\"
   5 .SH "NAME"
   6 .LP
   7 .B unbound\-streamtcp
   8 \- unbound DNS lookup utility
   9 .SH "SYNOPSIS"
  10 .LP
  11 .B unbound\-streamtcp
  12 .RB [ \-unsh ]
  13 .RB [ \-f
  14 .IR ipaddr[@port] ]
  15 .RB [ \-d
  16 .IR secs ]
  17 .I name
  18 .I type
  19 .I class
  20 .SH "DESCRIPTION"
  21 .LP
  22 .B unbound\-streamtcp
  23 sends a DNS Query of the given \fBtype\fR and \fBclass\fR for the given \fBname\fR
  24 to the DNS server over TCP and displays the response.
  25 .P
  26 If the server to query is not given using the \fB\-f\fR option then localhost
  27 (127.0.0.1) is used. More queries can be given on one commandline, they
  28 are resolved in sequence.
  29 .P
  30 The available options are:
  31 .TP
  32 .I name
  33 This name is resolved (looked up in the DNS).
  34 .TP
  35 .I type
  36 Specify the type of data to lookup.
  37 .TP
  38 .I class
  39 Specify the class to lookup for.
  40 .TP
  41 .B \-u
  42 Use UDP instead of TCP. No retries are attempted.
  43 .TP
  44 .B \-n
  45 Do not wait for the answer.
  46 .TP
  47 .B \-a
  48 Print answers on arrival.  This mean queries are sent in sequence without
  49 waiting for answer but if answers arrive in this time they are printed out.
  50 After sending queries the program waits and prints the remainder.
  51 .TP
  52 .B \-s
  53 Use SSL.
  54 .TP
  55 .B \-h
  56 Print program usage.
  57 .TP
  58 .B \-f \fIipaddr[@port]
  59 Specify the server to send the queries to. If not specified localhost (127.0.0.1) is used.
  60 .TP
  61 .B \-d \fIsecs
  62 Delay after the connection before sending query.  This tests the timeout
  63 on the other side, eg. if shorter the connection is closed.
  64 .TP
  65 .B \-p \fIclient
  66 Use proxy protocol to send the query. Specify the ipaddr@portnr of the client
  67 to include in PROXYv2.
  68 .TP
  69 .B IXFR=serial
  70 Pass the type of the query as IXFR=N to send an IXFR query with serial N.
  71 .TP
  72 .B NOTIFY[=serial]
  73 Pass the type of the query as NOTIFY[=N] to send a notify packet. The serial N
  74 of the new zone can be included.
  75 .SH "EXAMPLES"
  76 .LP
  77 Some examples of use.
  78 .P
  79 $ unbound\-streamtcp www.example.com A IN
  80 .P
  81 $ unbound\-streamtcp \-f 192.168.1.1 www.example.com SOA IN
  82 .P
  83 $ unbound\-streamtcp \-f 192.168.1.1@1234 153.1.168.192.in\-addr.arpa. PTR IN
  84 .SH "EXIT CODE"
  85 The unbound\-streamtcp program exits with status code 1 on error,
  86 0 on no error.
  87 .SH "AUTHOR"
  88 This manual page was written by Tomas Hozza <thozza@redhat.com>.