CLEANRL [ HP Link Editor/XL Reference Manual ] MPE/iX 5.0 Documentation
HP Link Editor/XL Reference Manual
CLEANRL
This command eliminates fragmentation that may exist in a relocatable
library file.
Although relocatable libraries can expand in size, expansion beyond a
certain point fragments the Library Symbol Table (so access to that
library is slower). The CLEANRL command rebuilds the library, while
allocating sufficient space in the library's internal tables for
expansion. Thus, you can use this command to allocate more space for a
full relocatable library or to conserve disc space by reducing the size
of a partially-filled library.
Syntax
CLEANRL [RL= rl_file]
[;COMPACT]
[;LIMIT= max_modules]
Parameters
rl_file Names an existing relocatable library. The file must
have an NMRL filecode. If the relocatable library
does not exist, an error results. Default: the
current relocatable library established by the last
BUILDRL or RL command.
COMPACT Removes fragmentation and reduces the internal tables
of the relocatable library to the minimum size that
will accommodate the current contents of the library.
Using this parameter does not restrict future use of
the library. Default: fragmentation of the internal
tables is removed. A pre-determined amount of space
is allocated for future expansion.
max_modules Specifies a new limit for the maximum number of
relocatable object modules within the library.
Example
LinkEd> CLEANRL BOXDRAW
This command rebuilds the relocatable library BOXDRAW and restructures
its library symbol table so the table can hold more symbols than it
currently stores.
MPE/iX 5.0 Documentation