From: "Wicki Gabriel (wicg)" <wicg@zhaw.ch>
To: 62007@debbugs.gnu.org
Subject: [bug#62007] doc: User Accounts: Refine user-account and user-group
Date: Mon, 6 Mar 2023 17:25:44 +0000 [thread overview]
Message-ID: <ZR0P278MB0268CD60FE72D9D0ED450E52C1B69@ZR0P278MB0268.CHEP278.PROD.OUTLOOK.COM> (raw)
[-- Attachment #1.1: Type: text/plain, Size: 335 bytes --]
Hi
I've stumbled upon some room for improvement considering where to add groups to a Guix system. Chapter 12.6 mentions the needed forms but lacks clear indication which operating-system fields to add these to.
My patch takes care of that.
This patch is based on commit 7bbeaa87e3796d56cc762dcfbc340f9be301d5f6
TIA,
g
[-- Attachment #1.2: Type: text/html, Size: 2340 bytes --]
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-doc-User-Accounts-Refine-user-account-and-user-group.patch --]
[-- Type: text/x-patch; name="0001-doc-User-Accounts-Refine-user-account-and-user-group.patch", Size: 2231 bytes --]
From 3bb4a0990906d227d77819d404864adef652933c Mon Sep 17 00:00:00 2001
From: gabriel <gabriel@erlikon.ch>
Date: Mon, 6 Mar 2023 18:04:17 +0100
Subject: [PATCH] doc: User Accounts: Refine user-account and user-group
examples
* doc/guix.texi (User Accounts): Show where the user-account and user-group
forms belong within the operation-system context.
---
doc/guix.texi | 27 ++++++++++++++++-----------
1 file changed, 16 insertions(+), 11 deletions(-)
diff --git a/doc/guix.texi b/doc/guix.texi
index 6671ba9305..de34ca7ff4 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -17388,18 +17388,21 @@ $ sudo filefrag -e /swapfile | grep '^ *0:' | cut -d: -f3 | cut -d. -f1
@cindex accounts
@cindex user accounts
User accounts and groups are entirely managed through the
-@code{operating-system} declaration. They are specified with the
-@code{user-account} and @code{user-group} forms:
+@code{operating-system} declaration. They are specified with
+@code{user-account} forms in the @code{users}-field and
+@code{user-group} forms in the @code{groups}-field:
@lisp
-(user-account
- (name "alice")
- (group "users")
- (supplementary-groups '("wheel" ;allow use of sudo, etc.
- "audio" ;sound card
- "video" ;video devices such as webcams
- "cdrom")) ;the good ol' CD-ROM
- (comment "Bob's sister"))
+(users (cons*
+ (user-account
+ (name "alice")
+ (group "users")
+ (supplementary-groups '("wheel" ;allow use of sudo, etc.
+ "audio" ;sound card
+ "video" ;video devices such as webcams
+ "cdrom")) ;the good ol' CD-ROM
+ (comment "Bob's sister"))
+ %base-user-accounts))
@end lisp
Here's a user account that uses a different shell and a custom home
@@ -17519,7 +17522,9 @@ Guile Reference Manual}, for information on Guile's @code{crypt} procedure.
User group declarations are even simpler:
@lisp
-(user-group (name "students"))
+(groups (cons*
+ (user-group (name "students"))
+ %base-groups))
@end lisp
@deftp {Data Type} user-group
--
2.39.1
next reply other threads:[~2023-03-06 17:32 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-03-06 17:25 Wicki Gabriel (wicg) [this message]
2023-03-08 20:53 ` [bug#62007] doc: User Accounts: Refine user-account and user-group Liliana Marie Prikler
2023-06-06 14:23 ` bug#62007: " Josselin Poiret via Guix-patches via
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://guix.gnu.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=ZR0P278MB0268CD60FE72D9D0ED450E52C1B69@ZR0P278MB0268.CHEP278.PROD.OUTLOOK.COM \
--to=wicg@zhaw.ch \
--cc=62007@debbugs.gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/guix.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).