nixpkgs/nixos/doc/manual/man-nixos-option.xml

138 lines
3.3 KiB
XML
Raw Normal View History

<refentry xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:xi="http://www.w3.org/2001/XInclude">
2018-05-01 23:57:09 +00:00
<refmeta>
<refentrytitle><command>nixos-option</command>
</refentrytitle><manvolnum>8</manvolnum>
<refmiscinfo class="source">NixOS</refmiscinfo>
2018-05-01 23:57:09 +00:00
<!-- <refmiscinfo class="version"><xi:include href="version.txt" parse="text"/></refmiscinfo> -->
</refmeta>
<refnamediv>
<refname><command>nixos-option</command>
</refname><refpurpose>inspect a NixOS configuration</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>nixos-option</command>
<arg>
<option>-I</option> <replaceable>path</replaceable>
2018-05-01 23:57:09 +00:00
</arg>
<arg>
<option>--verbose</option>
2018-05-01 23:57:09 +00:00
</arg>
<arg>
<option>--xml</option>
2018-05-01 23:57:09 +00:00
</arg>
<arg choice="plain">
<replaceable>option.name</replaceable>
2018-05-01 23:57:09 +00:00
</arg>
</cmdsynopsis>
2018-05-01 23:57:09 +00:00
</refsynopsisdiv>
<refsection>
<title>Description</title>
<para>
This command evaluates the configuration specified in
<filename>/etc/nixos/configuration.nix</filename> and returns the properties
of the option name given as argument.
</para>
<para>
When the option name is not an option, the command prints the list of
attributes contained in the attribute set.
</para>
</refsection>
<refsection>
<title>Options</title>
<para>
This command accepts the following options:
</para>
<variablelist>
<varlistentry>
<term>
<option>-I</option> <replaceable>path</replaceable>
2018-05-01 23:57:09 +00:00
</term>
2017-08-03 21:42:08 +00:00
<listitem>
2018-05-01 23:57:09 +00:00
<para>
This option is passed to the underlying
<command>nix-instantiate</command> invocation.
</para>
2017-08-03 21:42:08 +00:00
</listitem>
2018-05-01 23:57:09 +00:00
</varlistentry>
<varlistentry>
<term>
<option>--verbose</option>
2018-05-01 23:57:09 +00:00
</term>
2017-08-03 21:42:08 +00:00
<listitem>
2018-05-01 23:57:09 +00:00
<para>
This option enables verbose mode, which currently is just the Bash
<command>set</command> <option>-x</option> debug mode.
</para>
2017-08-03 21:42:08 +00:00
</listitem>
2018-05-01 23:57:09 +00:00
</varlistentry>
<varlistentry>
<term>
<option>--xml</option>
2018-05-01 23:57:09 +00:00
</term>
2017-08-03 21:42:08 +00:00
<listitem>
2018-05-01 23:57:09 +00:00
<para>
This option causes the output to be rendered as XML.
</para>
2017-08-03 21:42:08 +00:00
</listitem>
2018-05-01 23:57:09 +00:00
</varlistentry>
</variablelist>
</refsection>
<refsection>
<title>Environment</title>
<variablelist>
<varlistentry>
<term>
<envar>NIXOS_CONFIG</envar>
2018-05-01 23:57:09 +00:00
</term>
<listitem>
2018-05-01 23:57:09 +00:00
<para>
Path to the main NixOS configuration module. Defaults to
<filename>/etc/nixos/configuration.nix</filename>.
</para>
</listitem>
2018-05-01 23:57:09 +00:00
</varlistentry>
</variablelist>
</refsection>
<refsection>
<title>Examples</title>
<para>
Investigate option values:
<screen>$ nixos-option boot.loader
This attribute set contains:
generationsDir
grub
initScript
$ nixos-option boot.loader.grub.enable
Value:
true
Default:
true
Description:
Whether to enable the GNU GRUB boot loader.
Declared by:
"/nix/var/nix/profiles/per-user/root/channels/nixos/nixpkgs/nixos/modules/system/boot/loader/grub/grub.nix"
Defined by:
"/nix/var/nix/profiles/per-user/root/channels/nixos/nixpkgs/nixos/modules/system/boot/loader/grub/grub.nix"
2018-05-01 23:57:09 +00:00
</screen>
</para>
</refsection>
<refsection>
<title>Bugs</title>
<para>
The author listed in the following section is wrong. If there is any other
bug, please report to Nicolas Pierron.
</para>
</refsection>
</refentry>