Technical Reference: Kernel and Subsystems, Volume 1

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

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

Nonzero value

A pointer to a newly allocated and initialized credentials structure.

Related Information

Security Kernel Services in AIX 5L Version 5.2 Kernel Extensions and Device Support Programming Concepts.