aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStefan Boberg <[email protected]>2022-02-02 11:21:07 +0100
committerGitHub <[email protected]>2022-02-02 11:21:07 +0100
commit0135d6357f4bd048a8ff64632f6a25e2f27d74df (patch)
treebeb184b084a710c9667a57c4de1bf5c157a5f097
parentUpdate README.md (diff)
downloadzen-0135d6357f4bd048a8ff64632f6a25e2f27d74df.tar.xz
zen-0135d6357f4bd048a8ff64632f6a25e2f27d74df.zip
Update README.md
-rw-r--r--README.md10
1 files changed, 9 insertions, 1 deletions
diff --git a/README.md b/README.md
index cc1363da7..5f0af7a6d 100644
--- a/README.md
+++ b/README.md
@@ -41,7 +41,9 @@ currently building with the VS2022 toolchain has not been tested (please leave t
* run `xmake project -k vsxmake2019 -a x64 -y`
* open the `vsxmake2019\zen.sln` VS solution
* Note: if you want full connectivity with the http.sys server implementation you currently need to run
- Visual Studio in ADMIN mode since http.sys requires elevation to be able to listen on a non-local network socket
+ Visual Studio in ADMIN mode since http.sys requires elevation to be able to listen on a non-local network socket.
+ You can start Visual Studio in admin mode by holding CTRL-SHIFT when launching Visual Studio. Alternatively
+ you can add an URL reservation (see below)
* you can now build and run `zenserver` as usual from Visual Studio
* third-party dependencies will be built the first time via the `vcpkg` integration. This is not as
fast as it could be (it does not go wide) but should only happen on the first build and will leverage
@@ -194,6 +196,12 @@ is incredibly handy. When that is installed you may enable auto-attach to child
The tests are implemented using [doctest](https://github.com/onqtam/doctest), which is similar to Catch in usage.
+# Adding a http.sys URL reservation
+
+Registering a handler for an HTTP endpoint requires either process elevation (i.e running Zen as admin) or a one-time URL reservation. An URL reservation can be added by issuing a command like
+
+`netsh http add urlacl url=http://*:1337/ user=stefan.boberg`
+
# Coding Standards
See [Coding.md](Coding.md)