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;

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.