Commit | Line | Data |
---|---|---|
9e8e5516 C |
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 |