Process Package

Function List

The Process package contains the following KPs.

  • op_pro_argmem_access() Obtains address of argument memory passed by invoking process.
  • op_pro_create() Creates a new process as an instance of the specified process model and allows for the installation of parent-to-child shared memory to serve as a communication mechanism between the current process and the created child process.
  • op_pro_destroy() Destroys a dynamically created process.
  • op_pro_destroy_options() Destroys a dynamically created process and (optionally) all outstanding events scheduled for that process.
  • op_pro_equal() Compares two process handles to determine if they are equal.
  • op_pro_id() Obtains a unique integer identifier for a process.
  • op_pro_invoke() Invokes a process in the context of the current event and current module. The calling process is suspended until this KP returns.
  • op_pro_invoker() Determines whether an active process was invoked by the Kernel (direct mode) or by another process (indirect mode). In the case of indirect mode, the process handle of the invoking process is returned.
  • op_pro_mod_objid() Obtains the object ID of the module that owns a process.
  • op_pro_modmem_access() Obtains the memory address installed via op_pro_modmem_install() for the queue or processor module that owns the currently executing process.
  • op_pro_modmem_install() Installs a memory address to be associated with the current module and which can be accessed by other processes via the KP op_pro_modmem_access().
  • op_pro_parent() Obtains a process handle for the parent of a process (i.e., the process that created the specified process).
  • op_pro_parmem_access() Obtains the address of the memory block that is shared by the current process and its parent.
  • op_pro_root() Obtains a handle for the root process of a queue or processor module, given the module’s object ID.
  • op_pro_self() Obtains a process handle for the process currently executing.
  • op_pro_svar_get() Obtains a pointer to a state variable within the specified process.
  • op_pro_tag_set() Set a descriptive tag in the process.
  • op_pro_valid() Determines if a process handle refers to a valid, existing process (i.e, the process handle is not one that has been obtained as an indication of a KP error, and the process that it refers to has not yet been destroyed).

See Package Overview for a general description of this package.