commit cab30d8aa7b54656ecc26710b5942cd9578d909c
from: Omar Polo <op@omarpolo.com>
date: Sat Jan 22 16:04:53 2022 UTC

document wstat

commit - 2254cace9c3b8b5240b19e60f6358902b05c56ea
commit + cab30d8aa7b54656ecc26710b5942cd9578d909c
blob - 4a45918b3f66b619dd33957ed2e9b84eaa9d755d
blob + a30af2e7bb46c697b5b8db733565c6ffaa240cd4
--- kamid/9p.7
+++ kamid/9p.7
@@ -363,6 +363,26 @@ field is always present, even in the
 call.
 While it may be considered redundant, it's kept to simplify the
 parsing of the stat entries in a directory.
+.It Ic wstat
+change file attributes
+.Bd -literal
+fid[4] stat[n]
+.Aq empty response
+.Ed
+.Pp
+The
+.Sq stat
+structure is the same described in
+.Ic stat .
+.Pp
+The
+.Sq stat
+structure sent reflect what changes the client wishes to make to the
+given fid.
+To leave some fields as unchanged, use empty string or the maximum
+allowed value for integral fields.
+For example, to avoid changing the permission of the fid use
+0xFFFFFFFF, or (uint32_t)-1.
 .It Ic remove
 Remove a file
 .Bd -literal