Browse Source

Plan 9 from Bell Labs 2003-09-03

David du Colombier 20 years ago
parent
commit
f51d959603
5 changed files with 134 additions and 9 deletions
  1. 4 3
      dist/replica/plan9.db
  2. 4 0
      dist/replica/plan9.log
  3. 116 0
      sys/man/1/face
  4. 6 4
      sys/man/6/face
  5. 4 2
      sys/src/cmd/auth/secstore/secstored.c

+ 4 - 3
dist/replica/plan9.db

@@ -77,7 +77,7 @@
 386/bin/auth/rsagen - 775 sys sys 1057955567 152977
 386/bin/auth/secretpem - 775 sys sys 1045537944 118526
 386/bin/auth/secstore - 775 sys sys 1062277697 188052
-386/bin/auth/secstored - 775 sys sys 1062277702 193922
+386/bin/auth/secstored - 775 sys sys 1062525364 193939
 386/bin/auth/secuser - 775 sys sys 1062277712 151114
 386/bin/auth/status - 775 sys sys 1020319060 738
 386/bin/auth/uniq - 775 sys sys 1056364188 61793
@@ -4521,6 +4521,7 @@ sys/man/1/ed - 664 sys sys 961259286 13916
 sys/man/1/emacs - 664 sys sys 944959673 199
 sys/man/1/eqn - 664 sys sys 944959675 5655
 sys/man/1/expect - 664 sys sys 1058791094 3023
+sys/man/1/face - 664 sys sys 1062505426 2278
 sys/man/1/faces - 664 sys sys 1045501346 2052
 sys/man/1/factor - 664 sys sys 957920005 1019
 sys/man/1/file - 664 sys sys 1015024739 1578
@@ -4871,7 +4872,7 @@ sys/man/6/a.out - 664 sys sys 1015024888 7155
 sys/man/6/ar - 664 sys sys 944959678 2092
 sys/man/6/authsrv - 664 sys sys 1035840090 10534
 sys/man/6/color - 664 sys sys 988225304 5181
-sys/man/6/face - 664 sys sys 958504753 2815
+sys/man/6/face - 664 sys sys 1062505426 2846
 sys/man/6/font - 664 sys sys 954089525 2528
 sys/man/6/image - 664 sys sys 988225304 6209
 sys/man/6/keyboard - 664 sys sys 984709638 4467
@@ -6725,7 +6726,7 @@ sys/src/cmd/auth/secstore/secacct.c - 644 sys sys 1015008431 755
 sys/src/cmd/auth/secstore/secchk.c - 664 sys sys 1055698993 560
 sys/src/cmd/auth/secstore/secstore.c - 664 sys sys 1062277640 12269
 sys/src/cmd/auth/secstore/secstore.h - 664 sys sys 1041890053 841
-sys/src/cmd/auth/secstore/secstored.c - 664 sys sys 1062277641 7952
+sys/src/cmd/auth/secstore/secstored.c - 664 sys sys 1062525349 7978
 sys/src/cmd/auth/secstore/secuser.c - 664 sys sys 1061842567 4914
 sys/src/cmd/auth/secstore/util.c - 664 sys sys 1021579985 1498
 sys/src/cmd/auth/secureidcheck.c - 664 sys sys 1045504896 8973

+ 4 - 0
dist/replica/plan9.log

@@ -13118,3 +13118,7 @@
 1062444690 1 a lib/face/48x48x8/m/matt.h.1 - 664 sys sys 1062443541 1161
 1062460902 0 c sys/src/cmd/faces/facedb.c - 664 sys sys 1062460263 9927
 1062460902 1 c sys/src/cmd/faces/mkfile - 664 sys sys 1062460262 355
+1062505863 0 a sys/man/1/face - 664 sys sys 1062505426 2278
+1062505863 1 c sys/man/6/face - 664 sys sys 1062505426 2846
+1062525684 0 c 386/bin/auth/secstored - 775 sys sys 1062525364 193939
+1062525684 1 c sys/src/cmd/auth/secstore/secstored.c - 664 sys sys 1062525349 7978

+ 116 - 0
sys/man/1/face

@@ -0,0 +1,116 @@
+.TH FACES 1
+.SH NAME
+faces, seemail, vwhois \-  mailbox interface
+.SH SYNOPSIS
+.B faces
+[
+.B -ih
+] [
+.B -m
+.I maildir
+]
+.br
+.B seemail
+.br
+.B vwhois
+.I person
+\&...
+.SH DESCRIPTION
+The
+.I faces
+command monitors incoming mail and
+displays in its window a representation of the user's mail box
+using a small image for each message.
+The image is typically a portrait of the sender. Which image to 
+display is determined by two directories /usr/$user/lib/face 
+and /lib/face. Entries in /usr/$user/lib/face take priority over 
+those in /lib/face. See 
+.IR face(6),
+.I
+for how these directories are organised.
+.PP
+If the user is running
+.IR plumber (4),
+.I faces
+reacts to plumb messages to the
+.B seemail
+port,
+typically from
+.BR upas/fs ,
+and is thus notified of message additions and deletions.
+.PP
+Right-clicking on a message icon causes that message to be `plumbed' to
+.BR showmail .
+A typical plumb action will be to display the message, such as by
+the rule
+.EX
+    plumb start window mail -s $0
+.EE
+The
+.IR acme (1)
+mail reader listens to the
+.B showmail
+port automatically.
+.PP
+If the user is not running
+.IR plumber ,
+.I faces
+reads the log file
+.F /sys/log/mail
+and right-clicking has no effect.
+.PP
+If arrows are visible, clicking on them will scroll the display.
+Middle-clicking on the arrows scrolls to the end.
+.PP
+Starting
+.B faces
+with the
+.B -i
+flag causes
+.B faces
+to read the messages in
+.B /mail/fs/mbox
+upon startup.
+.PP
+The
+.B -m
+option directs
+.I faces
+to watch for messages arriving in
+.I maildir
+as well as in
+.BR /mail/fs/mbox .
+However, only
+.BR /mail/fs/mbox
+is used to load the initial set of faces.
+.PP
+The
+.B -h
+flag causes a different, venerable behavior in which
+the window displays the history of messages received
+rather than the current state of the mail box.
+In particular, faces are not removed from the screen when messages are deleted.
+Also, in this mode clicking button 1 in the display will clear the window.
+.PP
+.I Seemail
+is an
+.IR rc (1)
+script that invokes
+.B faces
+.BR -h .
+.PP
+.I Vwhois
+tells
+.I faces
+to display the icons of the named
+.IR persons ,
+without sending a message.
+.SH FILES
+.BR /mail/fs/mbox   "   mail directory.
+.SH "SEE ALSO"
+.IR mail (1),
+.IR marshal (1),
+.IR nedmail (1),
+.IR plumber (4),
+.IR face (6),
+.IR plumb (6)

+ 6 - 4
sys/man/6/face

@@ -2,10 +2,12 @@
 .SH NAME
 face \- face files
 .SH DESCRIPTION
-The directory
+The directories
+.B /usr/$user/lib/face
+and
 .B /lib/face
-contains a hierarchy of images of people.
-In that directory are subdirectories named by the sizes of
+contain a hierarchy of images of people.
+In those directories are subdirectories named by the sizes of
 the corresponding image files:
 .B 48x48x1
 (48 by 48 pixels, one bit per pixel);
@@ -46,7 +48,7 @@ This odd format is historical and the programs that read it
 are somewhat forgiving about blanks and the need for commas.
 .PP
 The files
-.BR /lib/face/*/.dict
+.BR  lib/face/*/.dict
 hold a correspondence between users at machines
 and face files.
 The format is

+ 4 - 2
sys/src/cmd/auth/secstore/secstored.c

@@ -24,6 +24,7 @@ static int
 getdir(SConn *conn, char *id)
 {
 	char *ls, *s; 
+	uchar *msg;
 	int n, len;
 
 	s = emalloc(Maxmsg);
@@ -40,11 +41,12 @@ getdir(SConn *conn, char *id)
 
 	/* send directory listing in Maxmsg chunks */
 	n = Maxmsg;
+	msg = (uchar*)ls;
 	while(len > 0){
 		if(len < Maxmsg)
 			n = len;
-		conn->write(conn, (uchar*)ls, n);
-		ls += n;
+		conn->write(conn, msg, n);
+		msg += n;
 		len -= n;
 	}
 	free(s);