HP 3000 Manuals

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