BORE(1)                     General Commands Manual                    BORE(1)

NNAAMMEE
     bboorree – DNS query tool

SSYYNNOOPPSSIISS
     bboorree [----eennccooddee | ----ddeeccooddee | ----sshhooww--rreessoollvveerrss] [----llooaadd] [----dduummpp]
          [----hhoosstt _h_o_s_t] [----ppoorrtt _p_o_r_t] [----ttiimmeeoouutt _t_i_m_e_o_u_t] [--xx | ----rreevveerrssee]
          [----ccllaassss _c_l_a_s_s] [----ccoolloorr _w_h_e_n] [_@_h_o_s_t] [_n_a_m_e] [_t_y_p_e]

DDEESSCCRRIIPPTTIIOONN
     Sends a DNS query and prints the response in zone format.

     If no _h_o_s_t is given, bboorree uses your system’s resolvers, which are
     gathered from GetAdaptersAddresses on Windows, dns_configuration_copy on
     macOS, or resolv.conf(5) on other Unix-like platforms, falling back on
     localhost.

     Note that your platform’s native name resolution probably supports other
     sources besides DNS, such as a hosts(5) file or mDNS (Bonjour).  bboorree
     only uses native resolution for _h_o_s_t itself, and otherwise only sends DNS
     queries, so the results may differ from how your system would resolve a
     name as a hostname.

     By default, bboorree will follow four steps:

     1.   build a query based on the given arguments

     2.   send the query to the given _h_o_s_t

     3.   receive a response from the given _h_o_s_t

     4.   decode and pretty-print the message

OOPPTTIIOONNSS
     The following options and positional arguments may be given in any order.

   PPoossiittiioonnaall aarrgguummeennttss
     _@_h_o_s_t   Sends the query to _h_o_s_t (see ----hhoosstt).

     _n_a_m_e [default: .]
             Question name.  Names are parsed in zone format, with dots
             separating labels unless escaped, \000 through \255 to escape an
             octet, and \x with any non-digit character ‘x’ to escape that
             character.  When ----rreevveerrssee is given, _n_a_m_e is required, and should
             instead be an IPv4 or IPv6 address.

             A trailing dot _m_u_s_t be added when querying top-level domains,
             otherwise they will be treated as a _t_y_p_e (and probably fail).
             Names starting with ‘@’ _m_u_s_t be escaped, otherwise they will be
             treated as a _@_h_o_s_t.

     _t_y_p_e [default: A]
             Question type.  The default is ‘PTR’ if ----rreevveerrssee is given, or
             ‘A’ if a _n_a_m_e is given, or ‘NS’ otherwise.  For unknown types,
             use ‘TYPE’ followed by the type number, e.g.  ‘type65535’.

   MMooddee ooppttiioonnss
     ----eennccooddee
             Writes the raw query to stdout, instead of sending it (step 1
             only).

     ----llooaadd  Reads the raw query from stdin, instead of building one (skip
             step 1).

     ----dduummpp  Writes the raw response to stdout, instead of pretty-printing it
             (skip step 4).

     ----ddeeccooddee
             Reads a raw message from stdin, then decodes and pretty-prints it
             (step 4 only).

     ----sshhooww--rreessoollvveerrss
             Prints details about your system’s resolvers, and a list of hosts
             we would actually send queries to (after taking ----hhoosstt and ----ppoorrtt
             into account), without doing anything else.

   NNeettwwoorrkk ooppttiioonnss
     ----hhoosstt _h_o_s_t
             Sends the query to _h_o_s_t, instead of your system’s resolvers.  If
             _h_o_s_t is a domain name, we use your platform’s native name
             resolution to turn it into a list of IP addresses.

     ----ppoorrtt _p_o_r_t [default: 53]
             Sends the query to the given _p_o_r_t.  The default is port 53, or on
             macOS, the custom port (if any) that each of your system’s
             resolvers and nameservers is configured to use.

     ----ttiimmeeoouutt _t_i_m_e_o_u_t [seconds; default: 5]
             Give up on waiting for the query after _t_i_m_e_o_u_t seconds, and if
             there are more hosts available, try the next one.  This timeout
             spans the whole query attempt, so the query needs to be sent _a_n_d
             a response received within that time.

   BBuuiillddiinngg qquueerriieess
     --xx | ----rreevveerrssee
             Makes a reverse DNS query, converting _n_a_m_e (required) from an IP
             address to a domain name in ‘in-addr.arpa.’ (IPv4) or ‘ip6.arpa.’
             (IPv6).

     ----ccllaassss _c_l_a_s_s [default: IN]
             Question class.  For unknown classes, use ‘CLASS’ followed by the
             class number, e.g.  ‘class65535’.

   OOtthheerr ooppttiioonnss
     ----ccoolloorr ⟨_a_u_t_o | _n_e_v_e_r | _a_l_w_a_y_s⟩ [default: auto]
             Controls when to use colours or other text styles. In _a_u_t_o mode,
             we decide whether or not to use them as follows:

             ••   no, if standard output is not a tty (Unix) or console
                 (Windows)

             ••   no, if the environment has TERM=dumb (all platforms)

             ••   no, if the environment has no TERM (Unix)

             ••   yes, otherwise

SSEEEE AALLSSOO
     hosts(5), resolv.conf(5)

AAUUTTHHOORRSS
     bboorree is written and maintained by Delan Azabani <_d_e_l_a_n_@_a_z_a_b_a_n_i_._c_o_m>.

NixOS                          November 28, 2021                         NixOS
