blob: c33dd17df1d819ba5ef9f6f6c0d9f5f627228d6f [file] [log] [blame]
dtucker@openbsd.orgc998bf02017-02-03 02:56:00 +00001/* $OpenBSD: packet.h,v 1.75 2017/02/03 02:56:00 dtucker Exp $ */
Ben Lindstrom05764b92002-03-05 01:53:02 +00002
Damien Millerd4a8b7e1999-10-27 13:42:43 +10003/*
Damien Miller95def091999-11-25 00:26:21 +11004 * Author: Tatu Ylonen <ylo@cs.hut.fi>
Damien Miller95def091999-11-25 00:26:21 +11005 * Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
6 * All rights reserved
Damien Miller95def091999-11-25 00:26:21 +11007 * Interface for the packet protocol functions.
Damien Miller4af51302000-04-16 11:18:38 +10008 *
Damien Millere4340be2000-09-16 13:29:08 +11009 * 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".
Damien Miller95def091999-11-25 00:26:21 +110014 */
Damien Millerd4a8b7e1999-10-27 13:42:43 +100015
Damien Millerd4a8b7e1999-10-27 13:42:43 +100016#ifndef PACKET_H
17#define PACKET_H
18
Damien Miller99bd21e2006-03-15 11:11:28 +110019#include <termios.h>
20
markus@openbsd.org091c3022015-01-19 19:52:16 +000021#ifdef WITH_OPENSSL
22# include <openssl/bn.h>
23# ifdef OPENSSL_HAS_ECC
24# include <openssl/ec.h>
Damien Miller773dda22015-01-30 23:10:17 +110025# else /* OPENSSL_HAS_ECC */
26# define EC_KEY void
27# define EC_GROUP void
28# define EC_POINT void
29# endif /* OPENSSL_HAS_ECC */
30#else /* WITH_OPENSSL */
31# define BIGNUM void
32# define EC_KEY void
33# define EC_GROUP void
34# define EC_POINT void
35#endif /* WITH_OPENSSL */
36
Tim Rice91020922015-02-23 22:06:56 -080037#include <signal.h>
Damien Miller62f678d2015-02-24 09:02:54 +110038#include "openbsd-compat/sys-queue.h"
Damien Millerd4a8b7e1999-10-27 13:42:43 +100039
markus@openbsd.org091c3022015-01-19 19:52:16 +000040struct kex;
41struct sshkey;
42struct sshbuf;
43struct session_state; /* private session data */
Damien Millerd4a8b7e1999-10-27 13:42:43 +100044
markus@openbsd.org3fdc88a2015-01-19 20:07:45 +000045#include "dispatch.h" /* typedef, DISPATCH_MAX */
46
markus@openbsd.orgf582f0e2015-01-19 20:30:23 +000047struct key_entry {
48 TAILQ_ENTRY(key_entry) next;
49 struct sshkey *key;
50};
51
markus@openbsd.org091c3022015-01-19 19:52:16 +000052struct ssh {
53 /* Session state */
54 struct session_state *state;
Damien Millerd4a8b7e1999-10-27 13:42:43 +100055
markus@openbsd.org091c3022015-01-19 19:52:16 +000056 /* Key exchange */
57 struct kex *kex;
Damien Millerd4a8b7e1999-10-27 13:42:43 +100058
djm@openbsd.org95767262016-03-07 19:02:43 +000059 /* cached local and remote ip addresses and ports */
markus@openbsd.org091c3022015-01-19 19:52:16 +000060 char *remote_ipaddr;
61 int remote_port;
djm@openbsd.org95767262016-03-07 19:02:43 +000062 char *local_ipaddr;
63 int local_port;
Damien Millerd4a8b7e1999-10-27 13:42:43 +100064
markus@openbsd.org3fdc88a2015-01-19 20:07:45 +000065 /* Dispatcher table */
66 dispatch_fn *dispatch[DISPATCH_MAX];
67 /* number of packets to ignore in the dispatcher */
68 int dispatch_skip_packets;
69
markus@openbsd.org091c3022015-01-19 19:52:16 +000070 /* datafellows */
71 int compat;
markus@openbsd.orgf582f0e2015-01-19 20:30:23 +000072
73 /* Lists for private and public keys */
74 TAILQ_HEAD(, key_entry) private_keys;
75 TAILQ_HEAD(, key_entry) public_keys;
76
77 /* APP data */
78 void *app_data;
markus@openbsd.org091c3022015-01-19 19:52:16 +000079};
Ben Lindstromf6027d32002-03-22 01:42:04 +000080
djm@openbsd.org39af7b42016-10-11 21:47:45 +000081typedef int (ssh_packet_hook_fn)(struct ssh *, struct sshbuf *,
82 u_char *, void *);
83
markus@openbsd.org091c3022015-01-19 19:52:16 +000084struct ssh *ssh_alloc_session_state(void);
85struct ssh *ssh_packet_set_connection(struct ssh *, int, int);
86void ssh_packet_set_timeout(struct ssh *, int, int);
87int ssh_packet_stop_discard(struct ssh *);
88int ssh_packet_connection_af(struct ssh *);
89void ssh_packet_set_nonblocking(struct ssh *);
90int ssh_packet_get_connection_in(struct ssh *);
91int ssh_packet_get_connection_out(struct ssh *);
92void ssh_packet_close(struct ssh *);
93void ssh_packet_set_encryption_key(struct ssh *, const u_char *, u_int, int);
djm@openbsd.org39af7b42016-10-11 21:47:45 +000094void ssh_packet_set_input_hook(struct ssh *, ssh_packet_hook_fn *, void *);
95
djm@openbsd.org19bcf2e2016-02-08 10:57:07 +000096int ssh_packet_is_rekeying(struct ssh *);
markus@openbsd.org091c3022015-01-19 19:52:16 +000097void ssh_packet_set_protocol_flags(struct ssh *, u_int);
98u_int ssh_packet_get_protocol_flags(struct ssh *);
99int ssh_packet_start_compression(struct ssh *, int);
100void ssh_packet_set_tos(struct ssh *, int);
101void ssh_packet_set_interactive(struct ssh *, int, int, int);
102int ssh_packet_is_interactive(struct ssh *);
103void ssh_packet_set_server(struct ssh *);
104void ssh_packet_set_authenticated(struct ssh *);
markus@openbsd.org8d057842016-09-30 09:19:13 +0000105void ssh_packet_set_mux(struct ssh *);
106int ssh_packet_get_mux(struct ssh *);
107
108int ssh_packet_log_type(u_char);
Damien Millerd4a8b7e1999-10-27 13:42:43 +1000109
markus@openbsd.org091c3022015-01-19 19:52:16 +0000110int ssh_packet_send1(struct ssh *);
111int ssh_packet_send2_wrapped(struct ssh *);
112int ssh_packet_send2(struct ssh *);
113
114int ssh_packet_read(struct ssh *);
djm@openbsd.org4509b5d2015-01-30 01:13:33 +0000115int ssh_packet_read_expect(struct ssh *, u_int type);
markus@openbsd.org091c3022015-01-19 19:52:16 +0000116int ssh_packet_read_poll(struct ssh *);
117int ssh_packet_read_poll1(struct ssh *, u_char *);
118int ssh_packet_read_poll2(struct ssh *, u_char *, u_int32_t *seqnr_p);
djm@openbsd.orgfae7bbe2015-01-28 21:15:47 +0000119int ssh_packet_process_incoming(struct ssh *, const char *buf, u_int len);
markus@openbsd.org091c3022015-01-19 19:52:16 +0000120int ssh_packet_read_seqnr(struct ssh *, u_char *, u_int32_t *seqnr_p);
121int ssh_packet_read_poll_seqnr(struct ssh *, u_char *, u_int32_t *seqnr_p);
122
123const void *ssh_packet_get_string_ptr(struct ssh *, u_int *length_ptr);
124void ssh_packet_disconnect(struct ssh *, const char *fmt, ...)
125 __attribute__((format(printf, 2, 3)))
126 __attribute__((noreturn));
127void ssh_packet_send_debug(struct ssh *, const char *fmt, ...) __attribute__((format(printf, 2, 3)));
128
129int ssh_set_newkeys(struct ssh *, int mode);
130void ssh_packet_get_bytes(struct ssh *, u_int64_t *, u_int64_t *);
131
djm@openbsd.org4509b5d2015-01-30 01:13:33 +0000132int ssh_packet_write_poll(struct ssh *);
133int ssh_packet_write_wait(struct ssh *);
markus@openbsd.org091c3022015-01-19 19:52:16 +0000134int ssh_packet_have_data_to_write(struct ssh *);
135int ssh_packet_not_very_much_data_to_write(struct ssh *);
136
137int ssh_packet_connection_is_on_socket(struct ssh *);
138int ssh_packet_remaining(struct ssh *);
139void ssh_packet_send_ignore(struct ssh *, int);
Damien Millerd4a8b7e1999-10-27 13:42:43 +1000140
Ben Lindstrom4cc240d2001-07-04 04:46:56 +0000141void tty_make_modes(int, struct termios *);
142void tty_parse_modes(int, int *);
Damien Millerd4a8b7e1999-10-27 13:42:43 +1000143
markus@openbsd.org091c3022015-01-19 19:52:16 +0000144void ssh_packet_set_alive_timeouts(struct ssh *, int);
145int ssh_packet_inc_alive_timeouts(struct ssh *);
146int ssh_packet_set_maxsize(struct ssh *, u_int);
147u_int ssh_packet_get_maxsize(struct ssh *);
Damien Millerd4a8b7e1999-10-27 13:42:43 +1000148
markus@openbsd.org091c3022015-01-19 19:52:16 +0000149int ssh_packet_get_state(struct ssh *, struct sshbuf *);
150int ssh_packet_set_state(struct ssh *, struct sshbuf *);
Damien Miller4af51302000-04-16 11:18:38 +1000151
markus@openbsd.org091c3022015-01-19 19:52:16 +0000152const char *ssh_remote_ipaddr(struct ssh *);
djm@openbsd.orga4b9e0f2015-12-11 03:24:25 +0000153int ssh_remote_port(struct ssh *);
djm@openbsd.org95767262016-03-07 19:02:43 +0000154const char *ssh_local_ipaddr(struct ssh *);
155int ssh_local_port(struct ssh *);
Damien Millera5539d22003-04-09 20:50:06 +1000156
dtucker@openbsd.orgc998bf02017-02-03 02:56:00 +0000157void ssh_packet_set_rekey_limits(struct ssh *, u_int64_t, u_int32_t);
markus@openbsd.org091c3022015-01-19 19:52:16 +0000158time_t ssh_packet_get_rekey_timeout(struct ssh *);
Darren Tuckere841eb02009-07-06 07:11:13 +1000159
markus@openbsd.org091c3022015-01-19 19:52:16 +0000160void *ssh_packet_get_input(struct ssh *);
161void *ssh_packet_get_output(struct ssh *);
162
163/* new API */
164int sshpkt_start(struct ssh *ssh, u_char type);
165int sshpkt_send(struct ssh *ssh);
djm@openbsd.org4509b5d2015-01-30 01:13:33 +0000166int sshpkt_disconnect(struct ssh *, const char *fmt, ...)
167 __attribute__((format(printf, 2, 3)));
markus@openbsd.org091c3022015-01-19 19:52:16 +0000168int sshpkt_add_padding(struct ssh *, u_char);
djm@openbsd.org4509b5d2015-01-30 01:13:33 +0000169void sshpkt_fatal(struct ssh *ssh, const char *tag, int r);
markus@openbsd.org091c3022015-01-19 19:52:16 +0000170
171int sshpkt_put(struct ssh *ssh, const void *v, size_t len);
172int sshpkt_putb(struct ssh *ssh, const struct sshbuf *b);
173int sshpkt_put_u8(struct ssh *ssh, u_char val);
174int sshpkt_put_u32(struct ssh *ssh, u_int32_t val);
175int sshpkt_put_u64(struct ssh *ssh, u_int64_t val);
176int sshpkt_put_string(struct ssh *ssh, const void *v, size_t len);
177int sshpkt_put_cstring(struct ssh *ssh, const void *v);
178int sshpkt_put_stringb(struct ssh *ssh, const struct sshbuf *v);
179int sshpkt_put_ec(struct ssh *ssh, const EC_POINT *v, const EC_GROUP *g);
180int sshpkt_put_bignum1(struct ssh *ssh, const BIGNUM *v);
181int sshpkt_put_bignum2(struct ssh *ssh, const BIGNUM *v);
182
183int sshpkt_get(struct ssh *ssh, void *valp, size_t len);
184int sshpkt_get_u8(struct ssh *ssh, u_char *valp);
185int sshpkt_get_u32(struct ssh *ssh, u_int32_t *valp);
186int sshpkt_get_u64(struct ssh *ssh, u_int64_t *valp);
187int sshpkt_get_string(struct ssh *ssh, u_char **valp, size_t *lenp);
188int sshpkt_get_string_direct(struct ssh *ssh, const u_char **valp, size_t *lenp);
189int sshpkt_get_cstring(struct ssh *ssh, char **valp, size_t *lenp);
190int sshpkt_get_ec(struct ssh *ssh, EC_POINT *v, const EC_GROUP *g);
191int sshpkt_get_bignum1(struct ssh *ssh, BIGNUM *v);
192int sshpkt_get_bignum2(struct ssh *ssh, BIGNUM *v);
193int sshpkt_get_end(struct ssh *ssh);
194const u_char *sshpkt_ptr(struct ssh *, size_t *lenp);
195
196/* OLD API */
197extern struct ssh *active_state;
198#include "opacket.h"
Darren Tuckerf7288d72009-06-21 18:12:20 +1000199
Damien Miller773dda22015-01-30 23:10:17 +1100200#if !defined(WITH_OPENSSL)
201# undef BIGNUM
202# undef EC_KEY
203# undef EC_GROUP
204# undef EC_POINT
205#elif !defined(OPENSSL_HAS_ECC)
206# undef EC_KEY
207# undef EC_GROUP
208# undef EC_POINT
209#endif
210
Damien Miller95def091999-11-25 00:26:21 +1100211#endif /* PACKET_H */