diff options
| author | James M Snell <jasnell@gmail.com> | 2020-03-23 18:12:13 -0700 |
|---|---|---|
| committer | James M Snell <jasnell@gmail.com> | 2020-06-16 09:15:16 -0700 |
| commit | 813739bf853a2b0433d820f31515a791d5ef79b8 (patch) | |
| tree | 4b9084560f0ad9ad89f95c5af3d5d509751cd82d | |
| parent | 6c6ba3ce8fb59f1bad1b5e0ce1e6fd62ac356d10 (diff) | |
| download | node-new-initial-quic-part-2.tar.gz | |
deps: maintaining ngtcp2 and nghttp3initial-quic-part-2
Signed-off-by: James M Snell <jasnell@gmail.com>
| -rw-r--r-- | deps/ngtcp2/.gitignore | 4 | ||||
| -rw-r--r-- | doc/guides/maintaining-ngtcp2-nghttp3.md | 59 |
2 files changed, 63 insertions, 0 deletions
diff --git a/deps/ngtcp2/.gitignore b/deps/ngtcp2/.gitignore new file mode 100644 index 0000000000..118f239603 --- /dev/null +++ b/deps/ngtcp2/.gitignore @@ -0,0 +1,4 @@ +**/*/CMakeLists.txt +**/*/*.am +**/*/*.h.in +**/*/*.pc.in diff --git a/doc/guides/maintaining-ngtcp2-nghttp3.md b/doc/guides/maintaining-ngtcp2-nghttp3.md new file mode 100644 index 0000000000..8521c768e9 --- /dev/null +++ b/doc/guides/maintaining-ngtcp2-nghttp3.md @@ -0,0 +1,59 @@ +# Maintaining ngtcp2 and nghttp3 + +The ngtcp2 and nghttp3 libraries form the foundation of the QUIC +implementation. They are acquired from the [ngtcp2/ngtcp2][] and +[ngtcp2/nghttp3][] repositories on GitHub. + +ngtcp2 and nghttp3 are tightly related. They will typically be +updated together. + +## Updating ngtcp2 + +Update ngtcp2: +```shell +git clone https://github.com/ngtcp2/ngtcp2 +cd ngtcp2 +autoreconf -i +./configure --enable-lib-only +cd .. +cp -R ngtcp2/crypto node/deps/ngtcp2 +cp -R ngtcp2/lib node/deps/ngtcp2 +``` + +The `autoreconf -i` and `./configure --enable-lib-only` commands +ensure that the necessary template files (such as version.h.in +located in lib/includes/ngtcp2/ are processed appropriately. + +Check that Node.js still builds and tests. + +## Updating nghttp3 + +Update nghttp3: +```shell +git clone https://github.com/ngtcp2/nghttp3 +cd nghttp3 +autoreconf -i +./configure --enable-lib-only +cd .. +cp -R nghttp3/lib node/deps/nghttp3 +``` + +The `autoreconf -i` and `./configure --enable-lib-only` commands +ensure that the necessary template files (such as version.h.in +located in lib/includes/ngtcp2/ are processed appropriately. + +Check that Node.js still builds and tests. + +## Commiting ngtcp2 and nghttp3 + +Use: `git add --all deps/ngtcp2` and `git add --all deps/nghttp3` + +Commit the changes with a message like +```text +deps: update ngtcp2 and nghttp3 + +Updated as described in doc/guides/maintaining-ngtcp2-nghttp3.md. +``` + +[ngtcp2/nghttp3]: https://github.com/ngtcp2/nghttp3 +[ngtcp2/ngtcp2]: https://github.com/ngtcp2/ngtcp2 |