1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
#ifndef VL_NET_H_INCLUDED
#define VL_NET_H_INCLUDED
#include "arena.h"
enum {
/* The operation completed successfully */
NET_OK = 0,
/* There was some kind of error relating to I/O on the local system */
NET_EIO = -1,
/* There was some kind of network error downloading the file. */
NET_ENETWORK = -2,
/* The server gave us a bad status code while downloading the file. */
NET_ESTATUS = -3,
/* An unrecoverable integrity error occurred. */
NET_EINTEGRITY = -4,
/* An unspecified error occurred. */
NET_EUNSPEC = -5,
/* An unspecified (remote) error occurred. */
NET_EREMOTEUNSPEC = -6
};
enum {
VERIFY_SIZE = 1u,
VERIFY_SHA1 = 2u
};
/* Ensures the latest version of the file available at 'url' is downloaded to 'target_path'.
* Will avoid downloading the file if it hasn't changed.
*
* Never returns NET_EINTEGRITY. */
int vl_net_ensure_cached(vl_arena *scratch, const char *url, const char *target_path);
/* Will verify that the file at 'target_path' hasn't been tampered with since being updated
* by vl_net_ensure_cached.
*
* Returns NET_EIO if the file doesn't exist or couldn't be read.
* Returns NET_EINTEGRITY if the file on disk doesn't match. */
int vl_net_verify_cached(vl_arena *scratch, const char *target_path);
/* Downloads a file for which you know the integrity information (SHA1 and/or size) from 'url' to
* 'target_path'. Will not download the file if the file already exists with correct SHA1 and size
* (as specified).
*
* Pass variadic arguments in the following order:
* - size_t size (if VERIFY_SIZE is set)
* - const uint8_t *hash (if VERIFY_SHA1 is set)
*
* Returns NET_EINTEGRITY if the file at 'url' doesn't match the provided integrity information. */
int vl_net_ensure_verified(const char *url, const char *target_path, unsigned flags, ...);
/* See vl_net_ensure_verified for information on the variadic argument list.
*
* Returns NET_EINTEGRITY if the file at 'target_path' doesn't match the provided integrity information.
* Returns NET_EIO if the downloaded file is not readable or could not be verified due to an I/O issue. */
int vl_net_verify(const char *target_path, unsigned flags, ...);
#endif
|
