dg_vm_process_info(2)             SDK R4.11            dg_vm_process_info(2)


NAME
       dg_vm_process_info - get virtual memory information about processes

SYNOPSIS
       #include <sys/dg_vm_process_info.h>

       int    dg_vm_process_info (
              selector,
              selector_value,
              key_ptr,
              buffer_ptr,
              version)
       long   selector;
       long   selector_value;
       long   * key_ptr;
       struct dg_vm_process_info * buffer_ptr;
       long   version;

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

       selector_value      A value for the select condition above

       key_ptr             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

       buffer_ptr          A pointer to a buffer of structure
                           dg_vm_process_info 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 dg_vm_process_info 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
       There are no checks for access control.  All users can access this
       system call.

RETURN VALUE
       1      Successful search, but not done.  The buffer was filled with
              information about a process.  key_ptr 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 key_ptr argument specifies a bad address

       EFAULT    The buffer_ptr argument specifies a bad address

SEE ALSO
       killall(1M), dg_process_info(2), dg_sys_info(2), fork(2), vfork(2).


Licensed material--property of copyright holder(s)