romenskiy2012/curl
1
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2026-07-27 01:27:15 +03:00
Code Issues Projects Releases Packages Wiki Activity

docs/WEBSOCKET.md: explain the URL use

Browse source 
Fixes #9936
Closes #9941
This commit is contained in:
Daniel Stenberg 2022-11-18 09:39:26 +01:00
parent 12e1def51a
commit 117e3372a8
No known key found for this signature in database
GPG key ID: 5CC908FDB71E12C2
1 changed files with 15 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

15
docs/WEBSOCKET.md
View file

@ -6,6 +6,21 @@ SPDX-License-Identifier: curl
# WebSocket in curl
## URL
WebSocket communication with libcurl is done by setting up a transfer to a URL
using the `ws:/` or `wss://` URL schemes. The latter one being the secure
version done over HTTPS.
When using `wss://` to do WebSocket over HTTPS, the standard TLS and HTTPS
options will be acknowledged for the CA, verification of server certificate
etc.
WebSocket communication is done by upgrading a connection from either HTTP or
HTTPS. When given a WebSocket URL to work with, libcurl considers it a
transfer failure if the upgrade procedure fails. This means that a plain HTTP
200 response code is considered an error for this work.
## API
The WebSocket API is described in the individual man pages for the new API.