xref: /freebsd/usr.bin/finger/finger.conf.5 (revision 040864ac7a706ff9f138d9f0d77373722c64167c)
1098c6e87SBrian Somers.\"Copyright (c) 2000 Mark Knight <markk@knigma.org>
2098c6e87SBrian Somers.\"All rights reserved.
3098c6e87SBrian Somers.\"
4098c6e87SBrian Somers.\"Redistribution and use in source and binary forms, with or without
5098c6e87SBrian Somers.\"modification, are permitted provided that the following conditions
6098c6e87SBrian Somers.\"are met:
7098c6e87SBrian Somers.\"1. Redistributions of source code must retain the above copyright
8098c6e87SBrian Somers.\"   notice, this list of conditions and the following disclaimer.
9098c6e87SBrian Somers.\"2. Redistributions in binary form must reproduce the above copyright
10098c6e87SBrian Somers.\"   notice, this list of conditions and the following disclaimer in the
11098c6e87SBrian Somers.\"   documentation and/or other materials provided with the distribution.
12098c6e87SBrian Somers.\"
13098c6e87SBrian Somers.\"THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14098c6e87SBrian Somers.\"ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15098c6e87SBrian Somers.\"IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16098c6e87SBrian Somers.\"ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17098c6e87SBrian Somers.\"FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18098c6e87SBrian Somers.\"DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19098c6e87SBrian Somers.\"OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20098c6e87SBrian Somers.\"HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21098c6e87SBrian Somers.\"LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22098c6e87SBrian Somers.\"OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23098c6e87SBrian Somers.\"SUCH DAMAGE.
24098c6e87SBrian Somers.\"
25098c6e87SBrian Somers.\"$FreeBSD$
26098c6e87SBrian Somers.\"
27098c6e87SBrian Somers.Dd August 16, 2000
28098c6e87SBrian Somers.Dt FINGER.CONF 5
292087b453SSheldon Hearn.Os
30098c6e87SBrian Somers.Sh NAME
31098c6e87SBrian Somers.Nm finger.conf
32098c6e87SBrian Somers.Nd
33098c6e87SBrian Somers.Xr finger 1
34098c6e87SBrian Somersalias configuration file
35098c6e87SBrian Somers.Sh DESCRIPTION
36098c6e87SBrian SomersThe optional
372087b453SSheldon Hearn.Nm
38098c6e87SBrian Somersfile is used to provide aliases that can be fingered by local
39098c6e87SBrian Somersand network users.
40098c6e87SBrian SomersThis may be useful where a user's login name is not the same
41040864acSBrian Somersas their preferred mail address, or for providing virtual login names
42040864acSBrian Somersthan can be fingered.
43098c6e87SBrian Somers.Pp
44098c6e87SBrian SomersLines beginning with ``#'' are comments.
45098c6e87SBrian SomersOther lines must consist of an
46098c6e87SBrian Somersalias name and a target name separated by a colon.
47040864acSBrian SomersA target name should be either a user, a forward
48040864acSBrian Somersreference to another alias or the path of a world readable file.
49040864acSBrian Somers.Pp
50040864acSBrian SomersWhere an alias points to a file, the contents of that file will be displayed
51040864acSBrian Somerswhen the alias is fingered.
52098c6e87SBrian Somers.Sh EXAMPLES
53098c6e87SBrian Somers.Bd -literal
54098c6e87SBrian Somers# /etc/finger.conf alias definition file
55098c6e87SBrian Somers#
56098c6e87SBrian Somers# Format alias:(user|alias)
57098c6e87SBrian Somers#
58098c6e87SBrian Somers# Individual aliases
59098c6e87SBrian Somers#
60098c6e87SBrian Somersmarkk:mkn
61098c6e87SBrian Somersjohn.smith:dev329
62098c6e87SBrian Somersjohn:dev329
63040864acSBrian Somerssue:/etc/finger/sue.txt
64040864acSBrian Somers#
65040864acSBrian Somers# Network status message
66040864acSBrian Somers#
67040864acSBrian Somersstatus:/usr/local/etc/status.txt
68098c6e87SBrian Somers#
69098c6e87SBrian Somers# Administrative redirects
70098c6e87SBrian Somers#
71098c6e87SBrian Somersroot:admin
72098c6e87SBrian Somerspostmaster:admin
73098c6e87SBrian Somersabuse:admin
74098c6e87SBrian Somers#
75098c6e87SBrian Somers# For the time being, 'sod' is sysadmin.
76098c6e87SBrian Somers#
77098c6e87SBrian Somersadmin:sod
78098c6e87SBrian Somers.Ed
79098c6e87SBrian Somers.Sh FILES
80098c6e87SBrian Somers.Bl -tag -width /etc/finger.conf -compact
81098c6e87SBrian Somers.It Pa /etc/finger.conf
82098c6e87SBrian Somers.Xr finger 1
83098c6e87SBrian Somersalias definition data base
84098c6e87SBrian Somers.El
85098c6e87SBrian Somers.Sh SEE ALSO
862087b453SSheldon Hearn.Xr finger 1
87098c6e87SBrian Somers.Sh HISTORY
88098c6e87SBrian SomersSupport for the
892087b453SSheldon Hearn.Nm
90098c6e87SBrian Somersfile was submitted by Mark Knight <markk@knigma.org> and first appeared in
91098c6e87SBrian Somers.Fx 5.0 .
92