server_like.h

Go to the documentation of this file.

 
#pragma once
 
#include <ascii-chat/asciichat_errno.h>
#include <ascii-chat/crypto/handshake/common.h>
#include <ascii-chat/network/acip/transport.h>
#include <ascii-chat/network/mdns/mdns.h>
#include <ascii-chat/network/nat/upnp.h>
#include <ascii-chat/network/tcp/server.h>
#include <ascii-chat/network/websocket/server.h>
#include <ascii-chat/platform/api.h>
#include <ascii-chat/ui/status.h>
#include <stdbool.h>
 
/* ============================================================================
 * Callback Types
 * ============================================================================ */
 
typedef asciichat_error_t (*session_server_like_init_fn)(void *user_data);
 
typedef void (*session_server_like_interrupt_fn)(int sig);
 
typedef void (*session_server_like_cleanup_fn)(void *user_data);
 
typedef void (*session_server_like_status_fn)(void *user_data, ui_status_t *out_status);
 
/* ============================================================================
 * Configuration Structure
 * ============================================================================ */
 
typedef struct session_server_like_config {
  /* ================================================================ */
  /* Required Callbacks                                                */
  /* ================================================================ */
 
  session_server_like_init_fn init_fn;
  void *init_user_data;
 
  session_server_like_interrupt_fn interrupt_fn;
 
  /* ================================================================ */
  /* Optional Callbacks                                                */
  /* ================================================================ */
 
  session_server_like_cleanup_fn cleanup_fn;
  void *cleanup_user_data;
 
  session_server_like_status_fn status_fn;
  void *status_user_data;
 
  /* ================================================================ */
  /* TCP Server                                                        */
  /* ================================================================ */
 
  tcp_client_handler_fn tcp_handler;
 
  void *tcp_user_data;
 
  /* ================================================================ */
  /* WebSocket Server (optional)                                       */
  /* ================================================================ */
 
  struct {
    bool enabled;
 
    websocket_client_handler_fn handler;
 
    void *user_data;
  } websocket;
 
  /* ================================================================ */
  /* mDNS (optional)                                                   */
  /* ================================================================ */
 
  struct {
    bool enabled;
 
    const char *service_name;
 
    const char *service_type;
  } mdns;
 
  /* ================================================================ */
  /* UPnP (optional)                                                   */
  /* ================================================================ */
 
  struct {
    bool enabled;
 
    const char *description;
  } upnp;
 
  /* ================================================================ */
  /* System                                                            */
  /* ================================================================ */
 
  bool raise_fd_limit;
 
  int fd_limit_target;
 
} session_server_like_config_t;
 
/* ============================================================================
 * Entry Point
 * ============================================================================ */
 
ASCIICHAT_API asciichat_error_t session_server_like_run(const session_server_like_config_t *config);
 
/* ============================================================================
 * Accessors (for use by mode callbacks)
 * ============================================================================ */
 
ASCIICHAT_API tcp_server_t *session_server_like_get_tcp_server(void);
 
ASCIICHAT_API asciichat_mdns_t *session_server_like_get_mdns_ctx(void);
 
ASCIICHAT_API nat_upnp_context_t *session_server_like_get_upnp_ctx(void);
 
ASCIICHAT_API websocket_server_t *session_server_like_get_websocket_server(void);
 
/* ============================================================================
 * Helpers (for use by mode callbacks)
 * ============================================================================ */
 
ASCIICHAT_API asciichat_error_t session_server_like_mdns_advertise(const char *name, const char *type, uint16_t port,
                                                                   const char **txt, size_t txt_count);
 
ASCIICHAT_API asciichat_error_t session_server_like_handshake(crypto_handshake_context_t *ctx,
                                                              acip_transport_t *transport);
 
ASCIICHAT_API bool session_server_like_shutdown_requested(void);