BCHECK(1)

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.

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 2 3

SEE ALSO
dbx(1)