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