freeDiameter: include/freeDiameter/libfdcore.h annotate

annotate include/freeDiameter/libfdcore.h @ 1186:56c36d1007b4

Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling.

author	Sebastien Decugis <sdecugis@freediameter.net>
date	Fri, 07 Jun 2013 18:48:34 +0800
parents	773498f59520
children	50bf33dc8fe0

rev	line source
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	1 /*********************************************************************************************************
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	2 * Software License Agreement (BSD License) *
740 4a9f08d6b6ba Updated my mail address Sebastien Decugis <sdecugis@nict.go.jp> parents: 717 diff changeset	3 * Author: Sebastien Decugis <sdecugis@freediameter.net> *
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	4 * *
1127 1af09cc156d6 Updated copyright information Sebastien Decugis <sdecugis@freediameter.net> parents: 1122 diff changeset	5 * Copyright (c) 2013, WIDE Project and NICT *
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	6 * All rights reserved. *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	7 * *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	8 * Redistribution and use of this software in source and binary forms, with or without modification, are *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	9 * permitted provided that the following conditions are met: *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	10 * *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	11 * * Redistributions of source code must retain the above *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	12 * copyright notice, this list of conditions and the *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	13 * following disclaimer. *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	14 * *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	15 * * Redistributions in binary form must reproduce the above *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	16 * copyright notice, this list of conditions and the *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	17 * following disclaimer in the documentation and/or other *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	18 * materials provided with the distribution. *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	19 * *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	20 * * Neither the name of the WIDE Project or NICT nor the *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	21 * names of its contributors may be used to endorse or *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	22 * promote products derived from this software without *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	23 * specific prior written permission of WIDE Project and *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	24 * NICT. *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	25 * *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	26 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	27 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	28 * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	29 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	30 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	31 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	32 * TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	33 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	34 *********************************************************************************************************/
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	35
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	36 #ifndef _LIBFDCORE_H
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	37 #define _LIBFDCORE_H
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	38
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	39
904 b839a1b1c1da Make freeDiameter headers more C++ friendly -- thank you Thomas Sebastien Decugis <sdecugis@freediameter.net> parents: 808 diff changeset	40 #ifdef __cplusplus
b839a1b1c1da Make freeDiameter headers more C++ friendly -- thank you Thomas Sebastien Decugis <sdecugis@freediameter.net> parents: 808 diff changeset	41 extern "C" {
b839a1b1c1da Make freeDiameter headers more C++ friendly -- thank you Thomas Sebastien Decugis <sdecugis@freediameter.net> parents: 808 diff changeset	42 #endif
b839a1b1c1da Make freeDiameter headers more C++ friendly -- thank you Thomas Sebastien Decugis <sdecugis@freediameter.net> parents: 808 diff changeset	43
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	44 #include <freeDiameter/libfdproto.h>
16 013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	45 #include <gnutls/gnutls.h>
013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	46 #include <gnutls/x509.h>
013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	47
013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	48 /* GNUTLS version */
013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	49 #ifndef GNUTLS_VERSION
013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	50 #define GNUTLS_VERSION LIBGNUTLS_VERSION
013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	51 #endif /* GNUTLS_VERSION */
013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	52
214 5a1b93f59f8f Added trace facility for GNUTLS calls Sebastien Decugis <sdecugis@nict.go.jp> parents: 162 diff changeset	53 /* GNUTLS calls debug level */
5a1b93f59f8f Added trace facility for GNUTLS calls Sebastien Decugis <sdecugis@nict.go.jp> parents: 162 diff changeset	54 #ifndef GNUTLS_DBG_LEVEL
5a1b93f59f8f Added trace facility for GNUTLS calls Sebastien Decugis <sdecugis@nict.go.jp> parents: 162 diff changeset	55 #define GNUTLS_DBG_LEVEL ANNOYING
5a1b93f59f8f Added trace facility for GNUTLS calls Sebastien Decugis <sdecugis@nict.go.jp> parents: 162 diff changeset	56 #endif /* GNUTLS_DBG_LEVEL */
5a1b93f59f8f Added trace facility for GNUTLS calls Sebastien Decugis <sdecugis@nict.go.jp> parents: 162 diff changeset	57
805 fb5e0fd923ff Updated verification of the local certificate following GnuTLS 3.x guideline Sebastien Decugis <sdecugis@freediameter.net> parents: 740 diff changeset	58
16 013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	59 /* Check the return value of a GNUTLS function, log and propagate */
1085 7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	60 #define CHECK_GNUTLS_GEN( faillevel, __call__, __fallback__ ) { \
7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	61 CHECK_PRELUDE(__call__); \
7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	62 if (__ret__ < 0) { \
1159 05f74dc19c49 Include source rev number in version information when available Sebastien Decugis <sdecugis@freediameter.net> parents: 1155 diff changeset	63 LOG(faillevel, "TLS ERROR: in '%s' :\t%s", #__call__ , gnutls_strerror(__ret__)); \
1085 7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	64 __fallback__; \
7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	65 } \
16 013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	66 }
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	67
1085 7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	68 /* we use this macro to help debugging gnutls usage issues -- just change the content to display what you need */
214 5a1b93f59f8f Added trace facility for GNUTLS calls Sebastien Decugis <sdecugis@nict.go.jp> parents: 162 diff changeset	69 #define GNUTLS_TRACE( __call__) { \
1085 7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	70 TRACE_CALL("Check: %s", #__call__ ); \
214 5a1b93f59f8f Added trace facility for GNUTLS calls Sebastien Decugis <sdecugis@nict.go.jp> parents: 162 diff changeset	71 (__call__); \
5a1b93f59f8f Added trace facility for GNUTLS calls Sebastien Decugis <sdecugis@nict.go.jp> parents: 162 diff changeset	72 }
5a1b93f59f8f Added trace facility for GNUTLS calls Sebastien Decugis <sdecugis@nict.go.jp> parents: 162 diff changeset	73
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	74
1085 7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	75 #ifndef EXCLUDE_DEPRECATED
7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	76 /* Macro for transition, replace with CHECK_GNUTLS_GEN */
1159 05f74dc19c49 Include source rev number in version information when available Sebastien Decugis <sdecugis@freediameter.net> parents: 1155 diff changeset	77 #define CHECK_GNUTLS_DO( __call__, __fallback__ ) \
05f74dc19c49 Include source rev number in version information when available Sebastien Decugis <sdecugis@freediameter.net> parents: 1155 diff changeset	78 CHECK_GNUTLS_GEN( FD_LOG_ERROR, __call__, __fallback__ )
1085 7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	79
7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	80 #endif /* EXCLUDE_DEPRECATED */
7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	81
7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	82
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	83 /============================================================/
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	84 /* INITIALIZATION */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	85 /============================================================/
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	86
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	87
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	88 /* Initialize the libfdcore internals. This also initializes libfdproto */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	89 int fd_core_initialize(void);
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	90
1159 05f74dc19c49 Include source rev number in version information when available Sebastien Decugis <sdecugis@freediameter.net> parents: 1155 diff changeset	91 /* A string describing the version of the library */
05f74dc19c49 Include source rev number in version information when available Sebastien Decugis <sdecugis@freediameter.net> parents: 1155 diff changeset	92 extern const char fd_core_version[];
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	93
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	94 /* Parse the freeDiameter.conf configuration file, load the extensions */
947 cce5d4bace82 Make config file parameter const and convert another fprintf to TRACE_DEBUG_ERROR. Thomas Klausner <tk@giga.or.at> parents: 904 diff changeset	95 int fd_core_parseconf(const char * conffile);
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	96
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	97 /* Start the server & client threads */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	98 int fd_core_start(void);
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	99
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	100 /* Block until the framework has completed its initialization -- useful for extensions */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	101 int fd_core_waitstartcomplete(void);
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	102
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	103 /* Initialize shutdown of the framework */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	104 int fd_core_shutdown(void);
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	105
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	106 /* Wait for the shutdown to be complete -- this should always be called after fd_core_shutdown */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	107 int fd_core_wait_shutdown_complete(void);
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	108
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	109
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	110 /============================================================/
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	111 /* CONFIG */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	112 /============================================================/
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	113
8 3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	114 /* Structure to hold the configuration of the freeDiameter daemon */
640 237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	115 #define EYEC_CONFIG 0xC011F16
8 3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	116 struct fd_config {
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	117 int cnf_eyec; /* Eye catcher: EYEC_CONFIG */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	118
947 cce5d4bace82 Make config file parameter const and convert another fprintf to TRACE_DEBUG_ERROR. Thomas Klausner <tk@giga.or.at> parents: 904 diff changeset	119 const char cnf_file; / Configuration file to parse, default is DEFAULT_CONF_FILE */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	120
706 4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	121 DiamId_t cnf_diamid; /* Diameter Identity of the local peer (FQDN -- ASCII) */
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	122 size_t cnf_diamid_len;/* cached length of the previous string */
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	123 DiamId_t cnf_diamrlm; /* Diameter realm of the local peer, default to realm part of cnf_diamid */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	124 size_t cnf_diamrlm_len;/* length of the previous string */
8 3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	125
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	126 unsigned int cnf_timer_tc; /* The value in seconds of the default Tc timer */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	127 unsigned int cnf_timer_tw; /* The value in seconds of the default Tw timer */
8 3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	128
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	129 uint16_t cnf_port; /* the local port for legacy Diameter (default: 3868) in host byte order */
1164 e8bf101264fa Updated default secure port value according to RFC6733 Sebastien Decugis <sdecugis@freediameter.net> parents: 1159 diff changeset	130 uint16_t cnf_port_tls; /* the local port for Diameter/TLS (default: 5658) in host byte order */
1180 773498f59520 Preparing for future DTLS/SCTP support Sebastien Decugis <sdecugis@freediameter.net> parents: 1169 diff changeset	131 uint16_t cnf_port_3436; /* Open an additional server port to listen to old TLS/SCTP clients (RFC3436, freeDiameter versions < 1.2.0) */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	132 uint16_t cnf_sctp_str; /* default max number of streams for SCTP associations (def: 30) */
1122 d4371b7aa0ff New CMake option: ADDRESS_AVP_INCLUDE_PORT. Turn off for standard Host-IP-Address AVPs Sebastien Decugis <sdecugis@freediameter.net> parents: 1120 diff changeset	133 struct fd_list cnf_endpoints; /* the local endpoints to bind the server to. list of struct fd_endpoint. default is empty (bind all). After servers are started, this is the actual list of endpoints including port information. */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	134 struct fd_list cnf_apps; /* Applications locally supported (except relay, see flags). Use fd_disp_app_support to add one. list of struct fd_app. */
253 ad6c0118fb50 Configurable number of server threads Sebastien Decugis <sdecugis@nict.go.jp> parents: 214 diff changeset	135 uint16_t cnf_dispthr; /* Number of dispatch threads to create */
8 3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	136 struct {
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	137 unsigned no_fwd : 1; /* the peer does not relay messages (0xffffff app id) */
8 3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	138 unsigned no_ip4 : 1; /* disable IP */
3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	139 unsigned no_ip6 : 1; /* disable IPv6 */
3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	140 unsigned no_tcp : 1; /* disable use of TCP */
3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	141 unsigned no_sctp: 1; /* disable the use of SCTP */
3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	142 unsigned pr_tcp : 1; /* prefer TCP over SCTP */
3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	143 unsigned tls_alg: 1; /* TLS algorithm for initiated cnx. 0: separate port. 1: inband-security (old) */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	144 } cnf_flags;
8 3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	145
16 013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	146 struct {
1155 d00b5914351e Allow running freeDiameter without TLS credentials if the following conditions are verified: Sebastien Decugis <sdecugis@freediameter.net> parents: 1136 diff changeset	147 int tls_disabled;
d00b5914351e Allow running freeDiameter without TLS credentials if the following conditions are verified: Sebastien Decugis <sdecugis@freediameter.net> parents: 1136 diff changeset	148
18 e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	149 /* Credentials parameters (backup) */
e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	150 char * cert_file;
e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	151 char * key_file;
e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	152
e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	153 char * ca_file;
142 dee0a871abcd Added number of CA certificates for debug Sebastien Decugis <sdecugis@nict.go.jp> parents: 140 diff changeset	154 int ca_file_nr;
18 e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	155 char * crl_file;
e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	156
e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	157 char * prio_string;
e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	158 unsigned int dh_bits;
578 7c9a00bfd115 Allow TLS Diffie-Hellmann parameters to be loaded from a file (ticket #17) Sebastien Decugis <sdecugis@nict.go.jp> parents: 542 diff changeset	159 char * dh_file;
18 e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	160
e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	161 /* GNUTLS parameters */
e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	162 gnutls_priority_t prio_cache;
e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	163 gnutls_dh_params_t dh_cache;
e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	164
e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	165 /* GNUTLS server credential(s) */
805 fb5e0fd923ff Updated verification of the local certificate following GnuTLS 3.x guideline Sebastien Decugis <sdecugis@freediameter.net> parents: 740 diff changeset	166 gnutls_certificate_credentials_t credentials; /* contains local cert + trust anchors */
fb5e0fd923ff Updated verification of the local certificate following GnuTLS 3.x guideline Sebastien Decugis <sdecugis@freediameter.net> parents: 740 diff changeset	167 #ifdef GNUTLS_VERSION_300
fb5e0fd923ff Updated verification of the local certificate following GnuTLS 3.x guideline Sebastien Decugis <sdecugis@freediameter.net> parents: 740 diff changeset	168 gnutls_x509_trust_list_t trustlist; /* the logic to check local certificate has changed */
fb5e0fd923ff Updated verification of the local certificate following GnuTLS 3.x guideline Sebastien Decugis <sdecugis@freediameter.net> parents: 740 diff changeset	169 #endif /* GNUTLS_VERSION_300 */
18 e7187583dcf8 Added CA helper script Sebastien Decugis <sdecugis@nict.go.jp> parents: 17 diff changeset	170
16 013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	171 } cnf_sec_data;
013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	172
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	173 uint32_t cnf_orstateid; /* The value to use in Origin-State-Id, default to random value */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	174 struct dictionary cnf_dict; / pointer to the global dictionary */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	175 struct fifo cnf_main_ev; / events for the daemon's main (struct fd_event items) */
8 3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	176 };
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	177 extern struct fd_config fd_g_config; / The pointer to access the global configuration, initalized in main */
8 3e143f047f78 Backup for the week-end Sebastien Decugis <sdecugis@nict.go.jp> parents: 7 diff changeset	178
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	179
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	180
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	181 /============================================================/
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	182 /* PEERS */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	183 /============================================================/
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	184
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	185 /* States of a peer */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	186 enum peer_state {
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	187 /* Stable states */
16 013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	188 STATE_NEW = 0, /* The peer has been just been created, PSM thread not started yet */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	189 STATE_OPEN, /* Connexion established */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	190
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	191 /* Peer state machine */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	192 STATE_CLOSED, /* No connection established, will re-attempt after TcTimer. */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	193 STATE_CLOSING, /* the connection is being shutdown (DPR/DPA in progress) */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	194 STATE_WAITCNXACK, /* Attempting to establish transport-level connection */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	195 STATE_WAITCNXACK_ELEC, /* Received a CER from this same peer on an incoming connection (other peer object), while we were waiting for cnx ack */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	196 STATE_WAITCEA, /* Connection established, CER sent, waiting for CEA */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	197 /* STATE_WAITRETURNS_ELEC, / / This state is not stable and therefore deprecated:
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	198 We have sent a CER on our initiated connection, and received a CER from the remote peer on another connection. Election.
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	199 If we win the election, we must disconnect the initiated connection and send a CEA on the other => we go to OPEN state.
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	200 If we lose, we disconnect the other connection (receiver) and fallback to WAITCEA state. */
42 f4d94bc65e1f Some minor updates Sebastien Decugis <sdecugis@nict.go.jp> parents: 38 diff changeset	201 STATE_OPEN_HANDSHAKE, /* TLS Handshake and validation are in progress in open state -- we use it only for debug purpose, it is never displayed */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	202
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	203 /* Failover state machine */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	204 STATE_SUSPECT, /* A DWR was sent and not answered within TwTime. Failover in progress. */
14 14cf6daf716d Some progress on peers module Sebastien Decugis <sdecugis@nict.go.jp> parents: 13 diff changeset	205 STATE_REOPEN, /* Connection has been re-established, waiting for 3 DWR/DWA exchanges before putting back to service */
16 013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	206
706 4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	207 /* Ordering issues with multistream & state machine. -- see top of p_psm.c for explanation */
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	208 STATE_OPEN_NEW, /* after CEA is sent, until a new message is received. Force ordering in this state */
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	209 STATE_CLOSING_GRACE, /* after DPA is sent or received, give a short delay for messages in the pipe to be received. */
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	210
16 013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	211 /* Error state */
013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	212 STATE_ZOMBIE /* The PSM thread is not running anymore; it must be re-started or peer should be deleted. */
013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	213 #define STATE_MAX STATE_ZOMBIE
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	214 };
33 e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	215 /* The following macro is called in freeDiameter/p_psm.c */
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	216 #define DECLARE_STATE_STR() \
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	217 const char *peer_state_str[] = { \
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	218 "STATE_NEW" \
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	219 , "STATE_OPEN" \
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	220 , "STATE_CLOSED" \
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	221 , "STATE_CLOSING" \
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	222 , "STATE_WAITCNXACK" \
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	223 , "STATE_WAITCNXACK_ELEC" \
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	224 , "STATE_WAITCEA" \
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	225 , "STATE_OPEN_HANDSHAKE" \
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	226 , "STATE_SUSPECT" \
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	227 , "STATE_REOPEN" \
706 4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	228 , "STATE_OPEN_NEW" \
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	229 , "STATE_CLOSING_GRACE" \
33 e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	230 , "STATE_ZOMBIE" \
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	231 };
e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	232 extern const char *peer_state_str[];
12 418d2ce80dc8 Added support in configuration file for peers declaration Sebastien Decugis <sdecugis@nict.go.jp> parents: 11 diff changeset	233 #define STATE_STR(state) \
16 013ce9851131 Started including TLS code Sebastien Decugis <sdecugis@nict.go.jp> parents: 14 diff changeset	234 (((unsigned)(state)) <= STATE_MAX ? peer_state_str[((unsigned)(state)) ] : "<Invalid>")
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	235
972 ce3cacbbccc9 Fix some typos. Thomas Klausner <tk@giga.or.at> parents: 968 diff changeset	236 /* Constants for the peer_info structure below */
640 237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	237 #define PI_P3_DEFAULT 0 /* Use any available protocol */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	238 #define PI_P3_IP 1 /* Use only IP to connect to this peer */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	239 #define PI_P3_IPv6 2 /* resp, IPv6 */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	240
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	241 #define PI_P4_DEFAULT 0 /* Attempt any available protocol */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	242 #define PI_P4_TCP 1 /* Only use TCP */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	243 #define PI_P4_SCTP 2 /* Only use SCTP */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	244
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	245 #define PI_ALGPREF_SCTP 0 /* SCTP is attempted first (default) */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	246 #define PI_ALGPREF_TCP 1 /* TCP is attempted first */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	247
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	248 #define PI_SEC_DEFAULT 0 /* New TLS security (handshake after connection, protecting also CER/CEA) */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	249 #define PI_SEC_NONE 1 /* Transparent security with this peer (IPsec) */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	250 #define PI_SEC_TLS_OLD 2 /* Old TLS security (use Inband-Security-Id AVP during CER/CEA) */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	251 /* Set sec = 3 to authorize use of (Inband-Security-Id == NONE) with this peer, sec = 2 only authorizing TLS */
1180 773498f59520 Preparing for future DTLS/SCTP support Sebastien Decugis <sdecugis@freediameter.net> parents: 1169 diff changeset	252
773498f59520 Preparing for future DTLS/SCTP support Sebastien Decugis <sdecugis@freediameter.net> parents: 1169 diff changeset	253 #define PI_SCTPSEC_DEF 0 /* Use DTLS over SCTP to connect to this peer (default) */
773498f59520 Preparing for future DTLS/SCTP support Sebastien Decugis <sdecugis@freediameter.net> parents: 1169 diff changeset	254 #define PI_SCTPSEC_3436 1 /* Use TLS over SCTP to connect to this peer (RFC3436) */
640 237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	255
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	256 #define PI_EXP_NONE 0 /* the peer entry does not expire */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	257 #define PI_EXP_INACTIVE 1 /* the peer entry expires (i.e. is deleted) after pi_lft seconds without activity */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	258
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	259 #define PI_PRST_NONE 0 /* the peer entry is deleted after disconnection / error */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	260 #define PI_PRST_ALWAYS 1 /* the peer entry is persistant (will be kept as ZOMBIE in case of error) */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	261
37 cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	262 /* Information about a remote peer */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	263 struct peer_info {
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	264
706 4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	265 DiamId_t pi_diamid; /* (supposedly) UTF-8, \0 terminated. The Diameter Identity of the remote peer. */
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	266 size_t pi_diamidlen; /* cached length of pi_diamid */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	267
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	268 struct {
37 cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	269 struct {
640 237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	270 unsigned pro3 :2; /* PI_P3_* */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	271 unsigned pro4 :2; /* PI_P4_* */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	272 unsigned alg :1; /* PI_ALGPREF_* */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	273 unsigned sec :2; /* PI_SEC_* */
1180 773498f59520 Preparing for future DTLS/SCTP support Sebastien Decugis <sdecugis@freediameter.net> parents: 1169 diff changeset	274 unsigned sctpsec :1; /* PI_SCTPSEC_* */
640 237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	275 unsigned exp :1; /* PI_EXP_* */
237cf6339546 dbg_interactive almost complete Sebastien Decugis <sdecugis@nict.go.jp> parents: 628 diff changeset	276 unsigned persist :1; /* PI_PRST_* */
37 cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	277
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	278 } pic_flags; /* Flags influencing the connection to the remote peer */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	279
706 4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	280 DiamId_t pic_realm; /* If configured, the daemon will check the received realm in CER/CEA matches this. */
37 cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	281 uint16_t pic_port; /* port to connect to. 0: default. */
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	282
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	283 uint32_t pic_lft; /* lifetime of this peer when inactive (see pic_flags.exp definition) */
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	284 int pic_tctimer; /* use this value for TcTimer instead of global, if != 0 */
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	285 int pic_twtimer; /* use this value for TwTimer instead of global, if != 0 */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	286
37 cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	287 char * pic_priority; /* Priority string for GnuTLS if we don't use the default */
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	288
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	289 } config; /* Configured data (static for this peer entry) */
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	290
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	291 struct {
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	292
706 4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	293 /* enum peer_state pir_state; */
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	294 /* Since 1.1.0, read the state with fd_peer_getstate(peer). */
36 1498b3c7304c Backup Sebastien Decugis <sdecugis@nict.go.jp> parents: 34 diff changeset	295
706 4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	296 DiamId_t pir_realm; /* The received realm in CER/CEA. */
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	297 size_t pir_realmlen; /* length of the realm */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	298
37 cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	299 uint32_t pir_vendorid; /* Content of the Vendor-Id AVP, or 0 by default */
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	300 uint32_t pir_orstate; /* Origin-State-Id value */
706 4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	301 os0_t pir_prodname; /* copy of Product-Name AVP (\0 terminated) */
37 cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	302 uint32_t pir_firmrev; /* Content of the Firmware-Revision AVP */
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	303 int pir_relay; /* The remote peer advertized the relay application */
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	304 struct fd_list pir_apps; /* applications advertised by the remote peer, except relay (pi_flags.relay) */
43 2db15632a63d Added a large part of connection establishment logic, to test Sebastien Decugis <sdecugis@nict.go.jp> parents: 42 diff changeset	305 int pir_isi; /* Inband-Security-Id advertised (PI_SEC_* bits) */
37 cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	306
78 a58f0757c06a Added code for DPR/DPA Sebastien Decugis <sdecugis@nict.go.jp> parents: 43 diff changeset	307 uint32_t pir_lastDC; /* The last Disconnect-Cause value received */
a58f0757c06a Added code for DPR/DPA Sebastien Decugis <sdecugis@nict.go.jp> parents: 43 diff changeset	308
37 cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	309 int pir_proto; /* The L4 protocol currently used with the peer (IPPROTO_TCP or IPPROTO_SCTP) */
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	310 const gnutls_datum_t pir_cert_list; / The (valid) credentials that the peer has presented, or NULL if TLS is not used */
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	311 /* This is inspired from http://www.gnu.org/software/gnutls/manual/gnutls.html#ex_003ax509_002dinfo
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	312 see there for example of using this data */
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	313 unsigned int pir_cert_list_size; /* Number of certificates in the list */
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	314
cc3c59fe98fe Lot of cleanups in peer structure management Sebastien Decugis <sdecugis@nict.go.jp> parents: 36 diff changeset	315 } runtime; /* Data populated after connection, may change between 2 connections -- not used by fd_peer_add */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	316
13 ef9ef3bf4752 Progress on peer state machine Sebastien Decugis <sdecugis@nict.go.jp> parents: 12 diff changeset	317 struct fd_list pi_endpoints; /* Endpoint(s) of the remote peer (configured, discovered, or advertized). list of struct fd_endpoint. DNS resolved if empty. */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	318 };
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	319
454 f1484823cb4a Small hack which might spear some concurrency problems and is quite harmless Sebastien Decugis <sdecugis@nict.go.jp> parents: 447 diff changeset	320
11 6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	321 struct peer_hdr {
706 4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	322 struct fd_list chain; /* Link into the list of all the peers, ordered by their Diameter Id (fd_os_cmp) */
11 6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	323 struct peer_info info; /* The public data */
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	324
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	325 /* This header is followed by more data in the private peer structure definition */
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	326 };
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	327
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	328 /* the global list of peers.
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	329 Since we are not expecting so many connections, we don't use a hash, but it might be changed.
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	330 The list items are peer_hdr structures (actually, fd_peer, but the cast is OK) */
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	331 extern struct fd_list fd_g_peers;
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	332 extern pthread_rwlock_t fd_g_peers_rw; /* protect the list */
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	333
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	334 /*
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	335 * FUNCTION: fd_peer_add
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	336 *
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	337 * PARAMETERS:
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	338 * info : Information to create the peer.
12 418d2ce80dc8 Added support in configuration file for peers declaration Sebastien Decugis <sdecugis@nict.go.jp> parents: 11 diff changeset	339 * orig_dbg : A string indicating the origin of the peer information, for debug (ex: conf, redirect, ...)
11 6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	340 * cb : optional, a callback to call (once) when the peer connection is established or failed
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	341 * cb_data : opaque data to pass to the callback.
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	342 *
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	343 * DESCRIPTION:
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	344 * Add a peer to the list of peers to which the daemon must maintain a connexion.
13 ef9ef3bf4752 Progress on peer state machine Sebastien Decugis <sdecugis@nict.go.jp> parents: 12 diff changeset	345 *
ef9ef3bf4752 Progress on peer state machine Sebastien Decugis <sdecugis@nict.go.jp> parents: 12 diff changeset	346 * The content of info parameter is copied, except for the list of endpoints if
ef9ef3bf4752 Progress on peer state machine Sebastien Decugis <sdecugis@nict.go.jp> parents: 12 diff changeset	347 * not empty, which is simply moved into the created object. It means that the list
ef9ef3bf4752 Progress on peer state machine Sebastien Decugis <sdecugis@nict.go.jp> parents: 12 diff changeset	348 * items must have been malloc'd, so that they can be freed.
ef9ef3bf4752 Progress on peer state machine Sebastien Decugis <sdecugis@nict.go.jp> parents: 12 diff changeset	349 *
ef9ef3bf4752 Progress on peer state machine Sebastien Decugis <sdecugis@nict.go.jp> parents: 12 diff changeset	350 * If cb is not null, the callback is called when the connection is in OPEN state or
11 6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	351 * when an error has occurred. The callback should use the pi_state information to
13 ef9ef3bf4752 Progress on peer state machine Sebastien Decugis <sdecugis@nict.go.jp> parents: 12 diff changeset	352 * determine which one it is. If the first parameter of the called callback is NULL, it
ef9ef3bf4752 Progress on peer state machine Sebastien Decugis <sdecugis@nict.go.jp> parents: 12 diff changeset	353 * means that the peer is being destroyed before attempt success / failure.
ef9ef3bf4752 Progress on peer state machine Sebastien Decugis <sdecugis@nict.go.jp> parents: 12 diff changeset	354 * cb is called to allow freeing cb_data in * this case.
ef9ef3bf4752 Progress on peer state machine Sebastien Decugis <sdecugis@nict.go.jp> parents: 12 diff changeset	355 *
ef9ef3bf4752 Progress on peer state machine Sebastien Decugis <sdecugis@nict.go.jp> parents: 12 diff changeset	356 * The orig_dbg string is only useful for easing debug, and can be left to NULL.
11 6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	357 *
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	358 * RETURN VALUE:
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	359 * 0 : The peer is added.
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	360 * EINVAL : A parameter is invalid.
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	361 * EEXIST : A peer with the same Diameter-Id is already in the list.
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	362 * (other standard errors may be returned, too, with their standard meaning. Example:
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	363 * ENOMEM : Memory allocation for the new object element failed.)
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	364 */
947 cce5d4bace82 Make config file parameter const and convert another fprintf to TRACE_DEBUG_ERROR. Thomas Klausner <tk@giga.or.at> parents: 904 diff changeset	365 int fd_peer_add ( struct peer_info * info, const char * orig_dbg, void (cb)(struct peer_info , void ), void cb_data );
11 6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	366
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	367 /*
86 e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	368 * FUNCTION: fd_peer_getbyid
e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	369 *
e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	370 * PARAMETERS:
706 4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	371 * diamid : an UTF8 string describing the diameter Id of the peer to seek
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	372 * diamidlen : length of the diamid
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	373 * igncase : perform an almost-case-insensitive search? (slower)
86 e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	374 * peer : The peer is stored here if it exists.
e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	375 *
e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	376 * DESCRIPTION:
e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	377 * Search a peer by its Diameter-Id.
e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	378 *
e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	379 * RETURN VALUE:
e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	380 * 0 : *peer has been updated (to NULL if the peer is not found).
e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	381 * !0 : An error occurred.
e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	382 */
706 4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	383 int fd_peer_getbyid( DiamId_t diamid, size_t diamidlen, int igncase, struct peer_hdr ** peer );
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	384
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	385 /*
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	386 * FUNCTION: fd_peer_get_state
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	387 *
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	388 * PARAMETERS:
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	389 * peer : The peer which state to read
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	390 *
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	391 * DESCRIPTION:
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	392 * Returns the current state of the peer.
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	393 *
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	394 * RETURN VALUE:
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	395 * -1 : peer is invalid
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	396 * >=0 : the state of the peer at the time of reading.
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	397 */
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	398 int fd_peer_get_state(struct peer_hdr *peer);
86 e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	399
939 1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	400 /*
1186 56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	401 * FUNCTION: fd_peer_cnx_proto_info
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	402 *
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	403 * PARAMETERS:
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	404 * peer : The peer which information to be read
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	405 * buf : Where to store the protocol information
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	406 * len : available space in bug
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	407 *
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	408 * DESCRIPTION:
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	409 * Creates a string describing the current connection to this peer, e.g.: "TCP,TLS,soc#3".
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	410 *
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	411 * RETURN VALUE:
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	412 * 0 : buffer was written
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	413 * >=0 : error code.
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	414 */
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	415 int fd_peer_cnx_proto_info(struct peer_hdr peer, char buf, size_t len);
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	416
56c36d1007b4 Further preparation of the DTLS integration. Some cleanups in the GNUTLS handling. Sebastien Decugis <sdecugis@freediameter.net> parents: 1180 diff changeset	417 /*
939 1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	418 * FUNCTION: fd_peer_get_load_pending
1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	419 *
1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	420 * PARAMETERS:
1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	421 * peer : The peer which load to read
1010 357c2f892d24 Implement a new counter on pending answers to send back to a peer. Sebastien Decugis <sdecugis@freediameter.net> parents: 1008 diff changeset	422 * to_receive : (out) number of requests sent to this peer without matching answer yet.
357c2f892d24 Implement a new counter on pending answers to send back to a peer. Sebastien Decugis <sdecugis@freediameter.net> parents: 1008 diff changeset	423 * to_send : (out) number of requests received from this peer and not yet answered.
939 1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	424 *
1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	425 * DESCRIPTION:
1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	426 * Returns the current number of requests sent to this peer
1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	427 * that have not been answered yet. This is an empirical indication
1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	428 * of the workload of this peer.
1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	429 *
1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	430 * RETURN VALUE:
1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	431 * 0 : The load parameter has been updated. (it should have a positive value always)
1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	432 * !0 : An error occurred
1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	433 */
1010 357c2f892d24 Implement a new counter on pending answers to send back to a peer. Sebastien Decugis <sdecugis@freediameter.net> parents: 1008 diff changeset	434 int fd_peer_get_load_pending(struct peer_hdr peer, long to_receive, long * to_send);
939 1bc052ef961f Add a function to access this counter Sebastien Decugis <sdecugis@freediameter.net> parents: 904 diff changeset	435
86 e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	436 /*
162 79768bf7d208 Completed whitelist extension Sebastien Decugis <sdecugis@nict.go.jp> parents: 142 diff changeset	437 * FUNCTION: fd_peer_validate_register
11 6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	438 *
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	439 * PARAMETERS:
972 ce3cacbbccc9 Fix some typos. Thomas Klausner <tk@giga.or.at> parents: 968 diff changeset	440 * peer_validate : Callback as defined below.
11 6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	441 *
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	442 * DESCRIPTION:
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	443 * Add a callback to authorize / reject incoming peer connections.
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	444 * All registered callbacks are called until a callback sets auth = -1 or auth = 1.
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	445 * If no callback returns a clear decision, the default behavior is applied (reject unknown connections)
33 e6fcdf12b9a0 Added a lot of TODOs :) Sebastien Decugis <sdecugis@nict.go.jp> parents: 25 diff changeset	446 * The callbacks are called in FILO order of their registration.
11 6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	447 *
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	448 * RETURN VALUE:
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	449 * 0 : The callback is added.
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	450 * !0 : An error occurred.
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	451 */
20 277ec00d793e Backup before typhoon... Progress on server side Sebastien Decugis <sdecugis@nict.go.jp> parents: 18 diff changeset	452 int fd_peer_validate_register ( int (peer_validate)(struct peer_info /* info /, int /* auth /, int (cb2)(struct peer_info )) );
11 6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	453 /*
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	454 * CALLBACK: peer_validate
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	455 *
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	456 * PARAMETERS:
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	457 * info : Structure containing information about the peer attempting the connection.
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	458 * auth : Store there the result if the peer is accepted (1), rejected (-1), or unknown (0).
20 277ec00d793e Backup before typhoon... Progress on server side Sebastien Decugis <sdecugis@nict.go.jp> parents: 18 diff changeset	459 * cb2 : If != NULL and in case of PI_SEC_TLS_OLD, another callback to call after handshake (if auth = 1).
11 6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	460 *
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	461 * DESCRIPTION:
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	462 * This callback is called when a new connection is being established from an unknown peer,
20 277ec00d793e Backup before typhoon... Progress on server side Sebastien Decugis <sdecugis@nict.go.jp> parents: 18 diff changeset	463 * after the CER is received. An extension must register such callback with peer_validate_register.
277ec00d793e Backup before typhoon... Progress on server side Sebastien Decugis <sdecugis@nict.go.jp> parents: 18 diff changeset	464 *
43 2db15632a63d Added a large part of connection establishment logic, to test Sebastien Decugis <sdecugis@nict.go.jp> parents: 42 diff changeset	465 * The callback can learn if the peer has sent Inband-Security-Id AVPs in runtime.pir_isi fields.
2db15632a63d Added a large part of connection establishment logic, to test Sebastien Decugis <sdecugis@nict.go.jp> parents: 42 diff changeset	466 * It can also learn if a handshake has already been performed in runtime.pir_cert_list field.
2db15632a63d Added a large part of connection establishment logic, to test Sebastien Decugis <sdecugis@nict.go.jp> parents: 42 diff changeset	467 * The callback must set the value of config.pic_flags.sec appropriately to allow a connection without TLS.
20 277ec00d793e Backup before typhoon... Progress on server side Sebastien Decugis <sdecugis@nict.go.jp> parents: 18 diff changeset	468 *
43 2db15632a63d Added a large part of connection establishment logic, to test Sebastien Decugis <sdecugis@nict.go.jp> parents: 42 diff changeset	469 * If the old TLS mechanism is used,
20 277ec00d793e Backup before typhoon... Progress on server side Sebastien Decugis <sdecugis@nict.go.jp> parents: 18 diff changeset	470 * the extension may also need to check the credentials provided during the TLS
277ec00d793e Backup before typhoon... Progress on server side Sebastien Decugis <sdecugis@nict.go.jp> parents: 18 diff changeset	471 * exchange (remote certificate). For this purpose, it may set the address of a new callback
277ec00d793e Backup before typhoon... Progress on server side Sebastien Decugis <sdecugis@nict.go.jp> parents: 18 diff changeset	472 * to be called once the handshake is completed. This new callback receives the information
43 2db15632a63d Added a large part of connection establishment logic, to test Sebastien Decugis <sdecugis@nict.go.jp> parents: 42 diff changeset	473 * structure as parameter (with pir_cert_list set) and returns 0 if the credentials are correct,
20 277ec00d793e Backup before typhoon... Progress on server side Sebastien Decugis <sdecugis@nict.go.jp> parents: 18 diff changeset	474 * or an error code otherwise. If the error code is received, the connection is closed and the
277ec00d793e Backup before typhoon... Progress on server side Sebastien Decugis <sdecugis@nict.go.jp> parents: 18 diff changeset	475 * peer is destroyed.
162 79768bf7d208 Completed whitelist extension Sebastien Decugis <sdecugis@nict.go.jp> parents: 142 diff changeset	476 * Note that freeDiameter already achieves some usual checks. The callback may be used to enforce
79768bf7d208 Completed whitelist extension Sebastien Decugis <sdecugis@nict.go.jp> parents: 142 diff changeset	477 * additional restrictions.
11 6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	478 *
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	479 * RETURN VALUE:
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	480 * 0 : The authorization decision has been written in the location pointed by auth.
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	481 * !0 : An error occurred.
6576ef5e01eb Added some support for peers Sebastien Decugis <sdecugis@nict.go.jp> parents: 10 diff changeset	482 */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	483
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	484
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	485
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	486 /============================================================/
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	487 /* MESSAGES */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	488 /============================================================/
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	489
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	490 /*
646 cfc8da9264f4 Prepared first part of the changes for #10 Sebastien Decugis <sdecugis@nict.go.jp> parents: 640 diff changeset	491 * FUNCTION: fd_msg_send, fd_msg_send_timeout
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	492 *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	493 * PARAMETERS:
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	494 * pmsg : Location of the message to be sent on the network (set to NULL on function return to avoid double deletion).
1014 908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	495 * anscb : A callback to be called when corresponding answer is received, when sending a request (not used with answers)
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	496 * anscb_data : opaque data to be passed back to the anscb (or expirecb) when it is called.
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	497 * expirecb : (only for fd_msg_send_timeout) If the request did not get an answer before timeout, this callback is called.
646 cfc8da9264f4 Prepared first part of the changes for #10 Sebastien Decugis <sdecugis@nict.go.jp> parents: 640 diff changeset	498 * timeout : (only for fd_msg_send_timeout) sets the absolute time until when to wait for an answer. Past this time,
1014 908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	499 * the expirecb is called with the request and the answer will be discarded if received later.
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	500 *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	501 * DESCRIPTION:
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	502 * Sends a message on the network. (actually simply queues it in a global queue, to be picked by a daemon's thread)
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	503 * For requests, the end-to-end id must be set (see fd_msg_get_eteid / MSGFL_ALLOC_ETEID).
1014 908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	504 * For answers, the message must be created with function fd_msg_new_answer_from_req.
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	505 *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	506 * The routing module will handle sending to the correct peer, usually based on the Destination-Realm / Destination-Host AVP.
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	507 *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	508 * If the msg is a request, there are two ways of receiving the answer:
93 3910804c84db Ported the app_test application Sebastien Decugis <sdecugis@nict.go.jp> parents: 89 diff changeset	509 * - either having registered a callback in the dispatch module (see fd_disp_register)
1014 908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	510 * - or provide a anscb callback here. If such callback is provided, it is called before the dispatch callbacks.
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	511 * The prototype for this anscb callback function is:
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	512 * void anscb(void * data, struct msg ** answer)
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	513 * where:
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	514 * data : opaque data that was registered along with the callback.
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	515 * answer : location of the pointer to the answer.
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	516 * note1: on function return, if *answer is not NULL, the message is passed to the dispatch module for regular callbacks.
336 5d1a22bb1cfe Removed some references to waaad Sebastien Decugis <sdecugis@nict.go.jp> parents: 258 diff changeset	517 * otherwise, the callback must take care of freeing the message (fd_msg_free).
5d1a22bb1cfe Removed some references to waaad Sebastien Decugis <sdecugis@nict.go.jp> parents: 258 diff changeset	518 * note2: the opaque data is not freed by the daemon in any case, extensions should ensure clean handling in fd_ext_fini.
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	519 *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	520 * If no callback is registered to handle an answer, the message is discarded and an error is logged.
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	521 *
1014 908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	522 * fd_msg_send_timeout is similar to fd_msg_send, except that it takes two additional arguments "expirecb" and "timeout".
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	523 * If the message parameter is an answer, there is no difference with fd_msg_send.
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	524 * Otherwise, if the corresponding answer (or error) is received before the timeout date elapses, everything occurs as with fd_msg_send.
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	525 * Otherwise, the request is removed from the queue (meaning the matching answer will be discarded upon reception) and passed to the expirecb
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	526 * function. Upon return, if the *msg parameter is not NULL, it is freed (not passed to other callbacks).
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	527 * expirecb is called in a dedicated thread.
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	528 *
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	529 * The prototype for the expirecb callback function is:
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	530 * void expirecb(void * data, struct peer_hdr * sentto, struct msg ** request)
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	531 * where:
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	532 * data : opaque data that was registered along with the callback.
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	533 * sentto : pointer to the peer to which the message was sent and no answer received within timeout.
908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	534 * request: location of the pointer to the request that was not answered.
646 cfc8da9264f4 Prepared first part of the changes for #10 Sebastien Decugis <sdecugis@nict.go.jp> parents: 640 diff changeset	535 *
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	536 * RETURN VALUE:
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	537 * 0 : The message has been queued for sending (sending may fail asynchronously).
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	538 * EINVAL : A parameter is invalid (ex: anscb provided but message is not a request).
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	539 * ...
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	540 */
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	541 int fd_msg_send ( struct msg ** pmsg, void (anscb)(void , struct msg *), void data );
1014 908ffbb81f60 Added a second callback in fd_msg_send_timeout to handle more easily the timeout situation Sebastien Decugis <sdecugis@freediameter.net> parents: 1010 diff changeset	542 int fd_msg_send_timeout ( struct msg ** pmsg, void (anscb)(void , struct msg *), void data, void (expirecb)(void , DiamId_t, size_t, struct msg *), const struct timespec timeout );
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	543
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	544 /*
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	545 * FUNCTION: fd_msg_rescode_set
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	546 *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	547 * PARAMETERS:
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	548 * msg : A msg object -- it must be an answer.
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	549 * rescode : The name of the returned error code (ex: "DIAMETER_INVALID_AVP")
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	550 * errormsg : (optional) human-readable error message to put in Error-Message AVP
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	551 * optavp : (optional) If provided, the content will be put inside a Failed-AVP
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	552 * type_id : 0 => nothing; 1 => adds Origin-Host and Origin-Realm with local info. 2=> adds Error-Reporting-Host.
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	553 *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	554 * DESCRIPTION:
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	555 * This function adds a Result-Code AVP to a message, and optionally
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	556 * - sets the 'E' error flag in the header,
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	557 * - adds Error-Message, Error-Reporting-Host and Failed-AVP AVPs.
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	558 *
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	559 * RETURN VALUE:
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	560 * 0 : Operation complete.
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	561 * !0 : an error occurred.
13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	562 */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	563 int fd_msg_rescode_set( struct msg * msg, char * rescode, char * errormsg, struct avp * optavp, int type_id );
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	564
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	565 /* Add Origin-Host, Origin-Realm, (if osi) Origin-State-Id AVPS at the end of the message */
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	566 int fd_msg_add_origin ( struct msg * msg, int osi );
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	567
706 4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	568 /* Generate a new Session-Id and add it at the beginning of the message (opt is added at the end of the sid if provided) */
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	569 int fd_msg_new_session( struct msg * msg, os0_t opt, size_t optlen );
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	570
4ffbc9f1e922 Large UNTESTED commit with the following changes: Sebastien Decugis <sdecugis@nict.go.jp> parents: 658 diff changeset	571
1103 d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	572 /* Parse a message against our dictionary,
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	573 return 0 in case of success.
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	574 log parsing error & return error code in case of failure in parsing.
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	575 In addition, if the error code is EBADMSG (the message does not follow our dictionary)
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	576 if msg was a request, msg is NULL and *error contains the error message ready to send back on return
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	577 if msg was an answer, msg is untouched and error==msg if msg was an error message, error is null otherwise */
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	578 int fd_msg_parse_or_error( struct msg msg, struct msg error );
0 13530e1f02e3 Initial files imported Sebastien Decugis <sdecugis@nict.go.jp> parents: diff changeset	579
7 e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	580
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	581
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	582
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	583 /============================================================/
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	584 /* DISPATCH */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	585 /============================================================/
7 e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	586
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	587 /*
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	588 * FUNCTION: fd_disp_app_support
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	589 *
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	590 * PARAMETERS:
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	591 * app : The dictionary object corresponding to the Application.
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	592 * vendor : (Optional) the dictionary object of a Vendor to claim support in Vendor-Specific-Application-Id
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	593 * auth : Support auth app part.
c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	594 * acct : Support acct app part.
7 e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	595 *
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	596 * DESCRIPTION:
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	597 * Registers an application to be advertized in CER/CEA exchanges.
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	598 * Messages with an application-id matching a registered value are passed to the dispatch module,
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	599 * while other messages are simply relayed or an error is returned (if local node does not relay)
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	600 *
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	601 * RETURN VALUE:
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	602 * 0 : The application support is registered.
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	603 * EINVAL : A parameter is invalid.
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	604 */
10 c5c99c73c2bf Added some extensions and functions in the daemon Sebastien Decugis <sdecugis@nict.go.jp> parents: 8 diff changeset	605 int fd_disp_app_support ( struct dict_object * app, struct dict_object * vendor, int auth, int acct );
7 e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	606
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	607 /* Note: if we want to support capabilities updates, we'll have to add possibility to remove an app as well... */
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	608
e5af94b04946 Added dispatch module and tests Sebastien Decugis <sdecugis@nict.go.jp> parents: 1 diff changeset	609
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	610 /============================================================/
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	611 /* ROUTING */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	612 /============================================================/
83 c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	613
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	614 /* This file contains the definitions of types and functions involved in the routing decisions in freeDiameter,
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	615 * and that can be called by extensions.
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	616 *
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	617 * Three different type of messages must be distinguished:
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	618 * - Messages received, and the peer is final recipient (IN messages)
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	619 * - Messages received, and the peer is not final recipient (FWD messages)
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	620 * - Message is locally generated (OUT messages)
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	621 *
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	622 * There are three global message queues (in queues.c) and also peers-specific queues (in struct fd_peer).
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	623 *
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	624 * (*) IN messages processing details:
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	625 * - the message is received from the remote peer, a FDEVP_CNX_MSG_RECV event is generated for the peer.
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	626 * - the PSM thread parses the buffer, does some verifications, handles non routable messages (fd_msg_is_routable)
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	627 * - routable messages are queued in the fd_g_incoming global queue.
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	628 * - a thread (routing-in) picks the message and takes the decision if it is handled locally or forwarded,
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	629 * based on local capabilities (registered by extensions with fd_disp_app_support).
83 c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	630 * - If the message is handled locally, it is queued in fd_g_local.
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	631 * - Another thread (dispatch.c) will handle this message and pass it to registered callbacks (see fd_disp_register in libfreeDiameter.h).
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	632 *
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	633 * (*) FWD messages details:
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	634 * - The process is the same as for IN messages, until the routing-in threads makes its decision that the message is not handled locally.
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	635 * - If the local peer does not relay message, an error DIAMETER_APPLICATION_UNSUPPORTED is returned.
972 ce3cacbbccc9 Fix some typos. Thomas Klausner <tk@giga.or.at> parents: 968 diff changeset	636 * - All callbacks registered with fd_rt_fwd_register are called for the message (see below).
83 c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	637 * - these callbacks will typically do proxying work. Note that adding the route-record is handled by the daemon.
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	638 * - Once all callbacks have been called, the message is queued in the global fd_g_outgoing queue.
972 ce3cacbbccc9 Fix some typos. Thomas Klausner <tk@giga.or.at> parents: 968 diff changeset	639 * - The remaining processing is the same as for OUT messages, as described below.
83 c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	640 *
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	641 * (*) OUT messages details:
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	642 * - The message are picked from fd_g_outgoing (they are queued there as result of forwarding process or call to fd_msg_send.)
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	643 * - The (routing-out) thread builds a list of possible destinations for the message, as follow:
83 c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	644 * - create a list of all known peers in the "OPEN" state.
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	645 * - remove from that list all peers that are in a Route-Record AVP of the message, to avoid routing loops.
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	646 * - remove also all peers that have previously replied an error message for this message.
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	647 * - If the list is empty, create an error UNABLE_TO_DELIVER (note: should we trig dynamic discovery here???) and reply.
83 c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	648 * - Otherwise, call all callbacks registered by function fd_rt_out_register, with the list of peers and the message.
972 ce3cacbbccc9 Fix some typos. Thomas Klausner <tk@giga.or.at> parents: 968 diff changeset	649 * - Order the resulting list of peers by score (see below), and sent the message to the peer with highest (positive) score.
83 c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	650 * - in case the peer is no longer in the "OPEN" state, send the message to the second peer in the list.
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	651 * - if no peer is in OPEN state anymore, restart the process of creating the list.
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	652 * - Once a peer has been selected, the message is queued into that peer's outgoing queue.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	653 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	654 * The following functions allow an extension to register or remove a callback as described above.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	655 */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	656
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	657 /******** Forwarding callbacks: for Proxy operations *********/
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	658
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	659 /* Handle to registered callback */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	660 struct fd_rt_fwd_hdl;
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	661
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	662 /* Message direction for the callback */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	663 enum fd_rt_fwd_dir {
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	664 RT_FWD_REQ = 1, /* The callback will be called on forwarded requests only */
86 e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	665 RT_FWD_ALL = 2, /* The callback will be called on all forwarded messages (requests and answers )*/
e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	666 RT_FWD_ANS = 3 /* The callback will be called on answers and errors only */
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	667 };
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	668
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	669 /*
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	670 * FUNCTION: fd_rt_fwd_register
83 c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	671 *
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	672 * PARAMETERS:
972 ce3cacbbccc9 Fix some typos. Thomas Klausner <tk@giga.or.at> parents: 968 diff changeset	673 * rt_fwd_cb : The callback function to register (see prototype below).
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	674 * cbdata : Pointer to pass to the callback when it is called. The data is opaque to the daemon.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	675 * dir : One of the RT_FWD_* directions defined above.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	676 * handler : On success, a handler to the registered callback is stored here.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	677 * This handler will be used to unregister the cb.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	678 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	679 * DESCRIPTION:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	680 * Register a new callback for forwarded messages. See explanations above.
86 e3e22d89e023 Started routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 85 diff changeset	681 * Note that there is no guaranteed order for the callbacks calls.
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	682 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	683 * RETURN VALUE:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	684 * 0 : The callback is registered.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	685 * EINVAL : A parameter is invalid.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	686 * ENOMEM : Not enough memory to complete the operation
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	687 */
620 bc7328e600f0 Removed the OUTPUT specification for SWIG, too complex Sebastien Decugis <sdecugis@nict.go.jp> parents: 618 diff changeset	688 int fd_rt_fwd_register ( int (rt_fwd_cb)(void cbdata, struct msg ** msg), void * cbdata, enum fd_rt_fwd_dir dir, struct fd_rt_fwd_hdl ** handler );
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	689 /*
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	690 * CALLBACK: rt_fwd_cb
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	691 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	692 * PARAMETERS:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	693 * data : pointer to some data that was passed when the callback was registered (optional).
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	694 * msg : The message that is being forwarded.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	695 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	696 * DESCRIPTION:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	697 * This callback is called when a message is forwarded to another peer. It may for example add a Proxy-Info AVP.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	698 * The callback may also choose to handle the message in a more complex form. In that case, it must set *msg = NULL
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	699 * and handle it differently. In such case, the forwarding thread will stop processing this message.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	700 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	701 * RETURN VALUE:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	702 * 0 : Operation complete.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	703 * !0 : An error occurred -- will result in daemon's termination.
83 c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	704 */
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	705
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	706 /*
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	707 * FUNCTION: fd_rt_fwd_unregister
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	708 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	709 * PARAMETERS:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	710 * handler : The handler of the callback that must be unregistered.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	711 * cbdata : Will receive the data registered with the callback, that can be freed if needed.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	712 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	713 * DESCRIPTION:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	714 * Removes a callback from the list of registered callbacks.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	715 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	716 * RETURN VALUE:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	717 * 0 : The callback is unregistered.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	718 * EINVAL : A parameter is invalid.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	719 */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	720 int fd_rt_fwd_unregister ( struct fd_rt_fwd_hdl * handler, void ** cbdata );
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	721
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	722
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	723 /******** Out callbacks: for next hop routing decision operations *********/
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	724
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	725 /* Handle to registered callback */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	726 struct fd_rt_out_hdl;
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	727
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	728 enum fd_rt_out_score {
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	729 FD_SCORE_NO_DELIVERY = -70, /* We should not send this message to this candidate */
717 571b3abaa5df Support for Diameter Redirects through rt_redirect.fdx extension (EXPERIMENTAL) Sebastien Decugis <sdecugis@nict.go.jp> parents: 706 diff changeset	730 FD_SCORE_SENT_REDIRECT = -60, /* If this peer previously sent a Redirect indication that applies to this message */
124 cc42d8607114 Completed cleanups of queues when the daemon is stopping Sebastien Decugis <sdecugis@nict.go.jp> parents: 105 diff changeset	731 FD_SCORE_INI = -2, /* All candidates are initialized with this value */
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	732 FD_SCORE_LOAD_BALANCE = 1, /* Use this to differentiate between several peers with the same score */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	733 FD_SCORE_DEFAULT = 5, /* The peer is a default route for all messages */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	734 FD_SCORE_DEFAULT_REALM = 10, /* The peer is a default route for this realm */
89 3f8b437bcb66 Added some default routing handlers Sebastien Decugis <sdecugis@nict.go.jp> parents: 87 diff changeset	735 FD_SCORE_REALM = 15, /* The peer belongs to Destination-Realm of the message */
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	736 FD_SCORE_REDIR_HOST = 25, /* If there is a redirect rule with ALL_HOST for these message and peer */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	737 FD_SCORE_REDIR_APP = 30, /* If there is a redirect rule with ALL_APPLICATION for these message and peer */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	738 FD_SCORE_REDIR_REALM = 35, /* If there is a redirect rule with ALL_REALM for these message and peer */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	739 FD_SCORE_REDIR_REALM_APP = 40, /* If there is a redirect rule with REALM_AND_APPLICATION for these message and peer */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	740 FD_SCORE_REDIR_USER = 45, /* If there is a redirect rule with ALL_USER for these message and peer */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	741 FD_SCORE_REDIR_SESSION = 50, /* If there is a redirect rule with ALL_SESSION for these message and peer */
717 571b3abaa5df Support for Diameter Redirects through rt_redirect.fdx extension (EXPERIMENTAL) Sebastien Decugis <sdecugis@nict.go.jp> parents: 706 diff changeset	742 FD_SCORE_REDIR_ONCE = 55, /* If there is a redirect rule with DONT_CACHE for these message and peer */
89 3f8b437bcb66 Added some default routing handlers Sebastien Decugis <sdecugis@nict.go.jp> parents: 87 diff changeset	743 FD_SCORE_FINALDEST = 100 /* If the peer is the final recipient of the message (i.e. matching Destination-Host), it receives a big score. */
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	744 };
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	745
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	746 /*
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	747 * FUNCTION: fd_rt_out_register
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	748 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	749 * PARAMETERS:
972 ce3cacbbccc9 Fix some typos. Thomas Klausner <tk@giga.or.at> parents: 968 diff changeset	750 * rt_out_cb : The callback function to register (see prototype below).
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	751 * cbdata : Pointer to pass to the callback when it is called. The data is opaque to the daemon.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	752 * priority : Order for calling this callback. The callbacks are called in reverse priority order (higher priority = called sooner).
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	753 * handler : On success, a handler to the registered callback is stored here.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	754 * This handler will be used to unregister the cb.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	755 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	756 * DESCRIPTION:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	757 * Register a new callback to handle OUT routing decisions. See explanations above.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	758 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	759 * RETURN VALUE:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	760 * 0 : The callback is registered.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	761 * EINVAL : A parameter is invalid.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	762 * ENOMEM : Not enough memory to complete the operation
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	763 */
620 bc7328e600f0 Removed the OUTPUT specification for SWIG, too complex Sebastien Decugis <sdecugis@nict.go.jp> parents: 618 diff changeset	764 int fd_rt_out_register ( int (rt_out_cb)(void cbdata, struct msg * msg, struct fd_list * candidates), void * cbdata, int priority, struct fd_rt_out_hdl ** handler );
85 e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	765 /*
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	766 * CALLBACK: rt_out_cb
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	767 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	768 * PARAMETERS:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	769 * cbdata : pointer to some data that was registered with the callback.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	770 * msg : The message that must be sent.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	771 * list : The list of peers to which the message may be sent to, as returned by fd_rtd_candidate_extract
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	772 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	773 * DESCRIPTION:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	774 * This callback must attribute a score (preferably from FD_SCORE_*) to each candidate peer in the list.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	775 * Once all registered callbacks have been called, the message is sent to the candidate with the highest score.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	776 * Note that each callback must add its locally-attributed score to the candidate current "score" parameter, not replace it!
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	777 * Note also that this callback must be re-entrant since it may be called by several threads at the same time
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	778 * (for different messages)
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	779 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	780 * RETURN VALUE:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	781 * 0 : Operation complete.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	782 * !0 : An error occurred.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	783 */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	784
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	785 /*
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	786 * FUNCTION: fd_rt_out_unregister
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	787 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	788 * PARAMETERS:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	789 * handler : The handler of the callback that must be unregistered.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	790 * cbdata : Will receive the data registered with the callback, that can be freed if needed.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	791 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	792 * DESCRIPTION:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	793 * Removes a callback from the list of registered callbacks.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	794 *
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	795 * RETURN VALUE:
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	796 * 0 : The callback is unregistered.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	797 * EINVAL : A parameter is invalid.
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	798 */
e5fcd672caff Added new function to retrieve messages sessions easily Sebastien Decugis <sdecugis@nict.go.jp> parents: 83 diff changeset	799 int fd_rt_out_unregister ( struct fd_rt_out_hdl * handler, void ** cbdata );
83 c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	800
c662d3eb6ff6 Started support for routing module Sebastien Decugis <sdecugis@nict.go.jp> parents: 82 diff changeset	801
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	802 /============================================================/
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	803 /* EVENTS */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	804 /============================================================/
82 b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	805
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	806 struct fd_event {
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	807 int code; /* codespace depends on the queue */
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	808 size_t size;
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	809 void *data;
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	810 };
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	811
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	812 /* Daemon's codespace: 1000->1999 (1500->1999 defined in fdcore-internal.h) */
82 b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	813 enum {
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	814 FDEV_TERMINATE = 1000 /* request to terminate */
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	815 ,FDEV_TRIGGER /* Trigger available for extensions. size is sizeof(int), data is int * */
82 b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	816 };
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	817
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	818 int fd_event_send(struct fifo queue, int code, size_t datasz, void data);
620 bc7328e600f0 Removed the OUTPUT specification for SWIG, too complex Sebastien Decugis <sdecugis@nict.go.jp> parents: 618 diff changeset	819 int fd_event_get(struct fifo queue, int code, size_t * datasz, void ** data);
bc7328e600f0 Removed the OUTPUT specification for SWIG, too complex Sebastien Decugis <sdecugis@nict.go.jp> parents: 618 diff changeset	820 int fd_event_timedget(struct fifo queue, struct timespec timeout, int timeoutcode, int * code, size_t * datasz, void ** data);
82 b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	821 void fd_event_destroy(struct fifo *queue, void (free_cb)(void * data));
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	822 const char * fd_ev_str(int event);
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	823
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	824 /* for extensions */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	825 int fd_event_trig_regcb(int trigger_val, const char * module, void (*cb)(void));
1085 7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	826
1088 1d1a20a0779d Second part of changeset 1083, now the code compiles again. Still missing some functions implementation, though Sebastien Decugis <sdecugis@freediameter.net> parents: 1085 diff changeset	827 #ifndef SWIG
1085 7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	828 DECLARE_FD_DUMP_PROTOTYPE(fd_event_trig_dump);
628 e1c6f45f5fcd Improvements to usability, still work ongoing Sebastien Decugis <sdecugis@nict.go.jp> parents: 621 diff changeset	829
1085 7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	830 /* The "old" FD_EV_DUMP_* events are replaced with direct calls to the following dump functions */
7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	831 DECLARE_FD_DUMP_PROTOTYPE(fd_conf_dump);
1169 11724ff78638 Some cleanups in dbg_interactive extension Sebastien Decugis <sdecugis@freediameter.net> parents: 1164 diff changeset	832 #else /* SWIG */
11724ff78638 Some cleanups in dbg_interactive extension Sebastien Decugis <sdecugis@freediameter.net> parents: 1164 diff changeset	833 DECLARE_FD_DUMP_PROTOTYPE_simple(fd_event_trig_dump);
11724ff78638 Some cleanups in dbg_interactive extension Sebastien Decugis <sdecugis@freediameter.net> parents: 1164 diff changeset	834 DECLARE_FD_DUMP_PROTOTYPE_simple(fd_conf_dump);
11724ff78638 Some cleanups in dbg_interactive extension Sebastien Decugis <sdecugis@freediameter.net> parents: 1164 diff changeset	835 #endif /* SWIG */
1120 c473581adff2 Cleanup some traces Sebastien Decugis <sdecugis@freediameter.net> parents: 1113 diff changeset	836 DECLARE_FD_DUMP_PROTOTYPE(fd_ext_dump, int indent_next);
1113 eb4ce68b6e5c Added calls to remaining hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1103 diff changeset	837 DECLARE_FD_DUMP_PROTOTYPE(fd_servers_dump, int details);
1085 7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	838 DECLARE_FD_DUMP_PROTOTYPE(fd_peer_dump_list, int details);
7d7266115a34 Cleaning of the traces in progress Sebastien Decugis <sdecugis@freediameter.net> parents: 1077 diff changeset	839 DECLARE_FD_DUMP_PROTOTYPE(fd_peer_dump, struct peer_hdr * p, int details);
628 e1c6f45f5fcd Improvements to usability, still work ongoing Sebastien Decugis <sdecugis@nict.go.jp> parents: 621 diff changeset	840
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	841 /============================================================/
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	842 /* ENDPOINTS */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	843 /============================================================/
24 bd83ce9328ed Cleanups and completed sctp code (not finished) Sebastien Decugis <sdecugis@nict.go.jp> parents: 23 diff changeset	844
82 b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	845 struct fd_endpoint {
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	846 struct fd_list chain; /* link in cnf_endpoints list */
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	847
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	848 union {
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	849 sSS ss; /* the socket information. List is always ordered by ss value (memcmp) -- see fd_ep_add_merge */
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	850 sSA4 sin;
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	851 sSA6 sin6;
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	852 sSA sa;
621 04dbea46c7a2 Cleanup many SWIG definitions from main .h files Sebastien Decugis <sdecugis@nict.go.jp> parents: 620 diff changeset	853 }
04dbea46c7a2 Cleanup many SWIG definitions from main .h files Sebastien Decugis <sdecugis@nict.go.jp> parents: 620 diff changeset	854 #ifdef SWIG /* nested anonymous unions are not supported yet */
04dbea46c7a2 Cleanup many SWIG definitions from main .h files Sebastien Decugis <sdecugis@nict.go.jp> parents: 620 diff changeset	855 s
04dbea46c7a2 Cleanup many SWIG definitions from main .h files Sebastien Decugis <sdecugis@nict.go.jp> parents: 620 diff changeset	856 #endif /* SWIG */
04dbea46c7a2 Cleanup many SWIG definitions from main .h files Sebastien Decugis <sdecugis@nict.go.jp> parents: 620 diff changeset	857 ;
82 b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	858
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	859 #define EP_FL_CONF (1 << 0) /* This endpoint is statically configured in a configuration file */
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	860 #define EP_FL_DISC (1 << 1) /* This endpoint was resolved from the Diameter Identity or other DNS query */
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	861 #define EP_FL_ADV (1 << 2) /* This endpoint was advertized in Diameter CER/CEA exchange */
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	862 #define EP_FL_LL (1 << 3) /* Lower layer mechanism provided this endpoint */
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	863 #define EP_FL_PRIMARY (1 << 4) /* This endpoint is primary in a multihomed SCTP association */
140 34e47f4addf8 Fix broken test Sebastien Decugis <sdecugis@nict.go.jp> parents: 124 diff changeset	864 #define EP_ACCEPTALL (1 << 15) /* This flag allows bypassing the address filter in fd_ep_add_merge. */
82 b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	865 uint32_t flags; /* Additional information about the endpoint */
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	866
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	867 /* To add: a validity timestamp for DNS records ? How do we retrieve this lifetime from DNS ? */
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	868 };
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	869
24 bd83ce9328ed Cleanups and completed sctp code (not finished) Sebastien Decugis <sdecugis@nict.go.jp> parents: 23 diff changeset	870 int fd_ep_add_merge( struct fd_list * list, sSA * sa, socklen_t sl, uint32_t flags );
bd83ce9328ed Cleanups and completed sctp code (not finished) Sebastien Decugis <sdecugis@nict.go.jp> parents: 23 diff changeset	871 int fd_ep_filter( struct fd_list * list, uint32_t flags );
38 68c1890f7049 Fixed a small bug in SCTP close Sebastien Decugis <sdecugis@nict.go.jp> parents: 37 diff changeset	872 int fd_ep_filter_family( struct fd_list * list, int af );
24 bd83ce9328ed Cleanups and completed sctp code (not finished) Sebastien Decugis <sdecugis@nict.go.jp> parents: 23 diff changeset	873 int fd_ep_clearflags( struct fd_list * list, uint32_t flags );
1113 eb4ce68b6e5c Added calls to remaining hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1103 diff changeset	874 DECLARE_FD_DUMP_PROTOTYPE(fd_ep_dump_one, int preamble, struct fd_endpoint * ep );
eb4ce68b6e5c Added calls to remaining hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1103 diff changeset	875 DECLARE_FD_DUMP_PROTOTYPE(fd_ep_dump, int preamble, int indent, struct fd_list * eps );
24 bd83ce9328ed Cleanups and completed sctp code (not finished) Sebastien Decugis <sdecugis@nict.go.jp> parents: 23 diff changeset	876
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	877
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	878 /============================================================/
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	879 /* APPLICATIONS IDs */
f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	880 /============================================================/
43 2db15632a63d Added a large part of connection establishment logic, to test Sebastien Decugis <sdecugis@nict.go.jp> parents: 42 diff changeset	881
82 b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	882 struct fd_app {
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	883 struct fd_list chain; /* link in cnf_apps list. List ordered by appid. */
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	884 struct {
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	885 unsigned auth : 1;
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	886 unsigned acct : 1;
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	887 } flags;
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	888 vendor_id_t vndid; /* if not 0, Vendor-Specific-App-Id AVP will be used */
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	889 application_id_t appid; /* The identifier of the application */
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	890 };
b6344f1d521a Some cleanups Sebastien Decugis <sdecugis@nict.go.jp> parents: 78 diff changeset	891
43 2db15632a63d Added a large part of connection establishment logic, to test Sebastien Decugis <sdecugis@nict.go.jp> parents: 42 diff changeset	892 int fd_app_merge(struct fd_list * list, application_id_t aid, vendor_id_t vid, int auth, int acct);
87 c1c0f8a45c67 Backup Sebastien Decugis <sdecugis@nict.go.jp> parents: 86 diff changeset	893 int fd_app_check(struct fd_list * list, application_id_t aid, struct fd_app **detail);
620 bc7328e600f0 Removed the OUTPUT specification for SWIG, too complex Sebastien Decugis <sdecugis@nict.go.jp> parents: 618 diff changeset	894 int fd_app_check_common(struct fd_list * list1, struct fd_list * list2, int * common_found);
447 097bae83b07a Forgot to cleanup the configuration on exit, spotted by valgrind Sebastien Decugis <sdecugis@nict.go.jp> parents: 403 diff changeset	895 int fd_app_empty(struct fd_list * list);
43 2db15632a63d Added a large part of connection establishment logic, to test Sebastien Decugis <sdecugis@nict.go.jp> parents: 42 diff changeset	896
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	897
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	898
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	899 /============================================================/
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	900 /* MONITORING */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	901 /============================================================/
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	902
1077 b36c81e52e9a Add empty code for hooks so that dbg_interactive extension can load Sebastien Decugis <sdecugis@freediameter.net> parents: 1071 diff changeset	903 /* These functions allow an extension to collect state information about the
b36c81e52e9a Add empty code for hooks so that dbg_interactive extension can load Sebastien Decugis <sdecugis@freediameter.net> parents: 1071 diff changeset	904 * framework, as well as being hooked at some key checkpoints in the processing
1098 f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	905 * for logging or statistics purpose.
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	906 */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	907
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	908
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	909 /* CALLBACK: fd_hook_cb
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	910 *
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	911 * PARAMETERS:
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	912 * type : The type of hook that triggered this call, in case same cb is registered for several hooks.
1098 f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	913 * msg : If relevant, the pointer to the message triggering the call. NULL otherwise.
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	914 * peer : If relevant, the pointer to the peer associated with the call. NULL otherwise.
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	915 * other : For some callbacks, the remaining information is passed in this parameter. See each hook detail.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	916 * permsgdata : Structure associated with a given message, across several hooks.
1098 f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	917 * A different structure is associated with requests and corresponding answers.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	918 * See fd_hook_data_hdl below for details.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	919 * If no fd_hook_data_hdl is registered with this callback, this parameter is always NULL
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	920 * regdata : Data pointer stored at registration, opaque for the framework.
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	921 *
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	922 * DESCRIPTION:
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	923 * When such callback is registered with fd_hook_register function, it will be called on matching events with
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	924 * the parameters as described in the list of fd_hook_type below. One can use this mechanism for e.g.:
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	925 * - log completely the messages for safety / backup
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	926 * - create statistics information on the throughput
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	927 * - ...
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	928 *
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	929 * IMPORTANT: the callback MUST NOT change the memory pointed by the different parameters (peer, message, ...)
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	930 *
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	931 * RETURN VALUE:
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	932 * none.
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	933 */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	934
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	935 /* The available hooks in the framework */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	936 enum fd_hook_type {
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	937
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	938 HOOK_DATA_RECEIVED = 0,
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	939 /* Hook called as soon as a message has been received from the network, after TLS & boundary processing.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	940 - {msg} is NULL.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	941 - {peer} is NULL.
1102 1d7b3ebda27f Implemented the calls to HOOK_DATA_RECEIVED hook Sebastien Decugis <sdecugis@freediameter.net> parents: 1101 diff changeset	942 - {other} is a pointer to a struct fd_cnx_rcvdata containing the received buffer.
1098 f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	943 - {permsgdata} points to either a new empty structure allocated for this message (cf. fd_hook_data_hdl), or NULL if no hdl is registered.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	944 */
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	945
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	946 HOOK_MESSAGE_RECEIVED,
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	947 /* Hook called when a message has been received and the structure has been parsed successfully (list of AVPs).
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	948 - {msg} points to the parsed message. At this time, the objects have not been dictionary resolved. If you
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	949 try to call fd_msg_parse_dict, it will slow down the operation of a relay agent.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	950 - {peer} is set if the message is received from a peer's connection, and NULL if the message is from a new client
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	951 connected and not yet identified
1103 d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	952 - {other} is NULL, or a char * identifying the connection when {peer} is null.
1098 f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	953 - {permsgdata} points to either a new empty structure allocated for this message or the one passed to HOOK_DATA_RECEIVED if used.
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	954 */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	955
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	956 HOOK_MESSAGE_LOCAL,
1113 eb4ce68b6e5c Added calls to remaining hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1103 diff changeset	957 /* Hook called when a request message has been created locally by an extension and is being sent.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	958 - {msg} points to the message.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	959 - {peer} is NULL
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	960 - {other} is NULL
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	961 - {permsgdata} points to a new empty structure allocated for this request (cf. fd_hook_data_hdl)
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	962 */
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	963
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	964 HOOK_MESSAGE_SENT,
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	965 /* Hook called when a message has been sent to a peer. The message might be freed as soon as the hook function returns,
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	966 so it is not safe to store the pointer for asynchronous processing.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	967 - {msg} points to the sent message. Again, the objects may not have been dictionary resolved. If you
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	968 try to call fd_msg_parse_dict, it will slow down the operation of a relay agent.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	969 - {peer} is set if the message is sent to a peer's connection, and NULL if the message is sent to a new client
1098 f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	970 connected and not yet identified, or being rejected
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	971 - {other} is NULL.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	972 - {permsgdata} points to existing structure if any, or a new structure otherwise.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	973 */
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	974
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	975 HOOK_MESSAGE_FAILOVER,
1099 6ce5c99a40af Fix some typos. Thomas Klausner <tk@giga.or.at> parents: 1088 diff changeset	976 /* Hook called when a message that was sent to a peer is being requeued, because e.g. the connection was torn down.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	977 In that case the message will go again through the routing process.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	978 - {msg} points to the corresponding request message (the answer is discarded). Again, the objects may not have been dictionary resolved. If you
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	979 try to call fd_msg_parse_dict, it might slow down the operation of a relay agent, although this hook is not on the normal execution path.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	980 - {peer} is the peer this message was previously sent to.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	981 - {other} is NULL.
1098 f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	982 - {permsgdata} points to existing structure if any, or a new structure otherwise.
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	983 */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	984
1103 d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	985 HOOK_MESSAGE_PARSING_ERROR,
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	986 /* Hook called when a message being processed cannot be parsed successfully.
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	987 - {msg} points to the message if buffer was parsed successfully, or NULL otherwise. You should not call fd_msg_parse_dict on this in any case.
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	988 - {peer} is NULL or the peer that received the message. If NULL and the message is not NULL, you can still retrieve the source from the message itself.
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	989 - {other} is a char * pointer to the error message (human-readable) if {msg} is not NULL, a pointer to struct fd_cnx_rcvdata containing the received buffer otherwise.
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	990 - {permsgdata} points to existing structure associated with this message (or new structure if no previous hook was registered).
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	991 */
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	992
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	993 HOOK_MESSAGE_ROUTING_ERROR,
1103 d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	994 /* Hook called when a message being processed by the routing thread meets an error such as no remaining available peer for sending, based on routing callbacks decisions (maybe after retries).
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	995 - {msg} points to the message. Again, the objects may not have been dictionary resolved. If you
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	996 try to call fd_msg_parse_dict, it might slow down the operation of a relay agent, although this hook is not on the normal execution path.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	997 - {peer} is NULL.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	998 - {other} is a char * pointer to the error message (human-readable).
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	999 - {permsgdata} points to existing structure associated with this message (or new structure if no previous hook was registered).
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1000 */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1001
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1002 HOOK_MESSAGE_ROUTING_FORWARD,
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1003 /* Hook called when a received message is deemed to be not handled locally by the routing_dispatch process.
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1004 The decision of knowing which peer it will be sent to is not made yet (or if an error will be returned).
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1005 The hook is trigged before the callbacks registered with fd_rt_fwd_register are called.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1006 - {msg} points to the message. Again, the objects may not have been dictionary resolved.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1007 If you try to call fd_msg_parse_dict, it will slow down the operation of a relay agent.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1008 - {peer} is NULL.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1009 - {other} is NULL.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1010 - {permsgdata} points to existing structure associated with this message (or new structure if no previous hook was registered).
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1011 */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1012
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1013 HOOK_MESSAGE_ROUTING_LOCAL,
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1014 /* Hook called when a received message is handled locally by the routing_dispatch process (i.e., not forwarded).
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1015 The hook is trigged before the callbacks registered with fd_disp_register are called.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1016 - {msg} points to the message. Here, the message has been already parsed completely & successfully.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1017 - {peer} is NULL.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1018 - {other} is NULL.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1019 - {permsgdata} points to existing structure associated with this message (or new structure if no previous hook was registered).
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1020 */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1021
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1022 HOOK_MESSAGE_DROPPED,
1098 f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1023 /* Hook called when a message is being discarded by the framework because of some error condition (normal or abnormal).
f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1024 It is probably a good idea to log this for analysis / backup.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1025 - {msg} points to the message, which will be freed as soon as the hook returns.
1103 d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	1026 - {peer} may be NULL or a peer related to the event.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1027 - {other} is a char * pointer to the error message (human-readable).
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1028 - {permsgdata} points to existing structure associated with this message (or new structure if no previous hook was registered).
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1029 */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1030
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1031 HOOK_PEER_CONNECT_FAILED,
1103 d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	1032 /* Hook called when a connection attempt to/from a remote peer has failed. This hook is also called when the peer was in OPEN state and the connection is broken.
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	1033 - {msg} may be NULL (lower layer error, e.g. connection timeout) or points to a message showing the error (either invalid incoming message, or the CEA message sent or received with an error code).
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1034 - {peer} may be NULL for incoming requests from unknown peers being rejected, otherwise it points to the peer structure associated with the attempt.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1035 - {other} is a char * pointer to the error message (human-readable).
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1036 - {permsgdata} is always NULL for this hook.
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1037 */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1038
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1039 HOOK_PEER_CONNECT_SUCCESS,
1103 d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	1040 /* Hook called when a connection attempt to/from a remote peer has succeeded (the peer moves to OPEN_HANDSHAKE or OPEN state).
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	1041 In case of deprecated TLS handshake after the CER/CEA exchange, this hook can still be followed by HOOK_PEER_CONNECT_FAILED if TLS handshake fails.
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	1042 - {msg} points to the CEA message sent or received (with a success code) -- in case it is sent, you can always get access to the matching CER.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1043 - {peer} points to the peer structure.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1044 - {other} is NULL.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1045 - {permsgdata} is always NULL for this hook.
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1046 */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1047
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1048 #define HOOK_PEER_LAST HOOK_PEER_CONNECT_SUCCESS
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1049 };
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1050
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1051
1099 6ce5c99a40af Fix some typos. Thomas Klausner <tk@giga.or.at> parents: 1088 diff changeset	1052 /* Type of the {permsgdata} pointer. It is up to each extension to define its own structure. This is opaque for the framework. */
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1053 struct fd_hook_permsgdata;
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1054
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1055 /* A handle that will be associated with the extension, and with the permsgdata structures. */
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1056 struct fd_hook_data_hdl;
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1057
1102 1d7b3ebda27f Implemented the calls to HOOK_DATA_RECEIVED hook Sebastien Decugis <sdecugis@freediameter.net> parents: 1101 diff changeset	1058 /* The following structure is what is passed to the HOOK_DATA_RECEIVED hook */
1d7b3ebda27f Implemented the calls to HOOK_DATA_RECEIVED hook Sebastien Decugis <sdecugis@freediameter.net> parents: 1101 diff changeset	1059 struct fd_cnx_rcvdata {
1d7b3ebda27f Implemented the calls to HOOK_DATA_RECEIVED hook Sebastien Decugis <sdecugis@freediameter.net> parents: 1101 diff changeset	1060 size_t length;
1d7b3ebda27f Implemented the calls to HOOK_DATA_RECEIVED hook Sebastien Decugis <sdecugis@freediameter.net> parents: 1101 diff changeset	1061 uint8_t * buffer; /* internal note: the buffer is padded with a struct fd_msg_pmdl, not accounted for in length */
1d7b3ebda27f Implemented the calls to HOOK_DATA_RECEIVED hook Sebastien Decugis <sdecugis@freediameter.net> parents: 1101 diff changeset	1062 };
1d7b3ebda27f Implemented the calls to HOOK_DATA_RECEIVED hook Sebastien Decugis <sdecugis@freediameter.net> parents: 1101 diff changeset	1063
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1064 /* Function to register a new fd_hook_data_hdl. Should be called by your extension init function.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1065 * The arguments are the functions called to initialize a new fd_hook_permsgdata and to free this structure when the corresponding message is being freed.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1066 */
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1067 /*
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1068 * FUNCTION: fd_hook_data_register
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1069 *
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1070 * PARAMETERS:
1098 f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1071 * permsgdata_size : the size of the fd_hook_permsgdata structure.
f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1072 * permsgdata_init_cb : function called to initialize a new fd_hook_permsgdata structure, when a hook will be called for a message that does not have such structure yet.
f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1073 * The memory is already allocated and blanked, so you can pass NULL if no further handling is required.
f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1074 * permsgdata_fini_cb : function called when a message is being disposed. It should free the resources associated with the fd_hook_permsgdata.
f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1075 * You can pass NULL if no special handling is required. The memory of the permsgdata structure itself will be freed by the framework.
f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1076 * new_handle : On success, a handler to the registered callback is stored here.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1077 * This handler will be used to unregister the cb.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1078 *
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1079 * DESCRIPTION:
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1080 * Register a new fd_hook_data_hdl. This handle is used during hooks registration (see below) in order to associate data with the messages, to allow keeping tracking of the message easily.
1098 f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1081 * Note that these handlers are statically allocated and cannot be unregistered. FD_HOOK_HANDLE_LIMIT handlers can be registered at maximum (recompile libfdproto if you change this value)
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1082 *
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1083 * RETURN VALUE:
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1084 * 0 : The callback is registered.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1085 * EINVAL : A parameter is invalid.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1086 * ENOSPC : Too many handles already registered. You may need to increase the limit in the code.
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1087 */
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1088 int fd_hook_data_register(
1098 f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1089 size_t permsgdata_size,
f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1090 void (permsgdata_init_cb) (struct fd_hook_permsgdata ),
f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1091 void (permsgdata_fini_cb) (struct fd_hook_permsgdata ),
f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1092 struct fd_hook_data_hdl **new_handle
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1093 );
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1094
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1095 /* A handler associated with a registered hook callback (for cleanup) */
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1096 struct fd_hook_hdl;
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1097
1128 7c5449ddc434 New macro HOOK_MASK to ease call of the fd_hook_register function Sebastien Decugis <sdecugis@freediameter.net> parents: 1127 diff changeset	1098 /* Helper for building a mask of hooks for registration */
7c5449ddc434 New macro HOOK_MASK to ease call of the fd_hook_register function Sebastien Decugis <sdecugis@freediameter.net> parents: 1127 diff changeset	1099 #define HOOK_MASK(hooklist...) fd_hook_mask_helper(0, ## hooklist, -1)
7c5449ddc434 New macro HOOK_MASK to ease call of the fd_hook_register function Sebastien Decugis <sdecugis@freediameter.net> parents: 1127 diff changeset	1100
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1101 /*
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1102 * FUNCTION: fd_hook_register
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1103 *
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1104 * PARAMETERS:
1128 7c5449ddc434 New macro HOOK_MASK to ease call of the fd_hook_register function Sebastien Decugis <sdecugis@freediameter.net> parents: 1127 diff changeset	1105 * type_mask : A bitmask of fd_hook_type bits for which this cb is registered, e.g. HOOK_MASK( HOOK_MESSAGE_RECEIVED, HOOK_MESSAGE_SENT )
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1106 * fd_hook_cb : The callback function to register (see prototype above).
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1107 * regdata : Pointer to pass to the callback when it is called. The data is opaque to the daemon.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1108 * data_hdl : If permsgdata is requested for the hooks, a handler registered with fd_hook_data_register. NULL otherwise.
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1109 * handler : On success, a handler to the registered callback is stored here.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1110 * This handler can be used to unregister the cb.
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1111 *
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1112 * DESCRIPTION:
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1113 * Register a new hook in the framework. See explanations above.
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1114 *
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1115 * RETURN VALUE:
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1116 * 0 : The callback is registered.
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1117 * EEXIST : Another callback is already registered for this type of hook (HOOK_DATA_RECEIVED).
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1118 * EINVAL : A parameter is invalid.
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1119 * ENOMEM : Not enough memory to complete the operation
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1120 */
1098 f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1121 int fd_hook_register ( uint32_t type_mask,
f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1122 void (fd_hook_cb)(enum fd_hook_type type, struct msg msg, struct peer_hdr * peer, void * other, struct fd_hook_permsgdata pmd, void regdata),
f38d77f9cfd3 Initial implementation of the hook mechanism Sebastien Decugis <sdecugis@freediameter.net> parents: 1088 diff changeset	1123 void *regdata,
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1124 struct fd_hook_data_hdl *data_hdl,
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1125 struct fd_hook_hdl ** handler );
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1126
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1127 /* Remove a hook registration */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1128 int fd_hook_unregister( struct fd_hook_hdl * handler );
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1129
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1130
1103 d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	1131 /* Use the following function to retrieve any pmd structure associated with a request matching the current answer. Returns NULL in case of error / no such structure */
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	1132 struct fd_hook_permsgdata * fd_hook_get_request_pmd(struct fd_hook_data_hdl data_hdl, struct msg answer);
d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	1133
1128 7c5449ddc434 New macro HOOK_MASK to ease call of the fd_hook_register function Sebastien Decugis <sdecugis@freediameter.net> parents: 1127 diff changeset	1134 /* The following is used by HOOK_MASK macro */
7c5449ddc434 New macro HOOK_MASK to ease call of the fd_hook_register function Sebastien Decugis <sdecugis@freediameter.net> parents: 1127 diff changeset	1135 uint32_t fd_hook_mask_helper(int dummy, ...);
1103 d8591b1c56cd Implemented a few hooks Sebastien Decugis <sdecugis@freediameter.net> parents: 1102 diff changeset	1136
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1137 /============================================================/
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1138
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1139 /*
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1140 * The following allows an extension to retrieve stat information on the different fifo queues involved in the freeDiameter framework.
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1141 * There are three global queues, plus per-peer queues.
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1142 * This information can be used to build SNMP-like data for example, or quickly get a status of the framework to find the loaded path of execution / bottlenecks.
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1143 */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1144 enum fd_stat_type {
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1145 /* For the following, no peer is associated with the stat */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1146 STAT_G_LOCAL= 1, /* Get statistics for the global queue of messages processed by local extensions */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1147 STAT_G_INCOMING, /* Get statistics for the global queue of received messages to be processed by routing_in thread */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1148 STAT_G_OUTGOING, /* Get statistics for the global queue of messages to be processed by routing_out thread */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1149
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1150 /* For the following, the peer must be provided */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1151 STAT_P_PSM, /* Peer state machine queue (events to be processed for this peer, including received messages) */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1152 STAT_P_TOSEND, /* Queue of messages for sending to this peer */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1153 };
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1154
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1155 /*
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1156 * FUNCTION: fd_stat_getstats
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1157 *
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1158 * PARAMETERS:
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1159 * stat : Which queue is being queried
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1160 * peer : (depending on the stat parameter) which peer is being queried
1071 6ca6cadf209c Implement the fd_stat_getstats function; changed prototype of fd_fifo_length. Sebastien Decugis <sdecugis@freediameter.net> parents: 1069 diff changeset	1161 * current_count : (out) The number of items in the queue currently
6ca6cadf209c Implement the fd_stat_getstats function; changed prototype of fd_fifo_length. Sebastien Decugis <sdecugis@freediameter.net> parents: 1069 diff changeset	1162 * limit_count : (out) The max number of items the queue accepts before becoming blocking -- 0 means no max.
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1163 * highest_count : (out) The highest count the queue has reached since startup
1067 23989d6c8390 Add total count in the statistics of the queues, thanks for the feedback :) Sebastien Decugis <sdecugis@freediameter.net> parents: 1063 diff changeset	1164 * total_count : (out) Total number of items that this queue has processed (always growing, use deltas for monitoring)
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1165 * total : (out) Cumulated time all items spent in this queue, including blocking time (always growing, use deltas for monitoring)
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1166 * blocking : (out) Cumulated time threads trying to post new items were blocked (queue full).
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1167 * last : (out) For the last element retrieved from the queue, how long it took between posting (including blocking) and poping
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1168 *
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1169 * DESCRIPTION:
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1170 * Get statistics information about a given queue.
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1171 * Any of the (out) parameters can be NULL if not requested.
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1172 *
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1173 * RETURN VALUE:
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1174 * 0 : The callback is registered.
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1175 * EINVAL : A parameter is invalid.
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1176 */
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1177 int fd_stat_getstats(enum fd_stat_type stat, struct peer_hdr * peer,
1071 6ca6cadf209c Implement the fd_stat_getstats function; changed prototype of fd_fifo_length. Sebastien Decugis <sdecugis@freediameter.net> parents: 1069 diff changeset	1178 int * current_count, int * limit_count, int * highest_count, long long * total_count,
1063 7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1179 struct timespec * total, struct timespec * blocking, struct timespec * last);
7a7f63f6f135 Commit prototype of new functions for discussion. These will replace the fd_log_msg feature as well as several internal dumping routines. The dbg_monitoring will be totally rewritten. Comments welcome... Sebastien Decugis <sdecugis@freediameter.net> parents: 1014 diff changeset	1180
1069 544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1181 /============================================================/
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1182 /* EOF */
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1183 /============================================================/
544fa1be79a9 Update the new API prototype to make it easier for extension to track messages between hooks, for e.g. timing computations Sebastien Decugis <sdecugis@freediameter.net> parents: 1067 diff changeset	1184
904 b839a1b1c1da Make freeDiameter headers more C++ friendly -- thank you Thomas Sebastien Decugis <sdecugis@freediameter.net> parents: 808 diff changeset	1185 #ifdef __cplusplus
b839a1b1c1da Make freeDiameter headers more C++ friendly -- thank you Thomas Sebastien Decugis <sdecugis@freediameter.net> parents: 808 diff changeset	1186 }
b839a1b1c1da Make freeDiameter headers more C++ friendly -- thank you Thomas Sebastien Decugis <sdecugis@freediameter.net> parents: 808 diff changeset	1187 #endif
b839a1b1c1da Make freeDiameter headers more C++ friendly -- thank you Thomas Sebastien Decugis <sdecugis@freediameter.net> parents: 808 diff changeset	1188
658 f198d16fa7f4 Initial commit for 1.1.0: Sebastien Decugis <sdecugis@nict.go.jp> parents: 648 diff changeset	1189 #endif /* _LIBFDCORE_H */

Mercurial > hg > freeDiameter

annotate include/freeDiameter/libfdcore.h @ 1186:56c36d1007b4