improve test server poll loop docs
[profile/ivi/libwebsockets.git] / test-server / test-client.c
1 /*
2  * libwebsockets-test-client - libwebsockets test implementation
3  *
4  * Copyright (C) 2011 Andy Green <andy@warmcat.com>
5  *
6  *  This library is free software; you can redistribute it and/or
7  *  modify it under the terms of the GNU Lesser General Public
8  *  License as published by the Free Software Foundation:
9  *  version 2.1 of the License.
10  *
11  *  This library is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  *  Lesser General Public License for more details.
15  *
16  *  You should have received a copy of the GNU Lesser General Public
17  *  License along with this library; if not, write to the Free Software
18  *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
19  *  MA  02110-1301  USA
20  */
21
22 #include <stdio.h>
23 #include <stdlib.h>
24 #include <unistd.h>
25 #include <getopt.h>
26 #include <string.h>
27
28 #include "../lib/libwebsockets.h"
29
30 static unsigned int opts;
31 static int was_closed;
32 static int deny_deflate;
33 static int deny_mux;
34 static struct libwebsocket *wsi_mirror;
35
36 /*
37  * This demo shows how to connect multiple websockets simultaneously to a
38  * websocket server (there is no restriction on their having to be the same
39  * server just it simplifies the demo).
40  *
41  *  dumb-increment-protocol:  we connect to the server and print the number
42  *                              we are given
43  *
44  *  lws-mirror-protocol: draws random circles, which are mirrored on to every
45  *                              client (see them being drawn in every browser
46  *                              session also using the test server)
47  */
48
49 enum demo_protocols {
50
51         PROTOCOL_DUMB_INCREMENT,
52         PROTOCOL_LWS_MIRROR,
53
54         /* always last */
55         DEMO_PROTOCOL_COUNT
56 };
57
58
59 /* dumb_increment protocol */
60
61 static int
62 callback_dumb_increment(struct libwebsocket_context *this,
63                         struct libwebsocket *wsi,
64                         enum libwebsocket_callback_reasons reason,
65                                                void *user, void *in, size_t len)
66 {
67         switch (reason) {
68
69         case LWS_CALLBACK_CLOSED:
70                 fprintf(stderr, "LWS_CALLBACK_CLOSED\n");
71                 was_closed = 1;
72                 break;
73
74         case LWS_CALLBACK_CLIENT_RECEIVE:
75                 ((char *)in)[len] = '\0';
76                 fprintf(stderr, "rx %d '%s'\n", (int)len, (char *)in);
77                 break;
78
79         /* because we are protocols[0] ... */
80
81         case LWS_CALLBACK_CLIENT_CONFIRM_EXTENSION_SUPPORTED:
82                 if ((strcmp(in, "deflate-stream") == 0) && deny_deflate) {
83                         fprintf(stderr, "denied deflate-stream extension\n");
84                         return 1;
85                 }
86                 if ((strcmp(in, "x-google-mux") == 0) && deny_mux) {
87                         fprintf(stderr, "denied x-google-mux extension\n");
88                         return 1;
89                 }
90
91                 break;
92
93         default:
94                 break;
95         }
96
97         return 0;
98 }
99
100
101 /* lws-mirror_protocol */
102
103
104 static int
105 callback_lws_mirror(struct libwebsocket_context *this,
106                         struct libwebsocket *wsi,
107                         enum libwebsocket_callback_reasons reason,
108                                                void *user, void *in, size_t len)
109 {
110         unsigned char buf[LWS_SEND_BUFFER_PRE_PADDING + 4096 +
111                                                   LWS_SEND_BUFFER_POST_PADDING];
112         int l = 0;
113         int n;
114
115         switch (reason) {
116
117         case LWS_CALLBACK_CLOSED:
118                 fprintf(stderr, "mirror: LWS_CALLBACK_CLOSED\n");
119                 wsi_mirror = NULL;
120                 break;
121
122         case LWS_CALLBACK_CLIENT_ESTABLISHED:
123
124                 /*
125                  * start the ball rolling,
126                  * LWS_CALLBACK_CLIENT_WRITEABLE will come next service
127                  */
128
129                 libwebsocket_callback_on_writable(this, wsi);
130                 break;
131
132         case LWS_CALLBACK_CLIENT_RECEIVE:
133 /*              fprintf(stderr, "rx %d '%s'\n", (int)len, (char *)in); */
134                 break;
135
136         case LWS_CALLBACK_CLIENT_WRITEABLE:
137
138                 for (n = 0; n < 1; n++)
139                         l += sprintf((char *)&buf[LWS_SEND_BUFFER_PRE_PADDING + l],
140                                         "c #%06X %d %d %d;",
141                                         (int)random() & 0xffffff,
142                                         (int)random() % 500,
143                                         (int)random() % 250,
144                                         (int)random() % 24);
145
146                 libwebsocket_write(wsi,
147                    &buf[LWS_SEND_BUFFER_PRE_PADDING], l, opts | LWS_WRITE_TEXT);
148
149                 /* get notified as soon as we can write again */
150
151                 libwebsocket_callback_on_writable(this, wsi);
152                 break;
153
154         default:
155                 break;
156         }
157
158         return 0;
159 }
160
161
162 /* list of supported protocols and callbacks */
163
164 static struct libwebsocket_protocols protocols[] = {
165         {
166                 "dumb-increment-protocol",
167                 callback_dumb_increment,
168                 0,
169         },
170         {
171                 "lws-mirror-protocol",
172                 callback_lws_mirror,
173                 0,
174         },
175         {  /* end of list */
176                 NULL,
177                 NULL,
178                 0
179         }
180 };
181
182 static struct option options[] = {
183         { "help",       no_argument,            NULL, 'h' },
184         { "debug",      required_argument,      NULL, 'd' },
185         { "port",       required_argument,      NULL, 'p' },
186         { "ssl",        no_argument,            NULL, 's' },
187         { "version",    required_argument,      NULL, 'v' },
188         { "undeflated", no_argument,            NULL, 'u' },
189         { "nomux",      no_argument,            NULL, 'n' },
190         { "longlived",  no_argument,            NULL, 'l' },
191         { NULL, 0, 0, 0 }
192 };
193
194
195 int main(int argc, char **argv)
196 {
197         int n = 0;
198         int port = 7681;
199         int use_ssl = 0;
200         struct libwebsocket_context *context;
201         const char *address;
202         struct libwebsocket *wsi_dumb;
203         int ietf_version = -1; /* latest */
204         int mirror_lifetime = 0;
205         int longlived = 0;
206
207         fprintf(stderr, "libwebsockets test client\n"
208                         "(C) Copyright 2010-2013 Andy Green <andy@warmcat.com> "
209                                                     "licensed under LGPL2.1\n");
210
211         if (argc < 2)
212                 goto usage;
213
214         while (n >= 0) {
215                 n = getopt_long(argc, argv, "nuv:hsp:d:l", options, NULL);
216                 if (n < 0)
217                         continue;
218                 switch (n) {
219                 case 'd':
220                         lws_set_log_level(atoi(optarg), NULL);
221                         break;
222                 case 's':
223                         use_ssl = 2; /* 2 = allow selfsigned */
224                         break;
225                 case 'p':
226                         port = atoi(optarg);
227                         break;
228                 case 'l':
229                         longlived = 1;
230                         break;
231                 case 'v':
232                         ietf_version = atoi(optarg);
233                         break;
234                 case 'u':
235                         deny_deflate = 1;
236                         break;
237                 case 'n':
238                         deny_mux = 1;
239                         break;
240                 case 'h':
241                         goto usage;
242                 }
243         }
244
245         if (optind >= argc)
246                 goto usage;
247
248         address = argv[optind];
249
250         /*
251          * create the websockets context.  This tracks open connections and
252          * knows how to route any traffic and which protocol version to use,
253          * and if each connection is client or server side.
254          *
255          * For this client-only demo, we tell it to not listen on any port.
256          */
257
258         context = libwebsocket_create_context(CONTEXT_PORT_NO_LISTEN, NULL,
259                                 protocols,
260 #ifndef LWS_NO_EXTENSIONS
261                                 libwebsocket_internal_extensions,
262 #else
263                                 NULL,
264 #endif
265                                 NULL, NULL, NULL, -1, -1, 0, NULL);
266         if (context == NULL) {
267                 fprintf(stderr, "Creating libwebsocket context failed\n");
268                 return 1;
269         }
270
271         /* create a client websocket using dumb increment protocol */
272
273         wsi_dumb = libwebsocket_client_connect(context, address, port, use_ssl,
274                         "/", argv[optind], argv[optind],
275                          protocols[PROTOCOL_DUMB_INCREMENT].name, ietf_version);
276
277         if (wsi_dumb == NULL) {
278                 fprintf(stderr, "libwebsocket dumb connect failed\n");
279                 return -1;
280         }
281
282         fprintf(stderr, "Websocket connections opened\n");
283
284         /*
285          * sit there servicing the websocket context to handle incoming
286          * packets, and drawing random circles on the mirror protocol websocket
287          */
288
289         n = 0;
290         while (n >= 0 && !was_closed) {
291                 n = libwebsocket_service(context, 1000);
292
293                 if (n < 0)
294                         continue;
295
296                 if (wsi_mirror == NULL) {
297
298                         /* create a client websocket using mirror protocol */
299
300                         wsi_mirror = libwebsocket_client_connect(context,
301                                 address, port, use_ssl,  "/",
302                                 argv[optind], argv[optind],
303                                 protocols[PROTOCOL_LWS_MIRROR].name,
304                                                                  ietf_version);
305
306                         if (wsi_mirror == NULL) {
307                                 fprintf(stderr, "libwebsocket "
308                                                       "dumb connect failed\n");
309                                 return -1;
310                         }
311
312                         mirror_lifetime = 10 + (random() & 1023);
313                         /* useful to test single connection stability */
314                         if (longlived)
315                                 mirror_lifetime += 50000;
316
317                         fprintf(stderr, "opened mirror connection with "
318                                              "%d lifetime\n", mirror_lifetime);
319
320                 } else {
321
322                         mirror_lifetime--;
323                         if (mirror_lifetime == 0) {
324                                 fprintf(stderr, "closing mirror session\n");
325                                 libwebsocket_close_and_free_session(context,
326                                         wsi_mirror, LWS_CLOSE_STATUS_GOINGAWAY);
327
328                                 /*
329                                  * wsi_mirror will get set to NULL in
330                                  * callback when close completes
331                                  */
332                         }
333                 }
334         }
335
336         fprintf(stderr, "Exiting\n");
337
338         libwebsocket_context_destroy(context);
339
340         return 0;
341
342 usage:
343         fprintf(stderr, "Usage: libwebsockets-test-client "
344                                 "<server address> [--port=<p>] "
345                                 "[--ssl] [-k] [-v <ver>] "
346                                 "[-d <log bitfield>] [-l]\n");
347         return 1;
348 }