DP_XMATT(2-N)              SYSTEM CALLS             DP_XMATT(2-N)


NAME
     dp_xmatt -- attach a global memory region


SYNOPSIS
     #include <sys/mppg.h>

     void *dp_xmatt(pid_t pid, void *addr, void *laddr);


DESCRIPTION
     dp_xmatt  attaches a global memory region in another process
     into the process virtual space of the calling process.   The
     calling process and the specified process must belong to the
     same logical node and the same MPPG.

     pid specifies the process ID of the  process  that  has  the
     target global memory region.

     addr is the start address of the global memory region on the
     process's process virtual space.

     laddr specifies an attaching address on the process  virtual
     space of the calling process.  When laddr is equal to 0, the
     attaching address is selected by the system.

     The calling process must be a large page process.

     dp_xmatt fails if one or more of the following are true:

     [EINVAL]   The calling process does not belong to an MPPG.

     [EINVAL]   The calling process is a small page process.

     [EINVAL]   addr is not a start address of  a  global  memory
                region.

     [EINVAL]   laddr is an illegal address.

     [EINVAL]   The area that specified with laddr is not allowed
                by the system.

     [EINVAL]   The area that specified  with  laddr  is  already
                used.

     [ESRCH]    No  process  can  be  found corresponding to that
                specified by pid.

     [ENOMEM]   The process requires more memory than is  allowed
                by  the  system-imposed  maximum  process virtual
                space.

     [ENOMEM]   The new process requires  more  memory  than  the
                per-process/per-job  usable  maximum memory size.



SUPER-UX            Last change: Oct 13, 1999                   1





DP_XMATT(2-N)              SYSTEM CALLS             DP_XMATT(2-N)


                See setrlimit(2).

SEE ALSO
     dp_create(2),   dp_join(2),    dp_exit(2),    dp_xmalloc(2),
     dp_xmfree(2),  dp_xmshare(2), dp_cntl(2),
     dp_kill(2), dp_resume(2)
     Global Memory in the SUPER-UX Programmer's Guide
     Memory Layout in the SUPER-UX User's Guide

DIAGNOSTICS
     Upon  successful  completion,  dp_xmatt  returns  the  start
     address of the global memory region on the calling process's
     process virtual space.  Otherwise, a value of -1 is returned
     and errno is set to indicate the error.











































SUPER-UX            Last change: Oct 13, 1999                   2