summaryrefslogtreecommitdiff
path: root/static/plan9-4e/man5/clunk.5
diff options
context:
space:
mode:
Diffstat (limited to 'static/plan9-4e/man5/clunk.5')
-rw-r--r--static/plan9-4e/man5/clunk.543
1 files changed, 43 insertions, 0 deletions
diff --git a/static/plan9-4e/man5/clunk.5 b/static/plan9-4e/man5/clunk.5
new file mode 100644
index 00000000..6256b3c4
--- /dev/null
+++ b/static/plan9-4e/man5/clunk.5
@@ -0,0 +1,43 @@
+.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 by
+.I close
+and indirectly by other actions such as failed
+.I open
+calls.