.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.5.
.TH GUIX "1" "November 2022" "GNU" "User Commands"
.SH NAME
guix \- manual page for guix show (GNU Guix) 1.3.0.27848-a3264
.SH SYNOPSIS
.B guix
\fI\,home \/\fR[\fI\,OPTION \/\fR...] \fI\,ACTION \/\fR[\fI\,ARG \/\fR...] [\fI\,FILE\/\fR]
.SH DESCRIPTION
Build the home environment declared in FILE according to ACTION.
Some ACTIONS support additional ARGS.
.PP
The valid values for ACTION are:
.TP
search
search for existing service types
.TP
edit
edit the definition of an existing service type
.TP
container
run the home environment configuration in a container
.TP
reconfigure
switch to a new home environment configuration
.TP
roll\-back
switch to the previous home environment configuration
.TP
describe
describe the current home environment
.TP
list\-generations
list the home environment generations
.TP
switch\-generation
switch to an existing home environment configuration
.IP
delete\-generations delete old home environment generations
build              build the home environment without installing anything
import             generates a home environment definition from dotfiles
extension\-graph    emit the service extension graph
shepherd\-graph     emit the graph of shepherd services
.TP
\fB\-L\fR, \fB\-\-load\-path\fR=\fI\,DIR\/\fR
prepend DIR to the package module search path
.TP
\fB\-K\fR, \fB\-\-keep\-failed\fR
keep build tree of failed builds
.TP
\fB\-k\fR, \fB\-\-keep\-going\fR
keep going when some of the derivations fail
.TP
\fB\-n\fR, \fB\-\-dry\-run\fR
do not build the derivations
.TP
\fB\-\-fallback\fR
fall back to building when the substituter fails
.TP
\fB\-\-no\-substitutes\fR
build instead of resorting to pre\-built substitutes
.TP
\fB\-\-substitute\-urls\fR=\fI\,URLS\/\fR
fetch substitute from URLS if they are authorized
.TP
\fB\-\-no\-grafts\fR
do not graft packages
.TP
\fB\-\-no\-offload\fR
do not attempt to offload builds
.TP
\fB\-\-max\-silent\-time\fR=\fI\,SECONDS\/\fR
mark the build as failed after SECONDS of silence
.TP
\fB\-\-timeout\fR=\fI\,SECONDS\/\fR
mark the build as failed after SECONDS of activity
.TP
\fB\-\-rounds\fR=\fI\,N\/\fR
build N times in a row to detect non\-determinism
.TP
\fB\-c\fR, \fB\-\-cores\fR=\fI\,N\/\fR
allow the use of up to N CPU cores for the build
.TP
\fB\-M\fR, \fB\-\-max\-jobs\fR=\fI\,N\/\fR
allow at most N build jobs
.TP
\fB\-\-debug\fR=\fI\,LEVEL\/\fR
produce debugging output at LEVEL
.TP
\fB\-e\fR, \fB\-\-expression\fR=\fI\,EXPR\/\fR
consider the home\-environment EXPR evaluates to
instead of reading FILE, when applicable
.TP
\fB\-\-allow\-downgrades\fR for 'reconfigure', allow downgrades to earlier
channel revisions
.TP
\fB\-N\fR, \fB\-\-network\fR
allow containers to access the network
.TP
\fB\-\-share\fR=\fI\,SPEC\/\fR
for containers, share writable host file system
according to SPEC
.TP
\fB\-\-expose\fR=\fI\,SPEC\/\fR
for containers, expose read\-only host file system
according to SPEC
.TP
\fB\-v\fR, \fB\-\-verbosity\fR=\fI\,LEVEL\/\fR
use the given verbosity LEVEL
.TP
\fB\-\-graph\-backend\fR=\fI\,BACKEND\/\fR
use BACKEND for 'extension\-graph' and 'shepherd\-graph'
.TP
\fB\-I\fR, \fB\-\-list\-installed\fR[=\fI\,REGEXP\/\fR]
for 'describe' or 'list\-generations', list installed
packages matching REGEXP
.TP
\fB\-h\fR, \fB\-\-help\fR
display this help and exit
.TP
\fB\-V\fR, \fB\-\-version\fR
display version information and exit
.SH "REPORTING BUGS"
Report bugs to: bug\-guix@gnu.org.
.br
GNU Guix home page: <https://www.gnu.org/software/guix/>
.br
General help using Guix and GNU software: <https://guix.gnu.org/en/help/>
.SH COPYRIGHT
Copyright \(co 2022 the Guix authors
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B guix
is maintained as a Texinfo manual.  If the
.B info
and
.B guix
programs are properly installed at your site, the command
.IP
.B info guix
.PP
should give you access to the complete manual.