xref: /freebsd/usr.bin/finger/finger.conf.5 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
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.Dd August 16, 2000
26098c6e87SBrian Somers.Dt FINGER.CONF 5
272087b453SSheldon Hearn.Os
28098c6e87SBrian Somers.Sh NAME
29098c6e87SBrian Somers.Nm finger.conf
30098c6e87SBrian Somers.Nd
31098c6e87SBrian Somers.Xr finger 1
32098c6e87SBrian Somersalias configuration file
33098c6e87SBrian Somers.Sh DESCRIPTION
34098c6e87SBrian SomersThe optional
352087b453SSheldon Hearn.Nm
36098c6e87SBrian Somersfile is used to provide aliases that can be fingered by local
37098c6e87SBrian Somersand network users.
38098c6e87SBrian SomersThis may be useful where a user's login name is not the same
39040864acSBrian Somersas their preferred mail address, or for providing virtual login names
40040864acSBrian Somersthan can be fingered.
41098c6e87SBrian Somers.Pp
42098c6e87SBrian SomersLines beginning with ``#'' are comments.
43098c6e87SBrian SomersOther lines must consist of an
44098c6e87SBrian Somersalias name and a target name separated by a colon.
45040864acSBrian SomersA target name should be either a user, a forward
46040864acSBrian Somersreference to another alias or the path of a world readable file.
47040864acSBrian Somers.Pp
48040864acSBrian SomersWhere an alias points to a file, the contents of that file will be displayed
49040864acSBrian Somerswhen the alias is fingered.
506c7216dfSRuslan Ermilov.Sh FILES
516c7216dfSRuslan Ermilov.Bl -tag -width /etc/finger.conf -compact
526c7216dfSRuslan Ermilov.It Pa /etc/finger.conf
536c7216dfSRuslan Ermilov.Xr finger 1
546c7216dfSRuslan Ermilovalias definition data base
556c7216dfSRuslan Ermilov.El
56098c6e87SBrian Somers.Sh EXAMPLES
57098c6e87SBrian Somers.Bd -literal
58098c6e87SBrian Somers# /etc/finger.conf alias definition file
59098c6e87SBrian Somers#
60098c6e87SBrian Somers# Format alias:(user|alias)
61098c6e87SBrian Somers#
62098c6e87SBrian Somers# Individual aliases
63098c6e87SBrian Somers#
64098c6e87SBrian Somersmarkk:mkn
65098c6e87SBrian Somersjohn.smith:dev329
66098c6e87SBrian Somersjohn:dev329
67040864acSBrian Somerssue:/etc/finger/sue.txt
68040864acSBrian Somers#
69040864acSBrian Somers# Network status message
70040864acSBrian Somers#
71040864acSBrian Somersstatus:/usr/local/etc/status.txt
72098c6e87SBrian Somers#
73098c6e87SBrian Somers# Administrative redirects
74098c6e87SBrian Somers#
75098c6e87SBrian Somersroot:admin
76098c6e87SBrian Somerspostmaster:admin
77098c6e87SBrian Somersabuse:admin
78098c6e87SBrian Somers#
79098c6e87SBrian Somers# For the time being, 'sod' is sysadmin.
80098c6e87SBrian Somers#
81098c6e87SBrian Somersadmin:sod
82098c6e87SBrian Somers.Ed
83098c6e87SBrian Somers.Sh SEE ALSO
842087b453SSheldon Hearn.Xr finger 1
85098c6e87SBrian Somers.Sh HISTORY
86098c6e87SBrian SomersSupport for the
872087b453SSheldon Hearn.Nm
88098c6e87SBrian Somersfile was submitted by Mark Knight <markk@knigma.org> and first appeared in
8978be7a11SBrian Somers.Fx 4.2 .
90