forked from mirrors/nixpkgs
98 lines
2.6 KiB
XML
98 lines
2.6 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-version</command></refentrytitle>
|
|
<manvolnum>8</manvolnum>
|
|
<refmiscinfo class="source">NixOS</refmiscinfo>
|
|
</refmeta>
|
|
|
|
<refnamediv>
|
|
<refname><command>nixos-version</command></refname>
|
|
<refpurpose>show the NixOS version</refpurpose>
|
|
</refnamediv>
|
|
|
|
<refsynopsisdiv>
|
|
<cmdsynopsis>
|
|
<command>nixos-version</command>
|
|
<arg><option>--hash</option></arg>
|
|
<arg><option>--revision</option></arg>
|
|
</cmdsynopsis>
|
|
</refsynopsisdiv>
|
|
|
|
<refsection><title>Description</title>
|
|
|
|
<para>This command shows the version of the currently active NixOS
|
|
configuration. For example:
|
|
|
|
<screen>$ nixos-version
|
|
16.03.1011.6317da4 (Emu)
|
|
</screen>
|
|
|
|
The version consists of the following elements:
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><literal>16.03</literal></term>
|
|
<listitem><para>The NixOS release, indicating the year and month
|
|
in which it was released (e.g. March 2016).</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><literal>1011</literal></term>
|
|
<listitem><para>The number of commits in the Nixpkgs Git
|
|
repository between the start of the release branch and the commit
|
|
from which this version was built. This ensures that NixOS
|
|
versions are monotonically increasing. It is
|
|
<literal>git</literal> when the current NixOS configuration was
|
|
built from a checkout of the Nixpkgs Git repository rather than
|
|
from a NixOS channel.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><literal>6317da4</literal></term>
|
|
<listitem><para>The first 7 characters of the commit in the
|
|
Nixpkgs Git repository from which this version was
|
|
built.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><literal>Emu</literal></term>
|
|
<listitem><para>The code name of the NixOS release. The first
|
|
letter of the code name indicates that this is the N'th stable
|
|
NixOS release; for example, Emu is the fifth
|
|
release.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</para>
|
|
|
|
</refsection>
|
|
|
|
|
|
<refsection><title>Options</title>
|
|
|
|
<para>This command accepts the following options:</para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><option>--hash</option></term>
|
|
<term><option>--revision</option></term>
|
|
<listitem>
|
|
<para>Show the full SHA1 hash of the Git commit from which this
|
|
configuration was built, e.g.
|
|
<screen>$ nixos-version --hash
|
|
6317da40006f6bc2480c6781999c52d88dde2acf
|
|
</screen>
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
|
|
</refsection>
|
|
</refentry>
|