summaryrefslogtreecommitdiff
path: root/src/bencode.h
blob: 23fc51a523a1ec3661fec24b1cfaa894a4723c07 (plain)
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
65
66
/*
 * C implementation of a bencode decoder.
 * This is the format defined by BitTorrent:
 *  http://wiki.theory.org/BitTorrentSpecification#bencoding
 *
 * The only external requirements are a few [standard] function calls and
 * the gint64 type.  Any sane system should provide all of these things.
 *
 * This is released into the public domain.
 * Written by Mike Frysinger <vapier@gmail.com>.
 */

/* USAGE:
 *  - pass the string full of the bencoded data to be_decode()
 *  - parse the resulting tree however you like
 *  - call be_free() on the tree to release resources
 */

#ifndef _BENCODE_H
#define _BENCODE_H

#ifdef __cplusplus
extern "C" {
#endif

    typedef enum {
        BE_STR,
        BE_INT,
        BE_LIST,
        BE_DICT
    } be_type;

    struct be_dict;
    struct be_node;

/*
 * XXX: the "val" field of be_dict and be_node can be confusing ...
 */

    typedef struct be_dict {
        char *key;
        struct be_node *val;
    } be_dict;

    typedef struct be_node {
        be_type type;
        union {
            char *s;
            gint64 i;
            struct be_node **l;
            struct be_dict *d;
        } val;
    } be_node;

    gint64 be_str_len(be_node * node);
    be_node *be_decode(const char *bencode);
    be_node *be_decoden(const char *bencode, gint64 bencode_len);
    void be_free(be_node * node);
    void be_dump(be_node * node);
    be_node *be_dict_find(be_node * node, char *key, int type);
    gboolean be_validate_node(be_node * node, gint type);

#ifdef __cplusplus
}
#endif
#endif