diff options
author | John Ericson <git@JohnEricson.me> | 2019-03-24 16:33:46 -0400 |
---|---|---|
committer | John Ericson <git@JohnEricson.me> | 2019-03-24 22:12:15 -0400 |
commit | ceb27efde0532bb663e3d8c4fe20f82ee4dc22e3 (patch) | |
tree | 34d1f95ade30cae4419ef5b6400fa8abc1412115 /doc/stdenv.xml | |
parent | 3b27113a7c361cffebcf111b05f45e1b553cabbf (diff) | |
download | nixlib-ceb27efde0532bb663e3d8c4fe20f82ee4dc22e3.tar nixlib-ceb27efde0532bb663e3d8c4fe20f82ee4dc22e3.tar.gz nixlib-ceb27efde0532bb663e3d8c4fe20f82ee4dc22e3.tar.bz2 nixlib-ceb27efde0532bb663e3d8c4fe20f82ee4dc22e3.tar.lz nixlib-ceb27efde0532bb663e3d8c4fe20f82ee4dc22e3.tar.xz nixlib-ceb27efde0532bb663e3d8c4fe20f82ee4dc22e3.tar.zst nixlib-ceb27efde0532bb663e3d8c4fe20f82ee4dc22e3.zip |
manual: Auto reformat
Diffstat (limited to 'doc/stdenv.xml')
-rw-r--r-- | doc/stdenv.xml | 29 |
1 files changed, 14 insertions, 15 deletions
diff --git a/doc/stdenv.xml b/doc/stdenv.xml index a3990dec052f..7e6c589d9fe9 100644 --- a/doc/stdenv.xml +++ b/doc/stdenv.xml @@ -2633,21 +2633,20 @@ addEnvHooks "$hostOffset" myBashFunction happens. It prevents nix from cleaning up the build environment immediately and allows the user to attach to a build environment using the <command>cntr</command> command. Upon build error it will print - instructions on how to use <command>cntr</command>, which can be used - to enter the environment for debugging. Installing cntr and - running the command will provide shell access to the build sandbox of - failed build. At <filename>/var/lib/cntr</filename> the sandboxed - filesystem is mounted. All commands and files of the system are still - accessible within the shell. To execute commands from the sandbox use - the cntr exec subcommand. Note that <command>cntr</command> also needs - to be executed on the machine that is doing the build, which might not - be the case when remote builders are enabled. <command>cntr</command> is - only supported on Linux-based platforms. To use it first add - <literal>cntr</literal> to your - <literal>environment.systemPackages</literal> on NixOS or alternatively - to the root user on non-NixOS systems. Then in the package that is - supposed to be inspected, add <literal>breakpointHook</literal> to - <literal>nativeBuildInputs</literal>. + instructions on how to use <command>cntr</command>, which can be used to + enter the environment for debugging. Installing cntr and running the + command will provide shell access to the build sandbox of failed build. + At <filename>/var/lib/cntr</filename> the sandboxed filesystem is + mounted. All commands and files of the system are still accessible + within the shell. To execute commands from the sandbox use the cntr exec + subcommand. Note that <command>cntr</command> also needs to be executed + on the machine that is doing the build, which might not be the case when + remote builders are enabled. <command>cntr</command> is only supported + on Linux-based platforms. To use it first add <literal>cntr</literal> to + your <literal>environment.systemPackages</literal> on NixOS or + alternatively to the root user on non-NixOS systems. Then in the package + that is supposed to be inspected, add <literal>breakpointHook</literal> + to <literal>nativeBuildInputs</literal>. <programlisting> nativeBuildInputs = [ breakpointHook ]; </programlisting> |