crcopy Kernel Service
Purpose
Copies a credentials structure to a new one and frees the old one.
Syntax
#include <sys/cred.h>
struct ucred * crcopy ( cr)
struct ucred * cr;
struct ucred * cr;
Parameter
| Item | Description |
|---|---|
| cr | Pointer to the credentials structure that is to be copied and then freed. |
Description
The crcopy kernel service allocates a new credentials structure that is initialized from the contents of the cr parameter. The reference to cr is then freed and a pointer to the new structure returned to the caller.
Note: The cr parameter
must have been obtained by an earlier call to the crcopy kernel
service, crdup kernel service, crget kernel service,
or the crref kernel service.
Execution Environment
The crcopy kernel service can be called from the process environment only.
Return Values
| Item | Description |
|---|---|
| Nonzero value | A pointer to a newly allocated and initialized credentials structure. |
| Zero value | An error occurred when the kernel service was attempting to allocate pinned memory for the credentials structure. |