Man Page 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