1 |
763 |
simons |
/*
|
2 |
|
|
* Copyright (c) 1988, 1993
|
3 |
|
|
* The Regents of the University of California. 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
|
7 |
|
|
* are met:
|
8 |
|
|
* 1. Redistributions of source code must retain the above copyright
|
9 |
|
|
* notice, this list of conditions and the following disclaimer.
|
10 |
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
11 |
|
|
* notice, this list of conditions and the following disclaimer in the
|
12 |
|
|
* documentation and/or other materials provided with the distribution.
|
13 |
|
|
* 3. All advertising materials mentioning features or use of this software
|
14 |
|
|
* must display the following acknowledgement:
|
15 |
|
|
* This product includes software developed by the University of
|
16 |
|
|
* California, Berkeley and its contributors.
|
17 |
|
|
* 4. Neither the name of the University nor the names of its contributors
|
18 |
|
|
* may be used to endorse or promote products derived from this software
|
19 |
|
|
* without specific prior written permission.
|
20 |
|
|
*
|
21 |
|
|
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
22 |
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
23 |
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
24 |
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
25 |
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
26 |
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
27 |
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
28 |
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
29 |
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
30 |
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
31 |
|
|
* SUCH DAMAGE.
|
32 |
|
|
*
|
33 |
|
|
* @(#)ring.h 8.1 (Berkeley) 6/6/93
|
34 |
|
|
*/
|
35 |
|
|
|
36 |
|
|
#ifndef __RING_H__
|
37 |
|
|
#define __RING_H__
|
38 |
|
|
|
39 |
|
|
#if defined(P)
|
40 |
|
|
# undef P
|
41 |
|
|
#endif
|
42 |
|
|
|
43 |
|
|
#if defined(__STDC__) || defined(LINT_ARGS)
|
44 |
|
|
# define P(x) x
|
45 |
|
|
#else
|
46 |
|
|
# define P(x) ()
|
47 |
|
|
#endif
|
48 |
|
|
|
49 |
|
|
/*
|
50 |
|
|
* This defines a structure for a ring buffer.
|
51 |
|
|
*
|
52 |
|
|
* The circular buffer has two parts:
|
53 |
|
|
*(((
|
54 |
|
|
* full: [consume, supply)
|
55 |
|
|
* empty: [supply, consume)
|
56 |
|
|
*]]]
|
57 |
|
|
*
|
58 |
|
|
*/
|
59 |
|
|
typedef struct {
|
60 |
|
|
unsigned char *consume, /* where data comes out of */
|
61 |
|
|
*supply, /* where data comes in to */
|
62 |
|
|
*bottom, /* lowest address in buffer */
|
63 |
|
|
*top, /* highest address+1 in buffer */
|
64 |
|
|
*mark; /* marker (user defined) */
|
65 |
|
|
int size; /* size in bytes of buffer */
|
66 |
|
|
u_long consumetime, /* help us keep straight full, empty, etc. */
|
67 |
|
|
supplytime;
|
68 |
|
|
} Ring;
|
69 |
|
|
|
70 |
|
|
/* Here are some functions and macros to deal with the ring buffer */
|
71 |
|
|
|
72 |
|
|
/* Initialization routine */
|
73 |
|
|
extern int
|
74 |
|
|
ring_init P((Ring *ring, unsigned char *buffer, int count));
|
75 |
|
|
|
76 |
|
|
/* Data movement routines */
|
77 |
|
|
extern void
|
78 |
|
|
ring_supply_data P((Ring *ring, unsigned char *buffer, int count));
|
79 |
|
|
#ifdef notdef
|
80 |
|
|
extern void
|
81 |
|
|
ring_consume_data P((Ring *ring, unsigned char *buffer, int count));
|
82 |
|
|
#endif
|
83 |
|
|
|
84 |
|
|
/* Buffer state transition routines */
|
85 |
|
|
extern void
|
86 |
|
|
ring_supplied P((Ring *ring, int count)),
|
87 |
|
|
ring_consumed P((Ring *ring, int count));
|
88 |
|
|
|
89 |
|
|
/* Buffer state query routines */
|
90 |
|
|
extern int
|
91 |
|
|
ring_empty_count P((Ring *ring)),
|
92 |
|
|
ring_empty_consecutive P((Ring *ring)),
|
93 |
|
|
ring_full_count P((Ring *ring)),
|
94 |
|
|
ring_full_consecutive P((Ring *ring));
|
95 |
|
|
|
96 |
|
|
|
97 |
|
|
extern void
|
98 |
|
|
ring_clear_mark(),
|
99 |
|
|
ring_mark();
|
100 |
|
|
#endif
|
101 |
|
|
|