summary refs log tree commit diff
path: root/nixos/doc
diff options
context:
space:
mode:
authorMaximilian Bosch <maximilian@mbosch.me>2019-12-22 22:03:14 +0100
committerMaximilian Bosch <maximilian@mbosch.me>2019-12-22 22:46:58 +0100
commit1fc248afccaa56777d0e5a96ceb3dfb099c52c9e (patch)
treee6c05b4dd163b9409b57781e6cc198c691acabd9 /nixos/doc
parent63fd2506424c82f21a25f0a449ad57c41ae92a4e (diff)
downloadnixpkgs-1fc248afccaa56777d0e5a96ceb3dfb099c52c9e.tar
nixpkgs-1fc248afccaa56777d0e5a96ceb3dfb099c52c9e.tar.gz
nixpkgs-1fc248afccaa56777d0e5a96ceb3dfb099c52c9e.tar.bz2
nixpkgs-1fc248afccaa56777d0e5a96ceb3dfb099c52c9e.tar.lz
nixpkgs-1fc248afccaa56777d0e5a96ceb3dfb099c52c9e.tar.xz
nixpkgs-1fc248afccaa56777d0e5a96ceb3dfb099c52c9e.tar.zst
nixpkgs-1fc248afccaa56777d0e5a96ceb3dfb099c52c9e.zip
nixos/nixos-installer: add flags for verbosity and build logs
When installing a fresh NixOS system it occasionally happens that you
encounter issues that are rather hard to track down since
`nixos-install(8)` doesn't provide any debugging flags.

This patch adds `-L` to force `nix build` to display the build-log on
stderr and `-v` to increase the log-level of Nix.
Diffstat (limited to 'nixos/doc')
-rw-r--r--nixos/doc/manual/man-nixos-install.xml37
1 files changed, 37 insertions, 0 deletions
diff --git a/nixos/doc/manual/man-nixos-install.xml b/nixos/doc/manual/man-nixos-install.xml
index 45bbd5d81ff..93082f914be 100644
--- a/nixos/doc/manual/man-nixos-install.xml
+++ b/nixos/doc/manual/man-nixos-install.xml
@@ -15,6 +15,26 @@
   <cmdsynopsis>
    <command>nixos-install</command>
    <arg>
+    <group choice='req'>
+     <arg choice='plain'>
+      <option>--verbose</option>
+     </arg>
+     <arg choice='plain'>
+      <option>-v</option>
+     </arg>
+    </group>
+   </arg>
+   <arg>
+    <group choice='req'>
+     <arg choice='plain'>
+      <option>--print-build-logs</option>
+     </arg>
+     <arg choice='plain'>
+      <option>-L</option>
+     </arg>
+    </group>
+   </arg>
+   <arg>
     <arg choice='plain'>
      <option>-I</option>
     </arg>
@@ -135,6 +155,23 @@
   </para>
   <variablelist>
    <varlistentry>
+    <term><option>--verbose</option> / <option>-v</option></term>
+    <listitem>
+     <para>Increases the level of verbosity of diagnostic messages
+     printed on standard error.  For each Nix operation, the information
+     printed on standard output is well-defined; any diagnostic
+     information is printed on standard error, never on standard
+     output.</para>
+     <para>Please note that this option may be specified repeatedly.</para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><option>--print-build-logs</option> / <option>-L</option></term>
+    <listitem>
+     <para>Print the full build logs of <command>nix build</command> to stderr.</para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
     <term>
      <option>--root</option>
     </term>