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