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