ryan77627/guix
1
0
Fork 0
mirror of https://git.in.rschanz.org/ryan77627/guix.git synced 2025-01-11 13:49:23 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: Try to clarify the setuid programs examples.

Browse source 
Based on user feedback, the shadow / passwd example was too obscure for those
who aren't familiar with the shadow collection of tools. And it was also
considered confusing for the two examples to use different packages.

* doc/guix.texi (Setuid Programs): Use 'nmtui' in the examples.
This commit is contained in:
Leo Famulari 2022-01-03 18:06:50 -05:00
parent 0c5a58e34d
commit 6a7945971d
No known key found for this signature in database
GPG key ID: 2646FA30BACA7F08
1 changed files with 7 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

13
doc/guix.texi
View file

@ -34077,22 +34077,23 @@ should be setuid root.
The @code{setuid-programs} field of an @code{operating-system} The @code{setuid-programs} field of an @code{operating-system}
declaration contains a list of @code{<setuid-program>} denoting the declaration contains a list of @code{<setuid-program>} denoting the
names of programs to have a setuid or setgid bit set (@pxref{Using the names of programs to have a setuid or setgid bit set (@pxref{Using the
Configuration System}). For instance, the @command{passwd} program, Configuration System}). For instance, the @command{nmtui} program,
which is part of the Shadow package, with a setuid root can be which is part of the NetworkManager package, with a setuid root can be
designated like this: designated like this:
@example @example
(setuid-program (setuid-program
(program (file-append shadow "/bin/passwd"))) (program (file-append network-manager "/bin/nmtui")))
@end example @end example
And then it can be added to your operating system declaration by And then, to make @code{nmtui} setuid on your system, add the previous
appending it to @code{%setuid-programs} like this: example to your operating system declaration by appending it to
@code{%setuid-programs} like this:
@example @example
(setuid-programs (setuid-programs
(append (list (setuid-program (append (list (setuid-program
(program (file-append swaylock "/bin/swaylock")))) (program (file-append network-manager "/bin/nmtui"))))
%setuid-programs)) %setuid-programs))
@end example @end example