dg_vm_process_info(2)          DG/UX R4.11MU05         dg_vm_process_info(2)


NAME
       dgvmprocessinfo - get virtual memory information about processes

SYNOPSIS
       #include <sys/dgvmprocessinfo.h>

       int    dgvmprocessinfo (
              selector,
              selectorvalue,
              keyptr,
              bufferptr,
              version)
       long   selector;
       long   selectorvalue;
       long   * keyptr;
       struct dgvmprocessinfo * bufferptr;
       long   version;

   where:
       selector            A condition for determining which process to
                           report information about

       selectorvalue      A value for the select condition above

       keyptr             On the first call, a pointer to a variable
                           containing the value
                           DG_VM_PROCESS_INFO_INITIAL_KEY; on return, a
                           handle that should be used on subsequent calls to
                           this system call

       bufferptr          A pointer to a buffer of structure
                           dgvmprocessinfo where the process information
                           will be returned

       version             To use the most recent version, version should be
                           set to DG_VM_PROCESS_INFO_CURRENT_VERSION.

DESCRIPTION
       The dgvmprocessinfo system call searches the process table for
       valid (non-free non-initializing) table entries and based on the
       selector determines whether or not to return information about that
       process.  Searching continues until a process is found (return value
       (1)), or until the process table is completely searched (return value
       (0)).  Only one search through the process table is made.  If a
       process exists in a particular slot in the process table when that
       slot is looked at, virtual memory information on that process will be
       returned.  If the slot is empty, no information will be returned.

ACCESS CONTROL
       On a system with MAC configured, this system call returns information
       about only those processes to which the caller has read access. There
       is no other access control on this system call.

RETURN VALUE
       1      Successful search, but not done.  The buffer was filled with
              information about a process.  keyptr is given a handle which
              subsequent calls to this routine will use to continue the
              search through the process table.

       0      Successful completion, that is, no more processes.  The
              contents of buffer are undefined.

       -1     An error occurred.  errno is set to indicate the error.

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

       EINTR     An interrupt occurred during the system call.

       EINVAL    A bad argument was passed in.

       EFAULT    The keyptr argument specifies a bad address.

       EFAULT    The bufferptr argument specifies a bad address.

SEE ALSO
       killall(1M), dgprocessinfo(2), dgsysinfo(2), fork(2), vfork(2).


Licensed material--property of copyright holder(s)