From patchwork Wed Jun 19 16:09:24 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: "pelzflorian (Florian Pelz)" X-Patchwork-Id: 14350 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 C1E4217118; Wed, 19 Jun 2019 17:23:31 +0100 (BST) X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_DKIM_INVALID autolearn=ham autolearn_force=no version=3.4.0 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTP id 7DD851710E for ; Wed, 19 Jun 2019 17:23:31 +0100 (BST) Received: from localhost ([::1]:40216 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hddMu-0002ut-FK for patchwork@mira.cbaines.net; Wed, 19 Jun 2019 12:23:29 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:55267) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hdd9y-0003Qv-P8 for guix-patches@gnu.org; Wed, 19 Jun 2019 12:10:09 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hdd9w-0008A6-D1 for guix-patches@gnu.org; Wed, 19 Jun 2019 12:10:06 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:33797) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hdd9v-00088F-3M for guix-patches@gnu.org; Wed, 19 Jun 2019 12:10:03 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hdd9u-00012V-TH for guix-patches@gnu.org; Wed, 19 Jun 2019 12:10:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#36294] [PATCH 3/3] Document use cases for NetworkManager with dnsmasq. References: <20190619160557.hkxkioufw2ybpgml@pelzflorian.localdomain> In-Reply-To: <20190619160557.hkxkioufw2ybpgml@pelzflorian.localdomain> Resent-From: Florian Pelz Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 19 Jun 2019 16:10:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 36294 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 36294@debbugs.gnu.org Received: via spool by 36294-submit@debbugs.gnu.org id=B36294.15609605673936 (code B ref 36294); Wed, 19 Jun 2019 16:10:02 +0000 Received: (at 36294) by debbugs.gnu.org; 19 Jun 2019 16:09:27 +0000 Received: from localhost ([127.0.0.1]:47340 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hdd9K-00011Q-N7 for submit@debbugs.gnu.org; Wed, 19 Jun 2019 12:09:26 -0400 Received: from pelzflorian.de ([5.45.111.108]:41666 helo=mail.pelzflorian.de) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hdd9J-00011J-9W for 36294@debbugs.gnu.org; Wed, 19 Jun 2019 12:09:25 -0400 Received: from pelzflorian.localdomain (unknown [5.45.111.108]) by mail.pelzflorian.de (Postfix) with ESMTPSA id A096036007F for <36294@debbugs.gnu.org>; Wed, 19 Jun 2019 18:09:24 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=pelzflorian.de; s=mail; t=1560960564; bh=nlBC9d8T+2MFd+lQis4RouBn0NdV/aSBXQQnMsdi7NM=; h=Date:From:To:Subject; b=TuZ3hTYXh8UGWzNMes3v3VvON2ursV6yUayDuYVzyPTS6haE3/k2WLBBG+Gi3Tczf A0ExCBJPdqd6E5OxCK1vEhhR5+ipalXz79IrxJU5vi7neTMqiHxrlzIfhhD3pGJ2UL 3tk8wOo07Bcx9OkdXvDtQdq5SrZME6SPbVJbGixY= Date: Wed, 19 Jun 2019 18:09:24 +0200 From: Florian Pelz Message-ID: <20190619160924.f6umtng4htysmqdi@pelzflorian.localdomain> MIME-Version: 1.0 Content-Disposition: inline User-Agent: NeoMutt/20180716 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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" X-getmail-retrieved-from-mailbox: Patches * doc/guix.texi (Networking Services): Give examples. --- doc/guix.texi | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/doc/guix.texi b/doc/guix.texi index 694b802e1e..172106068f 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -12739,6 +12739,31 @@ NetworkManager will run @code{dnsmasq} as a local caching nameserver, using a @dfn{conditional forwarding} configuration if you are connected to a VPN, and then update @code{resolv.conf} to point to the local nameserver. +With this setting, you can share your network connection. For example when +you want to share your network connection to another laptop @i{via} an +Ethernet cable, you can open @command{nm-connection-editor} and configure the +Wired connection’s method for IPv4 and IPv6 to be 'Shared to other computers' +and reestablish the connection (or reboot). + +You can also set up a @dfn{host-to-guest connection} to QEMU VMs +(@pxref{Installing Guix in a VM}). With a host-to-guest connection, you can +e.g.@: access a Web server running on the VM (@pxref{Web Services}) from a Web +browser on your host system, or connect to the VM @i{via} SSH +(@pxref{Networking Services, @code{openssh-service-type}}). To set up a +host-to-guest connection, run this command once: + +@example +nmcli connection add type tun \ + connection.interface-name tap0 \ + tun.mode tap tun.owner $(id -u) \ + ipv4.method shared \ + ipv4.addresses 172.28.112.1/24 +@end example + +Then each time you launch your QEMU VM (@pxref{Running Guix in a VM}), pass +@option{-nic tap,ifname=tap0,script=no,downscript=no} to +@command{qemu-system-...}. + @item none NetworkManager will not modify @code{resolv.conf}. @end table