Manpage of DDI_GET_CRED

DDI_GET_CRED

Section: OpenSS7 STREAMS Compatibility DDI/DKI (9)
Updated: 2008-10-31
Index Return to Main Contents

NAME

ddi_get_cred - get a reference to the credentials of the current user

SYNOPSIS

#define _SUN_SOURCE
#include <sys/streams.h>
#include <sys/ddi.h>
#include <sys/sunddi.h>

cred_t *ddi_get_cred(void);

ARGUMENTS

None.

DESCRIPTION

ddi_get_cred() returns a pointer to the cred_t(9) credentials structure associated with the current user. ddi_get_cred() is a SUNDDI specific function intended to replace drv_getparm(9). Both are a system independent way for a STREAMS driver or module to obtain a reference to the credentials structure for the current user.

RETURN

ddi_get_cred() returns a pointer to a cred_t(9) structure.

ERRORS

ddi_get_cred() always succeeds.

CONTEXT

ddi_get_cred() is valid only when called from user context. When called from another context the user for which credentials are returned are undefined.

MP-STREAMS

ddi_get_cred() is MP-safe.

NOTICES

ddi_get_cred() is a Solaris®-specific function: _SUN_SOURCE must be defined before including DDI/DKI include files to expose this symbol. OpenSS7 STREAMS Compatibility must also have been compiled with CONFIG_STREAMS_COMPAT_SUN or CONFIG_STREAMS_COMPAT_SUN_MODULE set.

ddi_get_cred() does not allocate a credentials structure but points into the current user's task_struct, which, when optimized will be inline. As such, ddi_get_cred() cannot fail due to allocation errors unlike some other implementations.

BUGS

ddi_get_cred() has no known bugs.

COMPATIBILITY

ddi_get_cred() is provided for source level compatibility with Solaris® for the purpose of porting Solaris® drivers to Linux. Because the cred_t(9) structure for Linux differs from that of Solaris®, binaries are incompatible.

See suncompat(9) for additional compatibility information.

CONFORMANCE

Solaris® SUNDDI documentation[1].

HISTORY

ddi_get_cred() first appeared in Solaris® 2.5.

REFERENCES

[1]: Solaris® 8, Solaris 8 Docmentation, 2001, (Santa Clara, California), Sun Microsystems, Inc., Sun. <http://docs.sun.com/>

TRADEMARKS

OpenSS7tm: is a trademark of OpenSS7 Corporation.
Linux®: is a registered trademark of Linus Torvalds.
UNIX®: is a registered trademark of The Open Group.
Solaris®: is a registered trademark of Sun Microsystems.

Other trademarks are the property of their respective owners.

IDENTIFICATION

OpenSS7 STREAMS Compatibility: Package strcompat version 0.9.2.7 released 2008-10-31.

Index

NAME
SYNOPSIS
ARGUMENTS
DESCRIPTION
RETURN
ERRORS
CONTEXT
MP-STREAMS
NOTICES
SEE ALSO
BUGS
COMPATIBILITY
CONFORMANCE
HISTORY
REFERENCES
TRADEMARKS
IDENTIFICATION

This document was created by man2html, using the manual pages.
Time: 05:56:54 GMT, June 20, 2013