.\" 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 shell (GNU Guix) 1.3.0.27848-a3264
.SH SYNOPSIS
.B guix
\fI\,shell \/\fR[\fI\,OPTION\/\fR] \fI\,PACKAGES\/\fR... [\fI\,-- COMMAND\/\fR...]
.SH DESCRIPTION
Build an environment that includes PACKAGES and execute COMMAND or an
interactive shell in that environment.
.TP
\fB\-D\fR, \fB\-\-development\fR
include the development inputs of the next package
.TP
\fB\-f\fR, \fB\-\-file\fR=\fI\,FILE\/\fR
add to the environment the package FILE evaluates to
.TP
\fB\-q\fR
inhibit loading of 'guix.scm' and 'manifest.scm'
.TP
\fB\-\-rebuild\-cache\fR
rebuild cached environment, if any
.TP
\fB\-\-export\-manifest\fR
print a manifest for the given options
.TP
\fB\-F\fR, \fB\-\-emulate\-fhs\fR
for containers, emulate the Filesystem Hierarchy
Standard (FHS)
.TP
\fB\-e\fR, \fB\-\-expression\fR=\fI\,EXPR\/\fR
create environment for the package that EXPR
evaluates to
.TP
\fB\-m\fR, \fB\-\-manifest\fR=\fI\,FILE\/\fR
create environment with the manifest from FILE
.TP
\fB\-p\fR, \fB\-\-profile\fR=\fI\,PATH\/\fR
create environment from profile at PATH
.TP
\fB\-\-check\fR
check if the shell clobbers environment variables
.TP
\fB\-\-pure\fR
unset existing environment variables
.TP
\fB\-E\fR, \fB\-\-preserve\fR=\fI\,REGEXP\/\fR
preserve environment variables that match REGEXP
.TP
\fB\-\-search\-paths\fR
display needed environment variable definitions
.TP
\fB\-r\fR, \fB\-\-root\fR=\fI\,FILE\/\fR
make FILE a symlink to the result, and register it
as a garbage collector root
.TP
\fB\-C\fR, \fB\-\-container\fR
run command within an isolated container
.TP
\fB\-N\fR, \fB\-\-network\fR
allow containers to access the network
.TP
\fB\-P\fR, \fB\-\-link\-profile\fR
link environment profile to ~/.guix\-profile within
an isolated container
.TP
\fB\-u\fR, \fB\-\-user\fR=\fI\,USER\/\fR
instead of copying the name and home of the current
user into an isolated container, use the name USER
with home directory \fI\,/home/USER\/\fP
.TP
\fB\-\-no\-cwd\fR
do not share current working directory with an
isolated container
.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\-S\fR, \fB\-\-symlink\fR=\fI\,SPEC\/\fR
for containers, add symlinks to the profile according
to SPEC, e.g. "/usr/bin/env=bin/env".
.TP
\fB\-v\fR, \fB\-\-verbosity\fR=\fI\,LEVEL\/\fR
use the given verbosity LEVEL
.TP
\fB\-\-bootstrap\fR
use bootstrap binaries to build the environment
.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\-\-help\-transform\fR
list package transformation options not shown here
.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.