|
Wireshark
4.3.0
The Wireshark network protocol analyzer
|
#include <glib.h>#include "ws_symbol_export.h"Go to the source code of this file.
Typedefs | |
| typedef void(* | secrets_block_callback_t) (const void *secrets, guint size) |
Functions | |
| void | secrets_init (void) |
| void | secrets_cleanup (void) |
| WS_DLL_PUBLIC void | secrets_wtap_callback (guint32 secrets_type, const void *secrets, guint size) |
| void | secrets_register_type (guint32 secrets_type, secrets_block_callback_t cb) |
Secrets management and processing. Copyright 2018, Peter Wu peter@lekensteyn.nl
Wireshark - Network traffic analyzer By Gerald Combs gerald@wireshark.org Copyright 1998 Gerald Combs
SPDX-License-Identifier: GPL-2.0-or-later
| typedef void(* secrets_block_callback_t) (const void *secrets, guint size) |
Receives a new block of secrets from an external source (wiretap or files).
| void secrets_init | ( | void | ) |
Interfaces for management and processing of secrets provided by external sources (wiretap, key files, HSMs, etc.). Dissectors can register themselves as consumers of these secrets.
Future idea: provide helper functions to manage external files. Typically these secrets can be erased when the file is truncated or deleted+created. Additionally, these secrets are not tied to the lifetime of a capture file.
Future idea: add a method for dissectors to mark secrets as "in use" such that unused entries can be removed when saving those secrets to file. Intended use case: read large TLS key log file (which is infrequently truncated by the user) and store only the bare minimum keys.
| void secrets_register_type | ( | guint32 | secrets_type, |
| secrets_block_callback_t | cb | ||
| ) |
Registers a consumer for pcapng Decryption Secrets Block (DSB). Only one dissector can register a type.
| secrets_type | A Secrets Type as defined in wiretap/secrets-types.h |
| cb | Callback to be invoked for new secrets. |
| WS_DLL_PUBLIC void secrets_wtap_callback | ( | guint32 | secrets_type, |
| const void * | secrets, | ||
| guint | size | ||
| ) |
Callback for the wiretap secrets provider (wtap_new_secrets_callback_t).