Skip to content

Linux only: full system-wide install with uSockets + Hints for CMake users #1702

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
talksik wants to merge 3 commits into
base: master
Choose a base branch
from
+20 −0
Open

Linux only: full system-wide install with uSockets + Hints for CMake users #1702

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
168350f
adjusting to include full install
talksik Jan 27, 2024
b7e2abd
adding instructions for CMake users
talksik Jan 27, 2024
92205ee
fix typo
talksik Nov 26, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions GNUmakefile
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,8 @@ capi: default
./build capi

install:
cp uSockets/uSockets.a "$(DESTDIR)$(prefix)/lib"
cp uSockets/src/libusockets.h "$(DESTDIR)$(prefix)/include"
mkdir -p "$(DESTDIR)$(prefix)/include/uWebSockets"
cp -r src/* "$(DESTDIR)$(prefix)/include/uWebSockets"

Expand Down
18 changes: 18 additions & 0 deletions misc/READMORE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,24 @@ There are a few compilation flags for µSockets (see its documentation), but com

You can use the Makefile on Linux and macOS. It is simple to use and builds the examples for you. `WITH_OPENSSL=1 make` builds all examples with SSL enabled. Examples will fail to listen if cert and key cannot be found, so make sure to specify a path that works for you.

### Steps for Linux
```sh
git clone --resurse-submodules https://github.com/uNetworking/uWebSockets
make # prepend variables if desired such as `WITH_OPENSSL` as mentioned above
make install
```

_Note for Linux CMake users: make sure to include ZLIB as a dependency as well as `uSockets.a` static library (which was installed during `make install`)._

Here is an example:
```
...
find_library(USOCKETS_LIBRARY uSockets.a PATHS /usr/local/lib REQUIRED)
find_package(ZLIB REQUIRED)
target_link_libraries(${PROJECT_NAME} ${USOCKETS_LIBRARY} ZLIB::ZLIB)
...
```

## User manual

### uWS::App & uWS::SSLApp
Expand Down