preload(8)                                                       preload(8)

NAME
     preload - preload and lock text into memory

SYNOPSIS
     /usr/bin/preload [filename]

     /usr/bin/preload -d [filename]

     /usr/bin/preload -l

DESCRIPTION
     preload is used to preload the text segment of binary objects linked
     with -B ptcbigpage option. Preloading a file into memory ensures that
     enough contiguous physical memory pages are allocated for the whole
     text segment, prior to executing other application files. Files that
     are preloaded into memory are locked, and will not be paged out of
     memory. System performance is improved in two ways:

     1.  There is only one TLB (Translation Lookaside Buffer) entry used to
         map the whole text segment. This TLB is locked to eliminate text
         TLB misses and consequently increase TLB hits for other memory
         segment.

     2.  The text pages are locked in the memory and thus, there are no
         paging or swapping activities on the text pages.

     The largest possible text segment that can be preloaded is 32 MB. Only
     one file can be preloaded at the present time.

OPTIONS
     -d filename
          Unload preloaded files. Preloaded files can also be unloaded by
          unmounting the file system containing the preloaded file. Both
          operations will fail if there are active processes executing that
          file.

     -l   List preloaded files.

DIAGNOSTICS
     preload returns exit code 0 if the file was preloaded or unloaded suc-
     cessfully. Otherwise, it prints a diagnostic message and returns non-
     zero.

SEE ALSO
     exec(2).










Page 1                       Reliant UNIX 5.44                Printed 11/98