STUBBY(1)                   General Commands Manual                  STUBBY(1)



<?><?><?> (NAME)
       stubby - <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> (stub
       resolver) <?><?><?><?> <?><?><?><?> <?><?><?><?><?> DNS


<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       stubby [-C file] [-ghilV] [-v loglevel]


<?><?><?><?><?><?><?> (DESCRIPTION)
       stubby <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> DNS
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?> DNS-over-TLS <?><?><?><?>
       <?><?><?><?><?><?>. Stubby <?><?><?><?><?><?><?><?><?><?> DNS
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> DNS <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?>.

       stubby <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       stubby <?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?> (daemon) <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       (loopback) <?><?> <?><?><?><?><?><?><?><?><?><?> DNS <?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> TLS
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> DNS <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.  <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <<<?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>>> (Strict
       Privacy) <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> DNS <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?><?><?>:
       https://dnsprivacy.org/wiki/display/DP/DNS+Privacy+Test+Servers


<?><?><?><?><?><?><?><?> (OPTIONS)
       -C file
              <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> file <?><?><?><?><?><?><?><?>.
              <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              stubby <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> ~/.stubby.yml
              <?><?><?><?><?><?><?>. <?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> stubby <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              /etc/stubby/stubby.yml <?><?><?><?> <?><?><?><?><?><?>.

       -g     <?><?><?><?><?> stubby <?><?> <?><?><?><?> <?><?> <?><?><?><?>.

       -h     <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?> <?><?><?><?>.

       -i     <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> (pretty-print) <?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?>
              <?><?><?><?>.

       -l     <?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?>. <?><?><?><?><?> <?><?>
              -v 7.

       -v loglevel
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>.
              <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> loglevel <?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>:

              0: EMERG
                     <?><?><?><?><?> <?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?> <?><?><?>

              1: ALERT
                     <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
                     <?><?><?><?>

              2: CRIT
                     <?><?><?><?><?> <?><?><?><?><?><?>

              3: ERROR
                     <?><?><?><?><?> <?><?><?>

              4: WARN
                     <?><?><?><?><?> <?><?><?><?><?>

              5: NOTICE
                     <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
                     <?><?><?><?><?>

              6: INFO
                     <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>

              7: DEBUG
                     <?><?><?><?><?><?><?><?> <?><?><?>
                     <?><?><?><?><?><?><?><?><?><?><?>

       -V     <?><?><?><?><?> <?><?><?><?><?> stubby <?> <?><?><?><?>.


<?><?><?><?><?><?><?><?> (CONFIGURATION)
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> YAML
       <?><?><?>. <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?>:

              resolution_type: GETDNS_RESOLUTION_STUB
              dns_transport_list:
                - GETDNS_TRANSPORT_TLS
              tls_authentication: GETDNS_AUTHENTICATION_REQUIRED
              tls_query_padding_blocksize: 256
              edns_client_subnet_private : 1
              idle_timeout: 10000
              listen_addresses:
                - 127.0.0.1
                -  0::1
              round_robin_upstreams: 1
              upstream_recursive_servers:
                - address_data: 145.100.185.15
                  tls_auth_name: "dnsovertls.sinodun.com"
                  tls_pubkey_pinset:
                    - digest: "sha256"
                      value: 62lKu9HsDVbyiPenApnc4sfmSYTHOVfFgL3pyB+cBL4=
                - address_data: 145.100.185.16
                  tls_auth_name: "dnsovertls1.sinodun.com"
                  tls_pubkey_pinset:
                    - digest: "sha256"
                      value: cE2ecALeE5B+urJhDrJlVFmf38cJLAvqekONvjvpqUA=
                - address_data: 185.49.141.37
                  tls_auth_name: "getdnsapi.net"
                  tls_pubkey_pinset:
                    - digest: "sha256"
                      value: foxZRnIh9gZpWnl+zEiKa0EJ2rdCGroMWm02gaxSc9Q=
                - address_data: 2001:610:1:40ba:145:100:185:15
                  tls_auth_name: "dnsovertls.sinodun.com"
                  tls_pubkey_pinset:
                    - digest: "sha256"
                      value: 62lKu9HsDVbyiPenApnc4sfmSYTHOVfFgL3pyB+cBL4=
                - address_data: 2001:610:1:40ba:145:100:185:16
                  tls_auth_name: "dnsovertls1.sinodun.com"
                  tls_pubkey_pinset:
                    - digest: "sha256"
                      value: cE2ecALeE5B+urJhDrJlVFmf38cJLAvqekONvjvpqUA=
                - address_data: 2a04:b900:0:100::38
                  tls_auth_name: "getdnsapi.net"
                  tls_pubkey_pinset:
                    - digest: "sha256"
                      value: foxZRnIh9gZpWnl+zEiKa0EJ2rdCGroMWm02gaxSc9Q=

       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?>. <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?> getdns <?><?>
       <?><?><?><?><?><?><?> stubby <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> getdns <?><?> <?><?>
       http://www.getdnsapi.net <?><?><?><?>.

       resolution_type resolution.
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?> GETDNS_RESOLUTION_STUB <?><?><?><?><?> <?><?><?>.
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> stubby <?><?> <?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?>.

       dns_transport_list list
              <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> (transport) <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?> DNS<?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
              GETDNS_TRANSPORT_TLS <?><?><?><?><?> <?><?><?>.
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              (Clear text) <?><?><?><?><?><?><?> <?><?> GETDNS_TRANSPORT_TCP
              <?> GETDNS_TRANSPORT_UDP

       tls_authentication type
              <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (Strict
              Privacy)<?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
              GETDNS_AUTHENTICATION_REQUIRED <?><?><?><?><?> <?><?><?>.
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
              (Opportunistic)<?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
              GETDNS_AUTHENTICATION_NONE <?><?><?><?> <?><?><?><?>. <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> (nameserver)
              <?><?><?><?><?><?> <?><?><?><?> <?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?> <?><?> dns_transport_list <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> (fallback) <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?>.

       tls_query_padding_blocksize blocksize
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> (padding) <?><?> EDNS0
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> DNS <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>.

       edns_client_subnet_private 0 or 1
              <?><?><?> 1 <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              EDNS0 Client Subnet <?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> (authoritative)
              <?><?><?><?><?> <?><?><?><?>.

       idle_timeout timeout
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> EDNS0 Keepalive <?><?> <?><?><?><?><?>
              timeout <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>.
              <?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> TLS
              <?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>.

       round_robin_upstreams 0 or 1
              <?><?><?> 1 <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (round robin)
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> stubby <?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?>
              <?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?>.

       upstream_recursive_servers server list
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> stubby <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>. <?><?> <?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
              <?><?><?>:

              address_data address
                     <?><?><?><?> IPv4 <?><?> IPv6 <?><?><?><?>.

              tls_auth_name name
                     <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
                     <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

              tls_pubkey_pinset pinset
                     <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
                     (pinset) <?><?><?><?> <?><?><?><?><?> sha256 SPKI
                     <?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?> <?><?>
                     <?><?><?><?><?> <?><?><?><?><?>
                     <?><?><?><?><?><?><?><?><?>
                     <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.
                     <?><?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
                     <?><?><?>:

                     digest type
                            <?><?><?> <?><?><?><?><?><?><?><?><?> (digest)
                            <?><?><?><?>.

                     value keyval
                            <?><?><?><?><?> <?><?><?><?>.


<?><?><?><?><?><?><?> (FILES)
       ~/.stubby.yml
       /etc/stubby/stubby.yml


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       https://getdnsapi.net
       https://dnsprivacy.org/wiki/display/DP/DNS+Privacy+Daemon+-+Stubby

                                                                     STUBBY(1)