From patchwork Sun Dec 25 21:19:00 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Simon Josefsson X-Patchwork-Id: 45577 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 971BC27BBED; Sun, 25 Dec 2022 21:20:12 +0000 (GMT) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-3.7 required=5.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,MAILING_LIST_MULTI,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS, URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 3D1F227BBE9 for ; Sun, 25 Dec 2022 21:20:10 +0000 (GMT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p9YPb-0004kX-Na; Sun, 25 Dec 2022 16:20:03 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p9YPa-0004kN-QL for guix-patches@gnu.org; Sun, 25 Dec 2022 16:20:02 -0500 Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1p9YPa-0004iv-D9 for guix-patches@gnu.org; Sun, 25 Dec 2022 16:20:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1p9YPZ-0002KK-SC for guix-patches@gnu.org; Sun, 25 Dec 2022 16:20:01 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#60320] [PATCH] doc: Improve user-group documentation. Resent-From: Simon Josefsson Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sun, 25 Dec 2022 21:20:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 60320 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 60320@debbugs.gnu.org X-Debbugs-Original-To: guix-patches@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.16720031508851 (code B ref -1); Sun, 25 Dec 2022 21:20:01 +0000 Received: (at submit) by debbugs.gnu.org; 25 Dec 2022 21:19:10 +0000 Received: from localhost ([127.0.0.1]:50189 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p9YOj-0002Ih-I1 for submit@debbugs.gnu.org; Sun, 25 Dec 2022 16:19:09 -0500 Received: from lists.gnu.org ([209.51.188.17]:47148) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p9YOg-0002IY-RS for submit@debbugs.gnu.org; Sun, 25 Dec 2022 16:19:08 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p9YOg-0004fm-Ma for guix-patches@gnu.org; Sun, 25 Dec 2022 16:19:06 -0500 Received: from uggla.sjd.se ([2001:9b1:8633::107]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p9YOe-0004ZH-Nl for guix-patches@gnu.org; Sun, 25 Dec 2022 16:19:06 -0500 DKIM-Signature: v=1; a=ed25519-sha256; q=dns/txt; c=relaxed/relaxed; d=josefsson.org; s=ed2110; h=Content-Type:MIME-Version:Message-ID:Date: Subject:To:From:Sender:Reply-To:Cc:Content-Transfer-Encoding:Content-ID: Content-Description; bh=A3WT1frlGSTEFm7iennAi2PNdK0MegAAk9xwdJbAdIY=; t=1672003142; x=1673212742; b=LPN0WTalKPBEpqEjGvFI0rHmu7XbBHdsqAuc2quqvap+QMk zV76yPx55jacc15VnuLAr7u10yOcSIJEtXWP8Dw==; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=josefsson.org; s=rsa2110; h=Content-Type:MIME-Version:Message-ID:Date: Subject:To:From:Sender:Reply-To:Cc:Content-Transfer-Encoding:Content-ID: Content-Description; bh=A3WT1frlGSTEFm7iennAi2PNdK0MegAAk9xwdJbAdIY=; t=1672003142; x=1673212742; b=gjmUnC01RHg6SWks7SnkWQ/HDX5HSu/ETTfmXo/Q9AQE0oO roBMAdPEp/WiL+dcICKyDGTR9cN7jPu4n9k0mv0E0RZNUi4KKEoDjdHi5a7tB6w8NgZJ6q75q/5sP IgBMwi4aWrSB/Qo3dOXHMkbjf4NHLwB8q9VmfMSWDnBoCF40eSRPy+7LX0yZ/yeiA4Msh4+LNrBq6 XwuIjBBWRTQ0YW2BnLsYVaP/6uOJoNyvtWA5C9E2x3jN3yPOZVGpHQi92bAxjYHJe3/i7HrYqOQJv 2+R+hwoSoqA9/5+ND5EkSI1V7SLBL2D4ZA/R5RphMYXprnqlgR5EMrCi6VURzf2XArWoWohsX3sHZ C2Xf/pnQ358TxHI2MC4rMa8OUE2liAQh4aiwk8ejSuf1qsmOtA9bpoWBgBRu1vpeWBKT8ST0ZF618 rRYGsx6PdaNLyxg6Xj24OMQk; Received: from [2001:9b1:41ac:ff00:67bf:136:16d3:4a37] (port=58126 helo=kaka) by uggla.sjd.se with esmtpsa (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1p9YOa-002oxN-Qe for guix-patches@gnu.org; Sun, 25 Dec 2022 22:19:00 +0100 X-Hashcash: 1:22:221225:guix-patches@gnu.org::2gvKjh48Cd6Ehfte:IN64 OpenPGP: id=B1D2BD1375BECB784CF4F8C4D73CF638C53C06BE; url=https://josefsson.org/key-20190320.txt Date: Sun, 25 Dec 2022 22:19:00 +0100 Message-ID: <871qonmbaz.fsf@josefsson.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux) MIME-Version: 1.0 Received-SPF: pass client-ip=2001:9b1:8633::107; envelope-from=simon@josefsson.org; helo=uggla.sjd.se X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-to: Simon Josefsson X-ACL-Warn: , Simon Josefsson via Guix-patches X-Patchwork-Original-From: Simon Josefsson via Guix-patches via From: Simon Josefsson Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org X-getmail-retrieved-from-mailbox: Patches Hi. Not knowing better I added this to my operating-system form: (groups (cons* (user-group (name "jas") (id "1000")) %base-groups)) Running 'guix system reconfigure /etc/config.scm' worked fine, and upon boot I was placed in group 30001. Any idea what happened? A warning would have been nice. If there had been an example in the manual I wouldn't have made the mistake, so the attached patch improves this manual page: https://guix.gnu.org/en/manual/en/html_node/User-Accounts.html#User-Accounts /Simon From 6b7464c2820fd5f8b570f78e6e79752bc47ceaf8 Mon Sep 17 00:00:00 2001 From: Simon Josefsson Date: Sun, 25 Dec 2022 22:04:42 +0100 Subject: [PATCH] doc: Improve user-group documentation. * doc/guix.texi (User Accounts): Add user-group form and modify user-group text and examples to use it. --- doc/guix.texi | 20 +++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index c5ae350a47..79475915ec 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -17165,8 +17165,8 @@ select the file system in an elegant fashion! @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. Users are specified with the +@code{user-account} form: @lisp (user-account @@ -17179,13 +17179,23 @@ User accounts and groups are entirely managed through the (comment "Bob's sister")) @end lisp -Here's a user account that uses a different shell and a custom home -directory (the default would be @file{"/home/bob"}): +Groups are specified with the @code{user-group} form: + +@lisp +(user-group + (name "bob") + (id 1000)) + %base-groups)) +@end lisp + +Here's a user account that uses a different shell, a custom home +directory (the default would be @file{"/home/bob"}) and uses the +@code{bob} group instead of the traditional @code{users}. @lisp (user-account (name "bob") - (group "users") + (group "bob") (comment "Alice's bro") (shell (file-append zsh "/bin/zsh")) (home-directory "/home/robert")) -- 2.38.1