kwpar_getrootpath Kernel Service
Purpose
Returns the root path of the workload partition associated with the requested ID.
Syntax
#include<sys/wparid.h>
int kwpar_getrootpath(kcid, length, buffer)
cid_t kcid;
size_t * length;
char * buffer;
Description
Get the root path of the workload partition associated with the kcid parameter and copy it to the output buffer. On entry, the value specified for the length parameter indicates the size of the output buffer. On return, the value specified for the length parameter, contains the size of the root path. If the value for the length parameter on entry is smaller than the actual path length, then ENOSPC is returned. Then, the length parameter is set to the actual length of the root path.
Parameters
| Item | Description |
|---|---|
| kcid | Specifies the workload partition ID. |
| length | Specifies the maximum number of bytes to return. |
| buffer | Points to the buffer where the workload partition root path will be stored. |
Execution Environment
Process environment only.
Return Values
| Item | Description |
|---|---|
| 0 | The command completed successfully. |
| EINVAL | Error indicating that buffer is NULL, length is NULL, or *length is 0. |
| ENOENT | Invalid WPAR ID specified for the kcid parameter. |
| ENOSPC | Insufficient space in buffer to copy path. |