kwpar_unregdevno Kernel Service
Purpose
Unregisters the mapping associated with a real device number for a given workload partition (WPAR).
Syntax
Parameters
| Item | Description |
|---|---|
| wparid | WPAR identifier. This parameter is required. |
| rdevno | Real device number. This parameter is required. |
Description
The kwpar_unregdevno kernel service provides the ability to unregister the mapping associated with a real device number for a given WPAR. The kwpar_unregdevno kernel service will perform the following steps:
- Deletes the virtual-to-real mapping associated with the real device number specified by the rdevno parameter for the WPAR specified by the wparid parameter.
- Releases the reserve associated with the real device number specified by the rdevno parameter.
Execution Environment
The kwpar_unregdevno kernel service can be called from the process environment only.
Return Values
| Item | Description |
|---|---|
| 0 | Success. |
| non-zero | Failure. |
Error Codes
The kwpar_unregdevno kernel service fails if one or more of the following errors occur:
| Item | Description |
|---|---|
| EINVAL | Either the wparid or rdevno argument is not valid. |
| ENXIO | Unable to locate the WPAR device map associated with the given WPAR ID. |
| ESRCH | Unable to locate the mapping for the given real device number rdevno. |