1*9e39c5baSBill Taylor /*
2*9e39c5baSBill Taylor * CDDL HEADER START
3*9e39c5baSBill Taylor *
4*9e39c5baSBill Taylor * The contents of this file are subject to the terms of the
5*9e39c5baSBill Taylor * Common Development and Distribution License (the "License").
6*9e39c5baSBill Taylor * You may not use this file except in compliance with the License.
7*9e39c5baSBill Taylor *
8*9e39c5baSBill Taylor * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9*9e39c5baSBill Taylor * or http://www.opensolaris.org/os/licensing.
10*9e39c5baSBill Taylor * See the License for the specific language governing permissions
11*9e39c5baSBill Taylor * and limitations under the License.
12*9e39c5baSBill Taylor *
13*9e39c5baSBill Taylor * When distributing Covered Code, include this CDDL HEADER in each
14*9e39c5baSBill Taylor * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15*9e39c5baSBill Taylor * If applicable, add the following below this CDDL HEADER, with the
16*9e39c5baSBill Taylor * fields enclosed by brackets "[]" replaced with your own identifying
17*9e39c5baSBill Taylor * information: Portions Copyright [yyyy] [name of copyright owner]
18*9e39c5baSBill Taylor *
19*9e39c5baSBill Taylor * CDDL HEADER END
20*9e39c5baSBill Taylor */
21*9e39c5baSBill Taylor
22*9e39c5baSBill Taylor /*
23*9e39c5baSBill Taylor * Copyright (c) 2002-2003, Network Appliance, Inc. All rights reserved.
24*9e39c5baSBill Taylor */
25*9e39c5baSBill Taylor
26*9e39c5baSBill Taylor /*
27*9e39c5baSBill Taylor * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
28*9e39c5baSBill Taylor * Use is subject to license terms.
29*9e39c5baSBill Taylor */
30*9e39c5baSBill Taylor
31*9e39c5baSBill Taylor /*
32*9e39c5baSBill Taylor *
33*9e39c5baSBill Taylor * MODULE: dapl_cno_util.c
34*9e39c5baSBill Taylor *
35*9e39c5baSBill Taylor * PURPOSE: Manage CNO Info structure
36*9e39c5baSBill Taylor *
37*9e39c5baSBill Taylor * $Id: dapl_cno_util.c,v 1.6 2003/06/13 12:21:02 sjs2 Exp $
38*9e39c5baSBill Taylor */
39*9e39c5baSBill Taylor
40*9e39c5baSBill Taylor #include "dapl_ia_util.h"
41*9e39c5baSBill Taylor #include "dapl_cno_util.h"
42*9e39c5baSBill Taylor #include "dapl_adapter_util.h"
43*9e39c5baSBill Taylor
44*9e39c5baSBill Taylor
45*9e39c5baSBill Taylor
46*9e39c5baSBill Taylor /*
47*9e39c5baSBill Taylor * dapl_cno_alloc
48*9e39c5baSBill Taylor *
49*9e39c5baSBill Taylor * alloc and initialize an EVD struct
50*9e39c5baSBill Taylor *
51*9e39c5baSBill Taylor * Input:
52*9e39c5baSBill Taylor * ia
53*9e39c5baSBill Taylor *
54*9e39c5baSBill Taylor * Returns:
55*9e39c5baSBill Taylor * cno_ptr, or null on failure.
56*9e39c5baSBill Taylor */
57*9e39c5baSBill Taylor DAPL_CNO *
dapl_cno_alloc(IN DAPL_IA * ia_ptr,IN DAT_OS_WAIT_PROXY_AGENT wait_agent)58*9e39c5baSBill Taylor dapl_cno_alloc(
59*9e39c5baSBill Taylor IN DAPL_IA *ia_ptr,
60*9e39c5baSBill Taylor IN DAT_OS_WAIT_PROXY_AGENT wait_agent)
61*9e39c5baSBill Taylor {
62*9e39c5baSBill Taylor DAPL_CNO *cno_ptr;
63*9e39c5baSBill Taylor
64*9e39c5baSBill Taylor cno_ptr = (DAPL_CNO *) dapl_os_alloc(sizeof (DAPL_CNO));
65*9e39c5baSBill Taylor if (!cno_ptr) {
66*9e39c5baSBill Taylor return (NULL);
67*9e39c5baSBill Taylor }
68*9e39c5baSBill Taylor
69*9e39c5baSBill Taylor /* zero the structure */
70*9e39c5baSBill Taylor (void) dapl_os_memzero(cno_ptr, sizeof (DAPL_CNO));
71*9e39c5baSBill Taylor
72*9e39c5baSBill Taylor /*
73*9e39c5baSBill Taylor * Initialize the header.
74*9e39c5baSBill Taylor */
75*9e39c5baSBill Taylor cno_ptr->header.provider = ia_ptr->header.provider;
76*9e39c5baSBill Taylor cno_ptr->header.magic = DAPL_MAGIC_CNO;
77*9e39c5baSBill Taylor cno_ptr->header.handle_type = DAT_HANDLE_TYPE_CNO;
78*9e39c5baSBill Taylor cno_ptr->header.owner_ia = ia_ptr;
79*9e39c5baSBill Taylor cno_ptr->header.user_context.as_64 = 0;
80*9e39c5baSBill Taylor cno_ptr->header.user_context.as_ptr = NULL;
81*9e39c5baSBill Taylor dapl_llist_init_entry(&cno_ptr->header.ia_list_entry);
82*9e39c5baSBill Taylor dapl_llist_init_head(&cno_ptr->evd_list_head);
83*9e39c5baSBill Taylor dapl_os_lock_init(&cno_ptr->header.lock);
84*9e39c5baSBill Taylor
85*9e39c5baSBill Taylor /*
86*9e39c5baSBill Taylor * Initialize the body
87*9e39c5baSBill Taylor */
88*9e39c5baSBill Taylor cno_ptr->cno_waiters = 0;
89*9e39c5baSBill Taylor cno_ptr->cno_ref_count = 0;
90*9e39c5baSBill Taylor cno_ptr->cno_state = DAPL_CNO_STATE_UNTRIGGERED;
91*9e39c5baSBill Taylor cno_ptr->cno_evd_triggered = NULL;
92*9e39c5baSBill Taylor cno_ptr->cno_wait_agent = wait_agent;
93*9e39c5baSBill Taylor (void) dapl_os_wait_object_init(&cno_ptr->cno_wait_object);
94*9e39c5baSBill Taylor
95*9e39c5baSBill Taylor return (cno_ptr);
96*9e39c5baSBill Taylor }
97*9e39c5baSBill Taylor
98*9e39c5baSBill Taylor /*
99*9e39c5baSBill Taylor * dapl_cno_dealloc
100*9e39c5baSBill Taylor *
101*9e39c5baSBill Taylor * Free the passed in CNO structure.
102*9e39c5baSBill Taylor *
103*9e39c5baSBill Taylor * Input:
104*9e39c5baSBill Taylor * cno_ptr
105*9e39c5baSBill Taylor *
106*9e39c5baSBill Taylor * Output:
107*9e39c5baSBill Taylor * none
108*9e39c5baSBill Taylor *
109*9e39c5baSBill Taylor * Returns:
110*9e39c5baSBill Taylor * none
111*9e39c5baSBill Taylor *
112*9e39c5baSBill Taylor */
113*9e39c5baSBill Taylor void
dapl_cno_dealloc(IN DAPL_CNO * cno_ptr)114*9e39c5baSBill Taylor dapl_cno_dealloc(
115*9e39c5baSBill Taylor IN DAPL_CNO *cno_ptr)
116*9e39c5baSBill Taylor {
117*9e39c5baSBill Taylor dapl_os_assert(cno_ptr->header.magic == DAPL_MAGIC_CNO);
118*9e39c5baSBill Taylor dapl_os_assert(cno_ptr->cno_ref_count == 0);
119*9e39c5baSBill Taylor
120*9e39c5baSBill Taylor /*
121*9e39c5baSBill Taylor * deinitialize the header
122*9e39c5baSBill Taylor */
123*9e39c5baSBill Taylor /* reset magic to prevent reuse */
124*9e39c5baSBill Taylor cno_ptr->header.magic = DAPL_MAGIC_INVALID;
125*9e39c5baSBill Taylor
126*9e39c5baSBill Taylor (void) dapl_os_wait_object_destroy(&cno_ptr->cno_wait_object);
127*9e39c5baSBill Taylor dapl_os_free(cno_ptr, sizeof (DAPL_CNO));
128*9e39c5baSBill Taylor }
129*9e39c5baSBill Taylor
130*9e39c5baSBill Taylor /*
131*9e39c5baSBill Taylor * dapl_cno_trigger
132*9e39c5baSBill Taylor *
133*9e39c5baSBill Taylor * DAPL Internal routine to trigger the specified CNO.
134*9e39c5baSBill Taylor * Called by the callback of some EVD associated with the CNO.
135*9e39c5baSBill Taylor *
136*9e39c5baSBill Taylor * Input:
137*9e39c5baSBill Taylor * cno_ptr
138*9e39c5baSBill Taylor * evd_ptr EVD triggering
139*9e39c5baSBill Taylor *
140*9e39c5baSBill Taylor * Output:
141*9e39c5baSBill Taylor * None
142*9e39c5baSBill Taylor *
143*9e39c5baSBill Taylor * Returns:
144*9e39c5baSBill Taylor * None
145*9e39c5baSBill Taylor */
146*9e39c5baSBill Taylor void
dapl_cno_trigger(IN DAPL_CNO * cno_ptr,IN DAPL_EVD * evd_ptr)147*9e39c5baSBill Taylor dapl_cno_trigger(
148*9e39c5baSBill Taylor IN DAPL_CNO *cno_ptr,
149*9e39c5baSBill Taylor IN DAPL_EVD *evd_ptr) /* ARGSUSED */
150*9e39c5baSBill Taylor {
151*9e39c5baSBill Taylor /*
152*9e39c5baSBill Taylor * In Solaris uDAPL the CNO is triggered in the kernel
153*9e39c5baSBill Taylor */
154*9e39c5baSBill Taylor }
155