libwebsockets
Lightweight C library for HTML5 websockets
lws-eventlib-exports.h
1 /*
2  * libwebsockets - small server side websockets and web server implementation
3  *
4  * Copyright (C) 2010 - 2021 Andy Green <andy@warmcat.com>
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a copy
7  * of this software and associated documentation files (the "Software"), to
8  * deal in the Software without restriction, including without limitation the
9  * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
10  * sell copies of the Software, and to permit persons to whom the Software is
11  * furnished to do so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be included in
14  * all copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
21  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
22  * IN THE SOFTWARE.
23  *
24  * These are exports needed by event lib plugins.
25  */
26 
27 enum lws_event_lib_ops_flags {
28  LELOF_ISPOLL = (1 >> 0),
29  LELOF_DESTROY_FINAL = (1 >> 1),
30 };
31 
32 enum {
33  LWS_EV_READ = (1 << 0),
34  LWS_EV_WRITE = (1 << 1),
35  LWS_EV_START = (1 << 2),
36  LWS_EV_STOP = (1 << 3),
37 
38  LWS_EV_PREPARE_DELETION = (1u << 31),
39 };
40 
42  const char *name;
43  /* event loop-specific context init during context creation */
44  int (*init_context)(struct lws_context *context,
45  const struct lws_context_creation_info *info);
46  /* called during lws_destroy_context */
47  int (*destroy_context1)(struct lws_context *context);
48  /* called during lws_destroy_context2 */
49  int (*destroy_context2)(struct lws_context *context);
50  /* init vhost listening wsi */
51  int (*init_vhost_listen_wsi)(struct lws *wsi);
52  /* init the event loop for a pt */
53  int (*init_pt)(struct lws_context *context, void *_loop, int tsi);
54  /* called at end of first phase of close_free_wsi() */
55  int (*wsi_logical_close)(struct lws *wsi);
56  /* return nonzero if client connect not allowed */
57  int (*check_client_connect_ok)(struct lws *wsi);
58  /* close handle manually */
59  void (*close_handle_manually)(struct lws *wsi);
60  /* event loop accept processing */
61  int (*sock_accept)(struct lws *wsi);
62  /* control wsi active events */
63  void (*io)(struct lws *wsi, unsigned int flags);
64  /* run the event loop for a pt */
65  void (*run_pt)(struct lws_context *context, int tsi);
66  /* called before pt is destroyed */
67  void (*destroy_pt)(struct lws_context *context, int tsi);
68  /* called just before wsi is freed */
69  void (*destroy_wsi)(struct lws *wsi);
70 
71  uint8_t flags;
72 
73  uint16_t evlib_size_ctx;
74  uint16_t evlib_size_pt;
75  uint16_t evlib_size_vh;
76  uint16_t evlib_size_wsi;
77 };
78 
79 LWS_VISIBLE LWS_EXTERN void *
80 lws_evlib_wsi_to_evlib_pt(struct lws *wsi);
81 
82 LWS_VISIBLE LWS_EXTERN void *
83 lws_evlib_tsi_to_evlib_pt(struct lws_context *ctx, int tsi);
84 
85  /*
86  * You should consider these opaque for normal user code.
87  */
88 
89 LWS_VISIBLE LWS_EXTERN void *
90 lws_realloc(void *ptr, size_t size, const char *reason);
91 
92 LWS_VISIBLE LWS_EXTERN void
93 lws_vhost_destroy1(struct lws_vhost *vh);
94 
95 LWS_VISIBLE LWS_EXTERN void
96 lws_close_free_wsi(struct lws *wsi, enum lws_close_status reason,
97  const char *caller);
98 
99 LWS_VISIBLE LWS_EXTERN int
100 lws_vhost_foreach_listen_wsi(struct lws_context *cx, void *arg,
101  lws_dll2_foreach_cb_t cb);
102 
103 struct lws_context_per_thread;
104 LWS_VISIBLE LWS_EXTERN void
105 lws_service_do_ripe_rxflow(struct lws_context_per_thread *pt);
106 
107 #if !defined(wsi_from_fd) && !defined(WIN32) && !defined(_WIN32)
108 struct lws_context;
109 LWS_VISIBLE LWS_EXTERN struct lws *
110 wsi_from_fd(const struct lws_context *context, int fd);
111 #endif
112 
113 LWS_VISIBLE LWS_EXTERN int
114 _lws_plat_service_forced_tsi(struct lws_context *context, int tsi);
115 
116 LWS_VISIBLE LWS_EXTERN void
117 lws_context_destroy2(struct lws_context *context);
118 
119 LWS_VISIBLE LWS_EXTERN void
120 lws_destroy_event_pipe(struct lws *wsi);
121 
122 LWS_VISIBLE LWS_EXTERN void
123 __lws_close_free_wsi_final(struct lws *wsi);
124 
125 #if LWS_MAX_SMP > 1
126 
127 struct lws_mutex_refcount {
128  pthread_mutex_t lock;
129  pthread_t lock_owner;
130  const char *last_lock_reason;
131  char lock_depth;
132  char metadata;
133 };
134 
135 LWS_VISIBLE LWS_EXTERN void
136 lws_mutex_refcount_assert_held(struct lws_mutex_refcount *mr);
137 
138 LWS_VISIBLE LWS_EXTERN void
139 lws_mutex_refcount_init(struct lws_mutex_refcount *mr);
140 
141 LWS_VISIBLE LWS_EXTERN void
142 lws_mutex_refcount_destroy(struct lws_mutex_refcount *mr);
143 
144 LWS_VISIBLE LWS_EXTERN void
145 lws_mutex_refcount_lock(struct lws_mutex_refcount *mr, const char *reason);
146 
147 LWS_VISIBLE LWS_EXTERN void
148 lws_mutex_refcount_unlock(struct lws_mutex_refcount *mr);
149 
150 #endif
lws_close_status
Definition: lws-ws-close.h:39
Definition: lws-context-vhost.h:271
Definition: lws-eventlib-exports.h:41