Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ dg_ipc_info(2) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                           dgipcinfo(2)



        _________________________________________________________________
        dgipcinfo                                           System Call
        Get information about IPCs - Static and current state.
        _________________________________________________________________


        SYNTAX

        int              dg_ipc_info  (cmd, ipc_component, buffer_ptr)
        int             cmd;
        int             ipc_component;
        char            *buffer_ptr;


        PARAMETERS

        cmd            A command to identify the kind of information
                       desired.


        ipc_component  Identifies the component of the IPC facility i.e.,
                       shared memory, message queues, or semaphores.


        buffer_ptr     Pointer to a user buffer for returned info.


        DESCRIPTION

        This system call returns information about the current and static
        (configured) states of the IPC components - shared memory,
        message queues, and semaphores, as selected by <ipc_component>.

        If <cmd> is IPC_STATIC_INFO, the configured parameters of the
        particular component are returned.  If <cmd> is IPC_CURRENT_INFO,
        the contents of all the currently valid user-visible data
        structures are returned.


        ACCESS CONTROL

        None.


        RETURN VALUE

        0              A successful IPC_STATIC_INFO call.


        integer        A successful IPC_CURRENT_INFO call returns the
                       number of currently valid user-visible data



        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)





                                                           dgipcinfo(2)



                       structures contained in the user buffer.


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


        EXCEPTIONS

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


        EINVAL         Invalid argument - <cmd> is neither
                       IPC_STATIC_INFO nor IPC_CURRENT_INFO.


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


        EFAULT         <buffer_ptr> is an invalid address.


        SEE ALSO

        The related system calls:  exec, shmop, ulimit.





























        DG/UX 4.00                                                 Page 2
               Licensed material--property of copyright holder(s)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026