first commit

2026-09-13 22:18:11 +01:00
commit 08c03ac533
6701 changed files with 1577314 additions and 0 deletions
@@ -0,0 +1,66 @@
+
+nghttp2_select_next_protocol
+============================
+
+Synopsis
+--------
+
+*#include <nghttp2/nghttp2.h>*
+
+.. function:: int nghttp2_select_next_protocol(unsigned char **out, unsigned char *outlen, const unsigned char *in, unsigned int inlen)
+
+    
+    A helper function for dealing with NPN in client side or ALPN in
+    server side.  The *in* contains peer's protocol list in preferable
+    order.  The format of *in* is length-prefixed and not
+    null-terminated.  For example, ``h2`` and
+    ``http/1.1`` stored in *in* like this::
+    
+        in[0] = 2
+        in[1..2] = "h2"
+        in[3] = 8
+        in[4..11] = "http/1.1"
+        inlen = 12
+    
+    The selection algorithm is as follows:
+    
+    1. If peer's list contains HTTP/2 protocol the library supports,
+       it is selected and returns 1. The following step is not taken.
+    
+    2. If peer's list contains ``http/1.1``, this function selects
+       ``http/1.1`` and returns 0.  The following step is not taken.
+    
+    3. This function selects nothing and returns -1 (So called
+       non-overlap case).  In this case, *out* and *outlen* are left
+       untouched.
+    
+    Selecting ``h2`` means that ``h2`` is written into *\*out* and its
+    length (which is 2) is assigned to *\*outlen*.
+    
+    For ALPN, refer to https://tools.ietf.org/html/rfc7301
+    
+    See http://technotes.googlecode.com/git/nextprotoneg.html for more
+    details about NPN.
+    
+    For NPN, to use this method you should do something like::
+    
+        static int select_next_proto_cb(SSL* ssl,
+                                        unsigned char **out,
+                                        unsigned char *outlen,
+                                        const unsigned char *in,
+                                        unsigned int inlen,
+                                        void *arg)
+        {
+            int rv;
+            rv = nghttp2_select_next_protocol(out, outlen, in, inlen);
+            if (rv == -1) {
+                return SSL_TLSEXT_ERR_NOACK;
+            }
+            if (rv == 1) {
+                ((MyType*)arg)->http2_selected = 1;
+            }
+            return SSL_TLSEXT_ERR_OK;
+        }
+        ...
+        SSL_CTX_set_next_proto_select_cb(ssl_ctx, select_next_proto_cb, my_obj);
+