Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
HOSTS(5)		  FreeBSD File Formats Manual		      HOSTS(5)

     hosts -- host and network name database

     The hosts file associates names and IP addresses.	Each line has the fol-
     lowing format:

	   Internet address
	   Host	or network name

     Items are separated by any	number of blanks and/or	tab characters.	 A `#'
     indicates the beginning of	a comment; characters up to the	end of the
     line are not interpreted by routines which	search the file.

     The system	configuration file resolv.conf(5) controls where host name in-
     formation will be searched	for.  The mechanism provided permits the ad-
     ministrator to describe the databases to search; the databases currently
     known include DNS and the hosts database.

     When using	a name server this file	provides a backup when the name	server
     is	not running.  For the name server, it is suggested that	only a few ad-
     dresses be	included in this file.	These include addresses	for the	local
     interfaces	that ifconfig(8) needs at boot time and	a few machines on the
     local network.

     Internet addresses	are specified using either dot notation	(IPv4) or
     colon separated notation (IPv6) as	described in inet_pton(3).  Host names
     may contain any printable character other than a field delimiter, new-
     line, or comment character.


     getaddrinfo(3), gethostbyname(3), getnameinfo(3), inet_pton(3),
     resolv.conf(5), ifconfig(8), nsd(8), unbound(8)

     The hosts file format appeared in 4.2BSD.

     An	official host database used to be maintained at	the Network Informa-
     tion Control Center (NIC).

     Up	to OpenBSD 6.3,	a separate file	/etc/networks could be used to store
     network names.

     A name server should be used instead of a static file.

     Lines in /etc/hosts are limited to	BUFSIZ characters (currently 1024).
     Longer lines will be ignored.

FreeBSD	13.0			 May 28, 2019			  FreeBSD 13.0


Want to link to this manual page? Use this URL:

home | help