1 .TH CLUNK 9P 
2 .SH NAME
3 clunk \- forget about a fid
4 .SH SYNOPSIS
5 .ta \w'\fLTclunk 'u
6 .IR size [4]
7 .B Tclunk
8 .IR tag [2]
9 .IR fid [4]
10 .br
11 .IR size [4]
12 .B Rclunk
13 .IR tag [2]
14 .SH DESCRIPTION
15 The
16 .B clunk
17 request informs the file server
18 that the current file represented by
19 .I fid 
20 is no longer needed by the client.
21 The actual file is not removed on the server unless the fid had been opened with
22 .BR ORCLOSE .
23 .PP
24 Once a fid has been clunked,
25 the same fid can be reused in a new
26 .B walk
27 or
28 .B attach
29 request.
30 .PP
31 Even if the
32 .B clunk
33 returns an error, the
34 .I fid
35 is no longer valid.
36 .SH ENTRY POINTS
37 .B Clunk
38 transactions are
39 generated by
40 .I fsclose
41 and
42 .I fsunmount
43 (see
44 .MR 9pclient (3) )
45 and indirectly by other actions such as failed
46 .I fsopen
47 calls.
48 .\" 
49 .\" A
50 .\" .B clunk
51 .\" message is generated by
52 .\" .I close
53 .\" and indirectly by other actions such as failed
54 .\" .I open
55 .\" calls.