Warning
This program is experimental and its interface is subject to change.
Name
nix nar ls
- show information about a path inside a NAR file
Synopsis
nix nar ls
[option...] nar path
Examples
-
To list a specific file in a NAR:
# nix nar ls --long ./hello.nar /bin/hello -r-xr-xr-x 38184 hello
-
To recursively list the contents of a directory inside a NAR, in JSON format:
# nix nar ls --json --recursive ./hello.nar /bin {"type":"directory","entries":{"hello":{"type":"regular","size":38184,"executable":true,"narOffset":400}}}
Description
This command shows information about a path inside NAR file nar.
Options
-
--directory
/-d
Show directories rather than their contents. -
--json
Produce output in JSON format, suitable for consumption by another program. -
--long
/-l
Show detailed file information. -
--recursive
/-R
List subdirectories recursively.
Logging-related options:
-
--debug
Set the logging verbosity level to 'debug'. -
--log-format
format Set the format of log output; one ofraw
,internal-json
,bar
orbar-with-logs
. -
--print-build-logs
/-L
Print full build logs on standard error. -
--quiet
Decrease the logging verbosity level. -
--verbose
/-v
Increase the logging verbosity level.
Miscellaneous global options:
-
--help
Show usage information. -
--offline
Disable substituters and consider all previously downloaded files up-to-date. -
--option
name value Set the Nix configuration setting name to value (overridingnix.conf
). -
--refresh
Consider all previously downloaded files out-of-date. -
--version
Show version information.
Options to override configuration settings:
-
--accept-flake-config
Enable theaccept-flake-config
setting. -
--access-tokens
value Set theaccess-tokens
setting. -
--allow-dirty
Enable theallow-dirty
setting. -
--allow-import-from-derivation
Enable theallow-import-from-derivation
setting. -
--allow-new-privileges
Enable theallow-new-privileges
setting. -
--allow-symlinked-store
Enable theallow-symlinked-store
setting. -
--allow-unsafe-native-code-during-evaluation
Enable theallow-unsafe-native-code-during-evaluation
setting. -
--allowed-impure-host-deps
value Set theallowed-impure-host-deps
setting. -
--allowed-uris
value Set theallowed-uris
setting. -
--allowed-users
value Set theallowed-users
setting. -
--auto-allocate-uids
Enable theauto-allocate-uids
setting. -
--auto-optimise-store
Enable theauto-optimise-store
setting. -
--bash-prompt
value Set thebash-prompt
setting. -
--bash-prompt-prefix
value Set thebash-prompt-prefix
setting. -
--bash-prompt-suffix
value Set thebash-prompt-suffix
setting. -
--build-hook
value Set thebuild-hook
setting. -
--build-poll-interval
value Set thebuild-poll-interval
setting. -
--build-users-group
value Set thebuild-users-group
setting. -
--builders
value Set thebuilders
setting. -
--builders-use-substitutes
Enable thebuilders-use-substitutes
setting. -
--commit-lockfile-summary
value Set thecommit-lockfile-summary
setting. -
--compress-build-log
Enable thecompress-build-log
setting. -
--connect-timeout
value Set theconnect-timeout
setting. -
--cores
value Set thecores
setting. -
--diff-hook
value Set thediff-hook
setting. -
--download-attempts
value Set thedownload-attempts
setting. -
--download-speed
value Set thedownload-speed
setting. -
--eval-cache
Enable theeval-cache
setting. -
--experimental-features
value Set theexperimental-features
setting. -
--extra-access-tokens
value Append to theaccess-tokens
setting. -
--extra-allowed-impure-host-deps
value Append to theallowed-impure-host-deps
setting. -
--extra-allowed-uris
value Append to theallowed-uris
setting. -
--extra-allowed-users
value Append to theallowed-users
setting. -
--extra-build-hook
value Append to thebuild-hook
setting. -
--extra-experimental-features
value Append to theexperimental-features
setting. -
--extra-extra-platforms
value Append to theextra-platforms
setting. -
--extra-hashed-mirrors
value Append to thehashed-mirrors
setting. -
--extra-ignored-acls
value Append to theignored-acls
setting. -
--extra-nix-path
value Append to thenix-path
setting. -
--extra-platforms
value Set theextra-platforms
setting. -
--extra-plugin-files
value Append to theplugin-files
setting. -
--extra-sandbox-paths
value Append to thesandbox-paths
setting. -
--extra-secret-key-files
value Append to thesecret-key-files
setting. -
--extra-substituters
value Append to thesubstituters
setting. -
--extra-system-features
value Append to thesystem-features
setting. -
--extra-trusted-public-keys
value Append to thetrusted-public-keys
setting. -
--extra-trusted-substituters
value Append to thetrusted-substituters
setting. -
--extra-trusted-users
value Append to thetrusted-users
setting. -
--fallback
Enable thefallback
setting. -
--filter-syscalls
Enable thefilter-syscalls
setting. -
--flake-registry
value Set theflake-registry
setting. -
--fsync-metadata
Enable thefsync-metadata
setting. -
--gc-reserved-space
value Set thegc-reserved-space
setting. -
--hashed-mirrors
value Set thehashed-mirrors
setting. -
--http-connections
value Set thehttp-connections
setting. -
--http2
Enable thehttp2
setting. -
--id-count
value Set theid-count
setting. -
--ignore-try
Enable theignore-try
setting. -
--ignored-acls
value Set theignored-acls
setting. -
--impersonate-linux-26
Enable theimpersonate-linux-26
setting. -
--keep-build-log
Enable thekeep-build-log
setting. -
--keep-derivations
Enable thekeep-derivations
setting. -
--keep-env-derivations
Enable thekeep-env-derivations
setting. -
--keep-failed
Enable thekeep-failed
setting. -
--keep-going
Enable thekeep-going
setting. -
--keep-outputs
Enable thekeep-outputs
setting. -
--log-lines
value Set thelog-lines
setting. -
--max-build-log-size
value Set themax-build-log-size
setting. -
--max-free
value Set themax-free
setting. -
--max-jobs
value Set themax-jobs
setting. -
--max-silent-time
value Set themax-silent-time
setting. -
--max-substitution-jobs
value Set themax-substitution-jobs
setting. -
--min-free
value Set themin-free
setting. -
--min-free-check-interval
value Set themin-free-check-interval
setting. -
--nar-buffer-size
value Set thenar-buffer-size
setting. -
--narinfo-cache-negative-ttl
value Set thenarinfo-cache-negative-ttl
setting. -
--narinfo-cache-positive-ttl
value Set thenarinfo-cache-positive-ttl
setting. -
--netrc-file
value Set thenetrc-file
setting. -
--nix-path
value Set thenix-path
setting. -
--no-accept-flake-config
Disable theaccept-flake-config
setting. -
--no-allow-dirty
Disable theallow-dirty
setting. -
--no-allow-import-from-derivation
Disable theallow-import-from-derivation
setting. -
--no-allow-new-privileges
Disable theallow-new-privileges
setting. -
--no-allow-symlinked-store
Disable theallow-symlinked-store
setting. -
--no-allow-unsafe-native-code-during-evaluation
Disable theallow-unsafe-native-code-during-evaluation
setting. -
--no-auto-allocate-uids
Disable theauto-allocate-uids
setting. -
--no-auto-optimise-store
Disable theauto-optimise-store
setting. -
--no-builders-use-substitutes
Disable thebuilders-use-substitutes
setting. -
--no-compress-build-log
Disable thecompress-build-log
setting. -
--no-eval-cache
Disable theeval-cache
setting. -
--no-fallback
Disable thefallback
setting. -
--no-filter-syscalls
Disable thefilter-syscalls
setting. -
--no-fsync-metadata
Disable thefsync-metadata
setting. -
--no-http2
Disable thehttp2
setting. -
--no-ignore-try
Disable theignore-try
setting. -
--no-impersonate-linux-26
Disable theimpersonate-linux-26
setting. -
--no-keep-build-log
Disable thekeep-build-log
setting. -
--no-keep-derivations
Disable thekeep-derivations
setting. -
--no-keep-env-derivations
Disable thekeep-env-derivations
setting. -
--no-keep-failed
Disable thekeep-failed
setting. -
--no-keep-going
Disable thekeep-going
setting. -
--no-keep-outputs
Disable thekeep-outputs
setting. -
--no-preallocate-contents
Disable thepreallocate-contents
setting. -
--no-print-missing
Disable theprint-missing
setting. -
--no-pure-eval
Disable thepure-eval
setting. -
--no-require-drop-supplementary-groups
Disable therequire-drop-supplementary-groups
setting. -
--no-require-sigs
Disable therequire-sigs
setting. -
--no-restrict-eval
Disable therestrict-eval
setting. -
--no-run-diff-hook
Disable therun-diff-hook
setting. -
--no-sandbox
Disable sandboxing. -
--no-sandbox-fallback
Disable thesandbox-fallback
setting. -
--no-show-trace
Disable theshow-trace
setting. -
--no-substitute
Disable thesubstitute
setting. -
--no-sync-before-registering
Disable thesync-before-registering
setting. -
--no-trace-function-calls
Disable thetrace-function-calls
setting. -
--no-trace-verbose
Disable thetrace-verbose
setting. -
--no-use-case-hack
Disable theuse-case-hack
setting. -
--no-use-cgroups
Disable theuse-cgroups
setting. -
--no-use-registries
Disable theuse-registries
setting. -
--no-use-sqlite-wal
Disable theuse-sqlite-wal
setting. -
--no-use-xdg-base-directories
Disable theuse-xdg-base-directories
setting. -
--no-warn-dirty
Disable thewarn-dirty
setting. -
--plugin-files
value Set theplugin-files
setting. -
--post-build-hook
value Set thepost-build-hook
setting. -
--pre-build-hook
value Set thepre-build-hook
setting. -
--preallocate-contents
Enable thepreallocate-contents
setting. -
--print-missing
Enable theprint-missing
setting. -
--pure-eval
Enable thepure-eval
setting. -
--relaxed-sandbox
Enable sandboxing, but allow builds to disable it. -
--require-drop-supplementary-groups
Enable therequire-drop-supplementary-groups
setting. -
--require-sigs
Enable therequire-sigs
setting. -
--restrict-eval
Enable therestrict-eval
setting. -
--run-diff-hook
Enable therun-diff-hook
setting. -
--sandbox
Enable sandboxing. -
--sandbox-build-dir
value Set thesandbox-build-dir
setting. -
--sandbox-dev-shm-size
value Set thesandbox-dev-shm-size
setting. -
--sandbox-fallback
Enable thesandbox-fallback
setting. -
--sandbox-paths
value Set thesandbox-paths
setting. -
--secret-key-files
value Set thesecret-key-files
setting. -
--show-trace
Enable theshow-trace
setting. -
--ssl-cert-file
value Set thessl-cert-file
setting. -
--stalled-download-timeout
value Set thestalled-download-timeout
setting. -
--start-id
value Set thestart-id
setting. -
--store
value Set thestore
setting. -
--substitute
Enable thesubstitute
setting. -
--substituters
value Set thesubstituters
setting. -
--sync-before-registering
Enable thesync-before-registering
setting. -
--system
value Set thesystem
setting. -
--system-features
value Set thesystem-features
setting. -
--tarball-ttl
value Set thetarball-ttl
setting. -
--timeout
value Set thetimeout
setting. -
--trace-function-calls
Enable thetrace-function-calls
setting. -
--trace-verbose
Enable thetrace-verbose
setting. -
--trusted-public-keys
value Set thetrusted-public-keys
setting. -
--trusted-substituters
value Set thetrusted-substituters
setting. -
--trusted-users
value Set thetrusted-users
setting. -
--use-case-hack
Enable theuse-case-hack
setting. -
--use-cgroups
Enable theuse-cgroups
setting. -
--use-registries
Enable theuse-registries
setting. -
--use-sqlite-wal
Enable theuse-sqlite-wal
setting. -
--use-xdg-base-directories
Enable theuse-xdg-base-directories
setting. -
--user-agent-suffix
value Set theuser-agent-suffix
setting. -
--warn-dirty
Enable thewarn-dirty
setting.