[thirdparty/man-pages.git] / man5 / networks.5

.\" Copyright (c) 2001 Martin Schulze <joey@infodrom.org>
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, see
.\" <http://www.gnu.org/licenses/>.
.\" %%%LICENSE_END
.\"
.\" 2008-09-04, mtk, taken from Debian downstream, with a few light edits
.\"
.TH NETWORKS 5 2008-09-04 "GNU/Linux" "Linux System Administration"
.SH NAME
networks \- network name information
.SH DESCRIPTION
The file
.I /etc/networks
is a plain ASCII file that describes known DARPA networks and symbolic
names for these networks.
Each line represents a network and has the following structure:
.PP
.RS
.I name number aliases ...
.RE
.PP
where the fields are delimited by spaces or tabs.
Empty lines are ignored.
The hash character (\fB#\fP) indicates the start of a comment:
this character, and the remaining characters up to
the end of the current line,
are ignored by library functions that process the file.
.PP
The field descriptions are:
.TP
.I name
The symbolic name for the network.
Network names can contain any printable characters except
white-space characters or the comment character.
.TP
.I number
The official number for this network in numbers-and-dots notation (see
.BR inet (3)).
The trailing ".0" (for the host component of the network address) may be omitted.
.TP
.I aliases
Optional aliases for the network.
.PP
.PP
This file is read by the
.BR route (8)
and
.BR netstat (8)
utilities.
Only Class A, B or C networks are supported, partitioned networks
(i.e., network/26 or network/28) are not supported by this facility.
.SH FILES
.TP
.I /etc/networks
The networks definition file.
.SH SEE ALSO
.BR getnetbyaddr (3),
.BR getnetbyname (3),
.BR getnetent (3),
.BR netstat (8),
.BR route (8)
Commit	Line	Data
ed26d24c MK	1	.\" Copyright (c) 2001 Martin Schulze <joey@infodrom.org>
ed26d24c MK	2	.\"
1dd72f9c	3	.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
ed26d24c MK	4	.\" This is free documentation; you can redistribute it and/or
	5	.\" modify it under the terms of the GNU General Public License as
	6	.\" published by the Free Software Foundation; either version 2 of
	7	.\" the License, or (at your option) any later version.
	8	.\"
	9	.\" The GNU General Public License's references to "object code"
	10	.\" and "executables" are to be interpreted as the output of any
	11	.\" document formatting or typesetting system, including
	12	.\" intermediate and printed output.
	13	.\"
	14	.\" This manual is distributed in the hope that it will be useful,
	15	.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
	16	.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	17	.\" GNU General Public License for more details.
	18	.\"
	19	.\" You should have received a copy of the GNU General Public
c715f741 MK	20	.\" License along with this manual; if not, see
c715f741 MK	21	.\" <http://www.gnu.org/licenses/>.
6a8d8745	22	.\" %%%LICENSE_END
6a717e5e	23	.\"
ed26d24c MK	24	.\" 2008-09-04, mtk, taken from Debian downstream, with a few light edits
	25	.\"
	26	.TH NETWORKS 5 2008-09-04 "GNU/Linux" "Linux System Administration"
	27	.SH NAME
	28	networks \- network name information
	29	.SH DESCRIPTION
	30	The file
	31	.I /etc/networks
	32	is a plain ASCII file that describes known DARPA networks and symbolic
	33	names for these networks.
	34	Each line represents a network and has the following structure:
2dad4c59	35	.PP
ed26d24c MK	36	.RS
	37	.I name number aliases ...
	38	.RE
2dad4c59	39	.PP
ed26d24c MK	40	where the fields are delimited by spaces or tabs.
	41	Empty lines are ignored.
	42	The hash character (\fB#\fP) indicates the start of a comment:
	43	this character, and the remaining characters up to
	44	the end of the current line,
	45	are ignored by library functions that process the file.
2dad4c59	46	.PP
ed26d24c	47	The field descriptions are:
ed26d24c MK	48	.TP
	49	.I name
	50	The symbolic name for the network.
1661524f	51	Network names can contain any printable characters except
ed26d24c MK	52	white-space characters or the comment character.
	53	.TP
	54	.I number
	55	The official number for this network in numbers-and-dots notation (see
	56	.BR inet (3)).
	57	The trailing ".0" (for the host component of the network address) may be omitted.
	58	.TP
	59	.I aliases
	60	Optional aliases for the network.
dd3568a1	61	.PP
2dad4c59	62	.PP
ed26d24c MK	63	This file is read by the
	64	.BR route (8)
	65	and
	66	.BR netstat (8)
	67	utilities.
	68	Only Class A, B or C networks are supported, partitioned networks
eeeffe2d	69	(i.e., network/26 or network/28) are not supported by this facility.
ed26d24c MK	70	.SH FILES
	71	.TP
	72	.I /etc/networks
	73	The networks definition file.
47297adb	74	.SH SEE ALSO
ed26d24c MK	75	.BR getnetbyaddr (3),
	76	.BR getnetbyname (3),
	77	.BR getnetent (3),
3e5c319e MK	78	.BR netstat (8),
3e5c319e MK	79	.BR route (8)