]> git.lizzy.rs Git - plan9front.git/blob - sys/man/5/clunk
/sys/man/*/*: fix perms (sorry)
[plan9front.git] / sys / man / 5 / clunk
1 .TH CLUNK 5 
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 A
38 .B clunk
39 message is generated by
40 .I close
41 and indirectly by other actions such as failed
42 .I open
43 calls.