XFACE(1C)

NAME
xface - face agent for X windows

SYNOPSIS
xface [-e] [-p port] [-r] [-s seconds] [-u] [=geometry] [host:display]

DESCRIPTION
This is the face agent under X windows. To access the image database, xface uses the OSI directory.

To map a hostname/username pair into a Distinguished Name, xface makes numerous searchers in the Directory, looking for any “associatedDomain” attributes contained by organizations. Once xface knows where to look, it once again searches the OSI Directory for the userid in the indicated subtree, and thence retrieve the photo attribute.

USAGE
The most common use is to start xface in the background upon login, as in:

xface -e -p 7000 -u

and then have an MH profile entry of the form:

faceproc: localhost 7000

Alternately, one can set the environment variable FACEPROC and have both xface and MH intuit the necessary values:

setenv FACEPROC “`hostname` 7000”
xface -e -u

OPTIONS
The `-e' option directs xface to not print error messages once the command line has been cracked.

The `-p port' option tells xface which UDP port to listen for requests from programs like mhl to display faces.

The `-r' option directs xface to report on its image-related activities to the file image.log in the current directory. This is useful for seeing how many hits the xface gets when using the Diretory.

The `-s seconds' option tells xface how long to sleep prior to checking for extraordinary conditions.

The `-u' option tells xface to run in the background, exiting when the parent process exits.

X DEFAULTS

BorderWidth: 2
    to specify the width of the border of the window.

ReverseVideo: off
    to invert the window.

FILES
isoaliases	ISODE aliases database
$HOME/.xface_mappings	hostname/username mappings

ENVIRONMENT
DISPLAY - the default host and display number
FACEPROC - the default host/port for the face agent

DIAGNOSTICS
Obvious.

AUTHOR
Marshall T. Rose