Difference between pages "Install/Kernel" and "Package:Dnsmasq"

From Funtoo
< Install(Difference between pages)
Jump to navigation Jump to search
 
m (more details)
 
Line 1: Line 1:
<noinclude>
{{Ebuild
{{InstallPart|Kernel Installation}}
|Summary=Small forwarding DNS server
</noinclude>
|CatPkg=net-dns/dnsmasq
=== Kernel ===
|Homepage=http://www.thekelleys.org.uk/dnsmasq/
 
Starting mid-May 2015, Funtoo Linux stage3's include a pre-built {{c|debian-sources}} kernel to make installation faster and easier. To see if debian-sources is installed, type:
 
{{console|body=
(chroot) # ##i##emerge -s debian-sources
Searching...   
[ Results for search key : debian-sources ]
[ Applications found : 1 ]
 
*  sys-kernel/debian-sources
      ##g##Latest version available:##!g## 3.19.3
      ##g##Latest version installed:##!g## 3.19.3
      ##g##Size of files:##!g## 81,292 kB
      ##g##Homepage:##!g##      http://www.debian.org
      ##g##Description:##!g##  Debian Sources (and optional binary kernel)
      ##g##License:##!g##      GPL-2
}}
}}
{{warning|As this page deals with DNS it has the potential to break your internet access!  Ensure you have stable live media that can restore your system.}}
Dnsmasq is a dns cache, dhcp, and pxe server.  This package is lightweight, and will work well for individual computers, or small lans.


If a version is listed under {{c|Latest version installed}}, then debian-sources is already pre-built for you and you can proceed to the next section.
=== Installation ===
 
{{console|body=###i## emerge net-dns/dnsmasq}}
==== Building the Kernel ====


If you need to build a kernel for Funtoo Linux, please follow these steps:
=== Configuration ===
{{c|/etc/dnsmasq.conf}} is where most of dnsmasq's configuration is done.  It's file is well commented, and ready for several scenarios.


{{Fancynote|1=
==== DNS only ====
See [[Funtoo Linux Kernels]] for a full list of kernels supported in Funtoo Linux. We recommend <code>debian-sources</code> for new users.}}


{{fancyimportant|1=
{{important|place other upstream dns servers in /etc/resolv.dnsmasq.conf with your preferred DNS server at the top of the list.  The first console command in the block will wipe out existing /etc/resolv.dnsmasq.conf settings, back them up if you have anything important in them.}}
<code>debian-sources</code> with <code>binary</code> USE flag requires at least 14GB free in <code>/var/tmp</code> and takes around 1 hour to build on a Intel Core i7 Processor.}}
{{console|body=###i## echo "nameserver 8.8.8.8" > /etc/resolv.dnsmasq.conf
###i## echo "resolv-file=/etc/resolv.dnsmasq.conf" >> /etc/dnsmasq.conf
###i## echo "listen-address=127.0.0.1" >> /etc/dnsmasq.conf}}


Let's emerge our kernel:
Now your localhost / 127.0.0.1 is your primary DNS to point net connection scripts to.
{{console|body=###i## echo "nameserver 127.0.0.1" > /etc/resolv.conf
###i## echo "nameserver 8.8.8.8" >> /etc/resolv.conf}}


<console>
(chroot) # ##i##emerge debian-sources
</console>


Once <code>emerge</code> completes, you'll have a brand new kernel and initramfs installed to <code>/boot</code>, plus kernel headers installed in <code>/usr/src/linux</code>, and you'll be ready to configure the boot loader to load these to boot your Funtoo Linux system.
=== Runtime ===
{{console|body=###i## rc-update add dnsmasq default
###i## rc}}


{{fancynote|NVIDIA card users: the <code>binary</code> USE flag installs the Nouveau drivers which cannot be loaded at the same time as the proprietary drivers, and cannot be unloaded at runtime because of KMS. You need to blacklist it under <code>/etc/modprobe.d/</code>.}}
=== Testing ===
==== DNS only ====
{{package|net-dns/bind-tools}} contains dns testing utilities.  To verify that dns requests are returned from the local server:  emerge bind-tools, then run:
{{console|body=###i## dig google.com {{!}} grep -i server
;; SERVER: 127.0.0.1#53(127.0.0.1)}}


{{fancynote|For an overview of other kernel options for Funtoo Linux, see [[Funtoo Linux Kernels]]. There may be modules that the Debian kernel doesn't include, a situation where [http://www.funtoo.org/wiki/Funtoo_Linux_Kernels#Using_Debian-Sources_with_Genkernel genkernel] would be useful. Also be sure to see [[:Category:Hardware Compatibility|hardware compatibility]] information.}}
{{PageNeedsUpdates}}
{{EbuildFooter}}

Revision as of 10:40, May 11, 2015

Dnsmasq

   Tip

We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.

   Warning

As this page deals with DNS it has the potential to break your internet access! Ensure you have stable live media that can restore your system.

Dnsmasq is a dns cache, dhcp, and pxe server. This package is lightweight, and will work well for individual computers, or small lans.

Installation

root # emerge net-dns/dnsmasq

Configuration

/etc/dnsmasq.conf is where most of dnsmasq's configuration is done. It's file is well commented, and ready for several scenarios.

DNS only

   Important

place other upstream dns servers in /etc/resolv.dnsmasq.conf with your preferred DNS server at the top of the list. The first console command in the block will wipe out existing /etc/resolv.dnsmasq.conf settings, back them up if you have anything important in them.

root # echo "nameserver 8.8.8.8" > /etc/resolv.dnsmasq.conf
root # echo "resolv-file=/etc/resolv.dnsmasq.conf" >> /etc/dnsmasq.conf
root # echo "listen-address=127.0.0.1" >> /etc/dnsmasq.conf

Now your localhost / 127.0.0.1 is your primary DNS to point net connection scripts to.

root # echo "nameserver 127.0.0.1" > /etc/resolv.conf
root # echo "nameserver 8.8.8.8" >> /etc/resolv.conf


Runtime

root # rc-update add dnsmasq default
root # rc

Testing

DNS only

net-dns/bind-tools contains dns testing utilities. To verify that dns requests are returned from the local server: emerge bind-tools, then run:

root # dig google.com | grep -i server
;; SERVER: 127.0.0.1#53(127.0.0.1)