[sr-dev] git:master: tmx: documentation for t_precheck_trans()

[Juha Heinanen]

i tried this code:

  if(t_precheck_trans()) {
    t_check_trans();
    exit;
  }
  t_check_trans();

and got a crash.

-- juha

(gdb) where
#0  0x00007fa3d6e994c0 in tmx_check_pretran (msg=0x7fa3e4db3d88)
    at tmx_pretran.c:225
#1  0x00007fa3d6e97deb in w_t_precheck_trans (msg=0x7fa3e4db3d88, p1=0x0, 
    p2=0x0) at tmx_mod.c:709
#2  0x000000000041c6b3 in do_action (h=0x7fff756e80e0, a=0x7fa3e44df2c8, 
    msg=0x7fa3e4db3d88) at action.c:1107
#3  0x0000000000425233 in run_actions (h=0x7fff756e80e0, a=0x7fa3e44df2c8, 
    msg=0x7fa3e4db3d88) at action.c:1607
#4  0x000000000042591f in run_actions_safe (h=0x7fff756e8990, 
    a=0x7fa3e44df2c8, msg=0x7fa3e4db3d88) at action.c:1672
#5  0x00000000004cb56f in rval_get_int (h=0x7fff756e8990, msg=0x7fa3e4db3d88, 
    i=0x7fff756e8800, rv=0x7fa3e44df558, cache=0x0) at rvalue.c:924
#6  0x00000000004ce227 in rval_expr_eval_int (h=0x7fff756e8990, 
    msg=0x7fa3e4db3d88, res=0x7fff756e8800, rve=0x7fa3e44df550)
    at rvalue.c:1918
#7  0x000000000041c3d6 in do_action (h=0x7fff756e8990, a=0x7fa3e44dfed0, 
    msg=0x7fa3e4db3d88) at action.c:1083
#8  0x0000000000425233 in run_actions (h=0x7fff756e8990, a=0x7fa3e44d3228, 
    msg=0x7fa3e4db3d88) at action.c:1607
#9  0x00000000004259e7 in run_top_route (a=0x7fa3e44d3228, msg=0x7fa3e4db3d88, 
    c=0x0) at action.c:1693
#10 0x00000000004ab495 in receive_msg (
    buf=0x199b390 "NOTIFY sip:test-0x1d81ce0 at 192.98.102.30:5064;alias=192.98.102.30~37384~2;transport=tcp SIP/2.0\r\nVia: SIP/2.0/TCP 192.98.102.30:5080;branch=z9hG4bK5d1b.05567df1", '0' <repeats 24 times>, ".0\r\nTo: <sip:test"..., 
    len=677, rcv_info=0x7fa3db3fb750) at receive.c:213
#11 0x0000000000533b6e in receive_tcp_msg (
    tcpbuf=0x7fa3db3fba20 "NOTIFY sip:test-0x1d81ce0 at 192.98.102.30:5064;alias=192.98.102.30~37384~2;transport=tcp SIP/2.0\r\nVia: SIP/2.0/TCP 192.98.102.30:5080;branch=z9hG4bK5d1b.05567df1", '0' <repeats 24 times>, ".0\r\nTo: <sip:test"..., len=677, rcv_info=0x7fa3db3fb750, con=0x7fa3db3fb738) at tcp_read.c:1232
#12 0x0000000000534a20 in tcp_read_req (con=0x7fa3db3fb738, 
    bytes_read=0x7fff756e8dec, read_flags=0x7fff756e8de8) at tcp_read.c:1387
#13 0x0000000000535e0c in handle_io (fm=0x7fa3e4e934f0, events=1, idx=-1)
    at tcp_read.c:1559
#14 0x000000000052edd9 in io_wait_loop_epoll (h=0x8e4200, t=2, repeat=0)
    at io_wait.h:1092
#15 0x0000000000536ce2 in tcp_receive_loop (unix_sock=49) at tcp_read.c:1728
#16 0x000000000052929f in tcp_init_children () at tcp_main.c:4970
#17 0x0000000000470d9d in main_loop () at main.c:1704
#18 0x00000000004739ae in main (argc=17, argv=0x7fff756e92b8) at main.c:2554
(gdb)  
#0  0x00007fa3d6e994c0 in tmx_check_pretran (msg=0x7fa3e4db3d88)
    at tmx_pretran.c:225
#1  0x00007fa3d6e97deb in w_t_precheck_trans (msg=0x7fa3e4db3d88, p1=0x0, 
    p2=0x0) at tmx_mod.c:709
#2  0x000000000041c6b3 in do_action (h=0x7fff756e80e0, a=0x7fa3e44df2c8, 
    msg=0x7fa3e4db3d88) at action.c:1107
#3  0x0000000000425233 in run_actions (h=0x7fff756e80e0, a=0x7fa3e44df2c8, 
    msg=0x7fa3e4db3d88) at action.c:1607
#4  0x000000000042591f in run_actions_safe (h=0x7fff756e8990, 
    a=0x7fa3e44df2c8, msg=0x7fa3e4db3d88) at action.c:1672
#5  0x00000000004cb56f in rval_get_int (h=0x7fff756e8990, msg=0x7fa3e4db3d88, 
    i=0x7fff756e8800, rv=0x7fa3e44df558, cache=0x0) at rvalue.c:924
#6  0x00000000004ce227 in rval_expr_eval_int (h=0x7fff756e8990, 
    msg=0x7fa3e4db3d88, res=0x7fff756e8800, rve=0x7fa3e44df550)
    at rvalue.c:1918
#7  0x000000000041c3d6 in do_action (h=0x7fff756e8990, a=0x7fa3e44dfed0, 
    msg=0x7fa3e4db3d88) at action.c:1083
#8  0x0000000000425233 in run_actions (h=0x7fff756e8990, a=0x7fa3e44d3228, 
    msg=0x7fa3e4db3d88) at action.c:1607
#9  0x00000000004259e7 in run_top_route (a=0x7fa3e44d3228, msg=0x7fa3e4db3d88, 
    c=0x0) at action.c:1693
#10 0x00000000004ab495 in receive_msg (
    buf=0x199b390 "NOTIFY sip:test-0x1d81ce0 at 192.98.102.30:5064;alias=192.98.102.30~37384~2;transport=tcp SIP/2.0\r\nVia: SIP/2.0/TCP 192.98.102.30:5080;branch=z9hG4bK5d1b.05567df1", '0' <repeats 24 times>, ".0\r\nTo: <sip:test"..., 
    len=677, rcv_info=0x7fa3db3fb750) at receive.c:213
#11 0x0000000000533b6e in receive_tcp_msg (
    tcpbuf=0x7fa3db3fba20 "NOTIFY sip:test-0x1d81ce0 at 192.98.102.30:5064;alias=192.98.102.30~37384~2;transport=tcp SIP/2.0\r\nVia: SIP/2.0/TCP 192.98.102.30:5080;branch=z9hG4bK5d1b.05567df1", '0' <repeats 24 times>, ".0\r\nTo: <sip:test"..., len=677, rcv_info=0x7fa3db3fb750, con=0x7fa3db3fb738) at tcp_read.c:1232
#12 0x0000000000534a20 in tcp_read_req (con=0x7fa3db3fb738, 
    bytes_read=0x7fff756e8dec, read_flags=0x7fff756e8de8) at tcp_read.c:1387
#13 0x0000000000535e0c in handle_io (fm=0x7fa3e4e934f0, events=1, idx=-1)
    at tcp_read.c:1559
#14 0x000000000052edd9 in io_wait_loop_epoll (h=0x8e4200, t=2, repeat=0)
    at io_wait.h:1092
#15 0x0000000000536ce2 in tcp_receive_loop (unix_sock=49) at tcp_read.c:1728
#16 0x000000000052929f in tcp_init_children () at tcp_main.c:4970
#17 0x0000000000470d9d in main_loop () at main.c:1704
#18 0x00000000004739ae in main (argc=17, argv=0x7fff756e92b8) at main.c:2554