| 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 | <indexterm zone="ch-network-resolv"> | 
|---|
| 14 | <primary sortas="e-/etc/resolv.conf">/etc/resolv.conf</primary> | 
|---|
| 15 | </indexterm> | 
|---|
| 16 |  | 
|---|
| 17 | <para>If the system is going to be connected to the Internet, it will | 
|---|
| 18 | need some means of Domain Name Service (DNS) name resolution to | 
|---|
| 19 | resolve Internet domain names to IP addresses, and vice versa. This is | 
|---|
| 20 | best achieved by placing the IP address of the DNS server, available | 
|---|
| 21 | from the ISP or network administrator, into | 
|---|
| 22 | <filename>/etc/resolv.conf</filename>. If at least one of your network | 
|---|
| 23 | interfaces is going to be configured by DHCP then you may not need to | 
|---|
| 24 | create this file. By default DHCPCD will overwrite this file when it gets | 
|---|
| 25 | a new lease from the DHCP server. If you wish to manually configure your | 
|---|
| 26 | network interfaces or manually set your DNS using DHCP then create the | 
|---|
| 27 | file by running the following:</para> | 
|---|
| 28 |  | 
|---|
| 29 | <screen role="nodump"><userinput>cat > /etc/resolv.conf << "EOF" | 
|---|
| 30 | <literal># Begin /etc/resolv.conf | 
|---|
| 31 |  | 
|---|
| 32 | domain <replaceable>[Your Domain Name]</replaceable> | 
|---|
| 33 | nameserver <replaceable>[IP address of your primary nameserver]</replaceable> | 
|---|
| 34 | nameserver <replaceable>[IP address of your secondary nameserver]</replaceable> | 
|---|
| 35 |  | 
|---|
| 36 | # End /etc/resolv.conf</literal> | 
|---|
| 37 | EOF</userinput></screen> | 
|---|
| 38 |  | 
|---|
| 39 | <para>The <replaceable>domain</replaceable> statement can be omitted or | 
|---|
| 40 | replaced with a <replaceable>search</replaceable> statement. See the man | 
|---|
| 41 | page for resolv.conf for more details.</para> | 
|---|
| 42 |  | 
|---|
| 43 | <para>Replace <replaceable>[IP address of the nameserver]</replaceable> | 
|---|
| 44 | with the IP address of the DNS most appropriate for the setup. There will | 
|---|
| 45 | often be more than one entry (requirements demand secondary servers for | 
|---|
| 46 | fallback capability). If you only need or want one DNS server, remove the | 
|---|
| 47 | second <emphasis>nameserver</emphasis> line from the file. The IP address | 
|---|
| 48 | may also be a router on the local network.</para> | 
|---|
| 49 |  | 
|---|
| 50 | </sect1> | 
|---|