| 1 | .TH XFACE 1C "30 Dec 1988" |
| 2 | .\" $Header: /f/osi/others/quipu/image/RCS/xface.1c,v 7.2 91/02/22 09:33:24 mrose Interim $ |
| 3 | .\" |
| 4 | .\" |
| 5 | .\" $Log: xface.1c,v $ |
| 6 | .\" Revision 7.2 91/02/22 09:33:24 mrose |
| 7 | .\" Interim 6.8 |
| 8 | .\" |
| 9 | .\" Revision 7.1 90/07/09 14:39:38 mrose |
| 10 | .\" sync |
| 11 | .\" |
| 12 | .\" Revision 7.0 89/11/23 22:00:02 mrose |
| 13 | .\" Release 6.0 |
| 14 | .\" |
| 15 | .SH NAME |
| 16 | xface \- face agent for X windows |
| 17 | .SH SYNOPSIS |
| 18 | .in +.5i |
| 19 | .ti -.5i |
| 20 | .B xface |
| 21 | \%[\-e] |
| 22 | \%[\-p\0port] |
| 23 | \%[\-r] |
| 24 | \%[\-s\0seconds] |
| 25 | \%[\-u] |
| 26 | \%[=geometry] |
| 27 | \%[host:display] |
| 28 | .in -.5i |
| 29 | .SH DESCRIPTION |
| 30 | This is the face agent under X windows. |
| 31 | To access the image database, |
| 32 | \fIxface\fR uses the OSI directory. |
| 33 | .PP |
| 34 | To map a hostname/username pair into a Distinguished Name, |
| 35 | \fIxface\fR makes numerous searchers in the Directory, |
| 36 | looking for any \*(lqassociatedDomain\*(rq attributes contained by |
| 37 | organizations. |
| 38 | Once \fIxface\fR knows where to look, |
| 39 | it once again searches the OSI Directory for the userid in the |
| 40 | indicated subtree, |
| 41 | and thence retrieve the \fBphoto\fR attribute. |
| 42 | .SH USAGE |
| 43 | The most common use is to start \fIxface\fR in the background upon login, |
| 44 | as in: |
| 45 | .sp |
| 46 | .ti +.5i |
| 47 | xface \-e \-p 7000 \-u |
| 48 | .sp |
| 49 | and then have an \fIMH\fR profile entry of the form: |
| 50 | .sp |
| 51 | .ti +.5i |
| 52 | faceproc: localhost 7000 |
| 53 | .sp |
| 54 | Alternately, |
| 55 | one can set the environment variable \fBFACEPROC\fR and have both \fIxface\fR |
| 56 | and \fIMH\fR intuit the necessary values: |
| 57 | .sp |
| 58 | .in +.5i |
| 59 | setenv FACEPROC \*(lq`hostname` 7000\*(rq |
| 60 | .br |
| 61 | xface \-e \-u |
| 62 | .in -.5i |
| 63 | .SH OPTIONS |
| 64 | The `\-e' option directs \fIxface\fR to not print error messages once |
| 65 | the command line has been cracked. |
| 66 | .PP |
| 67 | The `\-p\0port' option tells \fIxface\fR which UDP port to listen for requests |
| 68 | from programs like \fImhl\fR to display faces. |
| 69 | .PP |
| 70 | The `\-r' option directs \fIxface\fR to report on its image-related |
| 71 | activities to the file \fBimage.log\fR in the current directory. |
| 72 | This is useful for seeing how many hits the \fIxface\fR gets when using |
| 73 | the Diretory. |
| 74 | .PP |
| 75 | The `\-s\0seconds' option tells \fIxface\fR how long to sleep prior to |
| 76 | checking for extraordinary conditions. |
| 77 | .PP |
| 78 | The `\-u' option tells \fIxface\fR to run in the background, |
| 79 | exiting when the parent process exits. |
| 80 | .SH "X DEFAULTS" |
| 81 | .TP |
| 82 | .BR BorderWidth:\0 2 |
| 83 | to specify the width of the border of the window. |
| 84 | .TP |
| 85 | .BR ReverseVideo:\0 off |
| 86 | to invert the window. |
| 87 | .SH FILES |
| 88 | .nf |
| 89 | .ta \w'$HOME/.xface_mappings 'u |
| 90 | \*(EDisoaliases ISODE aliases database |
| 91 | $HOME/.xface_mappings hostname/username mappings |
| 92 | .re |
| 93 | .fi |
| 94 | .SH ENVIRONMENT |
| 95 | DISPLAY \- the default host and display number |
| 96 | .br |
| 97 | FACEPROC \- the default host/port for the face agent |
| 98 | .SH DIAGNOSTICS |
| 99 | Obvious. |
| 100 | .SH AUTHOR |
| 101 | Marshall T. Rose |