Man Page rtc_patch_area.1




NAME

     rtc_patch_area - patch area utility for Runtime Checking


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.


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),, the dbx help command help	rtc8M