1 // vi: ts=4 sw=4 noet :
3 ==================================================================================
4 Copyright (c) 2019-2020 Nokia
5 Copyright (c) 2018-2020 AT&T Intellectual Property.
7 Licensed under the Apache License, Version 2.0 (the "License");
8 you may not use this file except in compliance with the License.
9 You may obtain a copy of the License at
11 http://www.apache.org/licenses/LICENSE-2.0
13 Unless required by applicable law or agreed to in writing, software
14 distributed under the License is distributed on an "AS IS" BASIS,
15 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 See the License for the specific language governing permissions and
17 limitations under the License.
18 ==================================================================================
22 Mnemonic: test_tools.c
23 Abstract: Functions for test applications to make their life a bit easier.
24 This file is probably compiled to a .o, and then included on
25 the cc command for the test.
26 Author: E. Scott Daniels
30 #ifndef _test_support_c
31 #define _test_support_c
41 This is ugly, but needed to allow for component testing.
43 The test code (e.g. foo_test.c and not foo_static_test.c) can include these
44 constants to turn off the import of test support files:
45 NO_EMULATION -- the transport emulation will not be included
46 NO_PRIVATE_HEADERS -- the private headers for the transport component of RMR
47 (e.g. si) will not be included.
49 #ifndef NO_EMULATION // assume emulation unless specifically put off (love double negatives)
51 #define TP_HDR_LEN 0 // needed for support functions but nonexistant in nng world
52 #include "test_nng_em.c" // nano/ngg emulation functions
54 #include "test_si95_em.c" // si emulation functions
58 #ifndef NO_PRIVATE_HEADERS // include transport headers unless specifically turned off
60 #include <rmr_nng_private.h> // context things are type sensitive
62 #include "si95/socket_if.h" // need to have the si context more than anything else
63 #include <rmr_si_private.h>
68 #define BAD 1 // these are exit codes unless user overrides
72 // ----------- a couple of globals make it easier ---------------------------------------
73 static int ts_tests_driven = 0; // number of fail_if calls made == numer of tests driven
75 // ---------------------------------------------------------------------------------------
78 Support test counting, reset and summary.
80 static int test_get_attempted() {
81 return ts_tests_driven;
84 static void test_reset_attempted() {
88 static void test_summary( int ecount, char* tag ) {
89 fprintf( stderr, "<SUMMARY> %s completed; %d total tests, %d passed, %d failed\n",
90 tag, ts_tests_driven, ts_tests_driven - ecount, ecount );
94 Snag the optional positional parameter at pp, return defval if not there.
96 static char* snag_pp( int pp, int argc, char** argv, char* defval ) {
106 Signal handler -- inside of the tests we will exit cleanly for hup/temp/intr
107 signals so that the coverage stuff will generate the needed data files. If
108 we inter/term the process they don't drive.
111 void sig_clean_exit( int sign ) {
112 fprintf( stderr, "signal trapped for clean exit: %d\n", sign );
117 Setup all of the signal handling for signals that we want to force a clean exit:
118 term, intr, hup, quit, usr1/2 alarm, etc. All others we'll let default.
120 static void set_signals( void ) {
122 int sig_list[] = { SIGINT, SIGQUIT, SIGILL, SIGALRM, SIGTERM, SIGUSR1 , SIGUSR2 };
124 int nele; // number of elements in the list
126 nele = (int) ( sizeof( sig_list )/sizeof( int ) ); // convert raw size to the number of elements
127 for( i = 0; i < nele; i ++ ) {
128 memset( &sa, 0, sizeof( sa ) );
129 sa.sa_handler = sig_clean_exit;
130 sigaction( sig_list[i], &sa, NULL );
136 Assert like logic except these just record the test and return state so that we
137 can attempt all tests and not abort on the first failure as an assert would do.
139 static int fail_if_nil( void* p, char* what ) {
143 fprintf( stderr, "<FAIL> %s: pointer was nil\n", what );
145 return p ? GOOD : BAD;
148 static int fail_not_nil( void* p, char* what ) {
152 fprintf( stderr, "<FAIL> %s: pointer was not nil\n", what );
154 return !p ? GOOD : BAD;
157 static int fail_if_false( int bv, char* what ) {
161 fprintf( stderr, "<FAIL> %s: expected true, boolean test was false (%d)\n", what, bv );
164 return bv ? GOOD : BAD;
167 static int fail_if_true( int bv, char* what ) {
171 fprintf( stderr, "<FAIL> %s: expected false, boolean test was true (%d)\n", what, bv );
173 return bv ? BAD : GOOD;
177 Same as fail_if_true(), but reads easier in the test code.
179 static int fail_if( int bv, char* what ) {
184 fprintf( stderr, "<FAIL> %s: expected false, boolean test was true (%d)\n", what, bv );
186 return bv ? BAD : GOOD;
189 static int fail_pequal( void* a, void* b, char* what ) {
193 fprintf( stderr, "<FAIL> %s: pointers were not equal a=%p b=%p\n", what, a, b );
195 return a == b ? GOOD : BAD; // user may override good/bad so do NOT return a==b directly!
198 static int fail_not_pequal( void* a, void* b, char* what ) {
202 fprintf( stderr, "<FAIL> %s: pointers were not equal a=%p b=%p\n", what, a, b );
204 return a == b ? GOOD : BAD; // user may override good/bad so do NOT return a==b directly!
207 static int fail_not_equal( int a, int b, char* what ) {
211 fprintf( stderr, "<FAIL> %s: values were not equal a=%d b=%d\n", what, a, b );
213 return a == b ? GOOD : BAD; // user may override good/bad so do NOT return a==b directly!
216 static int fail_if_equal( int a, int b, char* what ) {
220 fprintf( stderr, "<FAIL> %s values were equal a=%d b=%d\n", what, a, b );
222 return a != b ? GOOD : BAD; // user may override good/bad so do NOT return a==b directly!
225 static int fail_not_equalp( void* a, void* b, char* what ) {
229 fprintf( stderr, "<FAIL> %s: pointers were not equal a=%p b=%p\n", what, a, b );
231 return a == b ? GOOD : BAD; // user may override good/bad so do NOT return a==b directly!
234 static int fail_if_equalp( void* a, void* b, char* what ) {
238 fprintf( stderr, "<FAIL> %s pointers were equal a=%p b=%p\n", what, a, b );
240 return a != b ? GOOD : BAD; // user may override good/bad so do NOT return a==b directly!
244 // for symtab and other non-message things this allows them to exclude by setting
247 Dummy message allocator for testing without sr_static functions
253 static rmr_mbuf_t* test_mk_msg( int len, int tr_len ) {
258 alen = sizeof( *hdr ) + tr_len + len + TP_HDR_LEN; // this does no support allocating len2 and len3 data fields
260 new_msg = (rmr_mbuf_t *) malloc( sizeof *new_msg );
261 memset( new_msg, 0, sizeof( *new_msg ) );
262 new_msg->tp_buf = (void *) malloc( alen );
263 memset( new_msg->tp_buf, 0, alen );
265 hdr = (uta_mhdr_t*) new_msg->tp_buf;
267 SET_HDR_TR_LEN( hdr, tr_len );
268 hdr->rmr_ver = htonl( MSG_VER );
269 strcpy( hdr->src, "dummyhost:1111" );
270 strcpy( hdr->srcip, "30.4.19.86:1111" );
272 new_msg->header = new_msg->tp_buf;
273 new_msg->payload = new_msg->header + PAYLOAD_OFFSET( hdr );
274 new_msg->alloc_len = alen;
280 static void test_set_ver( rmr_mbuf_t* msg, int ver ) {
283 hdr = (uta_mhdr_t*) msg->tp_buf;
284 hdr->rmr_ver = htonl( ver );
285 strcpy( hdr->src, "dummyhost-v2:1111" );
286 strcpy( hdr->srcip, "30.4.19.86:2222" );
292 These allow values to be pushed deep into the real RMR header allocated
293 at the front of the transport buffer. These are needed to simulate
294 the actions of rmr_send() which pushes the values from the message buffer
295 just before putting them on the wire.
297 static void test_set_mtype( rmr_mbuf_t* msg, int mtype ) {
301 hdr = (uta_mhdr_t*) msg->tp_buf;
302 hdr->mtype = htonl( mtype );
305 static void test_set_sid( rmr_mbuf_t* msg, int sid ) {
309 hdr = (uta_mhdr_t*) msg->tp_buf;
310 hdr->sub_id = htonl( sid );
313 static void test_set_plen( rmr_mbuf_t* msg, int plen ) {
317 hdr = (uta_mhdr_t*) msg->tp_buf;
318 hdr->plen = htonl( plen );
322 Build a message and populate both the msg buffer and the tranport header
323 with mid, sid, and payload len. Tr_len causes that much space in the
324 header for trace info to be reserved.
326 static rmr_mbuf_t* mk_populated_msg( int alloc_len, int tr_len, int mtype, int sid, int plen ) {
330 mbuf = test_mk_msg( alloc_len, tr_len );
331 test_set_mtype( mbuf, mtype );
332 test_set_sid( mbuf, sid );
333 test_set_plen( mbuf, plen );