Museum

MS_$FW_PARTIAL                    Domain/OS                     MS_$FW_PARTIAL


NAME
     ms_$fw_partial - partially synchronize a mapped object with the file sys-
     tem

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/ms.h>

     void ms_$fw_partial(
          void *&address,
          long int &length,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/ms.ins.pas';

     procedure ms_$fw_partial(
          in address:  univ_ptr;
          in length: integer32;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/ms.ins.ftn'

           integer*4 status, length

           integer*4 address, dummy
           pointer /address/ dummy

           call ms_$fw_file(address, length, status)

DESCRIPTION
     After ms_$fw_partial returns, the file system object in permanent storage
     exactly reflects any changes made to the portion of the object mapped at
     address.  A successful return means that changes to the portion of the
     object mapped at address are reflected in the object's image in storage.

     The system periodically synchronizes objects with their mapped images
     unless prevented by a system crash.  Use ms_$fw_partial before unmapping
     part of an object to ensure that it is stored safely in case some problem
     prevents periodic synchronization.

     address
          A pointer to the mapped portion of the object to update.

     length
          The number of bytes in the mapped portion to update.  Portions of
          the object beyond length bytes from address are not used in the
          update.  If length is larger than the number of bytes mapped at
          address, then some unmapped bytes from the object will be used in
          the update.

     status
          The completion status.

NOTES
     Ms_$fw_partial updates the stored image of the file system object with
     changes made only in the mapped portion defined by address and length.
     Use ms_$fw_file to update an entire object with changes made to all
     mapped portions of the object.