SHMEM_CACHE(3)SHMEM_CACHE(3)


NAME
     shmem_clear_cache_inv, shmem_set_cache_inv, shmem_set_cache_line_inv,
     shmem_udcflush, shmem_udcflush_line - Controls data cache utilities

SYNOPSIS
     C or C++:

        #include <mpp/shmem.h>

        void shmem_clear_cache_inv(void);

        void shmem_set_cache_inv(void);

        void shmem_set_cache_line_inv(void *target);

        void shmem_udcflush(void);

        void shmem_udcflush_line(void *target);

     Fortran:

        INCLUDE "mpp/shmem.fh"

        CALL SHMEM_CLEAR_CACHE_INV

        CALL SHMEM_SET_CACHE_INV

        CALL SHMEM_SET_CACHE_LINE_INV(target)

        CALL SHMEM_UDCFLUSH

        CALL SHMEM_UDCFLUSH_LINE(target)

DESCRIPTION
     The following argument is passed to the cache line control routines:

     target    A data object that is local to the processing element (PE).
               target can be of any noncharacter type.  If you are using
               Fortran, it can be of any kind.

     shmem_set_cache_inv enables automatic cache coherency mode.

     shmem_set_cache_line_inv enables automatic cache coherency mode for
     the cache line associated with the address of target only.

     shmem_clear_cache_inv disables automatic cache coherency mode
     previously enabled by shmem_set_cache_inv or shmem_set_cache_line_inv.

     shmem_udcflush makes the entire user data cache coherent.

     shmem_udcflush_line makes coherent the cache line that corresponds
     with the address specified by target.

NOTES
     These routines have been retained for improved backward compatability
     with legacy architectures.  They are not required on IRIX or Altix
     systems, nor do they have any effect on cacheline states.

SEE ALSO
     intro_shmem(3), shmem_put(3), shmem_swap(3)

     Message Passing Toolkit: MPI Programmer's Manual