mirror of
https://github.com/ipfs/kubo.git
synced 2025-06-03 12:16:18 +08:00
86 lines
2.5 KiB
Go
86 lines
2.5 KiB
Go
package commands
|
|
|
|
import (
|
|
"fmt"
|
|
"io"
|
|
|
|
ncmd "github.com/ipfs/go-ipfs/core/commands/name"
|
|
namesys "github.com/ipfs/go-ipfs/namesys"
|
|
nsopts "github.com/ipfs/interface-go-ipfs-core/options/namesys"
|
|
|
|
cmds "github.com/ipfs/go-ipfs-cmds"
|
|
)
|
|
|
|
const (
|
|
dnsRecursiveOptionName = "recursive"
|
|
)
|
|
|
|
var DNSCmd = &cmds.Command{
|
|
Helptext: cmds.HelpText{
|
|
Tagline: "Resolve DNS links.",
|
|
ShortDescription: `
|
|
Multihashes are hard to remember, but domain names are usually easy to
|
|
remember. To create memorable aliases for multihashes, DNS TXT
|
|
records can point to other DNS links, IPFS objects, IPNS keys, etc.
|
|
This command resolves those links to the referenced object.
|
|
`,
|
|
LongDescription: `
|
|
Multihashes are hard to remember, but domain names are usually easy to
|
|
remember. To create memorable aliases for multihashes, DNS TXT
|
|
records can point to other DNS links, IPFS objects, IPNS keys, etc.
|
|
This command resolves those links to the referenced object.
|
|
|
|
Note: This command can only recursively resolve DNS links,
|
|
it will fail to recursively resolve through IPNS keys etc.
|
|
For general-purpose recursive resolution, use ipfs name resolve -r.
|
|
|
|
For example, with this DNS TXT record:
|
|
|
|
> dig +short TXT _dnslink.ipfs.io
|
|
dnslink=/ipfs/QmRzTuh2Lpuz7Gr39stNr6mTFdqAghsZec1JoUnfySUzcy
|
|
|
|
The resolver will give:
|
|
|
|
> ipfs dns ipfs.io
|
|
/ipfs/QmRzTuh2Lpuz7Gr39stNr6mTFdqAghsZec1JoUnfySUzcy
|
|
|
|
The resolver can recursively resolve:
|
|
|
|
> dig +short TXT recursive.ipfs.io
|
|
dnslink=/ipns/ipfs.io
|
|
> ipfs dns -r recursive.ipfs.io
|
|
/ipfs/QmRzTuh2Lpuz7Gr39stNr6mTFdqAghsZec1JoUnfySUzcy
|
|
`,
|
|
},
|
|
|
|
Arguments: []cmds.Argument{
|
|
cmds.StringArg("domain-name", true, false, "The domain-name name to resolve.").EnableStdin(),
|
|
},
|
|
Options: []cmds.Option{
|
|
cmds.BoolOption(dnsRecursiveOptionName, "r", "Resolve until the result is not a DNS link.").WithDefault(true),
|
|
},
|
|
Run: func(req *cmds.Request, res cmds.ResponseEmitter, env cmds.Environment) error {
|
|
recursive, _ := req.Options[dnsRecursiveOptionName].(bool)
|
|
name := req.Arguments[0]
|
|
resolver := namesys.NewDNSResolver()
|
|
|
|
var routing []nsopts.ResolveOpt
|
|
if !recursive {
|
|
routing = append(routing, nsopts.Depth(1))
|
|
}
|
|
|
|
output, err := resolver.Resolve(req.Context, name, routing...)
|
|
if err != nil && (recursive || err != namesys.ErrResolveRecursion) {
|
|
return err
|
|
}
|
|
return cmds.EmitOnce(res, &ncmd.ResolvedPath{Path: output})
|
|
},
|
|
Encoders: cmds.EncoderMap{
|
|
cmds.Text: cmds.MakeTypedEncoder(func(req *cmds.Request, w io.Writer, out *ncmd.ResolvedPath) error {
|
|
fmt.Fprintln(w, out.Path.String())
|
|
return nil
|
|
}),
|
|
},
|
|
Type: ncmd.ResolvedPath{},
|
|
}
|