Quick View

 go back

 

***************************************************************************

*                          法律声明

* 版权所有:重庆比纯软件科技有限公司

* 比纯调试器及其文档是重庆比纯软件科技有限公司财产。没有

* 比纯软件科技正式许可,任何个人和单位不得将产品及其文档

* 用于商业活动。

*

*

*                          LAW   DECLARATION

* Copyright (C) by Chongqing btrue software technology co.,ltd 

*

* BTR product and its document is the property of Chongqing

* btrue software technology co.,ltd. Any person or orgnization 

* can't use it in commercial field without offical permission.

***************************************************************************

 

 

 

 

Introduce 

      Welcome to use BTR. 

      BTR is a true source code level debugger. BTR 1.0 can run in Windows and Linux. BTR 1.0 can debug C, C++, JAVA, C# code. 

      BTR 100% report crashed code , 100% report thread unlimited loop code.

      Code logical bugs can be found quickly by using its code log. BTR remember each actually running code line. Look at the code running history , your logical bugs can be find quickly and clearly!

      BTR track program resource open and close. Ram pointer, file, socket , object , ... can be tracked.

      BTR track program variable. When the value of variable changed  , BTR immediately remember the current value and the running code line.

      BTR's time used statistics can improve your program performance.

      Copyright  (C)  btrue software technology co., ltd

 

Function feature 

 

      BTR's main functions show as following:

1) flash

       User can watch the latest 1024 code runing lines.

2) log

     Trace each code line , save it to code log.

3) pointer trace 

      Wild pointer report in real-time.

4) message output

      Debug message output to console.

5) variable trace

      Trace the variable value changement.

6) time statistics

      Used time statistics

7) break point

     User can set code break point.

8) trace step by step

      Trace the code line step by step.

9) func

      The called functions sequence.

10)resource  

     trace  resource open and close. 

 

 

  

 

BTR Command list 

    

Command Usage and descript Example
F2 F2

pause the process

F2
F3 F3

process continue

F3
help help

print command usage

help
shutdown shutdown

exit bd.exe when process paused

shutdown
build build <homepath>

compile a project

build d:\myproj

build /home/usr/t

flash flash [filter] [-s file]

output the latest running code.

flash

flash -s a.txt

flash a.c -s a.txt

lon lon

log on ,so clog command is valid

lon
clog clog [filter] -s file

output the whole running code.

clog -s c.txt

clog a.cpp -s d.txt

clog -e b.cpp -s d.txt

clog a.cpp : 6433 -s c.txt

(6433 is function header)

loff loff

log off ,clog command is invalid

loff
func func [filter] [-s file]

output the latest functions sequence

func

func -s b.txt

func a.c -s b.txt

bins bins <file : no>

insert break point

bins a.cpp : 2149

bins [02149][a.cpp]

bdel bdel <no#>

delete a break point

bdel 1
blist blist

list all break points

blist
F7 F7

trace step by step

F7
F8 F8

each step must in a function

F8
F9 F9

next step isn't in current function

F9
pv pv

list all unreleased resources assigned in [PV_FUNCTION] .

list all unfree pointers ( malloc, free),(new,delete)

pv
kadd kadd <file : no >

add a key pointer, the process will interrupt if key pointer released. 

 
kdel kdel <no#>

delete a key pointer. 

 

kdel 1
klist  klist

show all key pointers

 

klist
vlog vlog <-s file> 

output value change log.

watch(var_name,v_addr,v_len) set variable in code.

vlog -s a.txt
timeon timeon

code time-used statistics switch on. clog command shows the used time.

[00008][hello.java](00054) subc x = new subc();
[00009][hello.java](00000) x.add( 21, 3725 );

new subc() used 54 time pieces. x.add(21,3725) used a few time.

timeon
timeoff timeoff

code time-used statistics switch off

timeoff
load load <file>

load old or other pc BTR debug information file

load /home/usr/bak/btrdbg.pkg

load d:\BTR\demo\win\cs\btrdbg.pkg

load d:\a.pkg

startpage start BTR web server

bd.exe start web to edit code tree or look help document.

http://127.0.0.1/btrcode.html edit code tree.

http://127.0.0.1/help/userguide.htm see help document.

In linux, startpage cmd need root privilege run bd.exe.

BTRweb.exe can alse start web.

 

startpage
stoppage stop BTR web server

use shutdown also stop web in BTRweb.exe 

stoppage

 

Copyright (C) btrue software technology co.,ltd.

 

 

BTR plugin api 

    

 

function Usage and descript Example
bprint() Output string message to BTR

C C++:

bprint( const char *message );

 

Java:

bdg.bprint( String message );

 

C#:

bdg.bprint( string message );

 

C C++:

sprintf( s , "%d" , i );

bprint( s );

 

Java:

z = x + y;
s = "" + z;

bdg.bprint( s );

C#:

bdg.bprint( "IUnknown" );

 

bwatch() Trace variable value

C++:

bwatch( const char *var_name , void *addr , int data_len );

 

bd>F2

bd>vlog -s x.txt 

( see x.txt to see the value and code line history )

 

Java:

No support

 

C#:

No support

b=(char *)malloc(64);

int i = 0;

//open to trace

bwatch("V1",b, 32 );

bwatch("V2",&i, 32 );

p = b;

while( i < 3 ){

strcpy( p , "ABC" );

i++;

p++;

strcat( p , "def");

p += 2;

*p++ = ( char )i;

}

//close trace

bwatch("V2",NULL, NULL );

bwatch("V1",NULL, NULL );

free( b );

 

Copyright (C) btrue software technology co.,ltd.

 

 

BTR version

    

        There are 2 BTR versions: 

        Free version is only used peronally for non-commercial field. Because of no accelerator , it debug large projects very slowly .

        Enterprise version is used in commercial field. User who use this version must purchase it first. 

        Free version has no server . The install of free version is simple.

        Enterprise version has client and server. Client is bd.exe . Server is bdee.exe.

        The installation of server needs serial key , install key, active key. User must set the host name correctly before installation bdee.exe.

        The installation of client is the same as free version.

 

 

Download enterprise version( no money )

 

    Company can download Enterprise version from www.btrue.com.cn to only have a try without pay any money , but it can run only in a few months .

    1.Download Enterprise version from www.btrue.com.cn, you will install it very smoothly. It generate install.ini file. Email install.ini to us before you get active-key. The BTR client num only assigned 1 when you download from www.btrue.com.cn. The BTR server hostname need not assign.

    2.  Company must email the following information to us before get a client_num >= 10 enterprise version package. 

Company:  
Address :   
Postcode:  
Email    :  
Install BTR server PC name:  
BTR client number: >=10
Company telephone  ( no mobilephone) :     
Contact person name:  
Contact person ext telephone(no mobilephone ):  
Date:  

    3.  Our engineer will sent back the enterprise version package and serial no rapidly.

    4.  Install the  enterprise version package , get the BTR server install key in setup\install.ini.

    5.  Email the BTR server install.ini key to us. ( not BTR client install key ), the email include the following information:

Company:  
Address :   
Postcode:  
Email    :  
Install BTR server PC name:  
BTR client number: >=10
Company telephone  ( no mobilephone) :     
Contact person name:  
Contact person ext telephone(no mobilephone ):  
Serial no:  
Install key:  
Date:  

    6.  Our engineer will sent back the active key rapidly. 

    7.  Fill setup\install.ini with the active key in BTR server. 

    8.  You can use BTR to debug or test the large project now.

 

 

 

 

BTR  document

            

      The help directory is : .\home\help. The document are html files.

      If you use BTR in windows platform , double click userguide.htm to learn how to use the debugger.

      If you use BTR in linux platform , use BTRweb.exe to study the help document. Port 80 needs root privilege, please run BTRweb.exe with root account.

      If your operation system has already start www server , close it first.

      BTR web server occupy so much resource that you must close BTR web server after you need not use it.

      If you find disordered characters in browser, please set UTF character set. 

      1) Start the web server :

      ./BTRweb.exe

      2) Use mozilla brower , visit url:

      http://127.0.0.1/help/userguide.htm

      3) Close the www server.

      BTRweb > shutdown

      BTR document solution can also browser your code tree. It will help you find your code quickly. You can modify , find , replace in the whole code tree.

      1) Start the web server:

      ./BTRweb.exe

      2) Use mozilla brower , visit url:

      http://127.0.0.1/btrcode.html

      3) In  "Project path" field , input your code project path.

      /home/usr/BTR/demo/...

      Then click "Load" button to load them.

      4) Click one code file link, it will show in main content windows.

      5) Do find , modify , replace operation.

      6) Quit  mozilla brower.

      7) Close the www server.

      BTRweb > shutdown

 

Contact with us 


 

Company: Chongqing btrue software technology co., ltd. 
   
Web site: www.btrue.com.cn
   
Address :  Shi qiao pu nanhua street 701#B2-9-8,  High and new technology development zone of Chongqing , China.
   
Email    : btrue@163.net
   
TEL       :     023-68935745
   
Postcode: 400039

   

 

Company: 重庆比纯软件科技有限公司 
   
Web site: www.btrue.com.cn
   
Address :  重庆市高新技术开发区石桥铺南华街701#B2-9-8
   
Email    : btrue@163.net
   
TEL       :     023-68935745
   
Postcode: 400039