packet-tls.h

/* packet-tls.h
 *
 * Wireshark - Network traffic analyzer
 * By Gerald Combs <[email protected]>
 * Copyright 1998 Gerald Combs
 *
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 */
 
#ifndef __PACKET_TLS_H__
#define __PACKET_TLS_H__
 
#include "ws_symbol_export.h"
#include <epan/packet.h>
 
/* Opaque structure; the details are defined in packet-tls-utils.h */
typedef struct _SslDecryptSession SslDecryptSession;
 
struct tlsinfo {
        uint32_t seq; /* The sequence number within the TLS stream. */
        bool is_reassembled;
        bool end_of_stream; /* TCP FIN, close_notify, etc. */
        /* The app handle for the session, set by heuristic dissectors
         * to be called in the future. */
        dissector_handle_t *app_handle;
};
 
WS_DLL_PUBLIC void ssl_dissector_add(unsigned port, dissector_handle_t handle);
WS_DLL_PUBLIC void ssl_dissector_delete(unsigned port, dissector_handle_t handle);
 
WS_DLL_PUBLIC void ssl_set_master_secret(uint32_t frame_num, address *addr_srv, address *addr_cli,
                                  port_type ptype, uint32_t port_srv, uint32_t port_cli,
                                  uint32_t version, int cipher, const unsigned char *_master_secret,
                                  const unsigned char *_client_random, const unsigned char *_server_random,
                                  uint32_t client_seq, uint32_t server_seq);

extern SslDecryptSession *
tls_get_current_session(packet_info *pinfo);

extern SslDecryptSession *
tls_get_parent_session(packet_info *pinfo);

extern bool
tls_get_cipher_info(SslDecryptSession *tls_session, uint16_t cipher_suite, int *cipher_algo, int *cipher_mode, int *hash_algo);

bool
tls13_exporter(SslDecryptSession *tls_session, bool is_early,
               const char *label, uint8_t *context,
               unsigned context_length, unsigned key_length, unsigned char **out);
 
int
tls13_get_quic_secret(packet_info *pinfo, bool is_from_server, int type, unsigned secret_min_len, unsigned secret_max_len, uint8_t *secret_out);

const char *
tls_get_alpn(SslDecryptSession *tls_session);

const char *
tls_get_client_alpn(SslDecryptSession *tls_session);
 
extern uint32_t
tls_increment_stream_count(void);
 
#endif  /* __PACKET_TLS_H__ */