te
 Copyright (c) 2009, Sun Microsystems, Inc., All Rights Reserved
 The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
 See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
 the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
 LDI_IDENT_FROM_DEV 9F "Mar 26, 2009"
 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.