From 9b6c0eaf748c80797c013b0e156c99b004e79124 Mon Sep 17 00:00:00 2001 From: David van Moolenbroek Date: Tue, 14 Feb 2017 23:22:42 +0000 Subject: [PATCH] Import NetBSD hosts(5) Change-Id: I0924dcc7d4eb9151b77305f370360722d4a7533a --- distrib/sets/lists/minix-base/mi | 1 + distrib/sets/lists/minix-man/mi | 2 +- etc/Makefile | 1 + etc/hosts | 19 +++++ share/man/man5/Makefile | 2 +- share/man/man5/hosts.5 | 129 +++++++++++++++++++++++++++++++ 6 files changed, 152 insertions(+), 2 deletions(-) create mode 100644 etc/hosts create mode 100644 share/man/man5/hosts.5 diff --git a/distrib/sets/lists/minix-base/mi b/distrib/sets/lists/minix-base/mi index da168f9d6..af5735f86 100644 --- a/distrib/sets/lists/minix-base/mi +++ b/distrib/sets/lists/minix-base/mi @@ -100,6 +100,7 @@ ./etc/gettytab minix-base ./etc/group minix-base ./etc/hostname.file minix-base +./etc/hosts minix-base ./etc/inet.conf minix-base obsolete ./etc/kyua minix-tests kyua ./etc/man.conf minix-base diff --git a/distrib/sets/lists/minix-man/mi b/distrib/sets/lists/minix-man/mi index 701436a3c..28169c57a 100644 --- a/distrib/sets/lists/minix-man/mi +++ b/distrib/sets/lists/minix-man/mi @@ -3284,7 +3284,7 @@ ./usr/man/man5/ftpusers.5 minix-man ./usr/man/man5/gettytab.5 minix-man ./usr/man/man5/group.5 minix-man -./usr/man/man5/hosts.5 minix-man obsolete +./usr/man/man5/hosts.5 minix-man ./usr/man/man5/http_status.5 minix-man obsolete ./usr/man/man5/httpd.conf.5 minix-man obsolete ./usr/man/man5/info.5 minix-man diff --git a/etc/Makefile b/etc/Makefile index d1fcd0199..db0128b9d 100644 --- a/etc/Makefile +++ b/etc/Makefile @@ -320,6 +320,7 @@ install-etc-files: .PHONY .MAKE check_DESTDIR MAKEDEV .for owner group mode sdir tdir files in \ ${BINOWN} ${BINGRP} ${BINMODE} ${NETBSDSRCDIR}/etc/ ${DESTDIR}/etc/ group \ ${BINOWN} ${BINGRP} ${BINMODE} ${NETBSDSRCDIR}/etc/ ${DESTDIR}/etc/ hostname.file \ + ${BINOWN} ${BINGRP} ${BINMODE} ${NETBSDSRCDIR}/etc/ ${DESTDIR}/etc/ hosts \ ${BINOWN} ${BINGRP} ${BINMODE} ${NETBSDSRCDIR}/etc/ ${DESTDIR}/etc/ mk.conf \ ${BINOWN} ${BINGRP} ${BINMODE} ${NETBSDSRCDIR}/etc/ ${DESTDIR}/etc/ motd \ ${BINOWN} ${BINGRP} ${BINMODE} ${NETBSDSRCDIR}/etc/ ${DESTDIR}/etc/ rc.conf \ diff --git a/etc/hosts b/etc/hosts new file mode 100644 index 000000000..014e066eb --- /dev/null +++ b/etc/hosts @@ -0,0 +1,19 @@ +# $NetBSD: hosts,v 1.9 2013/11/24 07:20:01 dholland Exp $ +# +# Host name database. +# +# This file contains addresses and aliases for local hosts whose names +# need to be resolvable during system boot; typically this includes only +# the address and FQDN for this machine's hostname. +# +# By default this file is consulted before DNS, so adding additional +# material here that then becomes out of date can lead to confusion. +# See nsswitch.conf(5). +# +::1 localhost localhost. +127.0.0.1 localhost localhost. +# +# RFC 1918 specifies that these networks are "internal": +# 10.0.0.0 - 10.255.255.255 (10/8 prefix) +# 172.16.0.0 - 172.31.255.255 (172.16/12 prefix) +# 192.168.0.0 - 192.168.255.255 (192.168/16 prefix) diff --git a/share/man/man5/Makefile b/share/man/man5/Makefile index f76957755..b9de96546 100644 --- a/share/man/man5/Makefile +++ b/share/man/man5/Makefile @@ -7,7 +7,7 @@ MAN= \ \ \ - \ + hosts.5 \ locale.alias.5 \ \ \ diff --git a/share/man/man5/hosts.5 b/share/man/man5/hosts.5 new file mode 100644 index 000000000..3e76ff418 --- /dev/null +++ b/share/man/man5/hosts.5 @@ -0,0 +1,129 @@ +.\" $NetBSD: hosts.5,v 1.13 2003/08/07 10:31:17 agc Exp $ +.\" +.\" Copyright (c) 1983, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" @(#)hosts.5 8.2 (Berkeley) 12/11/93 +.\" +.Dd November 17, 2000 +.Dt HOSTS 5 +.Os +.Sh NAME +.Nm hosts +.Nd host name data base +.Sh DESCRIPTION +The +.Nm hosts +file contains information regarding the known hosts on the network. +It can be used in conjunction with the DNS, and the +.Tn NIS +maps +.Sq hosts.byaddr , +and +.Sq hosts.byname , +as controlled by +.Xr nsswitch.conf 5 . +.Pp +For each host a single line should be present +with the following information: +.Dl address hostname [alias ...] +.Pp +These are: +.Bl -tag -width hostname -compact -offset indent +.It Em address +Internet address +.It Em hostname +Official host name +.It Em alias +Alias host name +.El +.Pp +Items are separated by any number of blanks and/or +tab characters. A hash sign +.Pq Dq \&# +indicates the beginning of +a comment; characters up to the end of the line are +not interpreted by routines which search the file. +.Pp +When using the name server +.Xr named 8 , +or +.Xr ypserv 8 , +this file provides a backup when the name server +is not running. +For the name server, it is suggested that only a few addresses +be included in this file. +These include address for the local interfaces that +.Xr ifconfig 8 +needs at boot time and a few machines on the local network. +.Pp +This file may be created from the official host +data base maintained at the Network Information Control +Center +.Pq Tn NIC , +though local changes may be required +to bring it up to date regarding unofficial aliases +and/or unknown hosts. As the data base maintained at +.Tn NIC +is incomplete, use of the name server is recommended for +sites on the +.Tn DARPA +Internet. +.Pp +As network addresses, both IPv4 and IPv6 addresses are allowed. +IPv4 addresses are specified in the conventional dot +.Pq Dq \&. +notation using the +.Xr inet_pton 3 +routine +from the Internet address manipulation library, +.Xr inet 3 . +IPv6 addresses are specified in the standard hex-and-colon notation. +Host names may contain any printable +character other than a field delimiter, newline, +or comment character. +.Sh FILES +.Bl -tag -width /etc/hosts -compact +.It Pa /etc/hosts +The +.Nm hosts +file resides in +.Pa /etc . +.El +.Sh SEE ALSO +.Xr gethostbyname 3 , +.Xr nsswitch.conf 5 , +.Xr ifconfig 8 , +.Xr named 8 +.Rs +.%T "Name Server Operations Guide for BIND" +.Re +.Sh HISTORY +The +.Nm +file format appeared in +.Bx 4.2 . -- 2.44.0