| 1 | <?xml version="1.0" encoding="ISO-8859-1"?> |
|---|
| 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" |
|---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ |
|---|
| 4 | <!ENTITY % general-entities SYSTEM "../../general.ent"> |
|---|
| 5 | %general-entities; |
|---|
| 6 | ]> |
|---|
| 7 | |
|---|
| 8 | <sect1 id="ch-network-resolv"> |
|---|
| 9 | <?dbhtml filename="resolv.html"?> |
|---|
| 10 | |
|---|
| 11 | <title>Creating the /etc/resolv.conf File</title> |
|---|
| 12 | |
|---|
| 13 | <sect2 id="resolv.conf"> |
|---|
| 14 | <title>Creating the /etc/resolv.conf File</title> |
|---|
| 15 | |
|---|
| 16 | <indexterm zone="resolv.conf"> |
|---|
| 17 | <primary sortas="e-/etc/resolv.conf">/etc/resolv.conf</primary> |
|---|
| 18 | </indexterm> |
|---|
| 19 | |
|---|
| 20 | <para>If the system is going to be connected to the Internet, it will |
|---|
| 21 | need some means of Domain Name Service (DNS) name resolution to |
|---|
| 22 | resolve Internet domain names to IP addresses, and vice versa. This is |
|---|
| 23 | best achieved by placing the IP address of the DNS server, available |
|---|
| 24 | from the ISP or network administrator, into |
|---|
| 25 | <filename>/etc/resolv.conf</filename>. If at least one of your network |
|---|
| 26 | interfaces is going to be configured by DHCP then you may not need to |
|---|
| 27 | create this file. By default DHCPCD will overwrite this file when it gets |
|---|
| 28 | a new lease from the DHCP server. If you wish to manually configure your |
|---|
| 29 | network interfaces or manually set your DNS using DHCP then create the |
|---|
| 30 | file by running the following:</para> |
|---|
| 31 | |
|---|
| 32 | <screen><userinput>cat > /etc/resolv.conf << "EOF" |
|---|
| 33 | <literal># Begin /etc/resolv.conf |
|---|
| 34 | |
|---|
| 35 | domain <replaceable>[Your Domain Name]</replaceable> |
|---|
| 36 | nameserver <replaceable>[IP address of your primary nameserver]</replaceable> |
|---|
| 37 | nameserver <replaceable>[IP address of your secondary nameserver]</replaceable> |
|---|
| 38 | |
|---|
| 39 | # End /etc/resolv.conf</literal> |
|---|
| 40 | EOF</userinput></screen> |
|---|
| 41 | |
|---|
| 42 | <para>The <replaceable>domain</replaceable> statement can be omitted or |
|---|
| 43 | replaced with a <replaceable>search</replaceable> statement. See the man |
|---|
| 44 | page for resolv.conf for more details.</para> |
|---|
| 45 | |
|---|
| 46 | <para>Replace <replaceable>[IP address of the nameserver]</replaceable> |
|---|
| 47 | with the IP address of the DNS most appropriate for the setup. There will |
|---|
| 48 | often be more than one entry (requirements demand secondary servers for |
|---|
| 49 | fallback capability). If you only need or want one DNS server, remove the |
|---|
| 50 | second <emphasis>nameserver</emphasis> line from the file. The IP address |
|---|
| 51 | may also be a router on the local network.</para> |
|---|
| 52 | |
|---|
| 53 | </sect2> |
|---|
| 54 | |
|---|
| 55 | </sect1> |
|---|
