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)

debugger(1)

RTC_PATCH_AREA(1)  —  USER COMMANDS

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 a tool 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 the user’s program to add patch area space to 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 8000000 if size is not supplied.  The name of the resulting object file (or shared library) will be written to the standard output.  One of the -o or -so options must be used. 

OPTIONS

−so sharedlibname
Specify the name of the shared library to be created. This name is then written to the standard output.

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

−size size
Create a patch area of size bytes (default and reasonable maximum is 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), debugger(1), the dbx help command (‘help rtc8M’), and Debugging a Program. 

Sun Release 4.1  —  Last change: 07 Jul 1994

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