ms_fw_file(A) — Apollo Domain/OS SR10.4.1

MS_$FW_FILE                       Domain/OS                        MS_$FW_FILE


NAME
     ms_$fw_file - synchronize a mapped object with the file system

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

     void ms_$fw_file(
          void *&address,
          status_$t *status)

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

     procedure ms_$fw_file(
         in address:  univ_ptr;
         out status: status_$t);

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

           integer*4 status

           integer*4 address, dummy
           pointer /address/ dummy

           call ms_$fw_file(address, status)

DESCRIPTION
     After ms_$fw_file returns, the file system object in permanent storage
     mapped at address exactly reflects the mapped image of the object.  A
     successful return means that the object's image in storage reflects the
     state of any portions of the object mapped by the process making the
     call.

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

     address
          A pointer to a mapped portion of the object to synchronize.

     status
          The completion status.

NOTES
     Ms_$fw_file updates the entire file system object with changes made to
     all mapped portions of the object.  To partially synchronize an object,
     use ms_$fw_partial.
Museum
