// : vi ts=4 sw=4 noet : /* ================================================================================== Copyright (c) 2019-2021 Nokia Copyright (c) 2018-2021 AT&T Intellectual Property. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ================================================================================== */ /* Mmemonic: rmr_api_static_test.c Abstract: Specific tests related to the API functions in rmr_nng.c/rmr.c. This should be included by a driver, but only the main RMr driver and there will likely not be a specific stand alone driver for just this small set of tests because of the depth of the library needed to test at this level. This can be used for both the nng and nanomsg outward facing RMr API functions. The message buffer specific API tests are in a different static module. API functions tested here are: rmr_close rmr_get_rcvfd rmr_ready rmr_init rmr_set_rtimeout rmr_set_stimeout rmr_rcv_specific rmr_torcv_msg rmr_rcv_msg rmr_call rmr_rts_msg rmr_send_msg rmr_mtosend_msg rmr_free_msg Author: E. Scott Daniels Date: 5 April 2019 */ #include #include #include #include #include #include #include #include #include #include "rmr.h" #include "rmr_agnostic.h" /* Send a 'burst' of messages to drive some send retry failures to increase RMr coverage by handling the retry caee. */ static void send_n_msgs( void* ctx, int n ) { rmr_mbuf_t* msg; // message buffers int i; msg = rmr_alloc_msg( ctx, 1024 ); if( ! msg ) { return; } for( i = 0; i < n; i++ ) { //fprintf( stderr, "mass send\n" ); msg->len = 100; msg->mtype = 1; msg->state = 999; errno = 999; msg = rmr_send_msg( ctx, msg ); } } /* Refresh or allocate a message with some default values */ static rmr_mbuf_t* fresh_msg( void* ctx, rmr_mbuf_t* msg ) { if( ! msg ) { msg = rmr_alloc_msg( ctx, 2048 ); } msg->mtype = 0; msg->sub_id = -1; msg->state = 0; msg->len = 100; return msg; } static int rmr_api_test( ) { int errors = 0; void* rmc; // route manager context void* rmc2; // second context for non-listener init rmr_mbuf_t* msg; // message buffers rmr_mbuf_t* msg2; int v = 0; // some value char wbuf[128]; int i; int state; v = rmr_ready( NULL ); errors += fail_if( v != 0, "rmr_ready returned true before initialisation " ); em_set_long_hostname( 1 ); if( (rmc = rmr_init( "4560", 1024, FL_NOTHREAD )) == NULL ) { fail_if_nil( rmc, "rmr_init returned a nil pointer " ); return 1; } setenv( "RMR_SRC_ID", "somehost", 1 ); // context should have this as source if( (rmc2 = rmr_init( ":6789", 1024, FL_NOTHREAD )) == NULL ) { // init without starting a thread errors += fail_if_nil( rmc, "rmr_init returned a nil pointer for non-threaded init " ); } fprintf( stderr, " with RMR_SRC_ID env set, source name in context: (%s)\n", ((uta_ctx_t *) rmc2)->my_name ); v = strcmp( ((uta_ctx_t *) rmc2)->my_name, "somehost:6789" ); errors += fail_not_equal( v, 0, "source name not set from environment variable (see previous info)" ); free_ctx( rmc2 ); // coverage unsetenv( "RMR_SRC_ID" ); // context should NOT have our artificial name if( (rmc2 = rmr_init( NULL, 1024, FL_NOTHREAD )) == NULL ) { // drive default port selector code errors += fail_if_nil( rmc, "rmr_init returned a nil pointer when driving for default port " ); } fprintf( stderr, " after unset of RMR_SRC_ID, source name in context: (%s)\n", ((uta_ctx_t *) rmc2)->my_name ); v = strcmp( ((uta_ctx_t *) rmc2)->my_name, "somehost:6789" ); errors += fail_if_equal( v, 0, "source name smells when removed from environment (see previous info)" ); free_ctx( rmc2 ); // attempt to reduce leak check errors v = rmr_ready( rmc ); // unknown return; not checking at the moment msg = rmr_alloc_msg( NULL, 1024 ); // should return nil pointer errors += fail_not_nil( msg, "rmr_alloc_msg didn't return nil when given nil context " ); msg = rmr_alloc_msg( rmc, 2048 ); // allocate larger than default size given on init errors += fail_if_nil( msg, "rmr_alloc_msg returned nil msg pointer " ); if( msg ) { rmr_get_srcip( msg, wbuf ); errors += fail_if_equal( 0, strlen( wbuf ), "rmr_get_srcip did not did not return string with length (b) after alloc_msg" ); fprintf( stderr, " ip: %s\n", wbuf ); } v = rmr_payload_size( NULL ); errors += fail_if( v >= 0, "rmr_payload_size returned valid size for nil message " ); errors += fail_if( errno == 0, "rmr_payload_size did not set errno on failure " ); v = rmr_payload_size( msg ); if( v >= 0 ) { errors += fail_not_equal( v, 2048, "rmr_payload_size returned invalid size (a) instead of expected size (b) " ); errors += fail_if( errno != 0, "rmr_payload_size did not clear errno on success " ); } else { errors += fail_if( v < 0, "rmr_payload_size returned invalid size for good message " ); } #ifdef EMULATE_NNG // this is only supported in nng, so behavour is different depending on the underlying library being tested v = rmr_get_rcvfd( NULL ); errors += fail_if( v >= 0, "rmr_get_rcvfd returned a valid file descriptor when given nil context " ); v = rmr_get_rcvfd( rmc ); errors += fail_if( v < 0, "rmr_get_rcvfd did not return a valid file descriptor " ); #else v = rmr_get_rcvfd( NULL ); errors += fail_if( v >= 0, "rmr_get_rcvfd returned a valid file descriptor when given nil context " ); v = rmr_get_rcvfd( rmc ); errors += fail_if( v >= 0, "rmr_get_rcvfd returned a valid file descriptor (not supported in nanomsg)" ); #endif msg2 = rmr_send_msg( NULL, NULL ); // drive for coverage errors += fail_not_nil( msg2, "send_msg returned msg pointer when given a nil message and context " ); msg->state = 0; msg = rmr_send_msg( NULL, msg ); errors += fail_if( msg->state == 0, "rmr_send_msg did not set msg state when msg given with nil context " ); // --- sends will fail with a no endpoint error until a dummy route table is set, so we test fail case first. msg->len = 100; msg->mtype = 1; msg->state = 999; msg->tp_state = 999; errno = 999; msg = rmr_send_msg( rmc, msg ); errors += fail_if_nil( msg, "send_msg_ did not return a message on send " ); if( msg ) { errors += fail_not_equal( msg->state, RMR_ERR_NOENDPT, "send_msg did not return no endpoints before rtable added " ); errors += fail_if( errno == 0, "send_msg did not set errno " ); errors += fail_if( msg->tp_state == 999, "send_msg did not set tp_state (1)" ); } gen_rt( rmc ); // --- after this point there is a dummy route table so send and rts calls should be ok msg->len = 100; msg->mtype = 1; msg->state = 999; msg->tp_state = 999; errno = 999; msg = rmr_send_msg( rmc, msg ); errors += fail_if_nil( msg, "send_msg_ did not return a message on send " ); if( msg ) { errors += fail_not_equal( msg->state, RMR_OK, "send_msg returned bad status for send that should work " ); errors += fail_if( errno != 0, "send_msg set errno for send that should work " ); v = rmr_payload_size( msg ); errors += fail_if( v != 2048, "send_msg did not allocate new buffer with correct size " ); errors += fail_if( msg->tp_state == 999, "send_msg did not set tp_state (2)" ); } rmr_set_stimeout( NULL, 0 ); rmr_set_stimeout( rmc, 20 ); rmr_set_stimeout( rmc, -1 ); rmr_set_rtimeout( NULL, 0 ); rmr_set_rtimeout( rmc, 20 ); rmr_set_rtimeout( rmc, -1 ); msg2 = rmr_rcv_msg( NULL, NULL ); errors += fail_if( msg2 != NULL, "rmr_rcv_msg returned msg when given nil context and msg " ); msg2 = rmr_rcv_msg( rmc, NULL ); errors += fail_if( msg2 == NULL, "rmr_rcv_msg returned nil msg when given nil msg " ); if( msg2 ) { if( msg2->state != RMR_ERR_EMPTY ) { errors += fail_not_equal( msg2->state, RMR_OK, "receive given nil message did not return msg with good state (not empty) " ); } } msg = rmr_rcv_msg( rmc, msg ); if( msg ) { errors += fail_not_equal( msg->state, RMR_OK, "rmr_rcv_msg did not return an ok state " ); errors += fail_not_equal( msg->len, 220, "rmr_rcv_msg returned message with invalid len " ); } else { errors += fail_if_nil( msg, "rmr_rcv_msg returned a nil pointer " ); } rmr_rts_msg( NULL, NULL ); // drive for coverage rmr_rts_msg( rmc, NULL ); errors += fail_if( errno == 0, "rmr_rts_msg did not set errno when given a nil message " ); msg->state = 0; msg = rmr_rts_msg( NULL, msg ); // should set state in msg if( msg ) { errors += fail_if_equal( msg->state, 0, "rmr_rts_msg did not set state when given valid message but no context " ); } else { errors += fail_if_nil( msg, "rmr_rts_msg returned a nil msg when given a good one" ); } msg = rmr_rts_msg( rmc, msg ); // return the buffer to the sender errors += fail_if_nil( msg, "rmr_rts_msg did not return a message pointer " ); errors += fail_not_equal( msg->state, 0, "rts_msg did not return a good state (a) when expected" ); errors += fail_not_equal( errno, 0, "rmr_rts_msg did not reset errno (a) expected (b)" ); msg->state = 0; msg = rmr_call( NULL, msg ); errors += fail_if( msg->state == 0, "rmr_call did not set message state when given message with nil context " ); snprintf( msg->xaction, 17, "%015d", 16 ); // dummy transaction id (emulation generates, this should arrive after a few calls to recv) msg->mtype = 0; msg->sub_id = -1; em_set_rcvcount( 0 ); // reset message counter em_set_rcvdelay( 1 ); // force slow msg rate during mt testing msg = rmr_call( rmc, msg ); // dummy nng/nano function will sequentually add xactions and should match or '16' errors += fail_if_nil( msg, "rmr_call returned a nil message on call expected to succeed " ); if( msg ) { errors += fail_not_equal( msg->state, RMR_OK, "rmr_call did not properly set state on successful return " ); errors += fail_not_equal( errno, 0, "rmr_call did not properly set errno (a) on successful return " ); } snprintf( wbuf, 17, "%015d", 14 ); // while waiting, the queued messages should have #14, so issue a few receives looking for it for( i = 0; i < 16; i++ ) { // it should be in the first 15 msg = rmr_rcv_msg( rmc, msg ); if( msg ) { if( strcmp( wbuf, msg->xaction ) == 0 ) { // found the queued message break; } fprintf( stderr, " msg: %s\n", msg->xaction ); } else { errors += fail_if_nil( msg, "receive returnd nil msg while looking for queued message " ); } } errors += fail_if( i >= 16, "did not find expected message on queue " ); if( ! msg ) { msg = rmr_alloc_msg( rmc, 2048 ); // something buggered above; get a new one } msg->mtype = 0; msg->sub_id = -1; msg = rmr_call( rmc, msg ); // make a call that we never expect a response on (nil pointer back) errors += fail_not_nil( msg, "rmr_call returned a nil message on call expected not to receive a response " ); errors += fail_if( errno == 0, "rmr_call did not set errno on failure " ); rmr_free_msg( NULL ); // drive for coverage; nothing to check rmr_free_msg( msg2 ); msg2 = rmr_torcv_msg( NULL, NULL, 10 ); errors += fail_not_nil( msg2, "rmr_torcv_msg returned a pointer when given nil information " ); msg2 = rmr_torcv_msg( rmc, NULL, 10 ); errors += fail_if_nil( msg2, "rmr_torcv_msg did not return a message pointer when given a nil old msg " ); // --- test timeout receive; our dummy epoll function will return 1 ready on first call and 0 ready (timeout emulation) on second // however we must drain the swamp (queue) first, so run until we get a timeout error, or 20 and report error if we get to 20. msg = NULL; for( i = 0; i < 40; i++ ) { msg = rmr_torcv_msg( rmc, msg, 10 ); errors += fail_if_nil( msg, "torcv_msg returned nil msg when message expected " ); if( msg ) { if( msg->state == RMR_ERR_TIMEOUT || msg->state == RMR_ERR_EMPTY ) { // queue drained and we've seen both states from poll if we get a timeout break; } } } errors += fail_if( i >= 40, "torcv_msg never returned a timeout " ); // ---- trace things that are not a part of the mbuf_api functions and thus must be tested here ------- state = rmr_init_trace( NULL, 37 ); // coverage test nil context errors += fail_not_equal( state, 0, "attempt to initialise trace with nil context returned non-zero state (a) " ); errors += fail_if_equal( errno, 0, "attempt to initialise trace with nil context did not set errno as expected " ); state = rmr_init_trace( rmc, 37 ); errors += fail_if_equal( state, 0, "attempt to set trace len in context was not successful " ); errors += fail_not_equal( errno, 0, "attempt to set trace len in context did not clear errno " ); msg = rmr_tralloc_msg( rmc, 1024, 17, "1904308620110417" ); errors += fail_if_nil( msg, "attempt to allocate message with trace data returned nil message " ); state = rmr_get_trace( msg, wbuf, 17 ); errors += fail_not_equal( state, 17, "len of trace data (a) returned after msg allocation was not expected size (b) " ); state = strcmp( wbuf, "1904308620110417" ); errors += fail_not_equal( state, 0, "trace data returned after tralloc was not correct " ); em_send_failures = 1; send_n_msgs( rmc, 30 ); // send 30 messages with emulation failures em_send_failures = 0; ((uta_ctx_t *)rmc)->shutdown = 1; rmr_close( NULL ); // drive for coverage rmr_close( rmc ); // no return to check; drive for coverage // -- allocate a new context for mt-call and drive that stuff ----------------------------------------- #ifdef EMULATE_NNG msg = fresh_msg( rmc, msg ); // ensure we have one with known contents msg->state = 0; msg = rmr_mt_call( rmc, msg, 3, 10 ); // drive when not in mt setup if( msg ) { errors += fail_not_equal( msg->state, RMR_ERR_NOTSUPP, "rmr_mt_call did not set not supported error when not mt initialised" ); } else { errors += fail_if_nil( msg, "rmr_mt_call returned nil pointer when not mt initialised" ); } msg = fresh_msg( rmc, msg ); msg = rmr_mt_rcv( rmc, msg, 10 ); // gen not supported error if ctx not set for mt if( msg ) { errors += fail_not_equal( msg->state, RMR_ERR_NOTSUPP, "rmr_mt_rcv did not return not supported state when mt not initialised" ); } else { errors += fail_if_nil( msg, "nil pointer from rmr_mt_rcv when mt not initialised\n" ); } msg = fresh_msg( rmc, msg ); msg->state = 0; if( msg ) { msg = rmr_mt_call( rmc, msg, 1000, 10 ); // thread id out of range errors += fail_if_equal( msg->state, 0, "rmr_mt_call did not set an error when given an invalid call-id" ); } else { errors += fail_if_nil( msg, "rmr_mt_call returned a nil pointer when given an invalid call-id" ); } msg = fresh_msg( rmc, msg ); state = init_mtcall( NULL ); // drive for coverage errors += fail_not_equal( state, 0, "init_mtcall did not return false (a) when given a nil context pointer" ); if( (rmc = rmr_init( NULL, 1024, FL_NOTHREAD | RMRFL_MTCALL )) == NULL ) { // drive multi-call setup code without rtc thread errors += fail_if_nil( rmc, "rmr_init returned a nil pointer when driving for mt-call setup " ); } gen_rt( rmc ); // must attach a route table so sends succeed fprintf( stderr, " enabling mt messages\n" ); em_set_rcvdelay( 1 ); // force slow msg rate during mt testing em_set_mtc_msgs( 1 ); // emulated nngrcv will now generate messages with call-id and call flag msg->state = 0; msg = rmr_mt_call( NULL, msg, 3, 10 ); // should timeout if( msg ) { errors += fail_if( msg->state == 0, "rmr_mt_call did not set message state when given message with nil context " ); } msg = fresh_msg( rmc, msg ); fprintf( stderr, " invoking mt_call with timout == 2999\n" ); msg = rmr_mt_call( rmc, msg, 2, 2999 ); // long timeout to drive time building code, should receive if( msg ) { if( msg->state != RMR_OK ) { fprintf( stderr, " rmr_mt_call returned error in mbuf: %d\n", msg->state ); } else { errors += fail_not_nil( msg, "rmr_mt_call did not return a nil pointer on read timeout" ); } } msg = fresh_msg( rmc, msg ); msg = rmr_mt_rcv( NULL, NULL, 10 ); errors += fail_not_nil( msg, "rmr_mt_rcv returned a non-nil message when given nil message and nil context" ); fprintf( stderr, " invoking mt_rcv with timout == 2999\n" ); msg = fresh_msg( rmc, msg ); msg = rmr_mt_rcv( rmc, msg, 2999 ); if( !msg ) { errors += fail_if_nil( msg, "rmr_mt_rcv returned a nil message when given valid message and timeout of 29999" ); } msg = fresh_msg( rmc, msg ); msg = rmr_mt_rcv( rmc, msg, -1 ); if( !msg ) { errors += fail_if_nil( msg, "rmr_mt_rcv returned a nil message when given valid message unlimited timeout" ); } msg = fresh_msg( rmc, msg ); fprintf( stderr, " waiting 20.0 seconds for a known call xaction to arrive (%ld)\n", time( NULL ) ); snprintf( msg->xaction, 17, "%015d", 5 ); // we'll reset receive counter before calling mt_call so this will arrive again em_set_rcvcount( 0 ); msg = rmr_mt_call( rmc, msg, 2, 15000 ); // we need about 10s to get the message with the 'slow rate' if( msg ) { errors += fail_not_equal( msg->state, RMR_OK, "mt_call with known xaction id bad state (a)" ); } else { errors += fail_if_nil( msg, "mt_call with known xaction id returned nil message" ); } fprintf( stderr, " time check: %ld\n", time( NULL ) ); em_set_mtc_msgs( 0 ); // turn off em_set_rcvdelay( 0 ); // full speed receive rate to overflow the ring fprintf( stderr, " pausing 5s to allow mt-call receive ring to fill %ld\n", time( NULL ) ); sleep( 2 ); fprintf( stderr, " tests continuing %ld\n", time( NULL ) ); em_set_rcvdelay( 1 ); // restore slow receive pace for any later tests ((uta_ctx_t *)rmc)->shutdown = 1; // force the mt-reciver attached to the context to stop #endif // --------------- phew, done ------------------------------------------------------------------------------ if( ! errors ) { fprintf( stderr, " all RMr API tests pass\n" ); } return errors; }