aboutsummaryrefslogtreecommitdiff
path: root/man/man9/clunk.9p
diff options
context:
space:
mode:
authorrsc <devnull@localhost>2005-01-03 06:40:20 +0000
committerrsc <devnull@localhost>2005-01-03 06:40:20 +0000
commit058b0118a52061ad57694c01fc8763b22b789c4d (patch)
tree6685f04dea5ed68edaa34998c976aed34c55fe94 /man/man9/clunk.9p
parent2600337aa704efbeba8201e88147a764b4fd2b90 (diff)
downloadplan9port-058b0118a52061ad57694c01fc8763b22b789c4d.tar.gz
plan9port-058b0118a52061ad57694c01fc8763b22b789c4d.tar.bz2
plan9port-058b0118a52061ad57694c01fc8763b22b789c4d.zip
Some man pages.
Diffstat (limited to 'man/man9/clunk.9p')
-rw-r--r--man/man9/clunk.9p55
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.