Rockhopper VPN

1. Click VPN's Settings button and show Add a New Global Setting (VPN) dialog.
   
   
2. Setting Name: Select dbg_use_trace_file.
   
   
3. Setting Value: Enter 1 to enable this service. When disabling it, please enter 0.
   
   
4. Click OK button.
   
   
5. Click Save Configuration button.
   
   
6. Restart Rockhopper like this (Ubuntu):
   
   # sudo /etc/init.d/rockhopper restart
   or
   # sudo systemctl restart rockhopper
   
   

  ...

(733) 2012/06/23 11:59:13-790394 [mainfreq] 6-3712 p:1336,t:1372 
(esp_impl_rx_decap_ipv4_ip_ip) tls_cache: 0x9ec80d8 pkt: 0x9bddf80 dec_out_p[LEN: dec_data_len]: 
[0x9ec7f30]  80(bytes)
*0 *1 *2 *3 *4 *5 *6 *7 *8 *9 *A *B *C *D *E *F     0123456789ABCDEF
45 00 00 4e 00 0d 00 00 80 11 15 d6 c0 a8 64 14     E..N..........d.
 ...
 pad_len: 0
[rhp_esp_impl.c:1211]

 ...

(725) 2012/06/23 11:59:13-790280 [mainfreq] 6-3717 p:1336,t:1372 
(esp_impl_rx_decap_ipv4) pkt: 0x9bddf80 tls_cache: 0x9ec80d8 seqh: 0 seqh: 0x0 
next_header_r: 0xb57645dc
[rhp_esp_impl.c:1268]


(726) 2012/06/23 11:59:13-790292 [mainfreq] 6-3302 p:1336,t:1372 
(openssl_encr_aes_cbc_get_iv_len) encr: 0x9ec6ca0 AES_BLOCK_SIZE: 16
[rhp_openssl_crypto.c:1441]


(727) 2012/06/23 11:59:13-790303 [mainfreq] 6-3303 p:1336,t:1372 
(openssl_encr_aes_cbc_get_block_len) encr: 0x9ec6ca0 AES_BLOCK_SIZE: 16
[rhp_openssl_crypto.c:1447]


(728) 2012/06/23 11:59:13-790315 [mainfreq] 6-3267 p:1336,t:1372 
(openssl_integ_hmac_sha1_96_get_output_len) integ: 0x9ec8250 12: 12
[rhp_openssl_crypto.c:1007]


(729) 2012/06/23 11:59:13-790326 [mainfreq] 6-3719 p:1336,t:1372 
(esp_impl_rx_decap_ipv4_esp_pkt) pkt: 0x9bddf80 tls_cache: 0x9ec80d8 pkt->data[LEN: pkt->len ]
[PROTO: MAC_IPV4_ESP ][IV_LEN: iv_len][ICV_LEN: icv_len] PROTO: 6 , IV LEN:16 , ICV LEN:12 , 
DATA LEN:158

==<MAC>==
dst_addr : 00:00:00:00:00:00
src_addr : 00:00:00:00:00:00
protocol : 0x800 (ARP:0x0806,IPv4:0x0800,IPv6:0x86DD,)

==<IPv4>==
IHL : 5
Version : 4
TOS : 0x0
total_len : 144
id : 0
frag : 0x0
TTL : 0
Protocol : 17 (ICMP:1,UDP:17,TCP:6,ESP:50,AH:51)
checksum : 0x0
src_addr : 10.0.0.10
dst_addr : 192.168.0.100

==<UDP>==
src_port : 8372
dst_port : 4500
len : 124
checksum : 0

==<ESP>==
spi : 3704306518(0xdccb3b56)
seq : 14

[IV] [0x0]  16(bytes)
*0 *1 *2 *3 *4 *5 *6 *7 *8 *9 *A *B *C *D *E *F     0123456789ABCDEF
41 b8 70 1f 66 c6 c6 8c 86 91 54 26 85 ad 1d 5d     A.p.f.....T....]

[Encrypted Data] [0x0]  80(bytes)
*0 *1 *2 *3 *4 *5 *6 *7 *8 *9 *A *B *C *D *E *F     0123456789ABCDEF
64 aa 97 1f 8c 83 12 9d 71 08 e4 10 34 41 12 c2     d.......q...4A..
a4 36 79 91 12 a9 67 11 97 09 a6 67 0c bc 0b ac     .6y...g....g....
 ...

[ICV] [0x0]  12(bytes)
*0 *1 *2 *3 *4 *5 *6 *7 *8 *9 *A *B *C *D *E *F     0123456789ABCDEF
4a d5 1a 55 c6 18 d8 d9 82 ee bc 64                 J..U.......d

[TRF](ESP)  11:59:13-790326 p:1336,t:1372    
10.0.0.10 >> 192.168.0.100 Len: 144:UDP[8372 >> 4500] NATT [ESP]  SPI(3704306518, 0xdccb3b56) 
SEQ(14) Len: 116

==<DUMP>==

[0x0]  158(bytes)
*0 *1 *2 *3 *4 *5 *6 *7 *8 *9 *A *B *C *D *E *F     0123456789ABCDEF
00 00 00 00 00 00 00 00 00 00 00 00 08 00 45 00     ..............E.
 ...

(736) 2012/06/23 11:59:13-790438 [mainfreq] 6-3716 p:1336,t:1372 
(esp_impl_rx_decap_ipv4_ip_ip_rtrn) tls_cache: 0x9ec80d8 pkt: 0x9bddf80 diff: 38
[rhp_esp_impl.c:1247]

 ...

• Writing trace records faster.
• All processes (a main process, a protected process and scripts invoked by Rockhopper) and their threads write their trace records to a common buffer, so you can easily debug interaction and timing problems between them.
• By using the rhp_trace command, you can manage behavior of debug trace service.
• This extended service also provides kernel-level API to write trace records to the common buffer. When you need to debug interaction or behavior between Rockhopper and kernel services like network stacks, you can embed the API into Linux kernel's source codes.

- Installed components:

• rhp_trace_helper: A daemon providing trace flags' status for processes and threads which use Debug trace service.
  
• rhp_trace.ko: A kernel module providing a cyclic on-memory buffer into which all processes and threads write trace records.
  
• librhptrace.so : A Debug trace library user processes link.
  
• rhp_trace_load script: A script file invoked by /etc/init.d/rockhopper script to start or stop Debug trace service. The Debug trace service starts before Rockohpper daemon processes are invoked.
• rhp_trace: A command-line tool to manage Debug trace service.

- Install Rockhopper VPN package with Debug trace service and tools:

1. Download the same software's package(rockhopper-<version>.tgz).
2. tar zxvf rockhopper-<version>.tgz
3. cd rockhopper-<version>
4. sudo ./install_dbg.sh       *:Run the installer script as root.
5. Finally, reboot your system.
   

- Use Debug trace tools

   # sudo rhp_trace -i
    Buffer:00099850 bytes / 10000000 bytes (used / total).
    [1] common       : mask[255] : ENABLED
    [2] syspxy       : mask[255] : ENABLED
    [3] main         : mask[255] : ENABLED
    [4] func         : mask[255] : ENABLED
    [5] trace_file   : mask[255] : ENABLED
    [6] main_freq    : mask[255] : ENABLED
    [7] syspxy_freq  : mask[255] : ENABLED
    [8] reserved     : mask[255] : ENABLED
    

- What does the output.sh script actually do?

- Debug trace management by rhp_trace command

                
# rhp_trace -h
 -e user_id [filter_mask] : enable trace
 -d user_id : disable trace
 -s output_file : save trace
 -t output_file xml_file ... : translate trace
 -z size : set trace size(byte)
 -r : reset trace
 -i : show trace configuration

• All arguments of the RHP_TRC macro must be written in a single line.
• If you create a new C source file, the file name must be globally unique in the Rockhopper package.
• If you define a new trace label for the conversion specifier 'L', which can be specified in the format argument of rhp_trace() function or RHP_TRC macro, please update bsym.def or msym.def in <install_dir>/rockhopper-<version>/rockhopper/misc/, too. bsym.def is for the conversion specifier 'B' and msym.def is for other conversion specifiers like 'w', 'd', 'q', etc.