Take the 2-minute tour ×
Ask Ubuntu is a question and answer site for Ubuntu users and developers. It's 100% free, no registration required.

can anybody describe me about dns-search directive in /etc/network/interfaces file:

iface eth0 inet static
    dns-search example.com

is it mandatory ? and how i configure it?

share|improve this question
I personally disabled this on my server, because I use IPv6, and when an address (f.e. hello.com) I was trying to connect to didn't support IPv6, the system tried to resolve hello.com.example.com instead and that yielded an IPv6 of the example.com as the result (not IPv4 address of hello.com as expected). I wrote about it in more detail here: daysleeper.cz/… –  arrange Mar 9 '13 at 11:28
@arrange, thanks in advance –  pylover Mar 9 '13 at 13:27

1 Answer 1

up vote 10 down vote accepted

dns-search determines which domain is appended for dns lookups.

Normally you will specify here the same domain as returned by hostname -f.

For detailed information see the following quote from man resolv.conf:

   search Search list for host-name lookup.
          The  search  list  is  normally  determined from the local domain name; by default, it contains only the local domain
          name.  This may be changed by listing the desired domain search path following the search keyword with spaces or tabs
          separating  the  names.  Resolver queries having fewer than ndots dots (default is 1) in them will be attempted using
          each component of the search path in turn until a match is found.  For environments with multiple  subdomains  please
          read options ndots:n below to avoid man-in-the-middle attacks and unnecessary traffic for the root-dns-servers.  Note
          that this process may be slow and will generate a lot of network traffic if the servers for the  listed  domains  are
          not local, and that queries will time out if no server is available for one of the domains.

          The search list is currently limited to six domains with a total of 256 characters.
share|improve this answer
Why isn't the dns-search directive mentioned in the man page for the interfaces file? (manpages.ubuntu.com/manpages/utopic/en/man5/interfaces.5.html) –  odigity Jan 12 at 19:41

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.