doc: Document use cases for NetworkManager with dnsmasq.
* doc/guix.texi (Networking Services): Give examples. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
This commit is contained in:
		
							parent
							
								
									57c16c97cb
								
							
						
					
					
						commit
						dc17daa43a
					
				
					 1 changed files with 25 additions and 0 deletions
				
			
		| 
						 | 
					@ -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
 | 
					@dfn{conditional forwarding} configuration if you are connected to a VPN, and
 | 
				
			||||||
then update @code{resolv.conf} to point to the local nameserver.
 | 
					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
 | 
					@item none
 | 
				
			||||||
NetworkManager will not modify @code{resolv.conf}.
 | 
					NetworkManager will not modify @code{resolv.conf}.
 | 
				
			||||||
@end table
 | 
					@end table
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Reference in a new issue