mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
386392690d
libpv is a collection of definitions and functions related to Protected Virtualization (PV). The functions cover mainly encryption (e.g. AES-GCM) and certificates (X509). There are also helping functions for glib2. Most of the code is extracted+refactored from `genprotimg`, which will use this library in future. Requires openssl v1.1.1+, glib2.56+, and libcurl. libpv is not designed or intended to be dynamically linked or used outside of this project. Its purpose is to avoid code duplication as PV tools do very similar things regarding cryptography. Signed-off-by: Steffen Eiden <seiden@linux.ibm.com> Acked-by: Marc Hartmayer <mhartmay@linux.ibm.com> Signed-off-by: Jan Höppner <hoeppner@linux.ibm.com>
54 lines
1.3 KiB
C
54 lines
1.3 KiB
C
/*
|
|
* Libcurl utils
|
|
*
|
|
* Copyright IBM Corp. 2022
|
|
*
|
|
* s390-tools is free software; you can redistribute it and/or modify
|
|
* it under the terms of the MIT license. See LICENSE for details.
|
|
*/
|
|
#ifndef LIBPV_CURL_H
|
|
#define LIBPV_CURL_H
|
|
|
|
#include <curl/curl.h>
|
|
|
|
#include "libpv/common.h"
|
|
|
|
#define CRL_DOWNLOAD_TIMEOUT_MS 3000
|
|
#define CRL_DOWNLOAD_MAX_SIZE 0x100000
|
|
|
|
WRAPPED_G_DEFINE_AUTOPTR_CLEANUP_FUNC(CURL, curl_easy_cleanup)
|
|
|
|
/** curl_download:
|
|
* @url: URL to specify location of data
|
|
* @timeout_ms: time to wait until fail
|
|
* @max_size: Maximum size of the downloaded data
|
|
* @error: return location for a GError
|
|
*
|
|
* Returns: (nullable) (transfer full): Downloaded data as #GByteArray
|
|
*/
|
|
GByteArray *curl_download(const char *url, long timeout_ms, uint max_size, GError **err);
|
|
|
|
/** pv_curl_init:
|
|
*
|
|
* Should not be called by user.
|
|
* Use pv_init() instead which
|
|
* calls this function during creation.
|
|
*/
|
|
int pv_curl_init(void);
|
|
|
|
/** pv_curl_cleanup:
|
|
*
|
|
* Should not be called by user.
|
|
* Use pv_cleanup() instead which
|
|
* calls this function during creation.
|
|
*/
|
|
void pv_curl_cleanup(void);
|
|
|
|
#define PV_CURL_ERROR g_quark_from_static_string("pv-curl-error-quark")
|
|
typedef enum {
|
|
PV_CURL_ERROR_CURL_INIT_FAILED,
|
|
PV_CURL_ERROR_DOWNLOAD_FAILED,
|
|
} PvCurlErrors;
|
|
|
|
#endif /* LIBPV_CURL_H */
|