Nilorea Library
C utilities for networking, threading, graphics
Loading...
Searching...
No Matches
ex_network_ws.c

WebSocket client example using Nilorea network module.

WebSocket client example using Nilorea network module

Author
Castagnier Mickael
Version
1.0
Date
26/03/2026
/*
* Nilorea Library
* Copyright (C) 2005-2026 Castagnier Mickael
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#include "nilorea/n_str.h"
#include "nilorea/n_log.h"
#include <getopt.h>
#include <string.h>
void usage(void) {
fprintf(stderr,
" -V 'log level' : set the log level (LOG_NULL, LOG_NOTICE, LOG_INFO, LOG_ERR, LOG_DEBUG)\n"
" -h : help\n");
}
int main(int argc, char* argv[]) {
int getoptret = 0;
while ((getoptret = getopt(argc, argv, "hV:")) != EOF) {
switch (getoptret) {
case 'V':
if (!strncmp("LOG_NULL", optarg, 8)) {
} else if (!strncmp("LOG_NOTICE", optarg, 10)) {
} else if (!strncmp("LOG_INFO", optarg, 8)) {
} else if (!strncmp("LOG_ERR", optarg, 7)) {
} else if (!strncmp("LOG_DEBUG", optarg, 9)) {
} else {
fprintf(stderr, "%s is not a valid log level.\n", optarg);
exit(1);
}
break;
case 'h':
default:
usage();
exit(1);
}
}
#ifdef HAVE_OPENSSL
n_log(LOG_INFO, "Connecting to wss://echo.websocket.org:443/ ...");
N_WS_CONN* ws = n_ws_connect("echo.websocket.org", "443", "/", 1);
if (!ws) {
fprintf(stdout, "WebSocket echo server unreachable, skipping\n");
exit(0);
}
/* read the welcome/greeting message the server sends on connect */
N_WS_MESSAGE greeting;
memset(&greeting, 0, sizeof(greeting));
if (n_ws_recv(ws, &greeting) == 0) {
n_log(LOG_INFO, "Server greeting (opcode %d): %s", greeting.opcode, greeting.payload ? greeting.payload->data : "(empty)");
free_nstr(&greeting.payload);
}
const char* test_msg = "nilorea ws test";
n_log(LOG_INFO, "Sending: %s", test_msg);
if (n_ws_send(ws, test_msg, strlen(test_msg), N_WS_OP_TEXT) != 0) {
n_log(LOG_ERR, "Failed to send WebSocket message");
exit(1);
}
memset(&msg, 0, sizeof(msg));
if (n_ws_recv(ws, &msg) == 0) {
n_log(LOG_INFO, "Received (opcode %d): %s", msg.opcode, msg.payload ? msg.payload->data : "(empty)");
if (msg.payload && strcmp(msg.payload->data, test_msg) == 0) {
fprintf(stdout, "WebSocket echo test PASSED\n");
} else {
fprintf(stdout, "WebSocket echo test: got response (opcode %d)\n", msg.opcode);
}
} else {
n_log(LOG_ERR, "Failed to receive WebSocket message");
exit(1);
}
n_log(LOG_INFO, "WebSocket example completed successfully");
#else
(void)log_level;
fprintf(stdout, "OpenSSL not available, skipping WebSocket test\n");
#endif
exit(0);
}
static void usage(void)
int main(void)
int getoptret
Definition ex_fluid.c:60
int log_level
Definition ex_fluid.c:61
#define n_log(__LEVEL__,...)
Logging function wrapper to get line and func.
Definition n_log.h:88
#define LOG_DEBUG
debug-level messages
Definition n_log.h:83
#define LOG_ERR
error conditions
Definition n_log.h:75
void set_log_level(const int log_level)
Set the global log level value ( static int LOG_LEVEL )
Definition n_log.c:120
#define LOG_NOTICE
normal but significant condition
Definition n_log.h:79
#define LOG_NULL
no log output
Definition n_log.h:45
#define LOG_INFO
informational
Definition n_log.h:81
char * data
the string
Definition n_str.h:62
#define free_nstr(__ptr)
free a N_STR structure and set the pointer to NULL
Definition n_str.h:201
N_STR * payload
message payload
Definition n_network.h:683
int opcode
frame opcode
Definition n_network.h:682
N_WS_CONN * n_ws_connect(const char *host, const char *port, const char *path, int use_ssl)
Connect to a WebSocket server (ws:// or wss://).
Definition n_network.c:4676
#define N_WS_OP_TEXT
WebSocket opcodes per RFC 6455.
Definition n_network.h:674
int n_ws_recv(N_WS_CONN *conn, N_WS_MESSAGE *msg_out)
Receive one WebSocket frame.
Definition n_network.c:4947
void n_ws_conn_free(N_WS_CONN **conn)
Free a WebSocket connection structure.
Definition n_network.c:5049
int n_ws_send(N_WS_CONN *conn, const char *payload, size_t len, int opcode)
Send a WebSocket frame (client always masks).
Definition n_network.c:4880
WebSocket connection.
Definition n_network.h:688
WebSocket message.
Definition n_network.h:681
Generic log system.
Network Engine.
N_STR and string function declaration.