openssh/buffer.h

   1 /* $OpenBSD: buffer.h,v 1.16 2006/08/03 03:34:41 deraadt Exp $ */
   2
   3 /*
   4  * Author: Tatu Ylonen <ylo@cs.hut.fi>
   5  * Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
   6  *                    All rights reserved
   7  * Code for manipulating FIFO buffers.
   8  *
   9  * As far as I am concerned, the code I have written for this software
  10  * can be used freely for any purpose.  Any derived versions of this
  11  * software must be clearly marked as such, and if the derived work is
  12  * incompatible with the protocol description in the RFC file, it must be
  13  * called by a name other than "ssh" or "Secure Shell".
  14  */
  15
  16 #ifndef BUFFER_H
  17 #define BUFFER_H
  18 #define BUFFER_MAX_LEN_HPN      0x4000000 /* 64MB */
  19
  20 typedef struct {
  21         u_char  *buf;           /* Buffer for data. */
  22         u_int    alloc;         /* Number of bytes allocated for data. */
  23         u_int    offset;        /* Offset of first byte containing data. */
  24         u_int    end;           /* Offset of last byte containing data. */
  25 }       Buffer;
  26
  27 void     buffer_init(Buffer *);
  28 void     buffer_clear(Buffer *);
  29 void     buffer_free(Buffer *);
  30
  31 u_int    buffer_len(Buffer *);
  32 void    *buffer_ptr(Buffer *);
  33
  34 void     buffer_append(Buffer *, const void *, u_int);
  35 void    *buffer_append_space(Buffer *, u_int);
  36
  37 int      buffer_check_alloc(Buffer *, u_int);
  38
  39 void     buffer_get(Buffer *, void *, u_int);
  40
  41 void     buffer_consume(Buffer *, u_int);
  42 void     buffer_consume_end(Buffer *, u_int);
  43
  44 void     buffer_dump(Buffer *);
  45
  46 int      buffer_get_ret(Buffer *, void *, u_int);
  47 int      buffer_consume_ret(Buffer *, u_int);
  48 int      buffer_consume_end_ret(Buffer *, u_int);
  49
  50 #include <openssl/bn.h>
  51
  52 void    buffer_put_bignum(Buffer *, const BIGNUM *);
  53 void    buffer_put_bignum2(Buffer *, const BIGNUM *);
  54 void    buffer_get_bignum(Buffer *, BIGNUM *);
  55 void    buffer_get_bignum2(Buffer *, BIGNUM *);
  56
  57 u_short buffer_get_short(Buffer *);
  58 void    buffer_put_short(Buffer *, u_short);
  59
  60 u_int   buffer_get_int(Buffer *);
  61 void    buffer_put_int(Buffer *, u_int);
  62
  63 u_int64_t buffer_get_int64(Buffer *);
  64 void    buffer_put_int64(Buffer *, u_int64_t);
  65
  66 int     buffer_get_char(Buffer *);
  67 void    buffer_put_char(Buffer *, int);
  68
  69 void   *buffer_get_string(Buffer *, u_int *);
  70 void    buffer_put_string(Buffer *, const void *, u_int);
  71 void    buffer_put_cstring(Buffer *, const char *);
  72
  73 #define buffer_skip_string(b) \
  74     do { u_int l = buffer_get_int(b); buffer_consume(b, l); } while (0)
  75
  76 int     buffer_put_bignum_ret(Buffer *, const BIGNUM *);
  77 int     buffer_get_bignum_ret(Buffer *, BIGNUM *);
  78 int     buffer_put_bignum2_ret(Buffer *, const BIGNUM *);
  79 int     buffer_get_bignum2_ret(Buffer *, BIGNUM *);
  80 int     buffer_get_short_ret(u_short *, Buffer *);
  81 int     buffer_get_int_ret(u_int *, Buffer *);
  82 int     buffer_get_int64_ret(u_int64_t *, Buffer *);
  83 void    *buffer_get_string_ret(Buffer *, u_int *);
  84 int     buffer_get_char_ret(char *, Buffer *);
  85
  86 #endif                          /* BUFFER_H */