kwpar_unregdevno Kernel Service

Purpose

Unregisters the mapping associated with a real device number for a given workload partition (WPAR).

Syntax

#include <sys/wparid.h>

int kwpar_unregdevno ( wparid, rdevno)
cid_t wparid;
dev_t rdevno;

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:

  1. 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.
  2. 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.