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