NAME

bcheck − batch utility for Runtime Checking

SYNOPSIS

bcheck [ −access | −all | −leaks ] [ −o logfile ] [ −s script ] program [ args ]

DESCRIPTION

bcheck is a batch interface to the Runtime Checking (RTC) feature of dbx(1).  It is a shell script which runs the program under dbx, with the arguments specified by args, if any. The RTC error output will be placed in logfile, if specified; otherwise the file program.errs will be used by default.  If this file already exists, its contents will be overwritten.  bcheck can perform memory leak checking, memory access checking, or both.  The default is to perform leak checking only. 

(x86)

Access checking is not available with x86; therefore, the options -access and -all are not supported. 

OPTIONS

−access
Perform memory access checking only. (SPARC only)

−all Perform both memory access checking and memory leak checking. (SPARC only)

−leaks
Perform memory leak checking only. This is the default.

−o logfile
Place the error output in logfile. Default is the file program.errs. 

−s script
Before executing the program, read in the dbx commands contained in the file script. This file typically contains commands like suppress and dbxenv to tailor the error output of bcheck.

EXAMPLES

Perform leaks checking only on hello:

bcheck hello

Perform access checking only on mach with the argument 5(SPARConly):

bcheck -access mach 5

Perform both access checking and leaks checking on cc(SPARConly):

bcheck -all cc -c prog.c

Perform access checking on foo, suppressing all rui errors (SPARC only). 

echo "suppress rui" > foo.sup
bcheck -access -s foo.sup foo 1 2 3

ENVIRONMENT

DBX If set, indicates the full pathname of the dbx to run.  Otherwise, dbx is assumed to be in the same directory as bcheck. 

SEE ALSO

dbx(1), debugger(1), and the Runtime Checking chapter of Debugging a Program

SunOS 3.0.1  —  Last change: 28 Feb 1995