1 files changed, 55 insertions, 0 deletions
diff --git a/man/man9/clunk.9p b/man/man9/clunk.9p
new file mode 100644
index 00000000..ef3ecdc4
--- /dev/null
+++ b/man/man9/clunk.9p
@@ -0,0 +1,55 @@
+.TH CLUNK 9P 
+.SH NAME
+clunk \- forget about a fid
+.SH SYNOPSIS
+.ta \w'\fLTclunk 'u
+.IR size [4]
+.B Tclunk
+.IR tag [2]
+.IR fid [4]
+.br
+.IR size [4]
+.B Rclunk
+.IR tag [2]
+.SH DESCRIPTION
+The
+.B clunk
+request informs the file server
+that the current file represented by
+.I fid 
+is no longer needed by the client.
+The actual file is not removed on the server unless the fid had been opened with
+.BR ORCLOSE .
+.PP
+Once a fid has been clunked,
+the same fid can be reused in a new
+.B walk
+or
+.B attach
+request.
+.PP
+Even if the
+.B clunk
+returns an error, the
+.I fid
+is no longer valid.
+.SH ENTRY POINTS
+.B Clunk
+transactions are
+generated by
+.I fsclose
+and
+.I fsunmount
+(see
+.IR 9pclient (3))
+and indirectly by other actions such as failed
+.I fsopen
+calls.
+.\" 
+.\" A
+.\" .B clunk
+.\" message is generated by
+.\" .I close
+.\" and indirectly by other actions such as failed
+.\" .I open
+.\" calls.