about summary refs log tree commit diff
path: root/doc/manual/command-ref
AgeCommit message (Collapse)AuthorFilesLines
2019-08-29 Reword to clarify newer generations are left alonetoonn1-1/+4
My attempt at clarifying the docs resulted in a false explanation. This is now fixed and I added an example to eliminate all possible confusion.
2019-08-17 Fix nix-env documentation for --delete-generationsToon Nolten1-4/+4
The documentation for `--delete-generations` had an erroneous fullstop and as it turns out inaccurate information on the `+No.` syntax.
2019-08-15 Merge pull request #2945 from danidiaz/doc001Eelco Dolstra1-9/+31
Expanded documentation for .nix-defexpr
2019-08-15 Merge pull request #2782 from grahamc/flamesEelco Dolstra1-0/+28
Track function start and end
2019-08-15 Expanded documentation for .nix-defexprDaniel Diaz1-9/+31
2019-08-14 Track function start and ends for flame graphsGraham Christensen1-0/+28
With this patch, and this file I called `log.py`: #!/usr/bin/env nix-shell #!nix-shell -i python3 -p python3 --pure import sys from pprint import pprint stack = [] timestack = [] for line in open(sys.argv[1]): components = line.strip().split(" ", 2) if components[0] != "function-trace": continue direction = components[1] components = components[2].rsplit(" ", 2) loc = components[0] _at = components[1] time = int(components[2]) if direction == "entered": stack.append(loc) timestack.append(time) elif direction == "exited": dur = time - timestack.pop() vst = ";".join(stack) print(f"{vst} {dur}") stack.pop() and: nix-instantiate --trace-function-calls -vvvv ../nixpkgs/pkgs/top-level/release.nix -A unstable > log.matthewbauer 2>&1 ./log.py ./log.matthewbauer > log.matthewbauer.folded flamegraph.pl --title matthewbauer-post-pr log.matthewbauer.folded > log.matthewbauer.folded.svg I can make flame graphs like: http://gsc.io/log.matthewbauer.folded.svg --- Includes test cases around function call failures and tryEval. Uses RAII so the finish is always called at the end of the function.
2019-08-08 conf: stalled-download-timeout: make tunableGraham Christensen1-0/+8
Make curl's low speed limit configurable via stalled-download-timeout. Before, this limit was five minutes without receiving a single byte. This is much too long as if the remote end may not have even acknowledged the HTTP request.
2019-08-07 fixup: docs for post-build-hookGraham Christensen1-1/+1
2019-08-07 Merge pull request #2995 from tweag/post-build-hookEelco Dolstra1-0/+56
Add a post build hook
2019-08-06 post-build-hook: docs fixupGraham Christensen1-1/+2
2019-08-02 Add a post-build-hookregnat1-0/+55
Passing `--post-build-hook /foo/bar` to a nix-* command will cause `/foo/bar` to be executed after each build with the following environment variables set: DRV_PATH=/nix/store/drv-that-has-been-built.drv OUT_PATHS=/nix/store/...build /nix/store/...build-bin /nix/store/...build-dev This can be useful in particular to upload all the builded artifacts to the cache (including the ones that don't appear in the runtime closure of the final derivation or are built because of IFD). This new feature prints the stderr/stdout output to the `nix-build` and `nix build` client, and the output is printed in a Nix 2 compatible format: [nix]$ ./inst/bin/nix-build ./test.nix these derivations will be built: /nix/store/ishzj9ni17xq4hgrjvlyjkfvm00b0ch9-my-example-derivation.drv building '/nix/store/ishzj9ni17xq4hgrjvlyjkfvm00b0ch9-my-example-derivation.drv'... hello! bye! running post-build-hook '/home/grahamc/projects/github.com/NixOS/nix/post-hook.sh'... post-build-hook: + sleep 1 post-build-hook: + echo 'Signing paths' /nix/store/qr213vjmibrqwnyp5fw678y7whbkqyny-my-example-derivation post-build-hook: Signing paths /nix/store/qr213vjmibrqwnyp5fw678y7whbkqyny-my-example-derivation post-build-hook: + sleep 1 post-build-hook: + echo 'Uploading paths' /nix/store/qr213vjmibrqwnyp5fw678y7whbkqyny-my-example-derivation post-build-hook: Uploading paths /nix/store/qr213vjmibrqwnyp5fw678y7whbkqyny-my-example-derivation post-build-hook: + sleep 1 post-build-hook: + printf 'very important stuff' /nix/store/qr213vjmibrqwnyp5fw678y7whbkqyny-my-example-derivation [nix-shell:~/projects/github.com/NixOS/nix]$ ./inst/bin/nix build -L -f ./test.nix my-example-derivation> hello! my-example-derivation> bye! my-example-derivation (post)> + sleep 1 my-example-derivation (post)> + echo 'Signing paths' /nix/store/c263gzj2kb2609mz8wrbmh53l14wzmfs-my-example-derivation my-example-derivation (post)> Signing paths /nix/store/c263gzj2kb2609mz8wrbmh53l14wzmfs-my-example-derivation my-example-derivation (post)> + sleep 1 my-example-derivation (post)> + echo 'Uploading paths' /nix/store/c263gzj2kb2609mz8wrbmh53l14wzmfs-my-example-derivation my-example-derivation (post)> Uploading paths /nix/store/c263gzj2kb2609mz8wrbmh53l14wzmfs-my-example-derivation my-example-derivation (post)> + sleep 1 my-example-derivation (post)> + printf 'very important stuff' [1 built, 0.0 MiB DL] Co-authored-by: Graham Christensen <graham@grahamc.com> Co-authored-by: Eelco Dolstra <edolstra@gmail.com>
2019-08-02 Tweak min-free/max-free descriptionsEelco Dolstra1-5/+9
2019-07-19 docs: document balancing cores and max-jobsGraham Christensen1-2/+6
2019-07-06 Merge pull request #2882 from grahamc/docs/1115-tarball-ttlEelco Dolstra1-0/+25
tarball-ttl: document
2019-07-05 tarball-ttl: documentGraham Christensen1-0/+25
Incorporates text from Niklas Hambüchen in #2978 Closes #1115
2019-07-02 Merge pull request #2779 from LnL7/build-exit-codesEelco Dolstra1-0/+42
build: add exit code for hash and check mismatches
2019-07-02 Merge pull request #2724 from LnL7/manpage-add-fixedEelco Dolstra1-0/+54
nix-store: document --add-fixed
2019-07-02 nix-store: document --add-fixedDaiderd Jordan1-0/+54
2019-07-02 build: replace 100 offset for build exit codesDaiderd Jordan1-2/+9
2019-07-02 nix-store: document exit codesDaiderd Jordan1-0/+35
2019-06-25 nix-channel: Don't fetch binary-cache-urlEelco Dolstra1-18/+5
This has been ignored since the Perl->C++ rewrite.
2019-05-17 docs: describe $IN_NIX_SHELL values (#2796)Vladimír Čunát1-1/+2
See commit 1bffd83e1a9
2019-05-12 Clarify where output from the diff hook goes.Graham Christensen1-4/+5
2019-05-12 diff hook: execute as the build user, and pass the temp dirGraham Christensen1-7/+13
2019-05-12 build: run diff-hook under --check and document diff-hookGraham Christensen1-4/+77
2019-03-31 docs: Mention `--max-jobs 0` to build remotely onlyNiklas Hambüchen1-2/+10
2019-03-25 manual: mention the "channel:" shorthand for NIX_PATHDmitry Kalinkin1-2/+7
Bumped to 15.09 because older channels, when downloaded from nixos.org, require firefox to be accessed via `pkgs.firefox`
2019-01-23 nix-store: make --dump-db take a list of paths to dumpSpencer Baugh1-0/+8
Inside a derivation, exportReferencesGraph already provides a way to dump the Nix database for a specific closure. On the command line, --dump-db gave us the same information, but only for the entire Nix database at once. With this change, one can now pass a list of paths to --dump-db to get the Nix database dumped for just those paths. (The user is responsible for ensuring this is a closure, like for --export). Among other things, this is useful for deploying a closure to a new host without using --import/--export; one can use tar to transfer the store paths, and --dump-db/--load-db to transfer the validity information. This is useful if the new host doesn't actually have Nix yet, and the closure that is being deployed itself contains Nix.
2019-01-20 Merge pull request #2635 from veprbl/patch-7Domen Kožar1-1/+2
manual: "sandbox" option default is "true" on Linux
2019-01-19 manual: "sandbox" option default is "true" on LinuxDmitry Kalinkin1-1/+2
Fixes: 812e39313c ('Enable sandboxing by default')
2019-01-18 Update instructions for Haskell script using nix-shell interpreterSamuel Evans-Powell1-1/+1
- The instructions for using nix-shell as an interpreter has a Haskell script example that doesn't work on more recent versions of Nix. Update the instructions with a working command
2019-01-07 Don't look for a "pv" program, or mention it in the manual sourceJohn Ericson1-9/+0
The manual reference was commented out, and the sole reference to this program other than the configure script. Removed both.
2018-12-14 Clarify nix-instantiate --read-write-modePatrick Hilhorst1-1/+3
2018-10-20 Add --graphml option to the nix-store --query commandAntoine Eiche1-0/+12
This prints the references graph of the store paths in the graphML format [1]. The graphML format is supported by several graph tools such as the Python Networkx library or the Apache Thinkerpop project. [1] http://graphml.graphdrawing.org
2018-09-28 Check requiredSystemFeatures for local buildsEelco Dolstra1-0/+27
For example, this prevents a "kvm" build on machines that don't have KVM. Fixes #2012.
2018-09-19 nix-shell: document double quotes being necessary for a simple Nix ↵Graham Christensen1-0/+14
expression in the shebang
2018-09-19 nix-shell: explain the merging property close to the exampleGraham Christensen1-3/+4
2018-09-18 docs: document deprecated aliasesGraham Christensen1-22/+169
2018-09-10 Prefer 'remote builder' over 'slave'Graham Christensen1-1/+1
2018-09-01 Merge pull request #2168 from grahamc/explain-why-netrc-is-bustedEelco Dolstra1-1/+6
manual: document why ~/.netrc doesn't work
2018-08-29 nix.conf: clarify -j0 doesn't affect preferLocalBuildDomen Kožar1-1/+3
2018-08-29 nix.conf: mention -j0 is usefulDomen Kožar1-1/+2
2018-08-02 Allows selectively adding environment variables to pure shells.Samuel Dionne-Riel1-0/+8
Includes documentation and test.
2018-05-31 Merge pull request #767 from mogorman/garbage_collect_keep_last_fewPeter Simons1-6/+9
Implement --delete-generations + flag for keeping last N number of gens
2018-05-23 Fix docs on --check suffixAlexandre Esteves1-1/+1
2018-05-18 manual: document why ~/.netrc doesn't workGraham Christensen1-1/+6
Maybe there is a better place to document this, which is more generic?
2018-04-30 nix-collect-garbage: little doc fixDanylo Hlynskyi1-6/+0
This removes confusing documentation. It's better to remove doc than add implementation, because Nix 1.12 will surely have new GC interface anyway. Fixes https://github.com/NixOS/nix/issues/641
2018-04-23 Merge branch 'aarch64-armv7' of git://github.com/lheckemann/nixShea Levy1-0/+19
Support extra compatible architectures (#1916)
2018-04-20 doc: Adds `--quiet` to the common options.Samuel Dionne-Riel2-0/+20
Fixes #1298
2018-04-07 fix typo in nix-env man pageNicolas Dudebout1-1/+1