mirror of
https://github.com/ipfs/kubo.git
synced 2025-11-04 06:00:01 +08:00
100 lines
2.5 KiB
Go
100 lines
2.5 KiB
Go
package commands
|
|
|
|
import (
|
|
"io"
|
|
"strings"
|
|
|
|
cmds "github.com/ipfs/go-ipfs/commands"
|
|
namesys "github.com/ipfs/go-ipfs/namesys"
|
|
path "github.com/ipfs/go-ipfs/path"
|
|
u "github.com/ipfs/go-ipfs/util"
|
|
)
|
|
|
|
type ResolvedPath struct {
|
|
Path path.Path
|
|
}
|
|
|
|
var ResolveCmd = &cmds.Command{
|
|
Helptext: cmds.HelpText{
|
|
Tagline: "Resolve the value of names to IPFS",
|
|
ShortDescription: `
|
|
There are a number of mutable name protocols that can link among
|
|
themselves and into IPNS. This command accepts any of these
|
|
identifiers and resolves them to the referenced item.
|
|
`,
|
|
LongDescription: `
|
|
There are a number of mutable name protocols that can link among
|
|
themselves and into IPNS. For example IPNS references can (currently)
|
|
point at IPFS object, and DNS links can point at other DNS links, IPNS
|
|
entries, or IPFS objects. This command accepts any of these
|
|
identifiers and resolves them to the referenced item.
|
|
|
|
Examples:
|
|
|
|
Resolve the value of your identity:
|
|
|
|
> ipfs resolve /ipns/QmatmE9msSfkKxoffpHwNLNKgwZG8eT9Bud6YoPab52vpy
|
|
/ipfs/Qmcqtw8FfrVSBaRmbWwHxt3AuySBhJLcvmFYi3Lbc4xnwj
|
|
|
|
Resolve the value of another name:
|
|
|
|
> ipfs resolve /ipns/QmbCMUZw6JFeZ7Wp9jkzbye3Fzp2GGcPgC3nmeUjfVF87n
|
|
/ipns/QmatmE9msSfkKxoffpHwNLNKgwZG8eT9Bud6YoPab52vpy
|
|
|
|
Resolve the value of another name recursively:
|
|
|
|
> ipfs resolve -r /ipns/QmbCMUZw6JFeZ7Wp9jkzbye3Fzp2GGcPgC3nmeUjfVF87n
|
|
/ipfs/Qmcqtw8FfrVSBaRmbWwHxt3AuySBhJLcvmFYi3Lbc4xnwj
|
|
|
|
`,
|
|
},
|
|
|
|
Arguments: []cmds.Argument{
|
|
cmds.StringArg("name", true, false, "The name to resolve.").EnableStdin(),
|
|
},
|
|
Options: []cmds.Option{
|
|
cmds.BoolOption("recursive", "r", "Resolve until the result is an IPFS name"),
|
|
},
|
|
Run: func(req cmds.Request, res cmds.Response) {
|
|
|
|
n, err := req.Context().GetNode()
|
|
if err != nil {
|
|
res.SetError(err, cmds.ErrNormal)
|
|
return
|
|
}
|
|
|
|
if !n.OnlineMode() {
|
|
err := n.SetupOfflineRouting()
|
|
if err != nil {
|
|
res.SetError(err, cmds.ErrNormal)
|
|
return
|
|
}
|
|
}
|
|
|
|
name := req.Arguments()[0]
|
|
recursive, _, _ := req.Option("recursive").Bool()
|
|
depth := 1
|
|
if recursive {
|
|
depth = namesys.DefaultDepthLimit
|
|
}
|
|
|
|
output, err := n.Namesys.ResolveN(n.Context(), name, depth)
|
|
if err != nil {
|
|
res.SetError(err, cmds.ErrNormal)
|
|
return
|
|
}
|
|
|
|
res.SetOutput(&ResolvedPath{output})
|
|
},
|
|
Marshalers: cmds.MarshalerMap{
|
|
cmds.Text: func(res cmds.Response) (io.Reader, error) {
|
|
output, ok := res.Output().(*ResolvedPath)
|
|
if !ok {
|
|
return nil, u.ErrCast()
|
|
}
|
|
return strings.NewReader(output.Path.String()), nil
|
|
},
|
|
},
|
|
Type: ResolvedPath{},
|
|
}
|