Maps a virtual process ID associated with a process within a workload partition to the equivalent real process ID.
| Item | Description |
|---|---|
| kcid | The workload partition (WPAR) ID associated with the vpid parameter. Equivalent virtual process IDs can be in use across different processes in different WPARs. Thus the caller must provide the WPAR ID for which a virtual to real mapping is to occur. |
| vpid | The virtual process ID on which to perform a virtual to real mapping. |
The kwpar_v2rmap_pid kernel service provides a mapping from a virtual process ID associated with a process in a workload partition to the equivalent real process ID. In most instances, both the real and virtual process IDs are the same, except in cases where the Workload Partition Mobility is in effect.
Normally, kernel services dealing with process IDs accept only real thread IDs. In some instances where a kernel extension is communicating with other WPAR services or with processes within the WPAR, a mapping from virtual to real process IDs might be needed.
The kwpar_v2rmap_pid kernel service can be called from the process environment only.
If the kwpar_v2rmap_pid kernel service succeeds, it returns the real pid_t value associated with the vpid value provided on input. If the kernel service fails, or if there is no real thread ID associated with the vpid value, then the vpid value is returned.