Returns the root path of the workload partition associated with the requested ID.
#include<sys/wparid.h>
int kwpar_getrootpath(kcid, length, buffer)
cid_t kcid;
size_t * length;
char * buffer;
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.
| 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. |
Process environment only.
| 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. |