Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ rtc_patch_area(1) — Sun WorkShop 3.0.1

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

dbx(1)

workshop(1)

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

SunOS 3.0.1  —  Last change: 04 Sep 1996

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026