IPFS指令集（三）

12

ipfs diag

-12.1-

ipfs diag

用法

ipfs diag - 生成诊断报告。

使用范例

ipfs diag

子命令

使用“ipfs diag --help”来获取关于每条命令的更多信息。

-12.2-

ipfs diag cmds

用法

ipfs diag cmds - 列出在本节点运行的所有命令。

使用范例

ipfs diag cmds [--verbose | -v]

选项

描述

列出正在运行和最近运行的命令。

子命令

使用“ipfs diag --help”获取更多关于每个命令的信息。

-12.3-

ipfs diag cmds clear

用法

ipfs diag cmds clear - 从日志中清除不活跃请求。

使用范例

ipfs diag cmds clear

-12.4-

ipfs diag cmds set-time

用法

ipfs diag cmds set-time - 设置日志中保存不活跃请求的时间。

使用范例

ipfs diag cmds set-time [--]

参数

- 在日志中保存不活跃请求的时间。

-12.5-

ipfs diag sys

用法

ipfs diag sys - 打印系统诊断信息。

使用范例

ipfs diag sys

描述

打印关于你的电脑的信息，可辅助debug。

13

ipfs dns

 用法

ipfs dns - 解析DNS链接。

使用范例

ipfs dns [--recursive | -r] [--]

参数

- 要解析的域名。

选项

描述

多重哈希很难记忆，但域名很容易记住。为了给多重哈希创建易于记忆的别名，DNS TXT记录能指向其他DNS链接，IPFS对象，IPNS密钥等待。这条命令解析这些指向相应对象的链接。

例如下面这条DNS TXT记录：

解析器将会给出：

解析器能递归解析出：

14

ipfs file

-14.1-

ipfs file

用法

ipfs file - 与以unix文件系统类似的IPFS对象交互。

使用范例

ipfs file

描述

“ipfs file”提供一个到以IPFS对象为代表文件系统的接口，这个接口隐藏了ipfs实现的细节，比如展示对象（分列和分块）。

子命令

使用“ipfs file - -help”来查看关于每条命令的详细信息。

-14.2-

ipfs file ls

用法

ipfs file ls … - 以unix文件系统形式列出目录内容。

使用范例

ipfs file ls [--] …

参数

… - 要列出链接的IPFS对象的路径。

描述

展示一个路径下的IPFS或IPNS对象的内容。

JSON输出包括大小信息。对文件来说，child的大小就是该文件内容的总共大小。对目录来说，child 的大小就是IPFS链接的大小。

路径可以是有前缀的斜杠，在这种情况下，我们假设他是一个/ipfs ref并且不是/ipns。

举例：

这个功能后续将被移除，请尽可能使用“ipfs ls”。

-14.3-

ipfs files

用法

ipfs files - 与unix文件系统文件交互。

使用范例

ipfs files [--f=false]

选项

描述

Files是一个以unix文件系统格式操作IPFS对象的API。

注意：

大部分“ipfs files”的子命令接受“—flush”，其缺省为true。如果把他设置为false时需要注意。这种操作以牺牲一致性为代价，能提升大批量文件操作时系统的表现。但如果后台进程意外的在执行“ipfs files flush” 前退出的话，数据有丢失的风险。这种情况也同样适用于在“ --flush=false”情况下执行“ipfs repo gc”。

子命令

使用“ipfs files --help”获取更多关于每个命令的信息。

-14.4-

ipfs files cp

用法

ipfs files cp - 将文件拷贝到mfs。

使用范例

ipfs files cp [—]

参数

   - 要拷贝的源文件。

    - 要拷贝到的地址。

-14.5-

ipfs files flush

用法

ipfs files flush [] - 将目标路径的数据转存到磁盘。

使用范例

ipfs files flush [--] []

参数

[] - 要清理的路径. 缺省为: “/”。

描述

将给定路径的数据转存到磁盘。本命令仅在“--flush=false”时有效。

-14.6-

ipfs files ls

用法

ipfs files ls [] - 列出本地可变命名空间的目录。

使用范例

ipfs files ls [-l] [--] []

参数

[] - 要列出的路径，缺省为“/”。

选项

描述

列出本地可变命名空间目录。

举例：

-14.7-

ipfs files mkdir

用法

ipfs files mkdir - 创建目录。

使用范例

ipfs files mkdir [--parents | -p] [--]

参数

- 要创建的目录的路径。

选项

描述

创建不存在的目录。

注意：所有目录一定要是绝对路径。

举例：

-14.8-

ipfs files mv

用法

ipfs files mv - 移动文件。

使用范例

ipfs files mv [--]

参数

  - 要移动的源文件。

     - 要移动到的位置。

描述

就像unix系统里的mv一样。

范例：

-14.9-

ipfs files read

用法

ipfs files read - 在给定的mfs里读取一个文件。

使用范例

ipfs files read [--offset= | -o] [--count= | -n] [--]

参数

- 读取路径。

选项

描述

从文件的给定偏移位置起去读一定数量的字节。默认情况下将像unix中的cat一样读取整个文件。

举例：

-14.10-

ipfs files rm

用法

ipfs files rm … - 移除一个文件。

使用范例

ipfs files rm [--recursive | -r] [--] …

参数

… - 要删除的文件。

选项

描述

删除文件或目录。

-14.11-

ipfs files stat

用法

ipfs files stat - 展示文件状态。

使用范例

ipfs files stat [--format=] [--hash] [--size] [--]

参数

- 要查看状态的文件路径。

选项

-14.12-

ipfs files write

用法

ipfs files write - 在给定的文件系统里写入一个可变的文件。

使用范例

ipfs files write [--offset= | -o] [--create | -e] [--truncate | -t] [--count= | -n] [--]

参数

- 要写入的路径。

- 要写入的数据。

选项

描述

在给定的文件系统中的文件内写入数据。这条命令允许你选定一个开始写入的偏移位置。输入将被完整写入到文件。

如果你使用了“—create”选项，那当文件不存在时其将被创建。不存在的中间目录不会被创建。

如果“—flush”选项被设置为false，那么改变不会影响默克尔有向无环图的根。当对较深的目录结构做大量写入操作时，这可以让操作更快。

举例：

警告：

使用“--flush=false”选项在树被清理之前不能确保数据持久性。该选项可以与“ipfs files stat”一起用到文件或其任何祖先上。

-14.13-

ipfs filestore

用法

ipfs filestore - 与其他文件仓库对象交互。

使用范例

ipfs filestore

子命令

使用“ipfs filestore --help”来查看关于每条命令的详细信息。

-14.14-

ipfs filestore dups

用法

ipfs filestore dups - 列出同时在文件仓库和标准块存储里的区块。

使用范例

ipfs filestore dups

-14.15-

ipfs filestore ls

用法

ipfs filestore ls []… - 列出在文件仓库里的对象。

使用范例

ipfs filestore ls [--] […]

参数

[]… - 要列出对象的Cid。

描述

列出文件仓库里的对象。

如果一个或多个对象被指定，那么只列出具体的对象，否则列出所有对象。

输出像这样：

-14.16-

ipfs filestore verify

用法

ipfs filestore verify []… - 验证文件仓库中的对象。

使用范例

ipfs filestore verify [--] […]

参数

[]… - 要验证对象的Cid。

描述

验证文件仓库中的对象。

如果一个或对个对象被指定，那么只验证具体的对象，否则验证所有对象。

输出像这样：

其中包含下列可能结果：

当出现ERROR错误时，错误信息会被打印到 stderr 中。