blob: c0182da1340c92b8980eecdd07c57657d60f1acd [file] [log] [blame]
Damien Millerd4a8b7e1999-10-27 13:42:43 +10001/*
Damien Miller95def091999-11-25 00:26:21 +11002 * Author: Tatu Ylonen <ylo@cs.hut.fi>
Damien Miller95def091999-11-25 00:26:21 +11003 * Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
4 * All rights reserved
Damien Miller4af51302000-04-16 11:18:38 +10005 *
Damien Millere4340be2000-09-16 13:29:08 +11006 * As far as I am concerned, the code I have written for this software
7 * can be used freely for any purpose. Any derived versions of this
8 * software must be clearly marked as such, and if the derived work is
9 * incompatible with the protocol description in the RFC file, it must be
10 * called by a name other than "ssh" or "Secure Shell".
Damien Miller95def091999-11-25 00:26:21 +110011 */
Damien Millerd4a8b7e1999-10-27 13:42:43 +100012
Ben Lindstrom226cfa02001-01-22 05:34:40 +000013/* RCSID("$OpenBSD: bufaux.h,v 1.11 2001/01/21 19:05:45 markus Exp $"); */
Damien Millerd4a8b7e1999-10-27 13:42:43 +100014
15#ifndef BUFAUX_H
16#define BUFAUX_H
17
18#include "buffer.h"
Ben Lindstrom226cfa02001-01-22 05:34:40 +000019#include <openssl/bn.h>
Damien Millerd4a8b7e1999-10-27 13:42:43 +100020
Damien Miller5428f641999-11-25 11:54:57 +110021/*
22 * Stores an BIGNUM in the buffer with a 2-byte msb first bit count, followed
23 * by (bits+7)/8 bytes of binary data, msb first.
24 */
Damien Miller95def091999-11-25 00:26:21 +110025void buffer_put_bignum(Buffer * buffer, BIGNUM * value);
Damien Millerb38eff82000-04-01 11:09:21 +100026void buffer_put_bignum2(Buffer * buffer, BIGNUM * value);
Damien Millerd4a8b7e1999-10-27 13:42:43 +100027
28/* Retrieves an BIGNUM from the buffer. */
Damien Miller95def091999-11-25 00:26:21 +110029int buffer_get_bignum(Buffer * buffer, BIGNUM * value);
Damien Millerb38eff82000-04-01 11:09:21 +100030int buffer_get_bignum2(Buffer *buffer, BIGNUM * value);
Damien Millerd4a8b7e1999-10-27 13:42:43 +100031
32/* Returns an integer from the buffer (4 bytes, msb first). */
Ben Lindstrom46c16222000-12-22 01:43:59 +000033u_int buffer_get_int(Buffer * buffer);
Ben Lindstrom16a86be2001-01-23 16:26:52 +000034#ifdef HAVE_U_INT64_T
Ben Lindstrom2f959b42001-01-11 06:20:23 +000035u_int64_t buffer_get_int64(Buffer *buffer);
Ben Lindstrom16a86be2001-01-23 16:26:52 +000036#endif
Damien Millerd4a8b7e1999-10-27 13:42:43 +100037
38/* Stores an integer in the buffer in 4 bytes, msb first. */
Ben Lindstrom46c16222000-12-22 01:43:59 +000039void buffer_put_int(Buffer * buffer, u_int value);
Ben Lindstrom16a86be2001-01-23 16:26:52 +000040#ifdef HAVE_U_INT64_T
Ben Lindstrom2f959b42001-01-11 06:20:23 +000041void buffer_put_int64(Buffer *buffer, u_int64_t value);
Ben Lindstrom16a86be2001-01-23 16:26:52 +000042#endif
Damien Millerd4a8b7e1999-10-27 13:42:43 +100043
44/* Returns a character from the buffer (0 - 255). */
Damien Miller95def091999-11-25 00:26:21 +110045int buffer_get_char(Buffer * buffer);
Damien Millerd4a8b7e1999-10-27 13:42:43 +100046
47/* Stores a character in the buffer. */
Damien Miller95def091999-11-25 00:26:21 +110048void buffer_put_char(Buffer * buffer, int value);
Damien Millerd4a8b7e1999-10-27 13:42:43 +100049
Damien Miller5428f641999-11-25 11:54:57 +110050/*
51 * Returns an arbitrary binary string from the buffer. The string cannot be
52 * longer than 256k. The returned value points to memory allocated with
53 * xmalloc; it is the responsibility of the calling function to free the
54 * data. If length_ptr is non-NULL, the length of the returned data will be
55 * stored there. A null character will be automatically appended to the
56 * returned string, and is not counted in length.
57 */
Ben Lindstrom46c16222000-12-22 01:43:59 +000058char *buffer_get_string(Buffer * buffer, u_int *length_ptr);
Damien Millerd4a8b7e1999-10-27 13:42:43 +100059
60/* Stores and arbitrary binary string in the buffer. */
Ben Lindstrom46c16222000-12-22 01:43:59 +000061void buffer_put_string(Buffer * buffer, const void *buf, u_int len);
Damien Millerb38eff82000-04-01 11:09:21 +100062void buffer_put_cstring(Buffer *buffer, const char *s);
Damien Millerd4a8b7e1999-10-27 13:42:43 +100063
Damien Miller95def091999-11-25 00:26:21 +110064#endif /* BUFAUX_H */