From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id QIKYGIMIZWWd/wAAauVa8A:P1 (envelope-from ) for ; Mon, 27 Nov 2023 22:22:11 +0100 Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id QIKYGIMIZWWd/wAAauVa8A (envelope-from ) for ; Mon, 27 Nov 2023 22:22:11 +0100 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 5289616C41 for ; Mon, 27 Nov 2023 22:22:11 +0100 (CET) Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=lease-up.com header.s=2017 header.b=ZP2JzvE2; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1701120131; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=sqhSogQM9kZ8FjNYu9M/JSDpam1OFo4XPyYt8vPGE6s=; b=EY9lRpjq++FD5KZOTfilkpupxx8n4Sf9znoXGIl63zXh8y+aidz689yLNG4kXmx7ZuFppw BA06vbiaMo7m2r+BN8N0nZk+J9CTlFJ+H+GLLs8FSwdSoZh+eZVo4/+K1BFG1fuEWJ+hTj 4hODJuuyN3QFncZwM4E3Q3/bHtpNqdzZksjj3P8Xnbsh6J2p114ndJ2xTde/AVLDePRVXQ ZHTtEPjIUSoLl1lCLwuwk7/rz14vhyCVRwLw4kkoOqpUot8k71Tj4aTplr5DDjicHuoSUu G8s/iQdzwwk0fmAByRCX/25rxAsFsZlOZEMJ0g1A3fz/Wmv9zFGebzf2wf4bEw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1701120131; a=rsa-sha256; cv=none; b=fkIK1eQ209oyDEnqr9HZzX42o2D+tZL4SODAOPonWQLTT8/cZy7/0p9C/8WbNU+GYyM+Ud OR5ZXakW/7c5zjdFs6+NC7Hdc4eSqnZYDp9Jgz/r6FLKhBHg6l8C7VAPHtfZhOzOj9DmCw E5irI5gT/up5Z+uwi9rgoJ76itChSQtCToLNvJdLsb+d6MgzYwMghX2QnqGrSfly4Hbf7q WC9loJanI6mOV/GYLMesAx1CrQ2ia328S+9q5YEFoyKkOu2it8o0LR5aoykUjFIWwBwQGl 2Wa2khhgdjV9Xf/HhkW8yKpgN0ukur5divcLqvS0DPRGZdE3hiri10n3AH4Dmw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=lease-up.com header.s=2017 header.b=ZP2JzvE2; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1r7j3G-0000zF-U3; Mon, 27 Nov 2023 16:21:58 -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 1r7j3F-0000yI-1h for guix-patches@gnu.org; Mon, 27 Nov 2023 16:21:57 -0500 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1r7j3E-0005n5-FF for guix-patches@gnu.org; Mon, 27 Nov 2023 16:21:56 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1r7j3K-00018w-Ta for guix-patches@gnu.org; Mon, 27 Nov 2023 16:22:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#67497] [PATCH 2/4] In certbot documentation, call environment variables by their proper name. Resent-From: Felix Lechner Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 27 Nov 2023 21:22:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 67497 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 67497@debbugs.gnu.org Cc: Bruno Victal , Felix Lechner Received: via spool by 67497-submit@debbugs.gnu.org id=B67497.17011200984339 (code B ref 67497); Mon, 27 Nov 2023 21:22:02 +0000 Received: (at 67497) by debbugs.gnu.org; 27 Nov 2023 21:21:38 +0000 Received: from localhost ([127.0.0.1]:44987 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1r7j2v-00017u-OS for submit@debbugs.gnu.org; Mon, 27 Nov 2023 16:21:38 -0500 Received: from sail-ipv4.us-core.com ([208.82.101.137]:56770) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1r7j2s-00017R-7n for 67497@debbugs.gnu.org; Mon, 27 Nov 2023 16:21:35 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; s=2017; bh=fvjhNjgOq6aLOZO RmF4VZEHyzgSdcD/CUrbIl3wI0/c=; h=references:in-reply-to:date:subject: cc:to:from; d=lease-up.com; b=ZP2JzvE2snqTnN+SJnNRw/HPPR8hxX78Rj4dqEqg EcIZHcmWIrhiGtE25DAhr5TLcaHVwpa16irPvNysdpph5Lky1Jf/iBFWG0eqaRxQJQcZ9k q5fOIQezwjdfYphlSa905m+7EotHPsRfGu7zYezMWZWHA+GSliJj9bo6BGLW8= Received: by sail-ipv4.us-core.com (OpenSMTPD) with ESMTPSA id 79edd8b4 (TLSv1.3:TLS_CHACHA20_POLY1305_SHA256:256:NO); Mon, 27 Nov 2023 21:21:27 +0000 (UTC) Received: from localhost (localhost [local]) by localhost (OpenSMTPD) with ESMTPA id de854032; Mon, 27 Nov 2023 21:21:26 +0000 (UTC) Date: Mon, 27 Nov 2023 13:20:52 -0800 Message-ID: X-Mailer: git-send-email 2.41.0 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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: Felix Lechner X-ACL-Warn: , Felix Lechner via Guix-patches From: Felix Lechner via Guix-patches via Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: guix-patches-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Scanner: mx11.migadu.com X-Migadu-Spam-Score: -4.63 X-Spam-Score: -4.63 X-Migadu-Queue-Id: 5289616C41 X-TUID: UsWjB28ZLJu3 Certbot's hooks can be written in any language. in fact, they can be any kind of executable. Environment variables are widely used to communicate values across that type of fork(2) boundary. In the context here, it is more accurate to talk about environment variables. Change-Id: If0b476c3367a3108d9365d718a74faa7d9fe7530 --- doc/guix.texi | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index b0b1c05c73..440a5f3efa 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -32139,24 +32139,24 @@ Certificate Services @item @code{authentication-hook} (default: @code{#f}) Command to be run in a shell once for each certificate challenge to be -answered. For this command, the shell variable @code{$CERTBOT_DOMAIN} +answered. For this command, the environment variable @code{$CERTBOT_DOMAIN} will contain the domain being authenticated, @code{$CERTBOT_VALIDATION} contains the validation string and @code{$CERTBOT_TOKEN} contains the file name of the resource requested when performing an HTTP-01 challenge. @item @code{cleanup-hook} (default: @code{#f}) Command to be run in a shell once for each certificate challenge that -have been answered by the @code{auth-hook}. For this command, the shell +have been answered by the @code{auth-hook}. For this command, the environment variables available in the @code{auth-hook} script are still available, and additionally @code{$CERTBOT_AUTH_OUTPUT} will contain the standard output of the @code{auth-hook} script. @item @code{deploy-hook} (default: @code{#f}) Command to be run in a shell once for each successfully issued -certificate. For this command, the shell variable +certificate. For this command, the environment variable @code{$RENEWED_LINEAGE} will point to the config live subdirectory (for example, @samp{"/etc/letsencrypt/live/example.com"}) containing the new -certificates and keys; the shell variable @code{$RENEWED_DOMAINS} will +certificates and keys; the environment variable @code{$RENEWED_DOMAINS} will contain a space-delimited list of renewed certificate domains (for example, @samp{"example.com www.example.com"}. -- 2.41.0