| .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. |
