[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
06/06: doc: Document use cases for NetworkManager with dnsmasq.
From: |
guix-commits |
Subject: |
06/06: doc: Document use cases for NetworkManager with dnsmasq. |
Date: |
Mon, 24 Jun 2019 17:28:39 -0400 (EDT) |
civodul pushed a commit to branch master
in repository guix.
commit dc17daa43a02e9dcb98cb94d99d87b755a21c8c2
Author: Florian Pelz <address@hidden>
Date: Wed Jun 19 18:09:24 2019 +0200
doc: Document use cases for NetworkManager with dnsmasq.
* doc/guix.texi (Networking Services): Give examples.
Signed-off-by: Ludovic Courtès <address@hidden>
---
doc/guix.texi | 25 +++++++++++++++++++++++++
1 file changed, 25 insertions(+)
diff --git a/doc/guix.texi b/doc/guix.texi
index ce82b48..f0d148a 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -12740,6 +12740,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
- branch master updated (38c8437 -> dc17daa), guix-commits, 2019/06/24
- 01/06: progress: Call 'time-difference' on times of the same type., guix-commits, 2019/06/24
- 04/06: doc: Use new upstream nomenclature for NetworkManager’s dnsmasq., guix-commits, 2019/06/24
- 03/06: doc: Recommend '-enable-kvm' for installing in a VM as well., guix-commits, 2019/06/24
- 06/06: doc: Document use cases for NetworkManager with dnsmasq.,
guix-commits <=
- 02/06: gnu: Add Guile-JPEG., guix-commits, 2019/06/24
- 05/06: services: network-manager: Create '/var/lib/misc' directory for dnsmasq., guix-commits, 2019/06/24