xref: /netbsd-src/share/man/man5/ifaliases.5 (revision c2b95373bf0fdf612ee0f8b5f5711bbc8c3d8b87)
1.\"	$NetBSD: ifaliases.5,v 1.14 2008/05/29 14:51:25 mrg Exp $
2.\"
3.\" Copyright (c) 1996 Matthew R. Green
4.\" All rights reserved.
5.\"
6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions
8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright
10.\"    notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\"    notice, this list of conditions and the following disclaimer in the
13.\"    documentation and/or other materials provided with the distribution.
14.\"
15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
20.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
21.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
22.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
23.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25.\" SUCH DAMAGE.
26.\"
27.Dd November 17, 2000
28.Dt IFALIASES 5
29.Os
30.Sh NAME
31.Nm ifaliases
32.Nd interface aliases file
33.Sh DESCRIPTION
34The
35.Nm
36file specifies the additional addresses (aliases) that each interface
37has.
38.Nm
39is processed by
40.Pa /etc/rc.d/network
41at system boot time.
42.Pp
43Each line of the file is of the form:
44.D1 address interface [netmask]
45.Pp
46The
47.Em address
48is a network address of the alias.
49This must be a number, or must be in
50.Pa /etc/hosts ,
51since the nameserver is not running at this point.
52.Pp
53The
54.Em interface
55is the network interface the alias will be configured on.
56.Pp
57The
58.Em netmask
59is the netmask of the alias' network address.
60Although this is optional, omitting the netmask is discouraged.
61Omission results in the use of the classful netmask associated with
62.Em address .
63.Sh FILES
64.Pa /etc/ifaliases ,
65.Pa /etc/rc.d/network
66.Sh HISTORY
67The
68.Nm
69file appeared in
70.Nx 1.2 .
71.Sh BUGS
72.Nm
73assumes IPv4, and does not support other protocol families.
74Please check
75.Xr rc.conf 5
76for alternatives like
77.Pa /etc/ifconfig.xxN .
78