.\".\" Copyright 1987-1996 Sun Microsystems, Inc.
.\" @(#)bcheck.1 1.16 96/09/04 SMI; 
.TH BCHECK 1 "09/04/96"
.SH NAME
bcheck \- batch utility for Runtime Checking (RTC)
.SH SYNOPSIS
.B bcheck
[
.BR "\-access \||"
.BR "\-all \||"
.BR "\-leaks \||"
.BR "\-memuse"
]
[
.BI \-o " logfile"
]
[
.BI \-q
]
[
.BI \-s " script"
]
.I "program" 
[
.I args
]
.LP
.SH DESCRIPTION
.IX "runtime" "error" "" ""
.IX "checking" "error" "" ""
.IX  "programming tools" "dbx" "" "\fLdbx\fP \(em source debugger"
.LP
.B bcheck 
, a batch interface to dbx's Runtime Checking (RTC), is a shell script which runs the
.I program
under
.BR dbx ,
with any specified
.IR args . 
The RTC error output is placed in the specified
.IR logfile ,
or the default file
.IB program .errs .
If this file already exists, its contents are overwritten.
Although
.B bcheck 
can perform memory leak checking, memory access checking, 
memory use checking or all three, the default is to perform leak checking only.
.SH OPTIONS
.TP
.B \-access
Perform memory access checking. (SPARC only)
.TP
.B \-all
Perform memory access and memory leak checking. (SPARC only)
.TP
.B \-leaks
Perform memory leak checking only. (Default)
.TP
.B \-memuse
Perform memory use checking, which includes memory leaks checking.
.TP
.BI \-o " logfile"
Place the error output in 
.IR logfile .
or the default file
.IB program .errs\fR.
.TP
.BI \-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.
.TP
.BI \-s " script"
Read in the 
.B dbx
commands contained in
.IR script 
before execution. Using commands like 
.B suppress 
and
.B dbxenv 
, you can tailor the error output of 
.IR bcheck .
.SH EXAMPLES
.LP
Perform leaks checking on
.BR hello :
.IP
.B bcheck hello
.LP
Perform access checking on 
.B mach
with the argument 
.IR 5  
(SPARC only):
.IP
.B bcheck -access mach 5
.LP
Perform access and memuse checking on 'cc' quietly and exit with normal exit status:
.BR 
.IP
.B bcheck -all -q cc -c prog.c
.LP
Perform access checking on 
.BR foo , 
suppressing all 
.B rui
errors (SPARC only):
.BR 
.IP
.B echo "suppress rui" > foo.sup
.B bcheck -access -s foo.sup foo 1 2 3
.LP
.SH "SEE ALSO"
.BR dbx (1)