Blame src/uv-common.h

Packit b5b901
/* Copyright Joyent, Inc. and other Node contributors. All rights reserved.
Packit b5b901
 *
Packit b5b901
 * Permission is hereby granted, free of charge, to any person obtaining a copy
Packit b5b901
 * of this software and associated documentation files (the "Software"), to
Packit b5b901
 * deal in the Software without restriction, including without limitation the
Packit b5b901
 * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
Packit b5b901
 * sell copies of the Software, and to permit persons to whom the Software is
Packit b5b901
 * furnished to do so, subject to the following conditions:
Packit b5b901
 *
Packit b5b901
 * The above copyright notice and this permission notice shall be included in
Packit b5b901
 * all copies or substantial portions of the Software.
Packit b5b901
 *
Packit b5b901
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
Packit b5b901
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
Packit b5b901
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
Packit b5b901
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
Packit b5b901
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
Packit b5b901
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
Packit b5b901
 * IN THE SOFTWARE.
Packit b5b901
 */
Packit b5b901
Packit b5b901
/*
Packit b5b901
 * This file is private to libuv. It provides common functionality to both
Packit b5b901
 * Windows and Unix backends.
Packit b5b901
 */
Packit b5b901
Packit b5b901
#ifndef UV_COMMON_H_
Packit b5b901
#define UV_COMMON_H_
Packit b5b901
Packit b5b901
#include <assert.h>
Packit b5b901
#include <stdarg.h>
Packit b5b901
#include <stddef.h>
Packit b5b901
Packit b5b901
#if defined(_MSC_VER) && _MSC_VER < 1600
Packit b5b901
# include "uv/stdint-msvc2008.h"
Packit b5b901
#else
Packit b5b901
# include <stdint.h>
Packit b5b901
#endif
Packit b5b901
Packit b5b901
#include "uv.h"
Packit b5b901
#include "uv/tree.h"
Packit b5b901
#include "queue.h"
Packit Service e08953
#include "strscpy.h"
Packit b5b901
Packit b5b901
#if EDOM > 0
Packit b5b901
# define UV__ERR(x) (-(x))
Packit b5b901
#else
Packit b5b901
# define UV__ERR(x) (x)
Packit b5b901
#endif
Packit b5b901
Packit b5b901
#if !defined(snprintf) && defined(_MSC_VER) && _MSC_VER < 1900
Packit b5b901
extern int snprintf(char*, size_t, const char*, ...);
Packit b5b901
#endif
Packit b5b901
Packit b5b901
#define ARRAY_SIZE(a) (sizeof(a) / sizeof((a)[0]))
Packit b5b901
Packit b5b901
#define container_of(ptr, type, member) \
Packit b5b901
  ((type *) ((char *) (ptr) - offsetof(type, member)))
Packit b5b901
Packit b5b901
#define STATIC_ASSERT(expr)                                                   \
Packit b5b901
  void uv__static_assert(int static_assert_failed[1 - 2 * !(expr)])
Packit b5b901
Packit b5b901
/* Handle flags. Some flags are specific to Windows or UNIX. */
Packit b5b901
enum {
Packit b5b901
  /* Used by all handles. */
Packit b5b901
  UV_HANDLE_CLOSING                     = 0x00000001,
Packit b5b901
  UV_HANDLE_CLOSED                      = 0x00000002,
Packit b5b901
  UV_HANDLE_ACTIVE                      = 0x00000004,
Packit b5b901
  UV_HANDLE_REF                         = 0x00000008,
Packit b5b901
  UV_HANDLE_INTERNAL                    = 0x00000010,
Packit b5b901
  UV_HANDLE_ENDGAME_QUEUED              = 0x00000020,
Packit b5b901
Packit b5b901
  /* Used by streams. */
Packit b5b901
  UV_HANDLE_LISTENING                   = 0x00000040,
Packit b5b901
  UV_HANDLE_CONNECTION                  = 0x00000080,
Packit b5b901
  UV_HANDLE_SHUTTING                    = 0x00000100,
Packit b5b901
  UV_HANDLE_SHUT                        = 0x00000200,
Packit b5b901
  UV_HANDLE_READ_PARTIAL                = 0x00000400,
Packit b5b901
  UV_HANDLE_READ_EOF                    = 0x00000800,
Packit b5b901
Packit b5b901
  /* Used by streams and UDP handles. */
Packit b5b901
  UV_HANDLE_READING                     = 0x00001000,
Packit b5b901
  UV_HANDLE_BOUND                       = 0x00002000,
Packit b5b901
  UV_HANDLE_READABLE                    = 0x00004000,
Packit b5b901
  UV_HANDLE_WRITABLE                    = 0x00008000,
Packit b5b901
  UV_HANDLE_READ_PENDING                = 0x00010000,
Packit b5b901
  UV_HANDLE_SYNC_BYPASS_IOCP            = 0x00020000,
Packit b5b901
  UV_HANDLE_ZERO_READ                   = 0x00040000,
Packit b5b901
  UV_HANDLE_EMULATE_IOCP                = 0x00080000,
Packit b5b901
  UV_HANDLE_BLOCKING_WRITES             = 0x00100000,
Packit b5b901
  UV_HANDLE_CANCELLATION_PENDING        = 0x00200000,
Packit b5b901
Packit b5b901
  /* Used by uv_tcp_t and uv_udp_t handles */
Packit b5b901
  UV_HANDLE_IPV6                        = 0x00400000,
Packit b5b901
Packit b5b901
  /* Only used by uv_tcp_t handles. */
Packit b5b901
  UV_HANDLE_TCP_NODELAY                 = 0x01000000,
Packit b5b901
  UV_HANDLE_TCP_KEEPALIVE               = 0x02000000,
Packit b5b901
  UV_HANDLE_TCP_SINGLE_ACCEPT           = 0x04000000,
Packit b5b901
  UV_HANDLE_TCP_ACCEPT_STATE_CHANGING   = 0x08000000,
Packit b5b901
  UV_HANDLE_TCP_SOCKET_CLOSED           = 0x10000000,
Packit b5b901
  UV_HANDLE_SHARED_TCP_SOCKET           = 0x20000000,
Packit b5b901
Packit b5b901
  /* Only used by uv_udp_t handles. */
Packit b5b901
  UV_HANDLE_UDP_PROCESSING              = 0x01000000,
Packit Service e08953
  UV_HANDLE_UDP_CONNECTED               = 0x02000000,
Packit Service e08953
  UV_HANDLE_UDP_RECVMMSG                = 0x04000000,
Packit b5b901
Packit b5b901
  /* Only used by uv_pipe_t handles. */
Packit b5b901
  UV_HANDLE_NON_OVERLAPPED_PIPE         = 0x01000000,
Packit b5b901
  UV_HANDLE_PIPESERVER                  = 0x02000000,
Packit b5b901
Packit b5b901
  /* Only used by uv_tty_t handles. */
Packit b5b901
  UV_HANDLE_TTY_READABLE                = 0x01000000,
Packit b5b901
  UV_HANDLE_TTY_RAW                     = 0x02000000,
Packit b5b901
  UV_HANDLE_TTY_SAVED_POSITION          = 0x04000000,
Packit b5b901
  UV_HANDLE_TTY_SAVED_ATTRIBUTES        = 0x08000000,
Packit b5b901
Packit b5b901
  /* Only used by uv_signal_t handles. */
Packit b5b901
  UV_SIGNAL_ONE_SHOT_DISPATCHED         = 0x01000000,
Packit b5b901
  UV_SIGNAL_ONE_SHOT                    = 0x02000000,
Packit b5b901
Packit b5b901
  /* Only used by uv_poll_t handles. */
Packit b5b901
  UV_HANDLE_POLL_SLOW                   = 0x01000000
Packit b5b901
};
Packit b5b901
Packit b5b901
int uv__loop_configure(uv_loop_t* loop, uv_loop_option option, va_list ap);
Packit b5b901
Packit b5b901
void uv__loop_close(uv_loop_t* loop);
Packit b5b901
Packit b5b901
int uv__tcp_bind(uv_tcp_t* tcp,
Packit b5b901
                 const struct sockaddr* addr,
Packit b5b901
                 unsigned int addrlen,
Packit b5b901
                 unsigned int flags);
Packit b5b901
Packit b5b901
int uv__tcp_connect(uv_connect_t* req,
Packit b5b901
                   uv_tcp_t* handle,
Packit b5b901
                   const struct sockaddr* addr,
Packit b5b901
                   unsigned int addrlen,
Packit b5b901
                   uv_connect_cb cb);
Packit b5b901
Packit Service e08953
int uv__udp_init_ex(uv_loop_t* loop,
Packit Service e08953
                    uv_udp_t* handle,
Packit Service e08953
                    unsigned flags,
Packit Service e08953
                    int domain);
Packit Service e08953
Packit b5b901
int uv__udp_bind(uv_udp_t* handle,
Packit b5b901
                 const struct sockaddr* addr,
Packit b5b901
                 unsigned int  addrlen,
Packit b5b901
                 unsigned int flags);
Packit b5b901
Packit Service e08953
int uv__udp_connect(uv_udp_t* handle,
Packit Service e08953
                    const struct sockaddr* addr,
Packit Service e08953
                    unsigned int addrlen);
Packit Service e08953
Packit Service e08953
int uv__udp_disconnect(uv_udp_t* handle);
Packit Service e08953
Packit Service e08953
int uv__udp_is_connected(uv_udp_t* handle);
Packit Service e08953
Packit b5b901
int uv__udp_send(uv_udp_send_t* req,
Packit b5b901
                 uv_udp_t* handle,
Packit b5b901
                 const uv_buf_t bufs[],
Packit b5b901
                 unsigned int nbufs,
Packit b5b901
                 const struct sockaddr* addr,
Packit b5b901
                 unsigned int addrlen,
Packit b5b901
                 uv_udp_send_cb send_cb);
Packit b5b901
Packit b5b901
int uv__udp_try_send(uv_udp_t* handle,
Packit b5b901
                     const uv_buf_t bufs[],
Packit b5b901
                     unsigned int nbufs,
Packit b5b901
                     const struct sockaddr* addr,
Packit b5b901
                     unsigned int addrlen);
Packit b5b901
Packit b5b901
int uv__udp_recv_start(uv_udp_t* handle, uv_alloc_cb alloccb,
Packit b5b901
                       uv_udp_recv_cb recv_cb);
Packit b5b901
Packit b5b901
int uv__udp_recv_stop(uv_udp_t* handle);
Packit b5b901
Packit b5b901
void uv__fs_poll_close(uv_fs_poll_t* handle);
Packit b5b901
Packit b5b901
int uv__getaddrinfo_translate_error(int sys_err);    /* EAI_* error. */
Packit b5b901
Packit b5b901
enum uv__work_kind {
Packit b5b901
  UV__WORK_CPU,
Packit b5b901
  UV__WORK_FAST_IO,
Packit b5b901
  UV__WORK_SLOW_IO
Packit b5b901
};
Packit b5b901
Packit b5b901
void uv__work_submit(uv_loop_t* loop,
Packit b5b901
                     struct uv__work *w,
Packit b5b901
                     enum uv__work_kind kind,
Packit b5b901
                     void (*work)(struct uv__work *w),
Packit b5b901
                     void (*done)(struct uv__work *w, int status));
Packit b5b901
Packit b5b901
void uv__work_done(uv_async_t* handle);
Packit b5b901
Packit b5b901
size_t uv__count_bufs(const uv_buf_t bufs[], unsigned int nbufs);
Packit b5b901
Packit b5b901
int uv__socket_sockopt(uv_handle_t* handle, int optname, int* value);
Packit b5b901
Packit b5b901
void uv__fs_scandir_cleanup(uv_fs_t* req);
Packit Service e08953
void uv__fs_readdir_cleanup(uv_fs_t* req);
Packit Service e08953
uv_dirent_type_t uv__fs_get_dirent_type(uv__dirent_t* dent);
Packit b5b901
Packit b5b901
int uv__next_timeout(const uv_loop_t* loop);
Packit b5b901
void uv__run_timers(uv_loop_t* loop);
Packit b5b901
void uv__timer_close(uv_timer_t* handle);
Packit b5b901
Packit Service e08953
void uv__process_title_cleanup(void);
Packit Service e08953
void uv__signal_cleanup(void);
Packit Service e08953
void uv__threadpool_cleanup(void);
Packit Service e08953
Packit b5b901
#define uv__has_active_reqs(loop)                                             \
Packit b5b901
  ((loop)->active_reqs.count > 0)
Packit b5b901
Packit b5b901
#define uv__req_register(loop, req)                                           \
Packit b5b901
  do {                                                                        \
Packit b5b901
    (loop)->active_reqs.count++;                                              \
Packit b5b901
  }                                                                           \
Packit b5b901
  while (0)
Packit b5b901
Packit b5b901
#define uv__req_unregister(loop, req)                                         \
Packit b5b901
  do {                                                                        \
Packit b5b901
    assert(uv__has_active_reqs(loop));                                        \
Packit b5b901
    (loop)->active_reqs.count--;                                              \
Packit b5b901
  }                                                                           \
Packit b5b901
  while (0)
Packit b5b901
Packit b5b901
#define uv__has_active_handles(loop)                                          \
Packit b5b901
  ((loop)->active_handles > 0)
Packit b5b901
Packit b5b901
#define uv__active_handle_add(h)                                              \
Packit b5b901
  do {                                                                        \
Packit b5b901
    (h)->loop->active_handles++;                                              \
Packit b5b901
  }                                                                           \
Packit b5b901
  while (0)
Packit b5b901
Packit b5b901
#define uv__active_handle_rm(h)                                               \
Packit b5b901
  do {                                                                        \
Packit b5b901
    (h)->loop->active_handles--;                                              \
Packit b5b901
  }                                                                           \
Packit b5b901
  while (0)
Packit b5b901
Packit b5b901
#define uv__is_active(h)                                                      \
Packit b5b901
  (((h)->flags & UV_HANDLE_ACTIVE) != 0)
Packit b5b901
Packit b5b901
#define uv__is_closing(h)                                                     \
Packit b5b901
  (((h)->flags & (UV_HANDLE_CLOSING | UV_HANDLE_CLOSED)) != 0)
Packit b5b901
Packit b5b901
#define uv__handle_start(h)                                                   \
Packit b5b901
  do {                                                                        \
Packit b5b901
    if (((h)->flags & UV_HANDLE_ACTIVE) != 0) break;                          \
Packit b5b901
    (h)->flags |= UV_HANDLE_ACTIVE;                                           \
Packit b5b901
    if (((h)->flags & UV_HANDLE_REF) != 0) uv__active_handle_add(h);          \
Packit b5b901
  }                                                                           \
Packit b5b901
  while (0)
Packit b5b901
Packit b5b901
#define uv__handle_stop(h)                                                    \
Packit b5b901
  do {                                                                        \
Packit b5b901
    if (((h)->flags & UV_HANDLE_ACTIVE) == 0) break;                          \
Packit b5b901
    (h)->flags &= ~UV_HANDLE_ACTIVE;                                          \
Packit b5b901
    if (((h)->flags & UV_HANDLE_REF) != 0) uv__active_handle_rm(h);           \
Packit b5b901
  }                                                                           \
Packit b5b901
  while (0)
Packit b5b901
Packit b5b901
#define uv__handle_ref(h)                                                     \
Packit b5b901
  do {                                                                        \
Packit b5b901
    if (((h)->flags & UV_HANDLE_REF) != 0) break;                             \
Packit b5b901
    (h)->flags |= UV_HANDLE_REF;                                              \
Packit b5b901
    if (((h)->flags & UV_HANDLE_CLOSING) != 0) break;                         \
Packit b5b901
    if (((h)->flags & UV_HANDLE_ACTIVE) != 0) uv__active_handle_add(h);       \
Packit b5b901
  }                                                                           \
Packit b5b901
  while (0)
Packit b5b901
Packit b5b901
#define uv__handle_unref(h)                                                   \
Packit b5b901
  do {                                                                        \
Packit b5b901
    if (((h)->flags & UV_HANDLE_REF) == 0) break;                             \
Packit b5b901
    (h)->flags &= ~UV_HANDLE_REF;                                             \
Packit b5b901
    if (((h)->flags & UV_HANDLE_CLOSING) != 0) break;                         \
Packit b5b901
    if (((h)->flags & UV_HANDLE_ACTIVE) != 0) uv__active_handle_rm(h);        \
Packit b5b901
  }                                                                           \
Packit b5b901
  while (0)
Packit b5b901
Packit b5b901
#define uv__has_ref(h)                                                        \
Packit b5b901
  (((h)->flags & UV_HANDLE_REF) != 0)
Packit b5b901
Packit b5b901
#if defined(_WIN32)
Packit b5b901
# define uv__handle_platform_init(h) ((h)->u.fd = -1)
Packit b5b901
#else
Packit b5b901
# define uv__handle_platform_init(h) ((h)->next_closing = NULL)
Packit b5b901
#endif
Packit b5b901
Packit b5b901
#define uv__handle_init(loop_, h, type_)                                      \
Packit b5b901
  do {                                                                        \
Packit b5b901
    (h)->loop = (loop_);                                                      \
Packit b5b901
    (h)->type = (type_);                                                      \
Packit b5b901
    (h)->flags = UV_HANDLE_REF;  /* Ref the loop when active. */              \
Packit b5b901
    QUEUE_INSERT_TAIL(&(loop_)->handle_queue, &(h)->handle_queue);            \
Packit b5b901
    uv__handle_platform_init(h);                                              \
Packit b5b901
  }                                                                           \
Packit b5b901
  while (0)
Packit b5b901
Packit b5b901
/* Note: uses an open-coded version of SET_REQ_SUCCESS() because of
Packit b5b901
 * a circular dependency between src/uv-common.h and src/win/internal.h.
Packit b5b901
 */
Packit b5b901
#if defined(_WIN32)
Packit b5b901
# define UV_REQ_INIT(req, typ)                                                \
Packit b5b901
  do {                                                                        \
Packit b5b901
    (req)->type = (typ);                                                      \
Packit b5b901
    (req)->u.io.overlapped.Internal = 0;  /* SET_REQ_SUCCESS() */             \
Packit b5b901
  }                                                                           \
Packit b5b901
  while (0)
Packit b5b901
#else
Packit b5b901
# define UV_REQ_INIT(req, typ)                                                \
Packit b5b901
  do {                                                                        \
Packit b5b901
    (req)->type = (typ);                                                      \
Packit b5b901
  }                                                                           \
Packit b5b901
  while (0)
Packit b5b901
#endif
Packit b5b901
Packit b5b901
#define uv__req_init(loop, req, typ)                                          \
Packit b5b901
  do {                                                                        \
Packit b5b901
    UV_REQ_INIT(req, typ);                                                    \
Packit b5b901
    uv__req_register(loop, req);                                              \
Packit b5b901
  }                                                                           \
Packit b5b901
  while (0)
Packit b5b901
Packit b5b901
/* Allocator prototypes */
Packit b5b901
void *uv__calloc(size_t count, size_t size);
Packit b5b901
char *uv__strdup(const char* s);
Packit b5b901
char *uv__strndup(const char* s, size_t n);
Packit b5b901
void* uv__malloc(size_t size);
Packit b5b901
void uv__free(void* ptr);
Packit b5b901
void* uv__realloc(void* ptr, size_t size);
Packit Service e08953
void* uv__reallocf(void* ptr, size_t size);
Packit b5b901
Packit b5b901
#endif /* UV_COMMON_H_ */