.TH GETFN 1 "September 17, 2002" CSLib "CSLib Utilities"
.nh
.SH NAME
getfn \- Get a user's full name from their email address in ECS
.SH SYNOPSIS
.B getfn
[ \fB-i\fP ] \fBusername\fP [ \fB...\fP ]
.SH DESCRIPTION
.B getfn
will get the full name of a username from the system passwd file. This 
is designed as an external query program for the mutt mail client.
.PP
.B getfn
runs two queries. First, it looks to see if the username exists. If it
does, it outputs the full name and email address, then exits. This is
useful for 'tab' (actually, it's Ctrl+t) email address completion in mutt. 
If the username does not exist, it then traverses the passwd file looking 
for any entries that contain the query string in the username or the full 
name, then prints out a list of these users' names and email addresses.
You can execute a query like this at any time in mutt using 'Q'.
.SH USAGE
Run
.B getfn
followed by a username or part of a username or user's full name (or
multiple instances of such a value), and it will return a list of
usernames and full names matching that value.
.TP
\fB-i\fP
This will do case-insensitive searching.
.SH LIMITATIONS
This program is designed specifically for use in University of 
Southampton Department of Electronics and Computer Science only, 
since for speed it queries NIS databases rather than using getpwent(3),
and it automatically appends @ecs.soton.ac.uk as the domain name.
.SH AUTHOR
.B getfn
was written by Alan Ford <ajf101@ecs.soton.ac.uk> <alan@whirlnet.co.uk>
for use with the CSLib (http://www.cslib.ecs.soton.ac.uk) installation
of mutt on the ECS systems.
.SH SEE ALSO
.BR mutt (1)