Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tjh.dev
kernel
os
linux
1/****************************************************************************
2
3 (c) SYSTEC electronic GmbH, D-07973 Greiz, August-Bebel-Str. 29
4 www.systec-electronic.com
5
6 Project: Project independend shared buffer (linear + circular)
7
8 Description: Declaration of platform independend part for the
9 shared buffer
10
11 License:
12
13 Redistribution and use in source and binary forms, with or without
14 modification, are permitted provided that the following conditions
15 are met:
16
17 1. Redistributions of source code must retain the above copyright
18 notice, this list of conditions and the following disclaimer.
19
20 2. Redistributions in binary form must reproduce the above copyright
21 notice, this list of conditions and the following disclaimer in the
22 documentation and/or other materials provided with the distribution.
23
24 3. Neither the name of SYSTEC electronic GmbH nor the names of its
25 contributors may be used to endorse or promote products derived
26 from this software without prior written permission. For written
27 permission, please contact info@systec-electronic.com.
28
29 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
30 "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
31 LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
32 FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
33 COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
34 INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
35 BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
36 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
37 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
38 LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
39 ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
40 POSSIBILITY OF SUCH DAMAGE.
41
42 Severability Clause:
43
44 If a provision of this License is or becomes illegal, invalid or
45 unenforceable in any jurisdiction, that shall not affect:
46 1. the validity or enforceability in that jurisdiction of any other
47 provision of this License; or
48 2. the validity or enforceability in other jurisdictions of that or
49 any other provision of this License.
50
51 -------------------------------------------------------------------------
52
53 2006/06/27 -rs: V 1.00 (initial version)
54
55****************************************************************************/
56
57#ifndef _SHAREDBUFF_H_
58#define _SHAREDBUFF_H_
59
60//---------------------------------------------------------------------------
61// Type definitions
62//---------------------------------------------------------------------------
63
64typedef enum {
65 kShbOk = 0,
66 kShbNoReadableData = 1,
67 kShbDataTruncated = 2,
68 kShbBufferFull = 3,
69 kShbDataOutsideBufferArea = 4,
70 kShbBufferAlreadyCompleted = 5,
71 kShbMemUsedByOtherProcs = 6,
72 kShbOpenMismatch = 7,
73 kShbInvalidBufferType = 8,
74 kShbInvalidArg = 9,
75 kShbBufferInvalid = 10,
76 kShbOutOfMem = 11,
77 kShbAlreadyReseting = 12,
78 kShbAlreadySignaling = 13,
79 kShbExceedDataSizeLimit = 14,
80
81} tShbError;
82
83// 2006/08/24 d.k.: Priority for threads (new data, job signaling)
84typedef enum {
85 kShbPriorityLow = 0,
86 kShbPriorityNormal = 1,
87 kshbPriorityHigh = 2
88} tShbPriority;
89
90typedef struct {
91 unsigned int m_uiFullBlockSize; // real size of allocated block (incl. alignment fill bytes)
92 unsigned long m_ulAvailableSize; // still available size for data
93 unsigned long m_ulWrIndex; // current write index
94 unsigned int m_fBufferCompleted; // TRUE if allocated block is complete filled with data
95
96} tShbCirChunk;
97
98typedef void *tShbInstance;
99
100typedef void (*tShbCirSigHndlrNewData) (tShbInstance pShbInstance_p,
101 unsigned long ulDataBlockSize_p);
102typedef void (*tShbCirSigHndlrReset) (tShbInstance pShbInstance_p,
103 unsigned int fTimeOut_p);
104
105//---------------------------------------------------------------------------
106// Prototypes
107//---------------------------------------------------------------------------
108
109#ifdef __cplusplus
110extern "C" {
111#endif
112
113 tShbError ShbInit(void);
114 tShbError ShbExit(void);
115
116// Circular Shared Buffer
117 tShbError ShbCirAllocBuffer(unsigned long ulBufferSize_p,
118 const char *pszBufferID_p,
119 tShbInstance * ppShbInstance_p,
120 unsigned int *pfShbNewCreated_p);
121 tShbError ShbCirReleaseBuffer(tShbInstance pShbInstance_p);
122
123
124 tShbError ShbCirResetBuffer(tShbInstance pShbInstance_p,
125 unsigned long ulTimeOut_p,
126 tShbCirSigHndlrReset
127 pfnSignalHandlerReset_p);
128 tShbError ShbCirWriteDataBlock(tShbInstance pShbInstance_p,
129 const void *pSrcDataBlock_p,
130 unsigned long ulDataBlockSize_p);
131 tShbError ShbCirAllocDataBlock(tShbInstance pShbInstance_p,
132 tShbCirChunk * pShbCirChunk_p,
133 unsigned long ulDataBufferSize_p);
134 tShbError ShbCirWriteDataChunk(tShbInstance pShbInstance_p,
135 tShbCirChunk * pShbCirChunk_p,
136 const void *pSrcDataChunk_p,
137 unsigned long ulDataChunkSize_p,
138 unsigned int *pfBufferCompleted_p);
139 tShbError ShbCirReadDataBlock(tShbInstance pShbInstance_p,
140 void *pDstDataBlock_p,
141 unsigned long ulRdBuffSize_p,
142 unsigned long *pulDataBlockSize_p);
143 tShbError ShbCirGetReadDataSize(tShbInstance pShbInstance_p,
144 unsigned long *pulDataBlockSize_p);
145 tShbError ShbCirGetReadBlockCount(tShbInstance pShbInstance_p,
146 unsigned long *pulDataBlockCount_p);
147 tShbError ShbCirSetSignalHandlerNewData(tShbInstance pShbInstance_p,
148 tShbCirSigHndlrNewData
149 pfnShbSignalHandlerNewData_p,
150 tShbPriority ShbPriority_p);
151
152
153// Linear Shared Buffer
154 tShbError ShbLinAllocBuffer(unsigned long ulBufferSize_p,
155 const char *pszBufferID_p,
156 tShbInstance * ppShbInstance_p,
157 unsigned int *pfShbNewCreated_p);
158 tShbError ShbLinReleaseBuffer(tShbInstance pShbInstance_p);
159
160
161 tShbError ShbLinWriteDataBlock(tShbInstance pShbInstance_p,
162 unsigned long ulDstBufferOffs_p,
163 const void *pSrcDataBlock_p,
164 unsigned long ulDataBlockSize_p);
165 tShbError ShbLinReadDataBlock(tShbInstance pShbInstance_p,
166 void *pDstDataBlock_p,
167 unsigned long ulSrcBufferOffs_p,
168 unsigned long ulDataBlockSize_p);
169
170
171#ifndef NDEBUG
172 tShbError ShbCirTraceBuffer(tShbInstance pShbInstance_p);
173 tShbError ShbLinTraceBuffer(tShbInstance pShbInstance_p);
174 tShbError ShbTraceDump(const unsigned char *pabStartAddr_p,
175 unsigned long ulDataSize_p,
176 unsigned long ulAddrOffset_p,
177 const char *pszInfoText_p);
178#else
179#define ShbCirTraceBuffer(p0)
180#define ShbLinTraceBuffer(p0)
181#define ShbTraceDump(p0, p1, p2, p3)
182#endif
183
184#ifdef __cplusplus
185}
186#endif
187#endif // #ifndef _SHAREDBUFF_H_