1 files changed, 44 insertions, 0 deletions
diff --git a/man/5/clunk b/man/5/clunk
new file mode 100644
index 00000000..b21eba0a
--- /dev/null
+++ b/man/5/clunk
@@ -0,0 +1,44 @@
+.TH CLUNK 5 
+.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
+A
+.B clunk
+message is generated when a file descriptor is closed (usually by the garbage collector)
+and indirectly by other actions such as failed
+.I open
+calls.
+.SH SEE ALSO
+.IR sys-open (2)