summaryrefslogtreecommitdiff
path: root/man/5/clunk
diff options
context:
space:
mode:
authorCharles.Forsyth <devnull@localhost>2006-12-22 20:52:35 +0000
committerCharles.Forsyth <devnull@localhost>2006-12-22 20:52:35 +0000
commit46439007cf417cbd9ac8049bb4122c890097a0fa (patch)
tree6fdb25e5f3a2b6d5657eb23b35774b631d4d97e4 /man/5/clunk
parent37da2899f40661e3e9631e497da8dc59b971cbd0 (diff)
20060303-partial
Diffstat (limited to 'man/5/clunk')
-rw-r--r--man/5/clunk44
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)