doc: Update 'README'.
* README: Update intro a bit. (Installing Guix as non-root): Remove as it's largely outdated. (Contact): Update.master
parent
c26f562e5e
commit
f475c6e53e
36
README
36
README
|
@ -10,8 +10,8 @@ It provides [[https://www.gnu.org/software/guile/][Guile]] Scheme APIs, includin
|
||||||
domain-specific languages (EDSLs) to describe how packages are to be
|
domain-specific languages (EDSLs) to describe how packages are to be
|
||||||
built and composed.
|
built and composed.
|
||||||
|
|
||||||
A user-land free software distribution for GNU/Linux comes as part of
|
GNU Guix can be used on top of an already-installed GNU/Linux distribution, or
|
||||||
Guix.
|
it can be used standalone (we call that “Guix System”).
|
||||||
|
|
||||||
Guix is based on the [[https://nixos.org/nix/][Nix]] package manager.
|
Guix is based on the [[https://nixos.org/nix/][Nix]] package manager.
|
||||||
|
|
||||||
|
@ -75,37 +75,17 @@ the promise of a build; it is stored as a text file under
|
||||||
`derivation' primitive, as well as higher-level wrappers such as
|
`derivation' primitive, as well as higher-level wrappers such as
|
||||||
`build-expression->derivation'.
|
`build-expression->derivation'.
|
||||||
|
|
||||||
Guix does remote procedure calls (RPCs) to the Guix or Nix daemon (the
|
Guix does remote procedure calls (RPCs) to the build daemon (the =guix-daemon=
|
||||||
=guix-daemon= or =nix-daemon= command), which in turn performs builds
|
command), which in turn performs builds and accesses to the store on its
|
||||||
and accesses to the Nix store on its behalf. The RPCs are implemented
|
behalf. The RPCs are implemented in the (guix store) module.
|
||||||
in the (guix store) module.
|
|
||||||
|
|
||||||
* Installing Guix as non-root
|
|
||||||
|
|
||||||
The Guix daemon allows software builds to be performed under alternate
|
|
||||||
user accounts, which are normally created specifically for this
|
|
||||||
purpose. For instance, you may have a pool of accounts in the
|
|
||||||
=guixbuild= group, and then you can instruct =guix-daemon= to use them
|
|
||||||
like this:
|
|
||||||
|
|
||||||
$ guix-daemon --build-users-group=guixbuild
|
|
||||||
|
|
||||||
However, unless it is run as root, =guix-daemon= cannot switch users.
|
|
||||||
In that case, it falls back to using a setuid-root helper program call
|
|
||||||
=nix-setuid-helper=. That program is not setuid-root by default when
|
|
||||||
you install it; instead you should run a command along these lines
|
|
||||||
(assuming Guix is installed under /usr/local):
|
|
||||||
|
|
||||||
# chown root.root /usr/local/libexec/nix-setuid-helper
|
|
||||||
# chmod 4755 /usr/local/libexec/nix-setuid-helper
|
|
||||||
|
|
||||||
* Contact
|
* Contact
|
||||||
|
|
||||||
GNU Guix is hosted at https://savannah.gnu.org/projects/guix/.
|
GNU Guix is hosted at https://savannah.gnu.org/projects/guix/.
|
||||||
|
|
||||||
Please email <bug-guix@gnu.org> for bug reports or questions regarding
|
Please email <help-guix@gnu.org> for questions and <bug-guix@gnu.org> for bug
|
||||||
Guix and its distribution; email <gnu-system-discuss@gnu.org> for
|
reports; email <gnu-system-discuss@gnu.org> for general issues regarding the
|
||||||
general issues regarding the GNU system.
|
GNU system.
|
||||||
|
|
||||||
Join #guix on irc.freenode.net.
|
Join #guix on irc.freenode.net.
|
||||||
|
|
||||||
|
|
Reference in New Issue