git.sip-router.org Git - sip-router/blob - src/core/socket_info.h

   1 /*
   2  * find & manage listen addresses
   3  *
   4  * Copyright (C) 2001-2003 FhG Fokus
   5  *
   6  * This file is part of Kamailio, a free SIP server.
   7  *
   8  * Kamailio is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version
  12  *
  13  * Kamailio is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to" the Free Software
  20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  21  */
  22
  23 /*! \file
  24  * \brief Kamailio core :: listen address
  25  * This file contains code that initializes and handles Kamailio listen addresses
  26  * lists (struct socket_info). It is used mainly on startup.
  27  *
  28  */
  29
  30
  31 #ifndef socket_info_h
  32 #define socket_info_h
  33
  34 #include "ip_addr.h"
  35 #include "dprint.h"
  36 #include "globals.h"
  37
  38 /* This macro evaluates to the maximum length of string buffer needed to print
  39  * the text description of any socket, not counting the terminating zero added
  40  * by socket2str */
  41 #define MAX_SOCKET_STR (sizeof("unknown") - 1 + IP_ADDR_MAX_STR_SIZE + \
  42         INT2STR_MAX_LEN + 2 + 2)
  43
  44 /* Maximum length for advertise string of listen socket */
  45 #define MAX_SOCKET_ADVERTISE_STR        511
  46
  47 int socket2str(char* s, int* len, struct socket_info* si);
  48 int socketinfo2str(char* s, int* len, struct socket_info* si, int mode);
  49
  50 /* Helper macro that results in the default port based on the protocol */
  51 #define proto_default_port(proto) ((proto==PROTO_TLS)?SIPS_PORT:SIP_PORT)
  52
  53 /* struct socket_info is defined in ip_addr.h */
  54
  55 extern struct socket_info* udp_listen;
  56 #ifdef USE_TCP
  57 extern struct socket_info* tcp_listen;
  58 #endif
  59 #ifdef USE_TLS
  60 extern struct socket_info* tls_listen;
  61 #endif
  62 #ifdef USE_SCTP
  63 extern struct socket_info* sctp_listen;
  64 #endif
  65
  66 extern enum sip_protos nxt_proto[PROTO_LAST+1];
  67
  68
  69
  70 /* flags for finding out the address types */
  71 #define SOCKET_T_IPV4  1
  72 #define SOCKET_T_IPV6  2
  73 #define SOCKET_T_UDP   4
  74 #define SOCKET_T_TCP   8
  75 #define SOCKET_T_TLS  16
  76 #define SOCKET_T_SCTP 32
  77
  78 extern int socket_types;
  79
  80 void init_proto_order(void);
  81
  82 int add_listen_iface(char* name, struct name_lst* nlst,
  83                                                 unsigned short port, unsigned short proto,
  84                                                 enum si_flags flags);
  85 int add_listen_iface_name(char* name, struct name_lst* addr_l,
  86                                                 unsigned short port, unsigned short proto, char *sockname,
  87                                                 enum si_flags flags);
  88 int add_listen_advertise_iface(char* name, struct name_lst* nlst,
  89                                                 unsigned short port, unsigned short proto,
  90                                                 char *useaddr, unsigned short useport,
  91                                                 enum si_flags flags);
  92 int add_listen_advertise_iface_name(char* name, struct name_lst* nlst,
  93                                                 unsigned short port, unsigned short proto,
  94                                                 char *useaddr, unsigned short useport, char *sockname,
  95                                                 enum si_flags flags);
  96 int fix_all_socket_lists(void);
  97 void print_all_socket_lists(void);
  98 void print_aliases(void);
  99
 100 struct socket_info* grep_sock_info(str* host, unsigned short port,
 101                                                                                 unsigned short proto);
 102 struct socket_info* grep_sock_info_by_port(unsigned short port,
 103                                                                                         unsigned short proto);
 104 struct socket_info* find_si(struct ip_addr* ip, unsigned short port,
 105                                                                                                 unsigned short proto);
 106 socket_info_t* ksr_get_socket_by_name(str *sockname);
 107
 108 struct socket_info** get_sock_info_list(unsigned short proto);
 109
 110 int parse_phostport(char* s, char** host, int* hlen,
 111                                                                  int* port, int* proto);
 112
 113 int parse_proto(unsigned char* s, long len, int* proto);
 114
 115 char* get_valid_proto_name(unsigned short proto);
 116
 117 /* helper function:
 118  * returns next protocol, if the last one is reached return 0
 119  * useful for cycling on the supported protocols
 120  * order: udp, tcp, tls, sctp */
 121 static inline int next_proto(unsigned short proto)
 122 {
 123         if (proto>PROTO_LAST)
 124                 LM_ERR("unknown proto %d\n", proto);
 125         else
 126                 return nxt_proto[proto];
 127         return 0;
 128 }
 129
 130
 131
 132 /* gets first non-null socket_info structure
 133  * (useful if for. e.g we are not listening on any udp sockets )
 134  */
 135 inline static struct socket_info* get_first_socket(void)
 136 {
 137         if (udp_listen) return udp_listen;
 138 #ifdef USE_TCP
 139         else if (tcp_listen) return tcp_listen;
 140 #endif
 141 #ifdef USE_SCTP
 142         else if (sctp_listen) return sctp_listen;
 143 #endif
 144 #ifdef USE_TCP
 145 #ifdef USE_TLS
 146         else if (tls_listen) return tls_listen;
 147 #endif
 148 #endif
 149         return 0;
 150 }
 151
 152 /* structure to break down 'proto:host:port' */
 153 typedef struct _sr_phostp {
 154         int proto;
 155         str host;
 156         int port;
 157 } sr_phostp_t;
 158
 159 struct socket_info* lookup_local_socket(str *phostp);
 160 int parse_protohostport(str* ins, sr_phostp_t *r);
 161
 162 unsigned int ipv6_get_netif_scope(char *ipval);
 163
 164 #endif