xref: /freebsd/usr.bin/finger/finger.conf.5 (revision 78be7a111af5c48b95d1c2c8f2d123d971346616)
1.\"Copyright (c) 2000 Mark Knight <markk@knigma.org>
2.\"All rights reserved.
3.\"
4.\"Redistribution and use in source and binary forms, with or without
5.\"modification, are permitted provided that the following conditions
6.\"are met:
7.\"1. Redistributions of source code must retain the above copyright
8.\"   notice, this list of conditions and the following disclaimer.
9.\"2. Redistributions in binary form must reproduce the above copyright
10.\"   notice, this list of conditions and the following disclaimer in the
11.\"   documentation and/or other materials provided with the distribution.
12.\"
13.\"THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\"ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\"IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\"ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\"FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\"DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\"OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\"HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\"LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\"OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\"SUCH DAMAGE.
24.\"
25.\"$FreeBSD$
26.\"
27.Dd August 16, 2000
28.Dt FINGER.CONF 5
29.Os
30.Sh NAME
31.Nm finger.conf
32.Nd
33.Xr finger 1
34alias configuration file
35.Sh DESCRIPTION
36The optional
37.Nm
38file is used to provide aliases that can be fingered by local
39and network users.
40This may be useful where a user's login name is not the same
41as their preferred mail address, or for providing virtual login names
42than can be fingered.
43.Pp
44Lines beginning with ``#'' are comments.
45Other lines must consist of an
46alias name and a target name separated by a colon.
47A target name should be either a user, a forward
48reference to another alias or the path of a world readable file.
49.Pp
50Where an alias points to a file, the contents of that file will be displayed
51when the alias is fingered.
52.Sh EXAMPLES
53.Bd -literal
54# /etc/finger.conf alias definition file
55#
56# Format alias:(user|alias)
57#
58# Individual aliases
59#
60markk:mkn
61john.smith:dev329
62john:dev329
63sue:/etc/finger/sue.txt
64#
65# Network status message
66#
67status:/usr/local/etc/status.txt
68#
69# Administrative redirects
70#
71root:admin
72postmaster:admin
73abuse:admin
74#
75# For the time being, 'sod' is sysadmin.
76#
77admin:sod
78.Ed
79.Sh FILES
80.Bl -tag -width /etc/finger.conf -compact
81.It Pa /etc/finger.conf
82.Xr finger 1
83alias definition data base
84.El
85.Sh SEE ALSO
86.Xr finger 1
87.Sh HISTORY
88Support for the
89.Nm
90file was submitted by Mark Knight <markk@knigma.org> and first appeared in
91.Fx 4.2 .
92