chore: deprecate /api/v0/dns (#8893)
Closes #8607
Marcin Rataj committed
Apr 21, 2022 at 23:49 UTC
76ae33a9f3f9abd166d1f6f23d6a8a0511510e3c
2 files changed
+9
-33
core/commands/dns.go
+7
-30
@@ -17,40 +17,17 @@ const (
17
)
18
19
var DNSCmd = &cmds.Command{
20
+ Status: cmds.Deprecated, // https://github.com/ipfs/go-ipfs/issues/8607
21
Helptext: cmds.HelpText{
21
- Tagline: "Resolve DNS links.",
22
+ Tagline: "Resolve DNSLink records.",
23
ShortDescription: `
23
-Multihashes are hard to remember, but domain names are usually easy to
24
-remember. To create memorable aliases for multihashes, DNS TXT
25
-records can point to other DNS links, IPFS objects, IPNS keys, etc.
26
-This command resolves those links to the referenced object.
27
-`,
28
- LongDescription: `
29
-Multihashes are hard to remember, but domain names are usually easy to
30
-remember. To create memorable aliases for multihashes, DNS TXT
31
-records can point to other DNS links, IPFS objects, IPNS keys, etc.
32
-This command resolves those links to the referenced object.
33
-
34
-Note: This command can only recursively resolve DNS links,
35
-it will fail to recursively resolve through IPNS keys etc.
36
-For general-purpose recursive resolution, use ipfs name resolve -r.
37
-
38
-For example, with this DNS TXT record:
39
-
40
- > dig +short TXT _dnslink.ipfs.io
41
- dnslink=/ipfs/QmRzTuh2Lpuz7Gr39stNr6mTFdqAghsZec1JoUnfySUzcy
42
-
43
-The resolver will give:
44
-
45
- > ipfs dns ipfs.io
46
- /ipfs/QmRzTuh2Lpuz7Gr39stNr6mTFdqAghsZec1JoUnfySUzcy
24
+This command can only recursively resolve DNSLink TXT records.
25
+It will fail to recursively resolve through IPNS keys etc.
26
48
-The resolver can recursively resolve:
27
+DEPRECATED: superseded by 'ipfs resolve'
28
50
- > dig +short TXT recursive.ipfs.io
51
- dnslink=/ipns/ipfs.io
52
- > ipfs dns -r recursive.ipfs.io
53
- /ipfs/QmRzTuh2Lpuz7Gr39stNr6mTFdqAghsZec1JoUnfySUzcy
29
+For general-purpose recursive resolution, use 'ipfs resolve -r'.
30
+It will work across multiple DNSLinks and IPNS keys.
31
`,
32
},
33
core/commands/root.go
+2
-3
@@ -51,14 +51,13 @@ TEXT ENCODING COMMANDS
51
ADVANCED COMMANDS
52
daemon Start a long-running daemon process
53
mount Mount an IPFS read-only mount point
54
- resolve Resolve any type of name
54
+ resolve Resolve any type of content path
55
name Publish and resolve IPNS names
56
key Create and list IPNS name keypairs
57
- dns Resolve DNS links
57
pin Pin objects to local storage
58
repo Manipulate the IPFS repository
59
stats Various operational stats
61
- p2p Libp2p stream mounting
60
+ p2p Libp2p stream mounting (experimental)
61
filestore Manage the filestore (experimental)
62
63
NETWORK COMMANDS