[DAPL2] DAPL Counters & 2.0.3 extensions to support counter retrieval.
[mirror/winof/.git] / ulp / dapl2 / dapl / common / dapl_pz_free.c
1 /*\r
2  * Copyright (c) 2002-2003, Network Appliance, Inc. All rights reserved.\r
3  *\r
4  * This Software is licensed under one of the following licenses:\r
5  *\r
6  * 1) under the terms of the "Common Public License 1.0" a copy of which is\r
7  *    available from the Open Source Initiative, see\r
8  *    http://www.opensource.org/licenses/cpl.php.\r
9  *\r
10  * 2) under the terms of the "The BSD License" a copy of which is\r
11  *    available from the Open Source Initiative, see\r
12  *    http://www.opensource.org/licenses/bsd-license.php.\r
13  *\r
14  * 3) under the terms of the "GNU General Public License (GPL) Version 2" a\r
15  *    copy of which is available from the Open Source Initiative, see\r
16  *    http://www.opensource.org/licenses/gpl-license.php.\r
17  *\r
18  * Licensee has the right to choose one of the above licenses.\r
19  *\r
20  * Redistributions of source code must retain the above copyright\r
21  * notice and one of the license notices.\r
22  *\r
23  * Redistributions in binary form must reproduce both the above copyright\r
24  * notice, one of the license notices in the documentation\r
25  * and/or other materials provided with the distribution.\r
26  */\r
27 \r
28 /**********************************************************************\r
29  * \r
30  * MODULE: dapl_pz_free.c\r
31  *\r
32  * PURPOSE: Memory management\r
33  *\r
34  * $Id:$\r
35  **********************************************************************/\r
36 \r
37 #include "dapl.h"\r
38 #include "dapl_pz_util.h"\r
39 #include "dapl_adapter_util.h"\r
40 \r
41 /*\r
42  * dapl_pz_free\r
43  *\r
44  * Remove an instance of a protection zone\r
45  *\r
46  * Input:\r
47  *      pz_handle\r
48  *\r
49  * Output:\r
50  *      None.\r
51  *\r
52  * Returns:\r
53  *      DAT_SUCCESS\r
54  *      DAT_INVALID_STATE\r
55  *      DAT_INVALID_HANDLE\r
56  */\r
57 DAT_RETURN DAT_API\r
58 dapl_pz_free (\r
59     IN  DAT_PZ_HANDLE   pz_handle)\r
60 {\r
61     DAPL_PZ             *pz;\r
62     DAT_RETURN          dat_status;\r
63 \r
64     dapl_dbg_log (DAPL_DBG_TYPE_API, "dapl_pz_free (%p)\n", pz_handle);\r
65 \r
66     dat_status = DAT_SUCCESS;\r
67     if ( DAPL_BAD_HANDLE (pz_handle, DAPL_MAGIC_PZ) )\r
68     {\r
69         dat_status = DAT_ERROR (DAT_INVALID_HANDLE,DAT_INVALID_HANDLE_PZ);\r
70         goto bail;\r
71     }\r
72 \r
73     pz = (DAPL_PZ *) pz_handle;\r
74 \r
75     DAPL_CNTR(pz->header.owner_ia, DCNT_IA_PZ_FREE);\r
76 \r
77     if ( 0 != dapl_os_atomic_read (&pz->pz_ref_count) )\r
78     {\r
79         dat_status = DAT_ERROR (DAT_INVALID_STATE,DAT_INVALID_STATE_PZ_IN_USE);\r
80         goto bail;\r
81     }\r
82 \r
83     dat_status = dapls_ib_pd_free (pz);\r
84     if ( DAT_SUCCESS == dat_status )\r
85     {\r
86         dapl_pz_dealloc (pz);\r
87     }\r
88 \r
89  bail:\r
90     return dat_status;\r
91 }\r