xref: /freebsd/usr.bin/finger/finger.conf.5 (revision c6ec7d31830ab1c80edae95ad5e4b9dba10c47ac)
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 FILES
53.Bl -tag -width /etc/finger.conf -compact
54.It Pa /etc/finger.conf
55.Xr finger 1
56alias definition data base
57.El
58.Sh EXAMPLES
59.Bd -literal
60# /etc/finger.conf alias definition file
61#
62# Format alias:(user|alias)
63#
64# Individual aliases
65#
66markk:mkn
67john.smith:dev329
68john:dev329
69sue:/etc/finger/sue.txt
70#
71# Network status message
72#
73status:/usr/local/etc/status.txt
74#
75# Administrative redirects
76#
77root:admin
78postmaster:admin
79abuse:admin
80#
81# For the time being, 'sod' is sysadmin.
82#
83admin:sod
84.Ed
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