.TH XFACE 1C "30 Dec 1988"
.\" $Header: /f/osi/others/quipu/image/RCS/xface.1c,v 7.2 91/02/22 09:33:24 mrose Interim $
.\" Revision 7.2 91/02/22 09:33:24 mrose
.\" Revision 7.1 90/07/09 14:39:38 mrose
.\" Revision 7.0 89/11/23 22:00:02 mrose
xface \- face agent for X windows
This is the face agent under X windows.
To access the image database,
\fIxface\fR uses the OSI directory.
To map a hostname/username pair into a Distinguished Name,
\fIxface\fR makes numerous searchers in the Directory,
looking for any \*(lqassociatedDomain\*(rq attributes contained by
Once \fIxface\fR knows where to look,
it once again searches the OSI Directory for the userid in the
and thence retrieve the \fBphoto\fR attribute.
The most common use is to start \fIxface\fR in the background upon login,
and then have an \fIMH\fR profile entry of the form:
one can set the environment variable \fBFACEPROC\fR and have both \fIxface\fR
and \fIMH\fR intuit the necessary values:
setenv FACEPROC \*(lq`hostname` 7000\*(rq
The `\-e' option directs \fIxface\fR to not print error messages once
the command line has been cracked.
The `\-p\0port' option tells \fIxface\fR which UDP port to listen for requests
from programs like \fImhl\fR to display faces.
The `\-r' option directs \fIxface\fR to report on its image-related
activities to the file \fBimage.log\fR in the current directory.
This is useful for seeing how many hits the \fIxface\fR gets when using
The `\-s\0seconds' option tells \fIxface\fR how long to sleep prior to
checking for extraordinary conditions.
The `\-u' option tells \fIxface\fR to run in the background,
exiting when the parent process exits.
to specify the width of the border of the window.
.ta \w'$HOME/.xface_mappings 'u
\*(EDisoaliases ISODE aliases database
$HOME/.xface_mappings hostname/username mappings
DISPLAY \- the default host and display number
FACEPROC \- the default host/port for the face agent