1.\" Copyright (c) 1985, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.roff%
5.\"
6.\"     @(#)aliases.5	8.1 (Berkeley) 06/16/93
7.\"
8.Dd
9.Dt ALIASES 5
10.Os BSD 4
11.Sh NAME
12.Nm aliases
13.Nd aliases file for sendmail
14.Sh SYNOPSIS
15.Nm aliases
16.Sh DESCRIPTION
17This file describes user
18.Tn ID
19aliases used by
20.Pa /usr/sbin/sendmail .
21The file resides in
22.Pa /etc
23and
24is formatted as a series of lines of the form
25.Bd -filled -offset indent
26name: name_1, name2, name_3, . . .
27.Ed
28.Pp
29The
30.Em name
31is the name to alias, and the
32.Em name_n
33are the aliases for that name.
34Lines beginning with white space are continuation lines.
35Lines beginning with
36.Ql #
37are comments.
38.Pp
39Aliasing occurs only on local names.
40Loops can not occur, since no message will be sent to any person more than once.
41.Pp
42After aliasing has been done, local and valid recipients who have a
43.Dq Pa .forward
44file in their home directory have messages forwarded to the
45list of users defined in that file.
46.Pp
47This is only the raw data file; the actual aliasing information is
48placed into a binary format in the file
49.Pa /etc/aliases.db
50using the program
51.Xr newaliases 1 .
52A
53.Xr newaliases
54command should be executed each time the aliases file is changed for the
55change to take effect.
56.Sh SEE  ALSO
57.Xr newaliases 1 ,
58.Xr dbopen 3 ,
59.Xr dbm 3 ,
60.Xr sendmail 8
61.Rs
62.%T "SENDMAIL Installation and Operation Guide"
63.Re
64.Rs
65.%T "SENDMAIL An Internetwork Mail Router"
66.Re
67.Sh BUGS
68If you have compiled
69.Xr sendmail
70with DBM support instead of NEWDB,
71you may have encounter problems in
72.Xr dbm 3
73restricting a single alias to about 1000 bytes of information.
74You can get longer aliases by ``chaining''; that is, make the last name in
75the alias be a dummy name which is a continuation alias.
76.Sh HISTORY
77The
78.Nm
79file format appeared in
80.Bx 4.0 .
81