NAME
bcheck - batch utility for Runtime Checking (RTC)
SYNOPSIS
bcheck [ -access | -all | -leaks | -memuse ] [ -o logfile ]
[ -q ] [ -s script ] program [ args ]
DESCRIPTION
bcheck , a batch interface to dbx's Runtime Checking (RTC),
is a shell script which runs the program under dbx, with any
specified args. The RTC error output is placed in the
specified logfile, or the default file program.errs. If
this file already exists, its contents are overwritten.
Although bcheck can perform memory leak checking, memory
access checking, memory use checking or all three, the
default is to perform leak checking only.
bcheck cannot perform memory access checking if you are run-
ning the Solaris OS on x86 based systems or s64 based sys-
tems, or on the Linux OS on x86 based systems or x64 based
systems.
Before running bcheck on a system running the Linux OS, you
must set the _DBX_EXEC_32 environment variable.
OPTIONS
-access
Perform memory access checking. (SPARC only)
-all Perform memory access and memory leak checking. (SPARC
only)
-leaks
Perform memory leak checking only. (Default)
-memuse
Perform memory use checking, which includes memory
leaks checking.
-o logfile
Place the error output in logfile. or the default file
program.errs.
-q Make bcheck completely quiet, and return with the same
exit status as the 'program'. Useful when you want to
use bcheck in scripts, makefiles, and such.
-s script
Read in the dbx commands contained in script before
execution. Using commands like suppress and dbxenv ,
you can tailor the error output of bcheck.
EXAMPLES
Perform leaks checking on hello:
bcheck hello
Perform access checking on mach with the argument 5 (SPARC
only):
bcheck -access mach 5
Perform access and memuse checking on 'cc' quietly and exit
with normal exit status:
bcheck -all -q 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
SEE ALSO
dbx(1)