0eaf29433e
Spaces inside <refname> cause stray double underscore in generated manual pages. Fixes #70468
154 lines
3.5 KiB
XML
154 lines
3.5 KiB
XML
<refentry xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude">
|
|
<refmeta>
|
|
<refentrytitle><command>nixos-enter</command>
|
|
</refentrytitle><manvolnum>8</manvolnum>
|
|
<refmiscinfo class="source">NixOS</refmiscinfo>
|
|
<!-- <refmiscinfo class="version"><xi:include href="version.txt" parse="text"/></refmiscinfo> -->
|
|
</refmeta>
|
|
<refnamediv>
|
|
<refname><command>nixos-enter</command></refname>
|
|
<refpurpose>run a command in a NixOS chroot environment</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
<cmdsynopsis>
|
|
<command>nixos-enter</command>
|
|
<arg>
|
|
<arg choice='plain'>
|
|
<option>--root</option>
|
|
</arg>
|
|
<replaceable>root</replaceable>
|
|
</arg>
|
|
|
|
<arg>
|
|
<arg choice='plain'>
|
|
<option>--system</option>
|
|
</arg>
|
|
<replaceable>system</replaceable>
|
|
</arg>
|
|
|
|
<arg>
|
|
<arg choice='plain'>
|
|
<option>-c</option>
|
|
</arg>
|
|
<replaceable>shell-command</replaceable>
|
|
</arg>
|
|
|
|
<arg>
|
|
<arg choice='plain'>
|
|
<option>--silent</option>
|
|
</arg>
|
|
</arg>
|
|
|
|
<arg>
|
|
<arg choice='plain'>
|
|
<option>--help</option>
|
|
</arg>
|
|
</arg>
|
|
|
|
<arg>
|
|
<arg choice='plain'>
|
|
<option>--</option>
|
|
</arg>
|
|
<replaceable>arguments</replaceable>
|
|
</arg>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
<refsection>
|
|
<title>Description</title>
|
|
<para>
|
|
This command runs a command in a NixOS chroot environment, that is, in a
|
|
filesystem hierarchy previously prepared using
|
|
<command>nixos-install</command>.
|
|
</para>
|
|
</refsection>
|
|
<refsection>
|
|
<title>Options</title>
|
|
<para>
|
|
This command accepts the following options:
|
|
</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>
|
|
<option>--root</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
The path to the NixOS system you want to enter. It defaults to
|
|
<filename>/mnt</filename>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<option>--system</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
The NixOS system configuration to use. It defaults to
|
|
<filename>/nix/var/nix/profiles/system</filename>. You can enter a
|
|
previous NixOS configuration by specifying a path such as
|
|
<filename>/nix/var/nix/profiles/system-106-link</filename>.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<option>--command</option>
|
|
</term>
|
|
<term>
|
|
<option>-c</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
The bash command to execute.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<option>--silent</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Suppresses all output from the activation script of the target system.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<option>--</option>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Interpret the remaining arguments as the program name and arguments to be
|
|
invoked. The program is not executed in a shell.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</refsection>
|
|
<refsection>
|
|
<title>Examples</title>
|
|
<para>
|
|
Start an interactive shell in the NixOS installation in
|
|
<filename>/mnt</filename>:
|
|
</para>
|
|
<screen>
|
|
# nixos-enter /mnt
|
|
</screen>
|
|
<para>
|
|
Run a shell command:
|
|
</para>
|
|
<screen>
|
|
# nixos-enter -c 'ls -l /; cat /proc/mounts'
|
|
</screen>
|
|
<para>
|
|
Run a non-shell command:
|
|
</para>
|
|
<screen>
|
|
# nixos-enter -- cat /proc/mounts
|
|
</screen>
|
|
</refsection>
|
|
</refentry>
|