Emulex Logo
OneCoreā„¢ Storage SDK Release 11.2
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
ocs_pool.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2011-2015, Emulex
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright notice,
9  * this list of conditions and the following disclaimer.
10  *
11  * 2. Redistributions in binary form must reproduce the above copyright notice,
12  * this list of conditions and the following disclaimer in the documentation
13  * and/or other materials provided with the distribution.
14  *
15  * 3. Neither the name of the copyright holder nor the names of its contributors
16  * may be used to endorse or promote products derived from this software
17  * without specific prior written permission.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
23  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  * POSSIBILITY OF SUCH DAMAGE.
30  *
31  */
32 
33 /**
34  * @file
35  *
36  */
37 
38 #if !defined(__OCS_POOL_H__)
39 #define __OCS_POOL_H__
40 
41 #include "ocs_array.h"
42 
43 typedef struct ocs_pool_s ocs_pool_t;
44 
45 extern ocs_pool_t *ocs_pool_alloc(ocs_os_handle_t os, uint32_t size, uint32_t count, uint32_t use_lock);
46 extern void ocs_pool_reset(ocs_pool_t *pool);
47 extern void ocs_pool_free(ocs_pool_t *pool);
48 extern void *ocs_pool_get(ocs_pool_t *pool);
49 extern void ocs_pool_put(ocs_pool_t *pool, void *item);
50 extern void ocs_pool_put_head(ocs_pool_t *pool, void *item);
51 extern uint32_t ocs_pool_get_count(ocs_pool_t *pool);
52 extern void *ocs_pool_get_instance(ocs_pool_t *pool, uint32_t idx);
53 extern uint32_t ocs_pool_get_freelist_count(ocs_pool_t *pool);
54 
55 #endif // __OCS_POOL_H__
void * ocs_pool_get(ocs_pool_t *pool)
Allocate a memory pool item.
Definition: ocs_pool.c:197
uint32_t ocs_pool_get_freelist_count(ocs_pool_t *pool)
Return count of free objects in a pool.
Definition: ocs_pool.c:335
void ocs_pool_put_head(ocs_pool_t *pool, void *item)
free memory pool item
Definition: ocs_pool.c:261
void ocs_pool_put(ocs_pool_t *pool, void *item)
free memory pool item
Definition: ocs_pool.c:230
uint32_t use_lock
Definition: ocs_pool.c:66
ocs_pool_t * ocs_pool_alloc(ocs_os_handle_t os, uint32_t size, uint32_t count, uint32_t use_lock)
Allocate a memory pool.
Definition: ocs_pool.c:88
void ocs_pool_free(ocs_pool_t *pool)
Free a previously allocated memory pool.
Definition: ocs_pool.c:173
void * ocs_pool_get_instance(ocs_pool_t *pool, uint32_t idx)
Return item given an index.
Definition: ocs_pool.c:315
void ocs_pool_reset(ocs_pool_t *pool)
Reset a memory pool.
Definition: ocs_pool.c:131
ocs_os_handle_t os
Definition: ocs_pool.c:63
uint32_t ocs_pool_get_count(ocs_pool_t *pool)
Return memory pool item count.
Definition: ocs_pool.c:291