mirror of
https://github.com/tailscale/tailscale.git
synced 2025-05-18 00:08:31 +00:00
61bea75092
3dabea0fc2c added some docs with inconsistent usage docs. This fixes them, and adds a test. It also adds some other tests and fixes other verb tense inconsistencies. Updates tailscale/corp#25278 Change-Id: I94c2a8940791bddd7c35c1c3d5fb791a317370c2 Signed-off-by: Brad Fitzpatrick <bradfitz@tailscale.com>
50 lines
1.7 KiB
Go
50 lines
1.7 KiB
Go
// Copyright (c) Tailscale Inc & AUTHORS
|
|
// SPDX-License-Identifier: BSD-3-Clause
|
|
|
|
package cli
|
|
|
|
import (
|
|
"flag"
|
|
|
|
"github.com/peterbourgon/ff/v3/ffcli"
|
|
)
|
|
|
|
var dnsCmd = &ffcli.Command{
|
|
Name: "dns",
|
|
ShortHelp: "Diagnose the internal DNS forwarder",
|
|
LongHelp: dnsCmdLongHelp(),
|
|
ShortUsage: "tailscale dns <subcommand> [flags]",
|
|
UsageFunc: usageFuncNoDefaultValues,
|
|
Subcommands: []*ffcli.Command{
|
|
{
|
|
Name: "status",
|
|
ShortUsage: "tailscale dns status [--all]",
|
|
Exec: runDNSStatus,
|
|
ShortHelp: "Print the current DNS status and configuration",
|
|
LongHelp: dnsStatusLongHelp(),
|
|
FlagSet: (func() *flag.FlagSet {
|
|
fs := newFlagSet("status")
|
|
fs.BoolVar(&dnsStatusArgs.all, "all", false, "outputs advanced debugging information (fallback resolvers, nameservers, cert domains, extra records, and exit node filtered set)")
|
|
return fs
|
|
})(),
|
|
},
|
|
{
|
|
Name: "query",
|
|
ShortUsage: "tailscale dns query <name> [a|aaaa|cname|mx|ns|opt|ptr|srv|txt]",
|
|
Exec: runDNSQuery,
|
|
ShortHelp: "Perform a DNS query",
|
|
LongHelp: "The 'tailscale dns query' subcommand performs a DNS query for the specified name using the internal DNS forwarder (100.100.100.100).\n\nIt also provides information about the resolver(s) used to resolve the query.",
|
|
},
|
|
|
|
// TODO: implement `tailscale log` here
|
|
|
|
// The above work is tracked in https://github.com/tailscale/tailscale/issues/13326
|
|
},
|
|
}
|
|
|
|
func dnsCmdLongHelp() string {
|
|
return `The 'tailscale dns' subcommand provides tools for diagnosing the internal DNS forwarder (100.100.100.100).
|
|
|
|
For more information about the DNS functionality built into Tailscale, refer to https://tailscale.com/kb/1054/dns.`
|
|
}
|