1 /***************************************************************************
3 * Project ___| | | | _ \| |
5 * | (__| |_| | _ <| |___
6 * \___|\___/|_| \_\_____|
8 * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
10 * This software is licensed as described in the file COPYING, which
11 * you should have received as part of this distribution. The terms
12 * are also available at http://curl.haxx.se/docs/copyright.html.
14 * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15 * copies of the Software, and permit persons to whom the Software is
16 * furnished to do so, under the terms of the COPYING file.
18 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19 * KIND, either express or implied.
21 ***************************************************************************/
23 #include "curl_setup.h"
26 #define _MPRINTF_REPLACE
27 #include <curl/mprintf.h>
29 #include <nghttp2/nghttp2.h>
34 #include "curl_base64.h"
35 #include "curl_memory.h"
37 /* include memdebug.h last */
40 #if (NGHTTP2_VERSION_NUM < 0x000300)
41 #error too old nghttp2 version, upgrade!
45 * HTTP2 handler interface. This isn't added to the general list of protocols
46 * but will be used at run-time when the protocol is dynamically switched from
49 const struct Curl_handler Curl_handler_http2 = {
51 ZERO_NULL, /* setup_connection */
52 ZERO_NULL, /* do_it */
53 ZERO_NULL , /* done */
54 ZERO_NULL, /* do_more */
55 ZERO_NULL, /* connect_it */
56 ZERO_NULL, /* connecting */
57 ZERO_NULL, /* doing */
58 ZERO_NULL, /* proto_getsock */
59 ZERO_NULL, /* doing_getsock */
60 ZERO_NULL, /* domore_getsock */
61 ZERO_NULL, /* perform_getsock */
62 ZERO_NULL, /* disconnect */
63 ZERO_NULL, /* readwrite */
64 PORT_HTTP, /* defport */
65 CURLPROTO_HTTP, /* protocol */
66 PROTOPT_NONE /* flags */
71 * Store nghttp2 version info in this buffer, Prefix with a space. Return
72 * total length written.
74 int Curl_http2_ver(char *p, size_t len)
76 nghttp2_info *h2 = nghttp2_version(0);
77 return snprintf(p, len, " nghttp2/%s", h2->version_str);
81 * The implementation of nghttp2_send_callback type. Here we write |data| with
82 * size |length| to the network and return the number of bytes actually
83 * written. See the documentation of nghttp2_send_callback for the details.
85 static ssize_t send_callback(nghttp2_session *h2,
86 const uint8_t *data, size_t length, int flags,
89 struct connectdata *conn = (struct connectdata *)userp;
92 Curl_write(conn, conn->sock[FIRSTSOCKET], data, length, &written);
97 failf(conn->data, "Failed sending HTTP2 data");
98 return NGHTTP2_ERR_CALLBACK_FAILURE;
101 return NGHTTP2_ERR_WOULDBLOCK;
107 * The implementation of nghttp2_recv_callback type. Here we read data from
108 * the network and write them in |buf|. The capacity of |buf| is |length|
109 * bytes. Returns the number of bytes stored in |buf|. See the documentation
110 * of nghttp2_recv_callback for the details.
112 static ssize_t recv_callback(nghttp2_session *h2,
113 uint8_t *buf, size_t length, int flags,
116 struct connectdata *conn = (struct connectdata *)userp;
120 infof(conn->data, "recv_callback() was called with length %d\n", length);
122 rc = Curl_read_plain(conn->sock[FIRSTSOCKET], (char *)buf, length,
127 if(CURLE_AGAIN == rc) {
128 infof(conn->data, "recv_callback() returns NGHTTP2_ERR_WOULDBLOCK\n");
129 return NGHTTP2_ERR_WOULDBLOCK;
132 failf(conn->data, "Failed receiving HTTP2 data: %d", rc);
133 return NGHTTP2_ERR_CALLBACK_FAILURE;
136 infof(conn->data, "recv_callback() returns %d to nghttp2\n", nread);
141 static int on_frame_recv(nghttp2_session *session, const nghttp2_frame *frame,
144 struct connectdata *conn = (struct connectdata *)userp;
147 infof(conn->data, "on_frame_recv() was called with header %x\n",
152 static int on_invalid_frame_recv(nghttp2_session *session,
153 const nghttp2_frame *frame,
154 nghttp2_error_code error_code, void *userp)
156 struct connectdata *conn = (struct connectdata *)userp;
159 infof(conn->data, "on_invalid_frame_recv() was called, error_code = %d\n",
164 static int on_data_chunk_recv(nghttp2_session *session, uint8_t flags,
166 const uint8_t *data, size_t len, void *userp)
168 struct connectdata *conn = (struct connectdata *)userp;
169 struct http_conn *c = &conn->proto.httpc;
173 infof(conn->data, "on_data_chunk_recv() "
174 "len = %u, stream = %x\n", len, stream_id);
177 memcpy(c->mem, data, len);
182 infof(conn->data, "EEEEEEK\n");
188 static int before_frame_send(nghttp2_session *session,
189 const nghttp2_frame *frame,
192 struct connectdata *conn = (struct connectdata *)userp;
195 infof(conn->data, "before_frame_send() was called\n");
198 static int on_frame_send(nghttp2_session *session,
199 const nghttp2_frame *frame,
202 struct connectdata *conn = (struct connectdata *)userp;
205 infof(conn->data, "on_frame_send() was called\n");
208 static int on_frame_not_send(nghttp2_session *session,
209 const nghttp2_frame *frame,
210 int lib_error_code, void *userp)
212 struct connectdata *conn = (struct connectdata *)userp;
215 infof(conn->data, "on_frame_not_send() was called, lib_error_code = %d\n",
219 static int on_stream_close(nghttp2_session *session, int32_t stream_id,
220 nghttp2_error_code error_code, void *userp)
222 struct connectdata *conn = (struct connectdata *)userp;
225 infof(conn->data, "on_stream_close() was called, error_code = %d\n",
230 static int on_unknown_frame_recv(nghttp2_session *session,
231 const uint8_t *head, size_t headlen,
232 const uint8_t *payload, size_t payloadlen,
235 struct connectdata *conn = (struct connectdata *)userp;
241 infof(conn->data, "on_unknown_frame_recv() was called\n");
244 static int on_begin_headers(nghttp2_session *session,
245 const nghttp2_frame *frame, void *userp)
247 struct connectdata *conn = (struct connectdata *)userp;
250 infof(conn->data, "on_begin_headers() was called\n");
254 /* frame->hd.type is either NGHTTP2_HEADERS or NGHTTP2_PUSH_PROMISE */
255 static int on_header(nghttp2_session *session, const nghttp2_frame *frame,
256 const uint8_t *name, size_t namelen,
257 const uint8_t *value, size_t valuelen,
260 struct connectdata *conn = (struct connectdata *)userp;
261 struct http_conn *c = &conn->proto.httpc;
262 size_t hlen = namelen + valuelen + 3; /* colon + CRLF == 3 bytes */
267 if(namelen && (name[0] == ':')) {
269 hlen = snprintf(c->mem, c->len, "HTTP/2.0 %s\r\n", value);
271 else if(hlen + 1 < c->len) { /* hlen + a zero byte */
272 /* convert to a HTTP1-style header */
273 memcpy(c->mem, name, namelen);
275 memcpy(&c->mem[namelen+1], value, valuelen);
276 c->mem[namelen + valuelen + 1]='\r';
277 c->mem[namelen + valuelen + 2]='\n';
278 c->mem[namelen + valuelen + 3]=0; /* to display this easier */
280 infof(conn->data, "Got %s", c->mem);
284 return 0; /* 0 is successful */
288 * This is all callbacks nghttp2 calls
290 static const nghttp2_session_callbacks callbacks = {
291 send_callback, /* nghttp2_send_callback */
292 recv_callback, /* nghttp2_recv_callback */
293 on_frame_recv, /* nghttp2_on_frame_recv_callback */
294 on_invalid_frame_recv, /* nghttp2_on_invalid_frame_recv_callback */
295 on_data_chunk_recv, /* nghttp2_on_data_chunk_recv_callback */
296 before_frame_send, /* nghttp2_before_frame_send_callback */
297 on_frame_send, /* nghttp2_on_frame_send_callback */
298 on_frame_not_send, /* nghttp2_on_frame_not_send_callback */
299 on_stream_close, /* nghttp2_on_stream_close_callback */
300 on_unknown_frame_recv, /* nghttp2_on_unknown_frame_recv_callback */
301 on_begin_headers, /* nghttp2_on_begin_headers_callback */
302 on_header /* nghttp2_on_header_callback */
306 * The HTTP2 settings we send in the Upgrade request
308 static nghttp2_settings_entry settings[] = {
309 { NGHTTP2_SETTINGS_MAX_CONCURRENT_STREAMS, 100 },
310 { NGHTTP2_SETTINGS_INITIAL_WINDOW_SIZE, NGHTTP2_INITIAL_WINDOW_SIZE },
314 * Initialize nghttp2 for a Curl connection
316 CURLcode Curl_http2_init(struct connectdata *conn) {
317 if(!conn->proto.httpc.h2) {
318 /* The nghttp2 session is not yet setup, do it */
319 int rc = nghttp2_session_client_new(&conn->proto.httpc.h2,
322 failf(conn->data, "Couldn't initialize nghttp2!");
323 return CURLE_OUT_OF_MEMORY; /* most likely at least */
330 * Send a request using http2
332 CURLcode Curl_http2_send_request(struct connectdata *conn)
339 * Append headers to ask for a HTTP1.1 to HTTP2 upgrade.
341 CURLcode Curl_http2_request_upgrade(Curl_send_buffer *req,
342 struct connectdata *conn)
348 struct SingleRequest *k = &conn->data->req;
349 uint8_t *binsettings = conn->proto.httpc.binsettings;
351 Curl_http2_init(conn);
353 /* As long as we have a fixed set of settings, we don't have to dynamically
354 * figure out the base64 strings since it'll always be the same. However,
355 * the settings will likely not be fixed every time in the future.
358 /* this returns number of bytes it wrote */
359 binlen = nghttp2_pack_settings_payload(binsettings, H2_BINSETTINGS_LEN,
361 sizeof(settings)/sizeof(settings[0]));
363 failf(conn->data, "nghttp2 unexpectedly failed on pack_settings_payload");
364 return CURLE_FAILED_INIT;
366 conn->proto.httpc.binlen = binlen;
368 result = Curl_base64_encode(conn->data, (const char *)binsettings, binlen,
373 result = Curl_add_bufferf(req,
374 "Connection: Upgrade, HTTP2-Settings\r\n"
376 "HTTP2-Settings: %s\r\n",
377 NGHTTP2_PROTO_VERSION_ID, base64);
380 k->upgr101 = UPGR101_REQUESTED;
386 * If the read would block (EWOULDBLOCK) we return -1. Otherwise we return
387 * a regular CURLcode value.
389 static ssize_t http2_recv(struct connectdata *conn, int sockindex,
390 char *mem, size_t len, CURLcode *err)
393 (void)sockindex; /* we always do HTTP2 on sockindex 0 */
395 conn->proto.httpc.mem = mem;
396 conn->proto.httpc.len = len;
398 rc = nghttp2_session_recv(conn->proto.httpc.h2);
401 failf(conn->data, "nghttp2_session_recv() returned %d\n",
403 *err = CURLE_RECV_ERROR;
405 return len - conn->proto.httpc.len;
408 /* return number of received (decrypted) bytes */
409 static ssize_t http2_send(struct connectdata *conn, int sockindex,
410 const void *mem, size_t len, CURLcode *err)
412 /* TODO: proper implementation */
421 int Curl_http2_switched(struct connectdata *conn)
424 struct http_conn *httpc = &conn->proto.httpc;
425 /* we are switched! */
426 conn->handler = &Curl_handler_http2;
427 conn->recv[FIRSTSOCKET] = http2_recv;
428 conn->send[FIRSTSOCKET] = http2_send;
429 infof(conn->data, "We have switched to HTTP2\n");
431 /* send the SETTINGS frame (again) */
432 rc = nghttp2_session_upgrade(httpc->h2, httpc->binsettings, httpc->binlen,