1 2eda9ef8 2005-01-14 devnull .TH OPENFD 9P
 2 2eda9ef8 2005-01-14 devnull .SH NAME
 3 2eda9ef8 2005-01-14 devnull openfd \- prepare a fid for I/O using a file descriptor
 4 2eda9ef8 2005-01-14 devnull .SH SYNOPSIS
 5 2eda9ef8 2005-01-14 devnull .ta \w'\fLTopenfd 'u
 6 2eda9ef8 2005-01-14 devnull .IR size [4]
 7 2eda9ef8 2005-01-14 devnull .B Topenfd
 8 2eda9ef8 2005-01-14 devnull .IR tag [2]
 9 2eda9ef8 2005-01-14 devnull .IR fid [4]
10 2eda9ef8 2005-01-14 devnull .IR mode [1]
11 2eda9ef8 2005-01-14 devnull .br
12 2eda9ef8 2005-01-14 devnull .IR size [4]
13 2eda9ef8 2005-01-14 devnull .B Ropenfd
14 2eda9ef8 2005-01-14 devnull .IR tag [2]
15 2eda9ef8 2005-01-14 devnull .IR qid [13]
16 2eda9ef8 2005-01-14 devnull .IR iounit [4]
17 2eda9ef8 2005-01-14 devnull .IR unixfd [4]
18 2eda9ef8 2005-01-14 devnull .SH DESCRIPTION
19 2eda9ef8 2005-01-14 devnull The
20 2eda9ef8 2005-01-14 devnull .I openfd
21 2eda9ef8 2005-01-14 devnull request behaves like open, except that it prepares and returns
22 2eda9ef8 2005-01-14 devnull a Unix file descriptor corresponding to the opened fid.
23 2eda9ef8 2005-01-14 devnull .PP
24 2eda9ef8 2005-01-14 devnull After a successful
25 2eda9ef8 2005-01-14 devnull .I open
26 2eda9ef8 2005-01-14 devnull transaction,
27 2eda9ef8 2005-01-14 devnull .I fid
28 2eda9ef8 2005-01-14 devnull is considered by the client to have been clunked
29 2eda9ef8 2005-01-14 devnull and can be reused.
30 2eda9ef8 2005-01-14 devnull .PP
31 2eda9ef8 2005-01-14 devnull The returned Unix file descriptor is one end of a Unix pipe.
32 2eda9ef8 2005-01-14 devnull A proxy process at the other end transfers data between
33 2eda9ef8 2005-01-14 devnull the pipe and the 9P server.
34 2eda9ef8 2005-01-14 devnull Because it is a pipe, errors on reads and writes are discarded
35 2eda9ef8 2005-01-14 devnull and
36 2eda9ef8 2005-01-14 devnull .I mode
37 2eda9ef8 2005-01-14 devnull must be
38 2eda9ef8 2005-01-14 devnull .B OREAD
39 2eda9ef8 2005-01-14 devnull or
40 2eda9ef8 2005-01-14 devnull .BR OWRITE ;
41 2eda9ef8 2005-01-14 devnull it cannot be
42 2eda9ef8 2005-01-14 devnull .BR ORDWR .
43 2eda9ef8 2005-01-14 devnull .PP
44 2eda9ef8 2005-01-14 devnull .I Openfd
45 2eda9ef8 2005-01-14 devnull is implemented by
46 36cd4c58 2021-01-30 crossd .MR 9pserve (4) .
47 2eda9ef8 2005-01-14 devnull 9P servers that post their services using
48 36cd4c58 2021-01-30 crossd .MR 9pserve (4)
49 2eda9ef8 2005-01-14 devnull (or indirectly via
50 36cd4c58 2021-01-30 crossd .MR post9pservice (3) )
51 2eda9ef8 2005-01-14 devnull will never see a
52 2eda9ef8 2005-01-14 devnull .B Topenfd
53 2eda9ef8 2005-01-14 devnull message.
54 2eda9ef8 2005-01-14 devnull .SH ENTRY POINTS
55 2eda9ef8 2005-01-14 devnull .I Fsopenfd
56 2eda9ef8 2005-01-14 devnull (see
57 36cd4c58 2021-01-30 crossd .MR 9pclient (3) )
58 2eda9ef8 2005-01-14 devnull generates an
59 2eda9ef8 2005-01-14 devnull .B openfd
60 2eda9ef8 2005-01-14 devnull message.