1 4b33cdd0 2015-11-30 stephen.d package p9p
3 4b33cdd0 2015-11-30 stephen.d import (
10 529e2b2e 2016-11-14 noreply "context"
13 4b33cdd0 2015-11-30 stephen.d // TODO(stevvooe): Add net/http.Server-like type here to manage connections.
14 4b33cdd0 2015-11-30 stephen.d // Coupled with Handler mux, we can get a very http-like experience for 9p
15 4b33cdd0 2015-11-30 stephen.d // servers.
17 4b33cdd0 2015-11-30 stephen.d // ServeConn the 9p handler over the provided network connection.
18 4b33cdd0 2015-11-30 stephen.d func ServeConn(ctx context.Context, cn net.Conn, handler Handler) error {
20 4b33cdd0 2015-11-30 stephen.d // TODO(stevvooe): It would be nice if the handler could declare the
21 4b33cdd0 2015-11-30 stephen.d // supported version. Before we had handler, we used the session to get
22 4b33cdd0 2015-11-30 stephen.d // the version (msize, version := session.Version()). We must decided if
23 4b33cdd0 2015-11-30 stephen.d // we want to proxy version and message size decisions all the back to the
24 4b33cdd0 2015-11-30 stephen.d // origin server or make those decisions at each link of a proxy chain.
26 4b33cdd0 2015-11-30 stephen.d ch := newChannel(cn, codec9p{}, DefaultMSize)
27 4b33cdd0 2015-11-30 stephen.d negctx, cancel := context.WithTimeout(ctx, 1*time.Second)
28 4b33cdd0 2015-11-30 stephen.d defer cancel()
30 4b33cdd0 2015-11-30 stephen.d // TODO(stevvooe): For now, we negotiate here. It probably makes sense to
31 4b33cdd0 2015-11-30 stephen.d // do this outside of this function and then pass in a ready made channel.
32 4b33cdd0 2015-11-30 stephen.d // We are not really ready to export the channel type yet.
34 4b33cdd0 2015-11-30 stephen.d if err := servernegotiate(negctx, ch, DefaultVersion); err != nil {
35 4b33cdd0 2015-11-30 stephen.d // TODO(stevvooe): Need better error handling and retry support here.
36 63c84aa9 2016-02-05 stevvooe return fmt.Errorf("error negotiating version: %s", err)
39 4b33cdd0 2015-11-30 stephen.d ctx = withVersion(ctx, DefaultVersion)
41 4b33cdd0 2015-11-30 stephen.d c := &conn{
42 4b33cdd0 2015-11-30 stephen.d ctx: ctx,
43 4b33cdd0 2015-11-30 stephen.d ch: ch,
44 4b33cdd0 2015-11-30 stephen.d handler: handler,
45 4b33cdd0 2015-11-30 stephen.d closed: make(chan struct{}),
48 4b33cdd0 2015-11-30 stephen.d return c.serve()
51 4b33cdd0 2015-11-30 stephen.d // conn plays role of session dispatch for handler in a server.
52 4b33cdd0 2015-11-30 stephen.d type conn struct {
53 4b33cdd0 2015-11-30 stephen.d ctx context.Context
54 4b33cdd0 2015-11-30 stephen.d session Session
55 4b33cdd0 2015-11-30 stephen.d ch Channel
56 4b33cdd0 2015-11-30 stephen.d handler Handler
58 4f41ff66 2016-08-12 noreply once sync.Once
59 4f41ff66 2016-08-12 noreply closed chan struct{}
60 4f41ff66 2016-08-12 noreply err error // terminal error for the conn
63 4b33cdd0 2015-11-30 stephen.d // activeRequest includes information about the active request.
64 4b33cdd0 2015-11-30 stephen.d type activeRequest struct {
65 4b33cdd0 2015-11-30 stephen.d ctx context.Context
66 4b33cdd0 2015-11-30 stephen.d request *Fcall
67 4b33cdd0 2015-11-30 stephen.d cancel context.CancelFunc
70 4b33cdd0 2015-11-30 stephen.d // serve messages on the connection until an error is encountered.
71 4b33cdd0 2015-11-30 stephen.d func (c *conn) serve() error {
72 4b33cdd0 2015-11-30 stephen.d tags := map[Tag]*activeRequest{} // active requests
74 6b62df47 2015-12-04 stevvooe requests := make(chan *Fcall) // sync, read-limited
75 6b62df47 2015-12-04 stevvooe responses := make(chan *Fcall) // sync, goroutine consumed
76 6b62df47 2015-12-04 stevvooe completed := make(chan *Fcall) // sync, send in goroutine per request
78 4b33cdd0 2015-11-30 stephen.d // read loop
79 4b33cdd0 2015-11-30 stephen.d go c.read(requests)
80 4b33cdd0 2015-11-30 stephen.d go c.write(responses)
83 4b33cdd0 2015-11-30 stephen.d select {
84 4b33cdd0 2015-11-30 stephen.d case req := <-requests:
85 4b33cdd0 2015-11-30 stephen.d if _, ok := tags[req.Tag]; ok {
86 4b33cdd0 2015-11-30 stephen.d select {
87 4b33cdd0 2015-11-30 stephen.d case responses <- newErrorFcall(req.Tag, ErrDuptag):
88 4b33cdd0 2015-11-30 stephen.d // Send to responses, bypass tag management.
89 4b33cdd0 2015-11-30 stephen.d case <-c.ctx.Done():
90 4b33cdd0 2015-11-30 stephen.d return c.ctx.Err()
91 4b33cdd0 2015-11-30 stephen.d case <-c.closed:
92 4b33cdd0 2015-11-30 stephen.d return c.err
94 4b33cdd0 2015-11-30 stephen.d continue
97 4b33cdd0 2015-11-30 stephen.d switch msg := req.Message.(type) {
98 4b33cdd0 2015-11-30 stephen.d case MessageTflush:
99 4b33cdd0 2015-11-30 stephen.d var resp *Fcall
100 4b33cdd0 2015-11-30 stephen.d // check if we have actually know about the requested flush
101 4b33cdd0 2015-11-30 stephen.d active, ok := tags[msg.Oldtag]
102 4b33cdd0 2015-11-30 stephen.d if ok {
103 6b62df47 2015-12-04 stevvooe active.cancel() // propagate cancellation to callees
104 6b62df47 2015-12-04 stevvooe delete(tags, msg.Oldtag)
105 4b33cdd0 2015-11-30 stephen.d resp = newFcall(req.Tag, MessageRflush{})
106 4b33cdd0 2015-11-30 stephen.d } else {
107 4b33cdd0 2015-11-30 stephen.d resp = newErrorFcall(req.Tag, ErrUnknownTag)
110 4b33cdd0 2015-11-30 stephen.d select {
111 4b33cdd0 2015-11-30 stephen.d case responses <- resp:
112 4b33cdd0 2015-11-30 stephen.d // bypass tag management in completed.
113 4b33cdd0 2015-11-30 stephen.d case <-c.ctx.Done():
114 4b33cdd0 2015-11-30 stephen.d return c.ctx.Err()
115 4b33cdd0 2015-11-30 stephen.d case <-c.closed:
116 4b33cdd0 2015-11-30 stephen.d return c.err
118 4b33cdd0 2015-11-30 stephen.d default:
119 4b33cdd0 2015-11-30 stephen.d // Allows us to session handlers to cancel processing of the fcall
120 4b33cdd0 2015-11-30 stephen.d // through context.
121 4b33cdd0 2015-11-30 stephen.d ctx, cancel := context.WithCancel(c.ctx)
123 4b33cdd0 2015-11-30 stephen.d // The contents of these instances are only writable in the main
124 4b33cdd0 2015-11-30 stephen.d // server loop. The value of tag will not change.
125 4b33cdd0 2015-11-30 stephen.d tags[req.Tag] = &activeRequest{
126 4b33cdd0 2015-11-30 stephen.d ctx: ctx,
127 4b33cdd0 2015-11-30 stephen.d request: req,
128 4b33cdd0 2015-11-30 stephen.d cancel: cancel,
131 4b33cdd0 2015-11-30 stephen.d go func(ctx context.Context, req *Fcall) {
132 c74282f8 2016-11-16 noreply // TODO(stevvooe): Re-write incoming Treads so that handler
133 c74282f8 2016-11-16 noreply // can always respond with a message of the correct msize.
135 4b33cdd0 2015-11-30 stephen.d var resp *Fcall
136 4b33cdd0 2015-11-30 stephen.d msg, err := c.handler.Handle(ctx, req.Message)
137 4b33cdd0 2015-11-30 stephen.d if err != nil {
138 4b33cdd0 2015-11-30 stephen.d // all handler errors are forwarded as protocol errors.
139 4b33cdd0 2015-11-30 stephen.d resp = newErrorFcall(req.Tag, err)
140 4b33cdd0 2015-11-30 stephen.d } else {
141 4b33cdd0 2015-11-30 stephen.d resp = newFcall(req.Tag, msg)
144 4b33cdd0 2015-11-30 stephen.d select {
145 4b33cdd0 2015-11-30 stephen.d case completed <- resp:
146 4b33cdd0 2015-11-30 stephen.d case <-ctx.Done():
147 4b33cdd0 2015-11-30 stephen.d return
148 4b33cdd0 2015-11-30 stephen.d case <-c.closed:
149 4b33cdd0 2015-11-30 stephen.d return
151 4b33cdd0 2015-11-30 stephen.d }(ctx, req)
153 4b33cdd0 2015-11-30 stephen.d case resp := <-completed:
154 4b33cdd0 2015-11-30 stephen.d // only responses that flip the tag state traverse this section.
155 4b33cdd0 2015-11-30 stephen.d active, ok := tags[resp.Tag]
156 4b33cdd0 2015-11-30 stephen.d if !ok {
157 6b62df47 2015-12-04 stevvooe // The tag is no longer active. Likely a flushed message.
158 6b62df47 2015-12-04 stevvooe continue
161 4b33cdd0 2015-11-30 stephen.d select {
162 4b33cdd0 2015-11-30 stephen.d case responses <- resp:
163 4b33cdd0 2015-11-30 stephen.d case <-active.ctx.Done():
164 4b33cdd0 2015-11-30 stephen.d // the context was canceled for some reason, perhaps timeout or
165 4b33cdd0 2015-11-30 stephen.d // due to a flush call. We treat this as a condition where a
166 4b33cdd0 2015-11-30 stephen.d // response should not be sent.
168 4b33cdd0 2015-11-30 stephen.d delete(tags, resp.Tag)
169 4b33cdd0 2015-11-30 stephen.d case <-c.ctx.Done():
170 4b33cdd0 2015-11-30 stephen.d return c.ctx.Err()
171 4b33cdd0 2015-11-30 stephen.d case <-c.closed:
172 4b33cdd0 2015-11-30 stephen.d return c.err
177 4b33cdd0 2015-11-30 stephen.d // read takes requests off the channel and sends them on requests.
178 4b33cdd0 2015-11-30 stephen.d func (c *conn) read(requests chan *Fcall) {
180 4b33cdd0 2015-11-30 stephen.d req := new(Fcall)
181 4b33cdd0 2015-11-30 stephen.d if err := c.ch.ReadFcall(c.ctx, req); err != nil {
182 4b33cdd0 2015-11-30 stephen.d if err, ok := err.(net.Error); ok {
183 4b33cdd0 2015-11-30 stephen.d if err.Timeout() || err.Temporary() {
184 4b33cdd0 2015-11-30 stephen.d // TODO(stevvooe): A full idle timeout on the connection
185 4b33cdd0 2015-11-30 stephen.d // should be enforced here. No logging because it is quite
186 4b33cdd0 2015-11-30 stephen.d // chatty.
187 4b33cdd0 2015-11-30 stephen.d continue
191 4b33cdd0 2015-11-30 stephen.d c.CloseWithError(fmt.Errorf("error reading fcall: %v", err))
192 4b33cdd0 2015-11-30 stephen.d return
195 4b33cdd0 2015-11-30 stephen.d select {
196 4b33cdd0 2015-11-30 stephen.d case requests <- req:
197 4b33cdd0 2015-11-30 stephen.d case <-c.ctx.Done():
198 4b33cdd0 2015-11-30 stephen.d c.CloseWithError(c.ctx.Err())
199 4b33cdd0 2015-11-30 stephen.d return
200 4b33cdd0 2015-11-30 stephen.d case <-c.closed:
201 4b33cdd0 2015-11-30 stephen.d return
206 4b33cdd0 2015-11-30 stephen.d func (c *conn) write(responses chan *Fcall) {
208 4b33cdd0 2015-11-30 stephen.d select {
209 4b33cdd0 2015-11-30 stephen.d case resp := <-responses:
210 c74282f8 2016-11-16 noreply // TODO(stevvooe): Correctly protect againt overflowing msize from
211 c74282f8 2016-11-16 noreply // handler. This can be done above, in the main message handler
212 c74282f8 2016-11-16 noreply // loop, by adjusting incoming Tread calls to have a Count that
213 c74282f8 2016-11-16 noreply // won't overflow the msize.
215 4b33cdd0 2015-11-30 stephen.d if err := c.ch.WriteFcall(c.ctx, resp); err != nil {
216 4b33cdd0 2015-11-30 stephen.d if err, ok := err.(net.Error); ok {
217 4b33cdd0 2015-11-30 stephen.d if err.Timeout() || err.Temporary() {
218 4b33cdd0 2015-11-30 stephen.d // TODO(stevvooe): A full idle timeout on the
219 4b33cdd0 2015-11-30 stephen.d // connection should be enforced here. We log here,
220 4b33cdd0 2015-11-30 stephen.d // since this is less common.
221 2da28ffa 2017-11-10 noreply log.Printf("p9p: temporary error writing fcall: %v", err)
222 4b33cdd0 2015-11-30 stephen.d continue
226 4b33cdd0 2015-11-30 stephen.d c.CloseWithError(fmt.Errorf("error writing fcall: %v", err))
227 4b33cdd0 2015-11-30 stephen.d return
229 4b33cdd0 2015-11-30 stephen.d case <-c.ctx.Done():
230 4b33cdd0 2015-11-30 stephen.d c.CloseWithError(c.ctx.Err())
231 4b33cdd0 2015-11-30 stephen.d return
232 4b33cdd0 2015-11-30 stephen.d case <-c.closed:
233 4b33cdd0 2015-11-30 stephen.d return
238 4b33cdd0 2015-11-30 stephen.d func (c *conn) Close() error {
239 4b33cdd0 2015-11-30 stephen.d return c.CloseWithError(nil)
242 4b33cdd0 2015-11-30 stephen.d func (c *conn) CloseWithError(err error) error {
243 4f41ff66 2016-08-12 noreply c.once.Do(func() {
244 4b33cdd0 2015-11-30 stephen.d if err == nil {
245 4f41ff66 2016-08-12 noreply err = ErrClosed
248 4f41ff66 2016-08-12 noreply c.err = err
249 4f41ff66 2016-08-12 noreply close(c.closed)
252 4f41ff66 2016-08-12 noreply return c.err
