From patchwork Mon Mar 6 17:25:44 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: "Wicki Gabriel (wicg)" X-Patchwork-Id: 47745 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 F1D8516D75; Mon, 6 Mar 2023 17:32:22 +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=-1.0 required=5.0 tests=HTML_MESSAGE, LONG_INVISIBLE_TEXT,MAILING_LIST_MULTI,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS 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 E40AF16D53 for ; Mon, 6 Mar 2023 17:32:19 +0000 (GMT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pZEgu-0007HQ-V7; Mon, 06 Mar 2023 12:32:05 -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 1pZEgt-0007Gw-5h for guix-patches@gnu.org; Mon, 06 Mar 2023 12:32:03 -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 1pZEgs-0002lA-S7 for guix-patches@gnu.org; Mon, 06 Mar 2023 12:32:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pZEgs-0006vN-J4 for guix-patches@gnu.org; Mon, 06 Mar 2023 12:32:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#62007] doc: User Accounts: Refine user-account and user-group Resent-From: "Wicki Gabriel (wicg)" Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 06 Mar 2023 17:32:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 62007 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: To: 62007@debbugs.gnu.org X-Debbugs-Original-To: "guix-patches@gnu.org" Received: via spool by submit@debbugs.gnu.org id=B.167812386826547 (code B ref -1); Mon, 06 Mar 2023 17:32:02 +0000 Received: (at submit) by debbugs.gnu.org; 6 Mar 2023 17:31:08 +0000 Received: from localhost ([127.0.0.1]:43560 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pZEg0-0006u7-BK for submit@debbugs.gnu.org; Mon, 06 Mar 2023 12:31:08 -0500 Received: from lists.gnu.org ([209.51.188.17]:48682) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pZEfx-0006tY-UX for submit@debbugs.gnu.org; Mon, 06 Mar 2023 12:31:06 -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 1pZEfm-0006xj-Fd for guix-patches@gnu.org; Mon, 06 Mar 2023 12:30:56 -0500 Received: from mail-gv0che01on2062e.outbound.protection.outlook.com ([2a01:111:f403:4012::62e] helo=CHE01-GV0-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pZEfj-0002M2-Fy for guix-patches@gnu.org; Mon, 06 Mar 2023 12:30:54 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=mmuUNRJUKtTmE5e54gACvSjpNNfo/qzHBkOj0np9yr0qq3lhzR+oajgIoYTTGdzmy1pieAa/HmfEA6jEhy++kXisg6zkdhMRiztjHaIMI2smATHCwwt9xwCzENoiNtZ1vBdApSe3mCTp65nd3LQbRV7IAGWXzLHGlWCQI9YlPx7o7kcHUQZGNgcE8wKl8bXPouLWAZjLonVZhYaj8/PnG21sYdpsJAM43jw9ECEfSJc5SznqVRXmXK8vDjA8RwVdyqB1fGya9VW7Aol/RR/QpIzLeo7+nBgxy7Li4fG5rfz0JtCo0vynJdBo18uvvfyQvjbkNjd755tq/5qx3OD0jA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=Pikc6/HpUF24OcOX60xB0JAKT9SmU2onrefN/KR+SnI=; b=I61leEiTmXs2xHAQrPDnV7/AyfLo4Nw01sSPq5NuI6oBEpOyI1u4VHeTGrmKAsL8vvWLEorbsbS5h5XKPEgXBs9nR2SAVhKqo7/O67aJB9koaowgc/ybvfK2ZPgKmpvXjBo2pBEpuMvq6X7PWvEHeuiiMswcewjXt/CHaLFxvrk15Bkp/v7T3JObFCUPWT1h4dmd/8cKAhXp5cFYaKuvurrhAahSfOiBVLZ02DMn3VdbJHXn1r5OPTqnJyDY7vIzMDjj3MxVvY1GWTfUsf1vPlNdIetPvuDwJjihcwZOxqbVovY5cigY4xDZqMZixfVzdLH/0GrB0iHvnn180rZzQw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=zhaw.ch; dmarc=pass action=none header.from=zhaw.ch; dkim=pass header.d=zhaw.ch; arc=none Received: from ZR0P278MB0268.CHEP278.PROD.OUTLOOK.COM (2603:10a6:910:25::9) by GVAP278MB0969.CHEP278.PROD.OUTLOOK.COM (2603:10a6:710:46::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6156.28; Mon, 6 Mar 2023 17:25:45 +0000 Received: from ZR0P278MB0268.CHEP278.PROD.OUTLOOK.COM ([fe80::3640:de69:8ba8:6b48]) by ZR0P278MB0268.CHEP278.PROD.OUTLOOK.COM ([fe80::3640:de69:8ba8:6b48%3]) with mapi id 15.20.6156.028; Mon, 6 Mar 2023 17:25:45 +0000 From: "Wicki Gabriel (wicg)" Thread-Topic: doc: User Accounts: Refine user-account and user-group Thread-Index: AQHZUE9ucQjMK7bFSUmob9UhTCPwnA== Date: Mon, 6 Mar 2023 17:25:44 +0000 Message-ID: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: yes X-MS-TNEF-Correlator: msip_labels: MSIP_Label_10d9bad3-6dac-4e9a-89a3-89f3b8d247b2_Enabled=True; MSIP_Label_10d9bad3-6dac-4e9a-89a3-89f3b8d247b2_SiteId=5d1a9f9d-201f-4a10-b983-451cf65cbc1e; MSIP_Label_10d9bad3-6dac-4e9a-89a3-89f3b8d247b2_SetDate=2023-03-06T17:25:44.789Z; MSIP_Label_10d9bad3-6dac-4e9a-89a3-89f3b8d247b2_Name=Intern; MSIP_Label_10d9bad3-6dac-4e9a-89a3-89f3b8d247b2_ContentBits=0; MSIP_Label_10d9bad3-6dac-4e9a-89a3-89f3b8d247b2_Method=Standard; authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=zhaw.ch; x-ms-publictraffictype: Email x-ms-traffictypediagnostic: ZR0P278MB0268:EE_|GVAP278MB0969:EE_ x-ms-office365-filtering-correlation-id: 8f6653ff-0890-4fc8-165b-08db1e67d199 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: 6ejQgyHr96yWEqWHh0zm3j8o3+aVdFe22lubW3uRvdJTcXsH8GQhO05b7P8urbzi9AhTLDg/PlYQkn0aDU1ZkOxdysv7IU8MQYbvrex0esw5vSts6gfLS3YuFCwHRphBMDppvcUUa0zrfp7FVywrS9deTvHMnleeZH+i9tP0Ssz8ar/WHEkhu/eGNzD1hDufx1hAxtlEcMBhimEmJvAFIyqS55DVfqkROqEI0eyHKUE+wnD3lOQJP2XcfZUJvEXV9IjeNF2ur1YZo4WdZ6DfG/QGSocJumI8TVOEX7MD4Kn1e5LjDb6EkqhgGgTnHFxq6ZpYR9ds8pV3nkZjRJYEQbLlcDpj6WHJC4K02b8osZ5chTRFR7OIJEj5zj1W2/PPkT8hvMOMnQ17ARe5SYbKWjQwdcGfpaCLHMbonoqS5qDyPnJ869V3svpaxUReIvo3EYEMzvRNCw4DG0QIt75r3HxkeEe1zXWqwPFg0VbpQHve/63T5oBTxHeJ80oKsDwLzfhv+FYSy8Vn6O+1/BORLBqkDiiGDssgY9zvvBiRe4O94MSOldY08AK/RSyz2/pEmArHMAfpqTghGyWkmK7vdTPi8u8/Bo5S1zuFsUae7ydPasQ09a1f0c4Y6USJrADUUiNzGnUoxyxGScjpSpaUQovDpaD4uDEs7S5mJc3LifeFyWJFD0oxENplOYohzGCtNSCWvZfMEgZ+eHi1jY8TVg== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:ZR0P278MB0268.CHEP278.PROD.OUTLOOK.COM; PTR:; CAT:NONE; SFS:(13230025)(4636009)(376002)(346002)(39860400002)(136003)(366004)(396003)(451199018)(33656002)(6506007)(9686003)(41300700001)(26005)(186003)(7696005)(71200400001)(5660300002)(8936002)(76116006)(64756008)(52536014)(66446008)(66946007)(86362001)(8676002)(66556008)(2906002)(6916009)(4744005)(66476007)(316002)(122000001)(38070700005)(99936003)(38100700002)(786003)(55016003)(478600001)(19627405001)(41320700001); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: SV8Bt8bLIloHYbBBj+kPi93wclzA2Ltg4FYYavn9i/MzIsGTMZrLZWv7Nx+Mhmpjjtn6jinMDtSBd0wX3vlbhzamAsx8D+pRxLIZ77Sld/CcR6beaDRChcFU3IZdRNUl3hJZkJGB3dxP7ip9drhFxntFU+L0JwYk9V6ela5QXvG3yOEA3wPJyXsrZMN/TAHAfEZ1ANPIu5W42es283o2ommfPqSqVzXQfHDn5fvvMqG4O/S+Hp4FFk/fjxjOdwSJC5Shy2bPP8wCVE88dmM8Ff6MXxCZTclyZbjogerbyF+6RtswfEDp5ZJgZ0t0Lb5Yl0dvhAKsWCzkGNJtH26vqAD3ElMCA/qFjkaiCGBkwCQjqe3Ilg3fzXWmUyKOf7Uk3EckEB7I0Oo9Ar2goY4IAd96HVa30pZNJEvwWqRk5UZx2TAI8JFE0jDAz/7onRPDQKb9rz+C14iWecmHMKTkznskAOmKVT6y1xAQzvd5UoG+uOTe/j6q0A286SgZJIvaHK3Sj9Ku8sMoeaLQeXBcF6ta4uVkr4VmHuNOJKrKcPx6tLWGo/B8wcW2wKGCcd6PEFOIETCD+pDvaN/ceur7cIfK9snnoH6siVqe8OFt4wmYEXzu1S2yJjrN1oM1NGvokqB8cMKAtEarLlNJmW3P1T3v6FT2s8garG+e6KIrMWQYGfNJ6Uf7ICHgi8isg4vFCblhbadM80VDdQ1sNtMTRYRQn+QtVmX1WFdS5JiJQ9c6akEpgavjfZHCJn7VWv4pbU1ikcblrWQ/EpHSLMsXmJIiTgh/IwSu0G+9VjISzk3MKSjJgWf5s7ST/tD7QOoUvDmKsWG1ElkIYHKv716aNhyRpwqv6ULBWfnZ0bKXq1X2ibkKBAuI3BE+Nxji7EAWuP/2ssd+mTCwESsYFRmOOaM0tU+qkn2ewqflA9b1FJR9HMgpJxOOIreoMou+Kj6AOzMNq+7hGf/8eCCNA6P1c1xMOHLAy+XrAid0WNyqOZBrYj1yLT2Ck/3brPSPtQs5SKO2g56ttND5t3Bl5yCV2EELainw+7YHrZmI7nAy0wISK5wX8R2wTRmHNQ7TeNgwhrUPnjz8Fzo3UvWRpsefbAi0j+yQY8yrv/pKLLogrWSr9anbKNDdlnuBmI/2nCbctJ6hisM6nKsZzZnhTLQ/IRN7sOF6gAW752dqfPAtKU976bAi6p34fDOtxXw8AwP9kaAMtjoQWFNU4KF8s28rZc6b9irjuWfMsgcF6mlIW1MM/C+SEDswXpDJGmJrMPSeY+WdcF7UO6vH6ruHoCMnBHwS6RXsXRLtR5MGG4L3Sh4MPS76FSKIzQrLqBHLDizOQAbBssH0uk1hsheN4Kt+WQJCsZB/ka6pIFgVF5n5cVrwtEeKTwxygYQXOWF0HRLAG6AE5rqCWJnYICVwwkPfZXgQ09fcLZZX1ld0lC2G4OHMnmCyc94YzLyhC3ZvwMAeukJj4rZUhJLEDzYuNpI4ZT3fMvO8pLq48IMUdszh1/FhW/j8kNizWgmzlKtbVE3oTgazxScy4jzFgM8nYJlMYg== MIME-Version: 1.0 X-OriginatorOrg: zhaw.ch X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: ZR0P278MB0268.CHEP278.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-Network-Message-Id: 8f6653ff-0890-4fc8-165b-08db1e67d199 X-MS-Exchange-CrossTenant-originalarrivaltime: 06 Mar 2023 17:25:44.9836 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 5d1a9f9d-201f-4a10-b983-451cf65cbc1e X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: Bnag4J7rfQp5zajBRalamxE7o2z4xd52Wem+sJ9nxSqxI3i1T0yC2Klqbu6Yu7qi X-MS-Exchange-Transport-CrossTenantHeadersStamped: GVAP278MB0969 Received-SPF: pass client-ip=2a01:111:f403:4012::62e; envelope-from=wicg@zhaw.ch; helo=CHE01-GV0-obe.outbound.protection.outlook.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, HTML_MESSAGE=0.001, 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: , 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 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 From 3bb4a0990906d227d77819d404864adef652933c Mon Sep 17 00:00:00 2001 From: gabriel 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