dgipcinfo(2)             DG/UX 4.30              dgipcinfo(2)



     NAME
          dg_ipc_info - get information about current IPCs state

     SYNOPSIS
          #include <sys/dg_ipc_info.h>

          int  dg_ipc_info  (ipc_component, buffer_ptr, key_ptr, version)
          int            ipc_component;
          char    *      buffer_ptr;
          key_t   *      key_ptr;
          long           version;

     PARAMETERS
          ipc_component  Identifies the IPC components.  Legal values
                         are IPC_MSQ for message queues, IPC_SEM for
                         semaphores, and IPC_SHM for shared memory.

          buffer_ptr     A pointer to a user buffer for returned
                         information.  The buffer should be of struct
                         msqidds, semidds or shmidds type,
                         depending on the value of ipc_component.

          key_ptr        The value of *key_ptr should be set to
                         DG_IPC_INFO_INITIAL_KEY on the first call for
                         each IPC component.  On return, *key_ptr
                         contains a value to which *key_ptr should be
                         assigned on a subsequent call to dgipcinfo.

          version        The version of this call.  Legal value is
                         DG_IPC_INFO_VERSION_0.  See dgipcinfo.h.

     DESCRIPTION
          This is an alternative interface to /dev/kmem.  This system
          call returns information about the current state of the IPC
          components--shared memory, message queues, and semaphores,
          as selected by ipc_component.

          The dgipcinfo call searches the ipc_component data
          structures.  The first valid entry it finds is copied into
          the user buffer pointed to by buffer_ptr.  *key_ptr is
          assigned to the value that should be used by the next
          dgipcinfo call to get the next valid entry of
          ipc_component.  If no valid entry is found, the dgipcinfo
          call returns with errno set to an appropriate value.

     RETURN VALUE
          1              This value indicates a successful return of
                         information about an IPC structure, but more
                         structures may still be available.

          0              Successful completion.  This means that there
                         are no more IPC structures of type



     Licensed material--property of copyright holder(s)         Page 1

     dgipcinfo(2)             DG/UX 4.30              dgipcinfo(2)



                         ipc_component to return.  The contents of
                         buffer are undefined.

          -1             Error.  Errno is set to indicate the error.

     EXCEPTIONS
          Errno may be set to one of the following error codes:

          EINVAL         Invalid argument--ipc_component is not
                         IPC_SHM, IPC_MSQ, or IPC_SEM.

          EINVAL         Invalid argument--version is not a valid
                         version number.

          EINVAL         Invalid argument--key_ptr points to an
                         invalid index key.

          EFAULT         buffer_ptr is an invalid address.

     SEE ALSO
          exec(2), ulimit(2).


































     Licensed material--property of copyright holder(s)         Page 2