V8/usr/man/man9/faced.9

Compare this file to the similar file:
Show the results in this format: 

.TH FACED 9.5
.SH NAME
faced \- network face server
.SH SYNOPSIS
.B /usr/net/face.go
.SH DESCRIPTION
The network face server provides a database of 48\(mu48 bit icons
and other facial representations.
It is implemented as a network file system similar to
.IR netfs (8).
.PP
The file system, conventionally mounted on
.IR /n/face ,
has a fixed three-level hierarchy.
The first level is a machine name,
the second level a user name,
and the third level a resolution.
Thus the file
.I /n/face/kwee/pjw/48x48x1
is the standard face icon (for user pjw) on machine kwee:
.sp .5
.ce 1000
.nf
.ps 6
.ft H
.tr x.
.tr -
.cs H 5
.vs 8u
-------------------xxxxxx-x---------------------
-----------------xxxxxxxxxxxxx------------------
----------------xxxxxxx-xxxxxxxx----------------
---------------xx-xxxxxxx-xxxxxxxx--------------
---------------xxxx-xxxxxxxxx-x-xxx-------------
--------------x---------xxxxxxxxxxxxx-----------
--------------x----------xxxxxxxxxxxxxxxx-------
---------------------------xxxxx-xxxxxx---------
------------xx-------------xxxxxxxxxxxxxxx------
---------------------------x-x-xxxxxxxxxxx------
----------xx---------------xxxxxxxxxxxxxxxxx----
---------xxx----------------xxxxxxxxxxx-x-xx----
--------xx-------------------xxxxxxxxxxxxxxxx---
--------xxx------------------xxxxxxxxxxxxxx-x---
-------xxxx-------------------xxxxxxxxxxxxxxx---
------xxxx---------------------xxxxxxxxxxxxxx---
------xxxxx--------------------xxxxxxxxxxxxxx---
-----xxxxx----x-x---------------xxxxxxxxxxxx----
----xxxxxxxxx-x-xxxxx-----xxxxxxx-xxxxxxxxxxx---
----xxxxxxx------xxxxx---xx--xxxxxxxxxxxxxxxx---
---xxxxxxxxx---xxxx-xxxxxxxxx--x-xxxxxxxxxxxx---
---xxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx---
---xxxxxxxxx-x-xx-x--x--xxxxxxxxxxxxxxxxxxxxx---
---xxxxxxx-x------x--x---xxxxxxxxxxxxxxxxxxx----
----xxxxxxx-----x--------x---x-xxxxxxxxxxxxx----
---xxxxxx-x---------x----xxx------xxxxxxxxxx----
------xx--x--------------xx-----xx-xxxxxxxx-----
----x-xxx----------x------xx-------xxxxxx-------
-------xx------x-xx--------xxxxxxxxx-xxxx-------
--------x----x-x-x-------x-xx-x--x-xxxxx--------
--------------------x-xxxxxxx-xxxxxxxxxx--------
-------xx----------xxxxxxxx-x---xxx-xxx---------
------xxx------------xxxxxxx--x-x-xxxxx---------
-------xx-----x-------xxxx-x-x-xxxx-xxxxxx------
--------x----------------xxx-x-x-xxxxxxxx-------
-------xxx-----xxx-x-x-xxx-xxx-x-x--xxxxx-------
--------xx-----x-x-x-xxxxxxxxxxxxxxxxxxxx-------
---------x----------------xxx--x-xxxxxxx--------
---------xx--------------xx-x-xxxx--xxx---------
-------------x-----xxxxxxxx-x-xx-xx-------------
---------------------xxxxxxxxxxxxxxxx-----------
--------------x------------x-x-xx-x-------------
-------------------------x-x-xxxxx--------------
--------------x-----------xxxxxx-x--------------
----------------x--------x--x-xxxx--------------
--------------x-x-xxx-xxxxxxxxx-x---------------
----------------x---xxxxxxxxx-xxxx--------------
---------------x-xxxx-x-x-xxxxxxxx--------------
.tr --
.tr xx
.fi
.vs
.ps
.ce 0
.ft
Many local users also have 512\(mu512 byte high-resolution faces, named
.IR 512x512x8 .
Other resolutions may also be present for a particular face.
One-bit images are stored in the format used by
.IR icon (9.1);
eight-bit images are arrays of bytes.
The directories for machines sharing a user community, such as those on
a Datakit node, are linked together and given a name appropriate to the
community.  For example,
.I /n/face/kwee
is a link to
.IR /n/face/astro .
.PP
To access the face for a mail name
.IR machine ! uid
take the result of the first successful open from the following list of files:
.IP
.nf
/n/face/machine/uid/48x48x1
/n/face/misc./uid/48x48x1
/n/face/machine/unknown/48x48x1
/n/face/misc./unknown/48x48x1
.fi
.PP
The directory
.I misc.
holds faces for generic users such as
.I root
and
.IR uucp .
The face server is made available on a machine by running
.I /usr/net/face.go
from
.IR rc (8).
.PP
The face server data is kept on kwee,
and is administered by a pair of
.SM ASCII
files that associate related
machines and faces.
The machine table
.I machine.tab
attaches machines to communities; the line
.IP
kwee=astro
.PP
puts the machine
.I kwee
in community
.IR astro .
The people table associates a machine/user pair in the
face server with a file on kwee;
.IP
astro/pjw=pjweinberger
.PP
causes the images stored in disk files named
.I pjweinberger
to be available in the face server in directory
.IR /n/face/astro/pjw .
As well, each disk file used by the face server is linked
(by its original name) into the directory
.I /n/face/48x48x1
or
.I /n/face/512x512x8
for easy access to all the images.
.SH FILES
.ta \w'/n/kwee/usr/net/face/machine.tab  'u
/n/kwee/usr/jerq/icon/face48	directory of low resolution faces
.br
/n/kwee/t0/face/512x512x8	directory of high resolution faces
.br
/n/kwee/usr/net/face/people.tab	people/file equivalences
.br
/n/kwee/usr/net/face/machine.tab	machine/community equivalences
.SH SEE ALSO
netfs(8), face(9.1), icon(9.1), sysmon(9.1)
.SH BUGS
After updating the tables, an indeterminate time may pass before the
new faces are available.
.br
All face server files are unwritable.