mirror of
https://github.com/privatevoid-net/nix-super.git
synced 2024-11-24 14:56:15 +02:00
eb7d7780b1
This is needed to avoid this https://github.com/mesonbuild/meson/issues/13774 when we go back to making our subproject directory `src`.
102 lines
2.9 KiB
Markdown
102 lines
2.9 KiB
Markdown
# Store object info JSON format
|
|
|
|
> **Warning**
|
|
>
|
|
> This JSON format is currently
|
|
> [**experimental**](@docroot@/development/experimental-features.md#xp-feature-nix-command)
|
|
> and subject to change.
|
|
|
|
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
|