ffdc4199218d922eb78d95b95962aca9e5dd6639
[sip-router] / 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
107 struct socket_info** get_sock_info_list(unsigned short proto);
108
109 int parse_phostport(char* s, char** host, int* hlen,
110                                                                  int* port, int* proto);
111
112 int parse_proto(unsigned char* s, long len, int* proto);
113
114 char* get_valid_proto_name(unsigned short proto);
115
116 /* helper function:
117  * returns next protocol, if the last one is reached return 0
118  * useful for cycling on the supported protocols
119  * order: udp, tcp, tls, sctp */
120 static inline int next_proto(unsigned short proto)
121 {
122         if (proto>PROTO_LAST)
123                 LM_ERR("unknown proto %d\n", proto);
124         else
125                 return nxt_proto[proto];
126         return 0;
127 }
128
129
130
131 /* gets first non-null socket_info structure
132  * (useful if for. e.g we are not listening on any udp sockets )
133  */
134 inline static struct socket_info* get_first_socket(void)
135 {
136         if (udp_listen) return udp_listen;
137 #ifdef USE_TCP
138         else if (tcp_listen) return tcp_listen;
139 #endif
140 #ifdef USE_SCTP
141         else if (sctp_listen) return sctp_listen;
142 #endif
143 #ifdef USE_TCP
144 #ifdef USE_TLS
145         else if (tls_listen) return tls_listen;
146 #endif
147 #endif
148         return 0;
149 }
150
151 /* structure to break down 'proto:host:port' */
152 typedef struct _sr_phostp {
153         int proto;
154         str host;
155         int port;
156 } sr_phostp_t;
157
158 struct socket_info* lookup_local_socket(str *phostp);
159 int parse_protohostport(str* ins, sr_phostp_t *r);
160
161 unsigned int ipv6_get_netif_scope(char *ipval);
162
163 #endif