Annotation of src/usr.bin/ssh/buffer.c, Revision 1.13
1.1 deraadt 1: /*
1.3 deraadt 2: * Author: Tatu Ylonen <ylo@cs.hut.fi>
3: * Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
4: * All rights reserved
5: * Functions for manipulating fifo buffers (that can grow if needed).
1.6 markus 6: *
1.8 deraadt 7: * As far as I am concerned, the code I have written for this software
8: * can be used freely for any purpose. Any derived versions of this
9: * software must be clearly marked as such, and if the derived work is
10: * incompatible with the protocol description in the RFC file, it must be
11: * called by a name other than "ssh" or "Secure Shell".
1.3 deraadt 12: */
1.1 deraadt 13:
14: #include "includes.h"
1.13 ! markus 15: RCSID("$OpenBSD: buffer.c,v 1.12 2001/04/07 08:55:15 markus Exp $");
1.1 deraadt 16:
17: #include "xmalloc.h"
18: #include "buffer.h"
1.10 markus 19: #include "log.h"
1.1 deraadt 20:
21: /* Initializes the buffer structure. */
22:
1.6 markus 23: void
1.2 markus 24: buffer_init(Buffer *buffer)
1.1 deraadt 25: {
1.2 markus 26: buffer->alloc = 4096;
27: buffer->buf = xmalloc(buffer->alloc);
28: buffer->offset = 0;
29: buffer->end = 0;
1.1 deraadt 30: }
31:
32: /* Frees any memory used for the buffer. */
33:
1.6 markus 34: void
1.2 markus 35: buffer_free(Buffer *buffer)
1.1 deraadt 36: {
1.2 markus 37: memset(buffer->buf, 0, buffer->alloc);
38: xfree(buffer->buf);
1.1 deraadt 39: }
40:
1.4 markus 41: /*
42: * Clears any data from the buffer, making it empty. This does not actually
43: * zero the memory.
44: */
1.1 deraadt 45:
1.6 markus 46: void
1.2 markus 47: buffer_clear(Buffer *buffer)
1.1 deraadt 48: {
1.2 markus 49: buffer->offset = 0;
50: buffer->end = 0;
1.1 deraadt 51: }
52:
53: /* Appends data to the buffer, expanding it if necessary. */
54:
1.6 markus 55: void
1.9 markus 56: buffer_append(Buffer *buffer, const char *data, u_int len)
1.1 deraadt 57: {
1.2 markus 58: char *cp;
59: buffer_append_space(buffer, &cp, len);
60: memcpy(cp, data, len);
1.1 deraadt 61: }
62:
1.4 markus 63: /*
64: * Appends space to the buffer, expanding the buffer if necessary. This does
65: * not actually copy the data into the buffer, but instead returns a pointer
66: * to the allocated region.
67: */
1.1 deraadt 68:
1.6 markus 69: void
1.9 markus 70: buffer_append_space(Buffer *buffer, char **datap, u_int len)
1.1 deraadt 71: {
1.2 markus 72: /* If the buffer is empty, start using it from the beginning. */
73: if (buffer->offset == buffer->end) {
74: buffer->offset = 0;
75: buffer->end = 0;
76: }
77: restart:
78: /* If there is enough space to store all data, store it now. */
79: if (buffer->end + len < buffer->alloc) {
80: *datap = buffer->buf + buffer->end;
81: buffer->end += len;
82: return;
83: }
1.4 markus 84: /*
85: * If the buffer is quite empty, but all data is at the end, move the
86: * data to the beginning and retry.
87: */
1.2 markus 88: if (buffer->offset > buffer->alloc / 2) {
89: memmove(buffer->buf, buffer->buf + buffer->offset,
90: buffer->end - buffer->offset);
91: buffer->end -= buffer->offset;
92: buffer->offset = 0;
93: goto restart;
94: }
95: /* Increase the size of the buffer and retry. */
96: buffer->alloc += len + 32768;
97: buffer->buf = xrealloc(buffer->buf, buffer->alloc);
98: goto restart;
1.1 deraadt 99: }
100:
101: /* Returns the number of bytes of data in the buffer. */
102:
1.9 markus 103: u_int
1.2 markus 104: buffer_len(Buffer *buffer)
1.1 deraadt 105: {
1.2 markus 106: return buffer->end - buffer->offset;
1.1 deraadt 107: }
108:
109: /* Gets data from the beginning of the buffer. */
110:
1.6 markus 111: void
1.9 markus 112: buffer_get(Buffer *buffer, char *buf, u_int len)
1.1 deraadt 113: {
1.2 markus 114: if (len > buffer->end - buffer->offset)
1.11 markus 115: fatal("buffer_get: trying to get more bytes %d than in buffer %d",
116: len, buffer->end - buffer->offset);
1.2 markus 117: memcpy(buf, buffer->buf + buffer->offset, len);
118: buffer->offset += len;
1.1 deraadt 119: }
120:
121: /* Consumes the given number of bytes from the beginning of the buffer. */
122:
1.6 markus 123: void
1.9 markus 124: buffer_consume(Buffer *buffer, u_int bytes)
1.1 deraadt 125: {
1.2 markus 126: if (bytes > buffer->end - buffer->offset)
1.5 markus 127: fatal("buffer_consume: trying to get more bytes than in buffer");
1.2 markus 128: buffer->offset += bytes;
129: }
1.1 deraadt 130:
131: /* Consumes the given number of bytes from the end of the buffer. */
132:
1.6 markus 133: void
1.9 markus 134: buffer_consume_end(Buffer *buffer, u_int bytes)
1.1 deraadt 135: {
1.2 markus 136: if (bytes > buffer->end - buffer->offset)
1.5 markus 137: fatal("buffer_consume_end: trying to get more bytes than in buffer");
1.2 markus 138: buffer->end -= bytes;
139: }
1.1 deraadt 140:
141: /* Returns a pointer to the first used byte in the buffer. */
142:
1.2 markus 143: char *
144: buffer_ptr(Buffer *buffer)
1.1 deraadt 145: {
1.2 markus 146: return buffer->buf + buffer->offset;
1.1 deraadt 147: }
148:
149: /* Dumps the contents of the buffer to stderr. */
150:
1.6 markus 151: void
1.2 markus 152: buffer_dump(Buffer *buffer)
1.1 deraadt 153: {
1.2 markus 154: int i;
1.9 markus 155: u_char *ucp = (u_char *) buffer->buf;
1.2 markus 156:
1.13 ! markus 157: for (i = buffer->offset; i < buffer->end; i++) {
! 158: fprintf(stderr, "%02x", ucp[i]);
! 159: if ((i-buffer->offset)%16==15)
! 160: fprintf(stderr, "\r\n");
! 161: else if ((i-buffer->offset)%2==1)
! 162: fprintf(stderr, " ");
! 163: }
1.12 markus 164: fprintf(stderr, "\r\n");
1.1 deraadt 165: }