Content-type: text/html
Manpage of GETFN
GETFN
Section: CSLib Utilities (1)
Updated: September 17, 2002
Index
Return to Main Contents
NAME
getfn - Get a user's full name and email address
SYNOPSIS
getfn
[ -i ] [ -q ] [ -f ] [ -d DOMAIN ] username [ ... ]
DESCRIPTION
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.
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'.
USAGE
Run
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.
- -i, --ignore-case
-
This will do case-insensitive searching.
- -q, --quiet
-
This will not print the 'querying...' line (which is needed for mutt).
- -f, --force-search
-
This will force searching the password file for all matches, even if there
is a user by that name in existance.
- -d, --domain=DOMAIN
-
This will set the domain name used in printed email addresses to the
one specified. If none is specified, it will default to the one specified
in the machine's hostname, and if that is not set, then the one specified
as default at compile time (by default ecs.soton.ac.uk).
- -h, --help
-
This will display usage information.
LIMITATIONS
This program has only been tested under the Department of Electronics
and Computer Science at the University of Southampton, with NIS based
searching for speed. This program should default to standard passwd
searching if no NIS is setup, however this has not been extensively tested.
AUTHOR
getfn
was written by Alan Ford
for use with the CSLib (http://www.cslib.ecs.soton.ac.uk) installation
of mutt on the ECS systems.
SEE ALSO
mutt(1),
getpwent(3),
passwd(5)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- USAGE
-
- LIMITATIONS
-
- AUTHOR
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 12:19:51 GMT, August 13, 2003