RTC_PATCH_AREA(1)

NAME
rtc_patch_area - patch area utility for Runtime Checking (SPARC only)

SYNOPSIS
rtc_patch_area [ -so sharedlibname ] [ -o objectname ] [ -size size ] [ -cc compiler ]

DESCRIPTION

rtc_patch_area is used with the Runtime Checking (RTC) feature of dbx(1). It is a shell script which creates object files or shared library files that can be linked into your program to add patch area space for programs with large text, data, or bss images. The object file or shared library created contains one RTC patch area of the specified size or the default size of 8,000,000. The name of the resulting object file or shared library is written to the standard output. One of the -o or -so options must be used. Since RTC access checking is only available on SPARC, this utility should only be used on SPARC.

OPTIONS

-so sharedlibname
    Specify the name of the shared library to be created, which is written to the standard output.

-o objectname
    Specify the name of the object file to be created, which is then written to the standard output. If the -so option was used and -o was not used the default is a name in /tmp based on the LOGNAME environment variable.

-size size
    Create a patch area of size bytes with the default and reasonable maximum being 8000000.

-cc compiler
    Use compiler instead of cc or acc to build the object file.

EXAMPLES

Generate a standard 8Mb patch area object file:

    rtc_patch_area -o patch.o

Generate an object file containing a 100,000 byte patch:

    rtc_patch_area -size 100000 -o patch.o

Generate a 1Mb patch area shared library:

    rtc_patch_area -so rtc1M.so -size 1000000

ENVIRONMENT

Assumes LOGNAME contains the login name.

SEE ALSO
dbx(1), workshop(1), the dbx help command help rtc8M