git: 9front

ref: abf8a2b5e3deff0a2b1b29b0bfb86f22d874f9b5
dir: /sys/man/5/clunk/

View raw version
.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.