guix-system - manual page for guix system (GNU Guix) 1.4.0rc2

NAME SYNOPSIS DESCRIPTION REPORTING BUGS COPYRIGHT SEE ALSO

NAME

guix − manual page for guix system (GNU Guix) 1.4.0rc2

SYNOPSIS

guix system [OPTION ...] ACTION [ARG ...] [FILE]

DESCRIPTION

Build the operating system declared in FILE according to ACTION. Some ACTIONS support additional ARGS.

The valid values for ACTION are:

	search		search for existing service types
	edit		edit the definition of an existing service type

reconfigure

switch to a new operating system configuration

roll−back

switch to the previous operating system configuration

describe

describe the current system

list−generations list the system generations switch−generation switch to an existing operating system configuration delete−generations delete old system generations build build the operating system without installing anything container build a container that shares the host’s store vm build a virtual machine image that shares the host’s store image build a Guix System image docker−image build a Docker image init initialize a root file system to run GNU extension−graph emit the service extension graph in Dot format shepherd−graph emit the graph of shepherd services in Dot format

−L, −−load−path=DIR

prepend DIR to the package module search path

−K, −−keep−failed

keep build tree of failed builds

−k, −−keep−going

keep going when some of the derivations fail

−n, −−dry−run

do not build the derivations

−−fallback

fall back to building when the substituter fails

−−no−substitutes

build instead of resorting to pre−built substitutes

−−substitute−urls=URLS

fetch substitute from URLS if they are authorized

−−no−grafts

do not graft packages

−−no−offload

do not attempt to offload builds

−−max−silent−time=SECONDS

mark the build as failed after SECONDS of silence

−−timeout=SECONDS

mark the build as failed after SECONDS of activity

−−rounds=N

build N times in a row to detect non−determinism

−c, −−cores=N

allow the use of up to N CPU cores for the build

−M, −−max−jobs=N

allow at most N build jobs

−−debug=LEVEL

produce debugging output at LEVEL

−d, −−derivation

return the derivation of the given system

−e, −−expression=EXPR

consider the operating−system EXPR evaluates to instead of reading FILE, when applicable

−−allow−downgrades for ’reconfigure’, allow downgrades to earlier

channel revisions

−−on−error=STRATEGY

apply STRATEGY (one of nothing−special, backtrace, or debug) when an error occurs while reading FILE

−−list−image−types list available image types

−t, −−image−type=TYPE

for ’image’, produce an image of TYPE

−−image−size=SIZE

for ’image’, produce an image of SIZE

−−no−bootloader

for ’init’, do not install a bootloader

−−volatile

for ’image’, make the root file system volatile

−−persistent

for ’vm’, make the root file system persistent

−−label=LABEL

for ’image’, label disk image with LABEL

−−save−provenance

save provenance information

−−share=SPEC

for ’vm’ and ’container’, share host file system with read/write access according to SPEC

−−expose=SPEC

for ’vm’ and ’container’, expose host file system directory as read−only according to SPEC

−N, −−network

for ’container’, allow containers to access the network

−r, −−root=FILE

for ’vm’, ’image’, ’container’ and ’build’, make FILE a symlink to the result, and register it as a garbage collector root

−−full−boot

for ’vm’, make a full boot sequence

−−no−graphic

for ’vm’, use the tty that we are started in for IO

−−skip−checks

skip file system and initrd module safety checks

−−target=TRIPLET

cross−build for TRIPLET−−e.g., "armel−linux−gnu"

−v, −−verbosity=LEVEL

use the given verbosity LEVEL

−−graph−backend=BACKEND

use BACKEND for ’extension−graph’ and ’shepherd−graph’

−I, −−list−installed[=REGEXP]

for ’describe’ and ’list−generations’, list installed packages matching REGEXP

−−list−targets

list available targets

−−target=TRIPLET

cross−build for TRIPLET−−e.g., "aarch64−linux−gnu"

−−list−systems

list available systems

−s, −−system=SYSTEM

attempt to build for SYSTEM−−e.g., "i686−linux"

−h, −−help

display this help and exit

−V, −−version

display version information and exit

REPORTING BUGS

Report bugs to: bug−[email protected].
GNU Guix home page: <https://www.gnu.org/software/guix/>
General help using Guix and GNU software: <https://guix.gnu.org/en/help/>

COPYRIGHT

Copyright © 2022 the Guix authors License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.