guix-shell - manual page for guix shell (GNU Guix) 1.3.0.27848-a3264

NAME SYNOPSIS DESCRIPTION REPORTING BUGS COPYRIGHT SEE ALSO

NAME

guix − manual page for guix shell (GNU Guix) 1.3.0.27848-a3264

SYNOPSIS

guix shell [OPTION] PACKAGES... [-- COMMAND...]

DESCRIPTION

Build an environment that includes PACKAGES and execute COMMAND or an interactive shell in that environment.
−D, −−development

include the development inputs of the next package

−f, −−file=FILE

add to the environment the package FILE evaluates to

−q

inhibit loading of ’guix.scm’ and ’manifest.scm’

−−rebuild−cache

rebuild cached environment, if any

−−export−manifest

print a manifest for the given options

−F, −−emulate−fhs

for containers, emulate the Filesystem Hierarchy Standard (FHS)

−e, −−expression=EXPR

create environment for the package that EXPR evaluates to

−m, −−manifest=FILE

create environment with the manifest from FILE

−p, −−profile=PATH

create environment from profile at PATH

−−check

check if the shell clobbers environment variables

−−pure

unset existing environment variables

−E, −−preserve=REGEXP

preserve environment variables that match REGEXP

−−search−paths

display needed environment variable definitions

−r, −−root=FILE

make FILE a symlink to the result, and register it as a garbage collector root

−C, −−container

run command within an isolated container

−N, −−network

allow containers to access the network

−P, −−link−profile

link environment profile to ˜/.guix−profile within an isolated container

−u, −−user=USER

instead of copying the name and home of the current user into an isolated container, use the name USER with home directory /home/USER

−−no−cwd

do not share current working directory with an isolated container

−−share=SPEC

for containers, share writable host file system according to SPEC

−−expose=SPEC

for containers, expose read−only host file system according to SPEC

−S, −−symlink=SPEC

for containers, add symlinks to the profile according to SPEC, e.g. "/usr/bin/env=bin/env".

−v, −−verbosity=LEVEL

use the given verbosity LEVEL

−−bootstrap

use bootstrap binaries to build the environment

−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

−−help−transform

list package transformation options not shown here

−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 © 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.