HP 3000 Manuals

CLEANXL [ HP Link Editor/XL Reference Manual ] MPE/iX 5.0 Documentation


HP Link Editor/XL Reference Manual

CLEANXL 

This command eliminates fragmentation which may exist in an executable
library.

Although executable libraries can expand in size, expansion beyond a
certain point fragments the Library Symbol Table so access to that
library becomes slower.  The CLEANXL command takes a fragmented library
and rebuilds that library, while allocating sufficient space in the
library's internal tables to allow for expansion.  You can use this
command to allocate more space for an executable library, or to conserve
disc space by reducing the size of a partially-filled library.

Syntax 

        CLEANXL [XL= xl_file]
                [;COMPACT]
                [;LIMIT= max_modules]

Parameters 

xl_file             Names an existing executable library (the file must
                    have an NMXL filecode).  If the executable library
                    does not exist, the link editor reports an error.
                    Default:  condense the current executable library
                    (established by the last BUILDXL or XL 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 that the library can
                    contain.

Example 

       LinkEd> CLEANXL XL=FILEIO

This command rebuilds the executable library FILEIO and restructures its
Library Symbol Table so the table can hold more symbols than it currently
stores.



MPE/iX 5.0 Documentation