xref: /openbsd/usr.sbin/ypserv/mkalias/mkalias.8 (revision 097a140d)
1.\"	$OpenBSD: mkalias.8,v 1.12 2020/11/01 21:32:04 jmc Exp $
2.\"
3.\" Copyright (c) 1997 Mats O Jansson <moj@stacken.kth.se>
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
16.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
19.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23.\" LIABILITY, 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 $Mdocdate: November 1 2020 $
28.Dt MKALIAS 8
29.Os
30.Sh NAME
31.Nm mkalias
32.Nd a YP map conversion program
33.Sh SYNOPSIS
34.Nm mkalias
35.Op Fl nv
36.Oo
37.Fl E | e
38.Op Fl du
39.Oc
40.Ar input
41.Op Ar output
42.Sh DESCRIPTION
43.Nm
44is used to convert a mail.aliases map to a mail.byaddr map.
45This is an inverse map of user@host (or user!host) back to alias.
46.Pp
47The options are as follows:
48.Bl -tag -width Ds
49.It Fl d
50Assume domain names are OK.
51Only useful together with
52.Fl E
53or
54.Fl e .
55.It Fl E
56Same as
57.Fl e ,
58but also check for any MX-record.
59.It Fl e
60Check host to verify that it exists.
61.It Fl n
62Capitalize name. e.g., mats.o.jansson becomes Mats.O.Jansson.
63.It Fl u
64Assume UUCP names are OK.
65Only useful together with
66.Fl E
67or
68.Fl e .
69.It Fl v
70Verbose mode.
71.It Ar input
72Use this map as input.
73.It Ar output
74Use this map as output.
75If the output map isn't given, don't create database.
76Can be useful together with
77.Fl E
78or
79.Fl e .
80.El
81.Sh SEE ALSO
82.Xr yp 8 ,
83.Xr ypserv 8
84.Sh AUTHORS
85.An Mats O Jansson Aq Mt moj@stacken.kth.se
86.Sh BUGS
87.Nm
88on SunOS 4.1.x seems to have a
89.Fl s .
90Since I don't know what it is supposed to do I haven't implemented it.
91But it is accepted by the program.
92