JSON output JSON 输出 

Supported types: 支持的类型:

  • number: %llu 数字: %llu

  • string: %s 字符串: %s

  • string: str (escaped special characters)
    字符串: str (转义特殊字符)

  • bool: bool (unquoted native json value)
    布尔值: bool (未引用的原生 JSON 值)

  • qgroupid: qgroupid (split to 48/16 for level/subvolid)
    qgroupid: qgroupid (拆分为 48/16 以用于级别/子卷)

  • size: size 大小: size

Commands that support json output
支持 JSON 输出的命令 

  • btrfs device stats btrfs 设备统计

  • btrfs filesystem df btrfs 文件系统磁盘空间使用情况

  • btrfs qgroup show btrfs qgroup 显示

  • btrfs subvolume get-default
    btrfs 子卷获取默认值

  • btrfs subvolume list btrfs 子卷列表

  • btrfs subvolume show btrfs 子卷显示

Recommendations 推荐

  • key names 键名
    • should be unified if they mean the same thing
      如果它们表示相同的含义,应统一

    • not abbreviated (e.g. generation instead of gen)
      不缩写(例如使用 generation 而不是 gen)

    • referring to existing and well known names (qgroupid, devid, …)
      指现有和众所周知的名称(如 qgroupid、devid 等)

  • values 
    • numbers without suffix or other transformation, i.e. no KiB
      没有后缀或其他转换的数字,即没有 KiB

  • printing more data about an item is better than printing less, assuming the filtering is done on the user side
    打印有关项目的更多数据比打印更少的数据更好,假设过滤是在用户端完成的

  • structure of json output may not reflect the way it’s printed in plain text, in that case do two separate printer functions
    JSON 输出的结构可能不反映其在纯文本中打印的方式,在这种情况下,请使用两个单独的打印函数

  • if plain and json output roughly follow the same style, e.g. line oriented that is easy to transform to a map, then both outputs should use the same rowspec
    如果普通和 JSON 输出大致遵循相同的风格,例如基于行的易于转换为映射,则两种输出应该使用相同的行规范。