From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id yPaoJGxQpV9HXgAA0tVLHw (envelope-from ) for ; Fri, 06 Nov 2020 13:32:28 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id aBZrIGxQpV+PLgAAB5/wlQ (envelope-from ) for ; Fri, 06 Nov 2020 13:32:28 +0000 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 5598F9402B4 for ; Fri, 6 Nov 2020 13:32:28 +0000 (UTC) Received: from localhost ([::1]:51130 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kb1qt-0002kb-Aa for larch@yhetil.org; Fri, 06 Nov 2020 08:32:27 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:41042) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kb1ql-0002jB-2z for guix-devel@gnu.org; Fri, 06 Nov 2020 08:32:19 -0500 Received: from tobias.gr ([2a02:c205:2020:6054::1]:54934) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kb1qi-0001jJ-El for guix-devel@gnu.org; Fri, 06 Nov 2020 08:32:18 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tobias.gr; s=2018; bh=shHGYElTmUEjPPf4bR0EGpX74ZuvDT9KYb3RFQFdlrw=; h=date:subject:to: from; b=WTyMkxEvqbeheIjLaCQIflQcHkYRsxdRfcBBgpyZkbtAvJUNhHRHFj1EUi27JE UM9IqCnVebLlOAv2/6Bl3GwBUIZbZee6Xp1K+i9k2zhSziviRWWPAS46VtXHemMwtc9eic 452Eui+ouijW+KJ0xzgnkUDUmBO/hAQXy4nWzW4cqtNiGFfZuzu2NzlQeXoFglR3dU9um8 TJwLKrKctGNlEQk4ejtPtAzI603KynQJZpNSsTclgRVp9k6pwc74ENE+kfI3cU85wPY3mN reWTMo3PRIasSfbephK7wsfgSnHzhmlH2vpPwJ1+vcPIEroNfrSc0lh/rH+L7ZBGTgBkIw == Received: by submission.tobias.gr (OpenSMTPD) with ESMTPSA id 5de479e2 (TLSv1.2:ECDHE-ECDSA-AES256-GCM-SHA384:256:NO) for ; Fri, 6 Nov 2020 13:32:14 +0000 (UTC) BIMI-Selector: v=BIMI1; s=default; From: Tobias Geerinckx-Rice To: guix-devel@gnu.org Subject: Fixing Zabbix db-secret-file documentation. Date: Fri, 06 Nov 2020 14:29:14 +0100 Message-ID: <87tuu2bolx.fsf@nckx> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="==-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" Received-SPF: pass client-ip=2a02:c205:2020:6054::1; envelope-from=me@tobias.gr; helo=tobias.gr X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: "Guix-devel" X-Scanner: ns3122888.ip-94-23-21.eu Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=tobias.gr header.s=2018 header.b=WTyMkxEv; dmarc=pass (policy=reject) header.from=tobias.gr; spf=pass (aspmx1.migadu.com: domain of guix-devel-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-devel-bounces@gnu.org X-Spam-Score: -3.31 X-TUID: 8dTw2bcs5/mC --==-=-= Content-Type: multipart/mixed; boundary="=-=-=" --=-=-= Content-Type: text/plain; format=flowed Guix, We currently claim that db-secret-file is appended to zabbix.conf.php. To me that can only mean: $ cat db-secret-file $DB['PASSWORD'] = 'supersecure' $DB['maybe'] = 'some more sekrit stuff too' but it's really just: "$DB['PASSWORD'] = '" (with-input-from-file db-secret-file read-string) "';" It's late into 1.2 to invalidate manual translations. However, I'm sceptical of shipping a translated-but-IMO-incorrect snippet over a better English one just to boost coverage stats, and would like to push it anyway. Thoughts? Kind regards, T G-R --=-=-= Content-Type: text/x-patch; charset=utf-8 Content-Disposition: inline; filename=0001-doc-Better-document-Zabbix-db-secret-file.patch Content-Transfer-Encoding: quoted-printable From=20c6746726e4db7f674297de79ae599ca9686658a1 Mon Sep 17 00:00:00 2001 From: Tobias Geerinckx-Rice Date: Fri, 6 Nov 2020 13:17:00 +0100 Subject: [PATCH 1/2] =3D?UTF-8?q?doc:=3D20Fix=3D20Zabbix=3D20?=3D =3D?UTF-8?q?=3DE2=3D80=3D98db-secret-file=3DE2=3D80=3D99=3D20documentation= .?=3D MIME-Version: 1.0 Content-Type: text/plain; charset=3DUTF-8 Content-Transfer-Encoding: 8bit * doc/guix.texi (Monitoring Services): Document =E2=80=98db-secret-file=E2= =80=99's (lack of) structure and gexp support. =2D-- doc/guix.texi | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 217ed7a8a8..1c29799d6c 100644 =2D-- a/doc/guix.texi +++ b/doc/guix.texi @@ -22168,9 +22168,10 @@ Defaults to @samp{""}. @end deftypevr =20 @deftypevr {@code{zabbix-front-end-configuration} parameter} string db-sec= ret-file =2DSecret file which will be appended to @file{zabbix.conf.php} file. This =2Dfile contains credentials for use by Zabbix front-end. You are expected =2Dto create it manually. +Secret file containing the credentials for the Zabbix front end. The value +must be a local file name, not a G-expression. You are expected to create +this file manually. Its contents will be copied into @file{zabbix.conf.ph= p} +as the value of @code{$DB['PASSWORD']}. =20 Defaults to @samp{""}. =20 =2D-=20 2.29.2 --=-=-=-- --==-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iIMEARYKACsWIQT12iAyS4c9C3o4dnINsP+IT1VteQUCX6VQWw0cbWVAdG9iaWFz LmdyAAoJEA2w/4hPVW15HnYBAOMD9yF2ev2CNxGVOCycrVvbBRo2HPmJgk143VkN 5hseAPsFeND1Tr15ftXkd1qe4oklN4h/xnQ6T7r4RopG2hP2AA== =wTNv -----END PGP SIGNATURE----- --==-=-=--