1 058b0118 2005-01-03 devnull .TH REMOVE 9P 
 2 058b0118 2005-01-03 devnull .SH NAME
 3 058b0118 2005-01-03 devnull remove \- remove a file from a server
 4 058b0118 2005-01-03 devnull .SH SYNOPSIS
 5 058b0118 2005-01-03 devnull .ta \w'\fLTremove 'u
 6 058b0118 2005-01-03 devnull .IR size [4]
 7 058b0118 2005-01-03 devnull .B Tremove
 8 058b0118 2005-01-03 devnull .IR tag [2]
 9 058b0118 2005-01-03 devnull .IR fid [4]
10 058b0118 2005-01-03 devnull .br
11 058b0118 2005-01-03 devnull .IR size [4]
12 058b0118 2005-01-03 devnull .B Rremove
13 058b0118 2005-01-03 devnull .IR tag [2]
14 058b0118 2005-01-03 devnull .SH DESCRIPTION
15 058b0118 2005-01-03 devnull The
16 058b0118 2005-01-03 devnull .B remove
17 058b0118 2005-01-03 devnull request asks the file server both to remove the file represented by
18 058b0118 2005-01-03 devnull .I fid
19 058b0118 2005-01-03 devnull and to
20 058b0118 2005-01-03 devnull .B clunk
21 058b0118 2005-01-03 devnull the
22 058b0118 2005-01-03 devnull .IR fid ,
23 058b0118 2005-01-03 devnull even if the remove fails.
24 058b0118 2005-01-03 devnull This request will fail if the client does not have write permission
25 058b0118 2005-01-03 devnull in the parent directory.
26 058b0118 2005-01-03 devnull .PP
27 058b0118 2005-01-03 devnull It is correct to consider
28 058b0118 2005-01-03 devnull .B remove
29 058b0118 2005-01-03 devnull to be a
30 058b0118 2005-01-03 devnull .B clunk
31 058b0118 2005-01-03 devnull with the side effect of removing the file if permissions allow.
32 058b0118 2005-01-03 devnull .PP
33 058b0118 2005-01-03 devnull If a file has been opened as multiple fids,
34 058b0118 2005-01-03 devnull possibly on different connections,
35 058b0118 2005-01-03 devnull and one fid is used to remove the file,
36 058b0118 2005-01-03 devnull whether the other fids continue to provide access to the file
37 058b0118 2005-01-03 devnull is implementation-defined.
38 058b0118 2005-01-03 devnull The Plan 9 file servers
39 058b0118 2005-01-03 devnull remove the file immediately: attempts to use the other fids
40 058b0118 2005-01-03 devnull will yield a
41 058b0118 2005-01-03 devnull ``phase error.''
42 058b0118 2005-01-03 devnull .IR U9fs
43 058b0118 2005-01-03 devnull follows the semantics of the underlying Unix file system,
44 058b0118 2005-01-03 devnull so other fids typically remain usable.
45 058b0118 2005-01-03 devnull .SH ENTRY POINTS
46 058b0118 2005-01-03 devnull .I Fsremove
47 058b0118 2005-01-03 devnull (see
48 36cd4c58 2021-01-30 crossd .MR 9pclient (3) )
49 058b0118 2005-01-03 devnull generates
50 058b0118 2005-01-03 devnull .B remove
51 058b0118 2005-01-03 devnull messages.