Files
m241Neelima/vxworks-6.9/target/h/wrn/wm/snmp/engine/buffer.h
T
2026-07-30 11:19:44 +05:30

339 lines
9.6 KiB
C

/* $Header: /usr/cvsroot/target/h/wrn/wm/snmp/engine/buffer.h,v 1.2 2001/11/06 21:35:01 josh Exp $ */
/*
* Copyright (C) 1999-2005 Wind River Systems, Inc.
* All rights reserved. Provided under license only.
* Distribution or other use of this software is only
* permitted pursuant to the terms of a license agreement
* from Wind River Systems (and is otherwise prohibited).
* Refer to that license agreement for terms of use.
*/
/****************************************************************************
* Copyright 1988-1997 Epilogue Technology Corporation.
* Copyright 1998 Integrated Systems, Inc.
* All rights reserved.
****************************************************************************/
/*
* $Log: buffer.h,v $
* Revision 1.2 2001/11/06 21:35:01 josh
* new revised path structure, first pass. Also removing useless
* shell include files.
*
* Revision 1.1.1.1 2001/11/05 17:47:22 tneale
* Tornado shuffle
*
* Revision 9.4 2001/01/19 22:22:04 paul
* Update copyright.
*
* Revision 9.3 2000/03/17 19:48:31 meister
* Update copyright notice
*
* Revision 9.2 2000/03/09 20:58:33 tneale
* All structure definitions are now bracketted with a test that
* potentially sets an alignment pragma. This is to maintain compatibility
* with the code base that had been distributed by Wind River.
*
* Revision 9.1 2000/03/09 16:55:08 tneale
* Added #ifdef for C++ to declare extern C if needed
*
* Revision 9.0 1998/10/16 22:10:07 sar
* Update version stamp to match release
*
* Revision 8.3 1998/06/18 04:42:00 sar
* Modified bflags in ebuffer to be unsigned ints and updated
* calling routines accordingly
*
* Revision 8.2 1998/05/23 20:01:13 sar
* Added EBufferAllocateLoad and updated some types
*
* Revision 8.1 1998/02/25 04:50:28 sra
* Update copyrights.
*
* Revision 8.0 1997/11/18 00:56:23 sar
* Updated revision to 8.0
*
* Revision 7.2 1997/03/20 06:48:05 sra
* DFARS-safe copyright text. Zap!
*
* Revision 7.1 1997/02/25 10:49:26 sra
* Update copyright notice, dust under the bed.
*
* Revision 7.0 1996/03/18 20:17:33 sar
* Updated rev to 7.0 and copyright to 96
*
* Revision 6.0 1995/05/31 21:46:34 sra
* Release 6.0.
*
* Revision 5.0 1994/05/16 15:49:04 sar
* Updated revision to 5.0 and copyright to include 1994
*
* Revision 4.0 1993/06/24 16:05:41 sar
* Updated rev to 4.0 and coypright to 93
*
* Revision 3.6 1993/05/03 17:54:14 sar
* Modified #include <foo> to be #include <envoy/h/foo.h> where it was correct.
*
* Revision 3.5 1993/04/22 20:14:13 sar
* Updating of macros and defines to use new naming scheme and get the
* names to be more useful in general. (use INSTALL_ENVOY_SNMP_VERSION_1
* for example).
*
* Revision 3.4 1993/03/20 00:21:50 sar
* Replaced EBufferAdd with EBufferAdjust which takes a length and if
* necessary extends the buffer.
* Added EBufferReplace which puts the given string into the buffer
* extending the buffer if necessary.
*
* Revision 3.3 1993/03/05 03:56:25 dab
* fixed up types
*
* Revision 3.2 1993/03/02 19:04:38 sar
* added definition of EBuffer_add which extends the string in a buffer.
*
* Revision 3.1 1993/02/17 20:46:41 sar
* Added EBufferStart - macro: obtain address of first byte in a buffer.
* Added EBufferSeek - definition: move the pointer in a buffer.
*
* Revision 3.0 92/04/03 19:52:27 dab
* Release 3.0
*
* Revision 2.102 1992/03/31 14:04:08 dab
* Fixed EBufferReset to fixup the remaining field too.
*
* Revision 2.101 92/02/04 11:04:37 dab
* Changed the EBufferReset macro to return void.
*
* Revision 2.100 91/08/09 14:09:44 dab
* Update version.
*
* Revision 1.1 91/07/30 02:24:21 romkey
* Initial revision
*
*
* Revision 2.0 31-Mar-1990 15:11:22 dab
* Release 2.00
*
* Rev 1.1 19 Sep 1988 17:27:04
* Made changes to make the Sun C compiler happy.
*
* Rev 1.0 12 Sep 1988 10:46:12
* Initial revision.
*/
/* [clearcase]
modification history
-------------------
01a,19apr05,job update copyright notices
*/
#if (!defined(buffer_inc))
#define buffer_inc
#ifdef __cplusplus
extern"C" {
#endif
#if (!defined(asn1_inc))
#include <wrn/wm/snmp/engine/asn1.h>
#endif
#ifdef WINDNET_STRUCT_ALIGN
#pragma align 1
#endif
/* The EBUFFER_T structure is used to control encoding into a buffer */
typedef struct EBUFFER_S
{
unsigned int bflags;
bits8_t *start_bp; /* Start of the buffer. */
bits8_t *next_bp; /* Next location in buffer to be filled */
ALENGTH_T remaining; /* Number of empty spots remaining in buffer*/
} EBUFFER_T;
#ifdef WINDNET_STRUCT_ALIGN
#pragma align 0
#endif
/* Values for bflags */
#define BFL_IS_ALLOC 0x0002 /* Buffer must be obtained */
#define BFL_IS_DYNAMIC 0x0001 /* Buffer was obtained by malloc */
#define BFL_IS_STATIC 0x0000 /* Buffer is statically allocated */
/****************************************************************************
NAME: EBufferInitialize
PURPOSE: Initialize a buffer to a know, but not usable state
EBufferSetup must be used to make the buffer ready for use.
PARAMETERS:
EBUFFER_T * Buffer descriptor
RETURNS: Nothing
RESTRICTIONS:
BUGS:
****************************************************************************/
#define EBufferInitialize(E) (((EBUFFER_T *)(E))->bflags=0, \
((EBUFFER_T *)(E))->next_bp=(bits8_t *)0, \
((EBUFFER_T *)(E))->start_bp=(bits8_t *)0, \
((EBUFFER_T *)(E))->remaining=(ALENGTH_T)0)
/****************************************************************************
NAME: EBufferSetup
PURPOSE: Setup a buffer to receive ASN.1 encoded data
PARAMETERS:
unsigned int BFL_xxx flags from buffer.h
EBUFFER_T * Buffer descriptor
bits8_t * Address of the buffer
ALENGTH_T Length of the buffer
RETURNS: Nothing
RESTRICTIONS:
BUGS:
****************************************************************************/
#define EBufferSetup(F,E,B,L) (((EBUFFER_T *)(E))->bflags=(F), \
((EBUFFER_T *)(E))->start_bp=(bits8_t *)(B), \
((EBUFFER_T *)(E))->next_bp=(bits8_t *)(B), \
((EBUFFER_T *)(E))->remaining=(ALENGTH_T)(L))
/****************************************************************************
NAME: EBufferPreLoad
PURPOSE: Pre-load data into a buffer
PARAMETERS:
unsigned int BFL_xxx flags from buffer.h
EBUFFER_T * Buffer descriptor
bits8_t * Address of the buffer containing the data
ALENGTH_T Length of the data
RETURNS: Nothing
RESTRICTIONS:
BUGS:
****************************************************************************/
#define EBufferPreLoad(F,E,B,L) ( \
((EBUFFER_T *)(E))->bflags=(F), \
((EBUFFER_T *)(E))->start_bp=(bits8_t *)(B), \
((EBUFFER_T *)(E))->next_bp=((bits8_t *)(B)+(ALENGTH_T)(L)), \
((EBUFFER_T *)(E))->remaining=(ALENGTH_T)0)
/****************************************************************************
NAME: EBufferNext
PURPOSE: Obtain address of next free byte in a buffer
PARAMETERS:
EBUFFER_T * Buffer descriptor
RETURNS: bits8_t * Buffer descriptor
RESTRICTIONS:
BUGS:
****************************************************************************/
#define EBufferNext(E) (((EBUFFER_T *)(E))->next_bp)
/****************************************************************************
NAME: EBufferStart
PURPOSE: Obtain address of first byte in a buffer
PARAMETERS:
EBUFFER_T * Buffer descriptor
RETURNS: bits8_t * Buffer descriptor
RESTRICTIONS:
BUGS:
****************************************************************************/
#define EBufferStart(E) (((EBUFFER_T *)(E))->start_bp)
/****************************************************************************
NAME: EBufferUsed
PURPOSE: Indicate how many octets are currently in the buffer.
PARAMETERS:
EBUFFER_T * Buffer descriptor
RETURNS: ALENGTH_T Number of octets used.
RESTRICTIONS:
BUGS:
****************************************************************************/
#define EBufferUsed(E) ((ALENGTH_T)((((EBUFFER_T *)(E))->next_bp) - \
(((EBUFFER_T *)(E))->start_bp)))
/****************************************************************************
NAME: EBufferRemaining
PURPOSE: Indicate how many octets are currently unused in the buffer.
PARAMETERS:
EBUFFER_T * Buffer descriptor
RETURNS: ALENGTH_T Number of octets unused.
RESTRICTIONS:
BUGS:
****************************************************************************/
#define EBufferRemaining(E) (((EBUFFER_T *)(E))->remaining)
/****************************************************************************
NAME: EBufferReset
PURPOSE: Reset the buffer to an empty state, just like after EBufferSetup
PARAMETERS:
EBUFFER_T * Buffer descriptor
RETURNS: Nothing
RESTRICTIONS:
BUGS:
****************************************************************************/
#define EBufferReset(E) ( \
(((EBUFFER_T *)(E))->remaining += \
((EBUFFER_T *)(E))->next_bp - \
((EBUFFER_T *)(E))->start_bp), \
((void)(((EBUFFER_T *)(E))->next_bp = \
((EBUFFER_T *)(E))->start_bp)))
extern int EBufferClone __((EBUFFER_T *, EBUFFER_T *));
extern void EBufferClean __((EBUFFER_T *));
extern void EBufferAppend __((EBUFFER_T *, EBUFFER_T *));
extern int EBufferSeek __((EBUFFER_T *, ALENGTH_T, int));
extern int EBufferAdjust __((EBUFFER_T *, ALENGTH_T));
extern int EBufferReplace __((EBUFFER_T *, bits8_t *, ALENGTH_T));
extern int EBufferAllocateLoad __((unsigned int, EBUFFER_T *,
bits8_t *, ALENGTH_T));
#ifdef __cplusplus
}
#endif
#endif /* buffer_inc */