Quick View
***************************************************************************
* 法律声明
* 版权所有:重庆比纯软件科技有限公司
*
*
* 比纯调试器及其文档是重庆比纯软件科技有限公司财产。没有
* 比纯软件科技正式许可,任何个人和单位不得将产品及其文档
* 用于商业活动。
*
*
* 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.
***************************************************************************
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
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.
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(); 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.
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; 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.
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.
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
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 |