diff --git a/core/commands/add.go b/core/commands/add.go index c2d73f8deee..fb8ee8a3145 100644 --- a/core/commands/add.go +++ b/core/commands/add.go @@ -107,10 +107,16 @@ You can now check what blocks have been created by: QmerURi9k4XzKCaaPbsK6BL5pMEjF7PGphjDvkkjDtsVf3 868 QmQB28iwSriSUSMqG2nXDTLtdPHgWb4rebBrU7Q1j4vxPv 338 -Finally, a note on hash determinism. While not guaranteed, adding the same -file/directory with the same flags will almost always result in the same output -hash. However, almost all of the flags provided by this command (other than pin, -only-hash, and progress/status related flags) will change the final hash. +Finally, a note on hash (CID) determinism and 'ipfs add' command. + +Almost all the flags provided by this command will change the final CID, and +new flags may be added in the future. It is not guaranteed for the implicit +defaults of 'ipfs add' to remain the same in future Kubo releases, or for other +IPFS software to use the same import parameters as Kubo. + +If you need to back up or transport content-addressed data using a non-IPFS +medium, CID can be preserved with CAR files. +See 'dag export' and 'dag import' for more information. `, }, diff --git a/core/commands/dag/dag.go b/core/commands/dag/dag.go index 1661c3818b0..77c9ee4b590 100644 --- a/core/commands/dag/dag.go +++ b/core/commands/dag/dag.go @@ -197,7 +197,8 @@ Note: currently present in the blockstore does not represent a complete DAG, pinning of that individual root will fail. -Maximum supported CAR version: 1 +Maximum supported CAR version: 2 +Specification of CAR formats: https://ipld.io/specs/transport/car/ `, }, Arguments: []cmds.Argument{ @@ -265,6 +266,7 @@ var DagExportCmd = &cmds.Command{ 'ipfs dag export' fetches a DAG and streams it out as a well-formed .car file. Note that at present only single root selections / .car files are supported. The output of blocks happens in strict DAG-traversal, first-seen, order. +CAR file follows the CARv1 format: https://ipld.io/specs/transport/car/carv1/ `, }, Arguments: []cmds.Argument{