LDI_IDENT_FROM_DEV(9F) Kernel Functions for Drivers LDI_IDENT_FROM_DEV(9F)

NAME

ldi_ident_from_dev, ldi_ident_from_stream, ldi_ident_from_dip,
ldi_ident_release - ldi cookie management

SYNOPSIS

#include <sys/sunldi.h>

int ldi_ident_from_dip(dev_info_t *dip, ldi_ident_t *lip);


int ldi_ident_from_dev(dev_t dev, ldi_ident_t *lip);


int ldi_ident_from_stream(struct queue *sq, ldi_ident_t *lip);


void ldi_ident_release(ldi_ident_t li);

PARAMETERS

li
ldi identifier


lip
ldi identifier pointer


dip
pointer to device info node


dev
device number


sq
pointer to a stream queue

DESCRIPTION

The ldi_ident_from_dev() function allocates and returns an ldi
identifier that is associated with the device number specified by
dev. The new ldi identifier is returned in the ldi identifier
pointer parameter lip.


The ldi_ident_from_dip() function allocates and returns an ldi
identifier that is associated with the device info node pointed to by
dip. The new ldi identifier is returned in the ldi identifier
pointer parameter lip.


The ldi_ident_from_stream() function allocates and returns an ldi
identifier that is associated with the stream pointed to by queue.
The new ldi identifier is returned in the ldi identifier pointer
parameter lip.


The ldi_ident_release() function releases an identifier that was
allocated by one of the ldi_ident_from_*() functions.

RETURN VALUES

The ldi_ident_from_dev(), ldi_ident_from_dip(), and
ldi_ident_from_stream() functions return 0 upon success.


All of these functions return EINVAL for invalid input parameters.

CONTEXT

These functions can be called from user or kernel context.

March 26, 2009 LDI_IDENT_FROM_DEV(9F)