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