| 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> | 
|---|