DataMuseum.dk

top - metrics - download

    Length: 5028 (0x13a4)
    Types: TextFile
    Names: »xface.1c«

└─⟦3d0c2be1b⟧ Bits:30001254 ISODE-5.0 Tape
    └─⟦eba4602b1⟧ »./isode-5.0.tar.Z« 
        └─⟦d3ac74d73⟧ 
            └─⟦this⟧ »isode-5.0/others/image/xface.1c« 

TextFile

.TH XFACE 1C "30 Dec 1988"
.\" $Header: /f/osi/others/image/RCS/xface.1c,v 6.0 89/03/18 23:35:20 mrose Rel $
.\"
.\"
.\" $Log:	xface.1c,v $
.\" Revision 6.0  89/03/18  23:35:20  mrose
.\" Release 5.0
.\" 
.SH NAME
xface \- face agent for X windows
.SH SYNOPSIS
.in +.5i
.ti -.5i
.B xface
\%[\-e]
\%[\-h\0prefix]
\%[\-p\0port]
\%[\-r]
\%[\-s\0seconds]
\%[\-u]
\%[=geometry]
\%[host:display]
.in -.5i
.SH DESCRIPTION
This is the face agent under X windows.
To access the image database,
\fIxface\fR uses the \*(lqhigher performance\*(rq nameservice to the
OSI directory.
.PP
To map a hostname/username pair into a Distinguished Name,
the user provides \fIxface\fR with a set of mappings in the file
\fB\&.xface_mappings\fR in the user's \fB$HOME\fR directory.
.PP
The format of this file is simple:
items are separated by any number of blanks and/or tab characters.
However, double-quotes may be used to prevent seperation between arguments.
The `#' character at the beginning of a line indicates a comment line.
Each line consists of two or three items.
The first item is a string denoting a hostname.
The second item is a string denoting a username.
The third item, if present, gives the corresponding Distguished Name.
.PP
The strings denoting host- and usernames may be prefixed or suffixed
with \*(lq*\*(rq in order to match 0 or more characters.
A lone \*(lq*\*(rq may be given to match either a hostname or an
username,
as appropriate.
.PP
When \fIxface\fR wishes to display a face,
it examines each hostname/username pair and tries to find a match.
If it succeeds,
it then evaluates the third item applying the following macros:
.sp
.nf
.ta \w'\fBmacro\fR  'u
\fBmacro\fR	\fBexpansion\fR
$h	hostname
$H	wild-part of hostname matched
$u	username
$U	wild-part of username matched
$a	hostname, aliased if possible
$H	wild-part of hostname matched, aliased if possible
$$	$
.re
.fi
.sp
After the evaulation,
\fIxface\fR uses the \*(lqhigher performance\*(rq nameservice to
retrieve the \fBphoto\fR attribute for the resulting Distinguished Name.
.PP
If the third item isn't present,
then \fIxface\fR interprets this as a directive to never display the
indicated face.
.PP
Here's an example of a simple \fB\&.xface_mappings\fR file:
.sp
.nf
.ta \w'cs.ucl.ac.uk  'u +\w'steve  'u 
twg.com	*	\*(lqC=US@O=TWG@OU=users@CN=$u\*(rq
cs.ucl.ac.uk	steve	\*(lqC=GB@O=UCL@OU=CS@CN=Steve Kille\*(rq
*.oz.au	*	\*(lq$A@CN=$u\*(rq
.re
.fi
.sp
The first line says that the DN for any user at \*(lqtwg.com\*(rq can be found
by simply appending their username to the DN-prefix given.
The second line precisely defines the DN for username \*(lqsteve\*(rq
at hostname \*(lqcs.ucl.ac.uk\*(rq.
The third line says that the DN for any user whose hostname ends with
\*(lqoz.au\*(rq can be found by taking the prefix of the hostname,
applying the aliasing mechanism,
and then appending their username to the resulting DN-prefix.
.PP
If no matches are found
(e.g., if the user's \fB\&.xface_mappings\fR file does not exist),
then \fIxface\fR forces a match using this entry:
.sp
.nf
.ta \w'cs.ucl.ac.uk  'u +\w'steve  'u 
*	*	prefix@CN=$u
.re
.fi
.sp
where prefix is taken from the `-h' switch after the aliasing
mechanism is applied.
.SH USAGE
The most common use is to start \fIxface\fR in the background upon login,
as in:
.sp
.ti +.5i
xface \-e \-p 7000 \-u
.sp
and then have an \fIMH\fR profile entry of the form:
.sp
.ti +.5i
faceproc: localhost 7000
.sp
Alternately,
one can set the environment variable \fBFACEPROC\fR and have both \fIxface\fR
and \fIMH\fR intuit the necessary values:
.sp
.in +.5i
setenv FACEPROC \*(lq`hostname` 7000\*(rq
.br
xface \-e \-u
.in -.5i
.SH OPTIONS
The `\-e' option directs \fIxface\fR to not print error messages once
the command line has been cracked.
.PP
The `\-h\0prefix' option tells \fIxface\fR what default designator
to use when calculating the distinguished name for each person.
Usually,
it is an alias defined in the \fIisoaliases\fR\0(5) file.
.PP
The `\-p\0port' option tells \fIxface\fR which UDP port to listen for requests
from programs like \fImhl\fR to display faces.
.PP
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 nameservice.
.PP
The `\-s\0seconds' option tells \fIxface\fR how long to sleep prior to
checking for extraordinary conditions.
.PP
The `\-u' option tells \fIxface\fR to run in the background,
exiting when the parent process exits.
.SH "X DEFAULTS"
.TP
.BR BorderWidth:\0 2
to specify the width of the border of the window.
.TP
.BR ReverseVideo:\0 off
to invert the window.
.SH FILES
.nf
.ta \w'$HOME/.xface_mappings  'u
/usr/etc/isoaliases	ISODE aliases database
$HOME/.xface_mappings	hostname/username mappings
.re
.fi
.SH ENVIRONMENT
DISPLAY \- the default host and display number
.br
FACEPROC \- the default host/port for the face agent
.SH DIAGNOSTICS
Obvious.
.SH AUTHOR
Marshall T. Rose,
The Wollongong Group