From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id 2O34GCF+hmNXhwAAbAwnHQ (envelope-from ) for ; Tue, 29 Nov 2022 22:48:17 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id yKnoGCF+hmODIAEA9RJhRA (envelope-from ) for ; Tue, 29 Nov 2022 22:48:17 +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 427EF3DC1C for ; Tue, 29 Nov 2022 22:48:17 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p08SV-0007n9-Ru; Tue, 29 Nov 2022 16:48:07 -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 1p08SQ-0007kI-OT for guix-patches@gnu.org; Tue, 29 Nov 2022 16:48:04 -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 1p08SQ-00059v-G7 for guix-patches@gnu.org; Tue, 29 Nov 2022 16:48:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1p08SQ-0001Ex-Bd for guix-patches@gnu.org; Tue, 29 Nov 2022 16:48:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#59700] [PATCH 1/1] doc: Move %facebook-host-aliases to operating-system. Resent-From: mirai@makinata.eu Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Tue, 29 Nov 2022 21:48:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 59700 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 59700@debbugs.gnu.org Cc: Bruno Victal Received: via spool by 59700-submit@debbugs.gnu.org id=B59700.16697584414758 (code B ref 59700); Tue, 29 Nov 2022 21:48:02 +0000 Received: (at 59700) by debbugs.gnu.org; 29 Nov 2022 21:47:21 +0000 Received: from localhost ([127.0.0.1]:56617 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p08Rl-0001Eg-5F for submit@debbugs.gnu.org; Tue, 29 Nov 2022 16:47:21 -0500 Received: from smtpm1.myservices.hosting ([185.26.105.232]:35494) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1p08Rj-0001Ea-2y for 59700@debbugs.gnu.org; Tue, 29 Nov 2022 16:47:19 -0500 Received: from mail1.netim.hosting (unknown [185.26.106.172]) by smtpm1.myservices.hosting (Postfix) with ESMTP id 51659202A7 for <59700@debbugs.gnu.org>; Tue, 29 Nov 2022 22:47:18 +0100 (CET) Received: from localhost (localhost [127.0.0.1]) by mail1.netim.hosting (Postfix) with ESMTP id 01AB180097; Tue, 29 Nov 2022 22:47:18 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at mail1.netim.hosting Received: from mail1.netim.hosting ([127.0.0.1]) by localhost (mail1-1.netim.hosting [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id B274oi_WcSQl; Tue, 29 Nov 2022 22:47:17 +0100 (CET) Received: from guix-nuc.home.arpa (bl12-93-156.dsl.telepac.pt [85.245.93.156]) (Authenticated sender: lumen@makinata.eu) by mail1.netim.hosting (Postfix) with ESMTPSA id 8BAA880093; Tue, 29 Nov 2022 22:47:17 +0100 (CET) From: mirai@makinata.eu Date: Tue, 29 Nov 2022 21:47:13 +0000 Message-Id: X-Mailer: git-send-email 2.38.1 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: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: guix-patches-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1669758497; h=from:from:sender:sender: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; bh=Al9Kbe/Rk36qt7ICrDNI1e8PdpZ2VCkW3osqBZAbHSo=; b=WPpEXZMPA5C/IPWVpSp4FFMFVjGMWPdT4dQK/4qPqKYOzbOhX4Rj2OUcAUbuhM4iIpXutM gj8+H/PX9ZPJ+DFmxxL1XOtxNDQyC0GqlfmBQjF6srHr509XPiieM2ncGGGog2BKC+RCcH +Jhp7vKlEN8gfZs3FcjpmCpNGqEo2/tkfdPxIW0E+aF5ELfW2Mt+Z4VCi4WRsllKY2fdYv aW5UdSgWTKGgvqTR7Qp4XIIlQ471tTDU0Ahgnw0Nb/j/LD7AlD8GgGCKWSVuqaxRiqL8VR PYjAX9U8hxM4LzZQghPqNQeeTnSuwgZnsh2ogmQeIMEi9MR3gtT+g2ViUI98BQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1669758497; a=rsa-sha256; cv=none; b=LXOvIL7mC/zqWZru6Yn0ia3mSlxlWL3QNJDkuURe+HXkgVJA+EGUHm9IDvLAbx2MxyhWlv 7oKkc+1GyYoUJd1PTeN0KmJWhkEgFQ3WFdHZGyRRplm5qiDBgnXh+S9K9ftjgKNY04/BIv d6mn0xjMq5wxKj/i80kpCgAdJQOmcYK4HBpuI9KpqHTz/sFL1SRvceC0W0i+9DG9WbbolM TD/ByakKWkJ/SwkFoQc/zim7SGPRoBu8uH/Oo4zYc37ZXvn0c7zUJlWjCIC8BhUSU4XUN3 hCnoHTTWvLBPqKLz/YDBWR4k35n54EJeLqbJ8cLS+EO556LtNb1rWkcPgITdFA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=none; 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" X-Migadu-Spam-Score: -1.46 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; 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" X-Migadu-Queue-Id: 427EF3DC1C X-Spam-Score: -1.46 X-Migadu-Scanner: scn1.migadu.com X-TUID: MtBX9FdTkDyK From: Bruno Victal --- doc/guix.texi | 58 +++++++++++++++++++++++++-------------------------- 1 file changed, 29 insertions(+), 29 deletions(-) diff --git a/doc/guix.texi b/doc/guix.texi index 47b805dc7f..3636c45b29 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -16530,6 +16530,35 @@ It is an error to refer to @code{this-operating-system} outside an operating system definition. @end deffn +@defvr {Scheme Variable} %facebook-host-aliases +This variable contains a string for use in @file{/etc/hosts} +(@pxref{Host Names,,, libc, The GNU C Library Reference Manual}). Each +line contains a entry that maps a known server name of the Facebook +on-line service---e.g., @code{www.facebook.com}---to the local +host---@code{127.0.0.1} or its IPv6 equivalent, @code{::1}. + +This variable is typically used in the @code{hosts-file} field of an +@code{operating-system} declaration (@pxref{operating-system Reference, +@file{/etc/hosts}}): + +@lisp +(use-modules (gnu) (guix)) + +(operating-system + (host-name "mymachine") + ;; ... + (hosts-file + ;; Create a /etc/hosts file with aliases for "localhost" + ;; and "mymachine", as well as for Facebook servers. + (plain-file "hosts" + (string-append (local-host-aliases host-name) + %facebook-host-aliases)))) +@end lisp + +This mechanism can prevent programs running locally, such as Web +browsers, from accessing Facebook. +@end defvr + @end deftp @node File Systems @@ -20841,35 +20870,6 @@ Logging level. @end table @end deftp -@defvr {Scheme Variable} %facebook-host-aliases -This variable contains a string for use in @file{/etc/hosts} -(@pxref{Host Names,,, libc, The GNU C Library Reference Manual}). Each -line contains a entry that maps a known server name of the Facebook -on-line service---e.g., @code{www.facebook.com}---to the local -host---@code{127.0.0.1} or its IPv6 equivalent, @code{::1}. - -This variable is typically used in the @code{hosts-file} field of an -@code{operating-system} declaration (@pxref{operating-system Reference, -@file{/etc/hosts}}): - -@lisp -(use-modules (gnu) (guix)) - -(operating-system - (host-name "mymachine") - ;; ... - (hosts-file - ;; Create a /etc/hosts file with aliases for "localhost" - ;; and "mymachine", as well as for Facebook servers. - (plain-file "hosts" - (string-append (local-host-aliases host-name) - %facebook-host-aliases)))) -@end lisp - -This mechanism can prevent programs running locally, such as Web -browsers, from accessing Facebook. -@end defvr - The @code{(gnu services avahi)} provides the following definition. @defvr {Scheme Variable} avahi-service-type -- 2.38.1