plan9port

fork of plan9port with libvec, libstr and libsdb
Log | Files | Refs | README | LICENSE

clunk.9p (890B)


      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.