mirror of
https://github.com/NixOS/nix
synced 2025-06-26 20:01:15 +02:00
4055239936
-----BEGIN PGP SIGNATURE----- iQFHBAABCAAxFiEEtUHVUwEnDgvPFcpdgXC0cm1xmN4FAmetA5oTHGVkb2xzdHJh QGdtYWlsLmNvbQAKCRCBcLRybXGY3g2pB/9JAFyjmaXuccbMTO/6x9qwsWuuXNLk OQWzfbdUekvsihZZSFZg1r7KqqXHCi64f0nxLPsJ/0oeDWZktJ5KnbV630nuUlDj ulLCpKdvhWFa8dVx9LiziGwQw4KLx8PjOfwThtQ4DqCWxWEmu6lKkijag9cE+ai4 3mw9YtUjBRxlXyhYLzWz3whLbv37c/m+R8iGS8xm8W260pmei6D0beOIPdfXYBQF PzPlPORyI08A06uqyA3z7bTxzmSMnzvu0QInCPCKSHzFUnTZPHUYuYStFl28NrZS fXKK59L0G7QEfdTRAmqQkdHdtPj2RlYFiMN0kQiNLflvKfGGWdi/kvdx =rRix -----END PGP SIGNATURE----- Merge tag '2.26.2' into sync-2.26.2 Tagging release 2.26.2
96 lines
2.8 KiB
Markdown
96 lines
2.8 KiB
Markdown
# Store object info JSON format
|
|
|
|
Info about a [store object].
|
|
|
|
* `path`:
|
|
|
|
[Store path][store path] to the given store object.
|
|
|
|
* `narHash`:
|
|
|
|
Hash of the [file system object] part of the store object when serialized as a [Nix Archive].
|
|
|
|
* `narSize`:
|
|
|
|
Size of the [file system object] part of the store object when serialized as a [Nix Archive].
|
|
|
|
* `references`:
|
|
|
|
An array of [store paths][store path], possibly including this one.
|
|
|
|
* `ca`:
|
|
|
|
If the store object is [content-addressed],
|
|
this is the content address of this store object's file system object, used to compute its store path.
|
|
Otherwise (i.e. if it is [input-addressed]), this is `null`.
|
|
|
|
[store path]: @docroot@/store/store-path.md
|
|
[file system object]: @docroot@/store/file-system-object.md
|
|
[Nix Archive]: @docroot@/store/file-system-object/content-address.md#serial-nix-archive
|
|
|
|
## Impure fields
|
|
|
|
These are not intrinsic properties of the store object.
|
|
In other words, the same store object residing in different store could have different values for these properties.
|
|
|
|
* `deriver`:
|
|
|
|
If known, the path to the [derivation] from which this store object was produced.
|
|
Otherwise `null`.
|
|
|
|
[derivation]: @docroot@/glossary.md#gloss-store-derivation
|
|
|
|
* `registrationTime` (optional):
|
|
|
|
If known, when this derivation was added to the store.
|
|
Otherwise `null`.
|
|
|
|
* `ultimate`:
|
|
|
|
Whether this store object is trusted because we built it ourselves, rather than substituted a build product from elsewhere.
|
|
|
|
* `signatures`:
|
|
|
|
Signatures claiming that this store object is what it claims to be.
|
|
Not relevant for [content-addressed] store objects,
|
|
but useful for [input-addressed] store objects.
|
|
|
|
[content-addressed]: @docroot@/store/store-object/content-address.md
|
|
[input-addressed]: @docroot@/glossary.md#gloss-input-addressed-store-object
|
|
|
|
### `.narinfo` extra fields
|
|
|
|
This meta data is specific to the "binary cache" family of Nix store types.
|
|
This information is not intrinsic to the store object, but about how it is stored.
|
|
|
|
* `url`:
|
|
|
|
Where to download a compressed archive of the file system objects of this store object.
|
|
|
|
* `compression`:
|
|
|
|
The compression format that the archive is in.
|
|
|
|
* `fileHash`:
|
|
|
|
A digest for the compressed archive itself, as opposed to the data contained within.
|
|
|
|
* `fileSize`:
|
|
|
|
The size of the compressed archive itself.
|
|
|
|
## Computed closure fields
|
|
|
|
These fields are not stored at all, but computed by traversing the other fields across all the store objects in a [closure].
|
|
|
|
* `closureSize`:
|
|
|
|
The total size of the compressed archive itself for this object, and the compressed archive of every object in this object's [closure].
|
|
|
|
### `.narinfo` extra fields
|
|
|
|
* `closureSize`:
|
|
|
|
The total size of this store object and every other object in its [closure].
|
|
|
|
[closure]: @docroot@/glossary.md#gloss-closure
|