wireshark/ui/software_update.h

72 lines
1.7 KiB
C

/** @file
*
* Wrappers and routines to check for software updates.
*
* Wireshark - Network traffic analyzer
* By Gerald Combs <gerald@wireshark.org>
* Copyright 1998 Gerald Combs
*
* SPDX-License-Identifier: GPL-2.0-or-later
*/
#ifndef __SOFTWARE_UPDATE_H__
#define __SOFTWARE_UPDATE_H__
/** @file
* Automatic update routines.
*
* Routines that integrate with WinSparkle on Windows and Sparkle on
* macOS.
* @ingroup main_ui_group
*/
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
/** Initialize software updates.
*
* Does nothing on platforms that don't support software updates.
*/
extern void software_update_init(void);
/** Force a software update check.
*
* Does nothing on platforms that don't support software updates.
*/
extern void software_update_check(void);
/** Clean up software update checking.
*
* Does nothing on platforms that don't support software updates.
*/
extern void software_update_cleanup(void);
/** Fetch a description of the software update mechanism.
*
* @return NULL, "Sparkle", or "WinSparkle".
*/
extern const char *software_update_info(void);
#ifdef _WIN32
/** Check to see if Wireshark can shut down safely (e.g. offer to save the
* current capture). Called from a separate thread.
*
* Does nothing on platforms that don't support software updates.
*/
extern int software_update_can_shutdown_callback(void);
/** Shut down Wireshark in preparation for an upgrade. Called from a separate
* thread.
*
* Does nothing on platforms that don't support software updates.
*/
extern void software_update_shutdown_request_callback(void);
#endif
#ifdef __cplusplus
}
#endif /* __cplusplus */
#endif /* __SOFTWARE_UPDATE_H__ */