Plan 9 from Bell Labs 2003-03-06

dist/replica/plan9.db

@@ -4555,7 +4555,7 @@ sys/man/1/yacc - 664 sys sys 944959676 3273
 sys/man/1/yesterday - 664 sys sys 1044909169 2202
 sys/man/2 - 20000000775 sys sys 1017423721 0
 sys/man/2/0intro - 664 sys sys 1044724217 11574
-sys/man/2/9p - 664 sys sys 1044430182 15044
+sys/man/2/9p - 664 sys sys 1046886431 15221
 sys/man/2/9pcmdbuf - 664 sys sys 1044430197 2057
 sys/man/2/9pfid - 664 sys sys 1030451710 3644
 sys/man/2/9pfile - 664 sys sys 1017423719 4426

dist/replica/plan9.log

@@ -18192,3 +18192,4 @@
 1046817090 0 c 386/lib/ape/libap.a - 664 sys sys 1046815884 780316
 1046817090 1 c sys/include/ape/stdio.h - 664 sys sys 1046815898 4863
 1046817090 2 c sys/src/ape/lib/ap/stdio/fseek.c - 664 sys sys 1046815860 416
+1046887277 0 c sys/man/2/9p - 664 sys sys 1046886431 15221

sys/man/2/9p

@@ -247,7 +247,7 @@ similarly,
 is the
 .B Req
 structure corresponding to
-.IB r -> ifcall.oldreq \fR.
+.IB r -> ifcall.oldtag \fR.
 The outgoing response data should be stored in 
 .IB r -> ofcall \fR.
 The one exception to this rule is that 
@@ -627,23 +627,32 @@ which arrange for
 .I respond
 to be called asynchronously.
 .I Flush
-must ensure that once
-.I respond
-has been called on
-.BR r ,
-.I respond
-will 
-.I never
-be called on 
-.IB r -> oldreq \fR,
-and in fact that 
+should cause the request
 .IB r -> oldreq
-and the pointers it contains
-will never be accessed again (consider them freed).
+to be cancelled or hurried along.
+If
+.I oldreq
+is cancelled, this should be signalled by calling
+.I respond
+on
+.I oldreq
+with error string
+.RB ` interrupted '.
 .I Flush
-must 
-.I not
-call respond with a non-nil error string.
+must respond to
+.I r
+with a nil error string.
+.I Flush
+may respond to
+.I r
+before forcing a response to
+.IB r -> oldreq \fR.
+In this case, the library will delay sending
+the
+.I Rflush
+message until the response to 
+.IB r -> oldreq
+has been sent.
 .PD
 .PP
 .IR Destroyfid ,
@@ -672,7 +681,7 @@ reference count drops to zero
 .RI ( i.e. ,
 it has been handled via
 .I respond
-or has been successfully flushed),
+and other outstanding pointers to it have been closed),
 .I destroyreq
 is called to allow the program to dispose of the
 .IB r -> aux