mirror of
https://github.com/ipfs/kubo.git
synced 2025-08-06 19:44:01 +08:00
fded3bc08c
This is what users expect. fixes #5635 fixes #5585 fixes #4181 fixes #4293 fixes #6086 License: MIT Signed-off-by: Steven Allen <steven@stebalien.com>
90 lines
2.6 KiB
Go
90 lines
2.6 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"
|
|
|
|
cmdkit "github.com/ipfs/go-ipfs-cmdkit"
|
|
cmds "github.com/ipfs/go-ipfs-cmds"
|
|
)
|
|
|
|
const (
|
|
dnsRecursiveOptionName = "recursive"
|
|
)
|
|
|
|
var DNSCmd = &cmds.Command{
|
|
Helptext: cmdkit.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: []cmdkit.Argument{
|
|
cmdkit.StringArg("domain-name", true, false, "The domain-name name to resolve.").EnableStdin(),
|
|
},
|
|
Options: []cmdkit.Option{
|
|
cmdkit.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 ropts []nsopts.ResolveOpt
|
|
if !recursive {
|
|
ropts = append(ropts, nsopts.Depth(1))
|
|
}
|
|
|
|
output, err := resolver.Resolve(req.Context, name, ropts...)
|
|
if err == namesys.ErrResolveFailed {
|
|
return err
|
|
}
|
|
if err != nil {
|
|
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{},
|
|
}
|