man/man5/hosts.5

   1 .TH HOSTS 5
   2 .SH NAME
   3 hosts \- hostname to IP address database
   4 .SH SYNOPSIS
   5 .B /etc/hosts
   6 .SH DESCRIPTION
   7 The hosts database lists the IP addresses and the hostnames that translate
   8 to these IP addresses.  It is used by
   9 .BR nonamed (8)
  10 in a network without name servers.  A simple
  11 .B /etc/hosts
  12 may look like this:
  13 .PP
  14 .RS
  15 .ta +15n
  16 .nf
  17 10.0.0.1        flotsam
  18 10.0.0.2        jetsam
  19 .fi
  20 .RE
  21 .PP
  22 These two entries give names to two IP addresses.  The file may contain
  23 comments marked with '#'.
  24 .PP
  25 You can have aliases (more hostnames on the same line) to give a machine
  26 more than one name, like
  27 .BR www ,
  28 if you run a web server on one.
  29 .PP
  30 If your PC is Internet connected then you can specify the name server(s)
  31 to get more information from with %nameserver entries:
  32 .PP
  33 .RS
  34 .ta +\w'172.16.24.3'u+4m +\w'%nameserver'u+4m
  35 .nf
  36 172.16.24.3     %nameserver     # dns1.example.com
  37 172.16.24.6     %nameserver     # dns2.example.com
  38 .fi
  39 .RE
  40 .PP
  41 Read
  42 .BR nonamed (8)
  43 for all the details on special host file entries that configure
  44 .B nonamed
  45 for use on the Internet, and on home machines that are occasionally
  46 connected to the Internet.
  47 .SH FILES
  48 .TP 15n
  49 /etc/hosts
  50 Hosts database.
  51 .SH "SEE ALSO"
  52 .BR ethers (5),
  53 .BR nonamed (8),
  54 .BR dhcpd (8),
  55 .BR boot (8).
  56 .SH AUTHOR
  57 Kees J. Bot (kjb@cs.vu.nl)