/usr/include/rhash_torrent.h is in librhash-dev 1.3.3-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 | /* rhash_torrent.h */
#ifndef RHASH_TORRENT_H
#define RHASH_TORRENT_H
#ifdef __cplusplus
extern "C" {
#endif
#ifndef RHASH_API
/* modifier for LibRHash functions */
# define RHASH_API
#endif
#ifndef LIBRHASH_RHASH_CTX_DEFINED
#define LIBRHASH_RHASH_CTX_DEFINED
/**
* Hashing context.
*/
typedef struct rhash_context* rhash;
#endif /* LIBRHASH_RHASH_CTX_DEFINED */
/**
* Binary string with length
*/
typedef struct rhash_str
{
char* str;
size_t length;
} rhash_str;
/* possible torrent options */
#define RHASH_TORRENT_OPT_PRIVATE 1
#define RHASH_TORRENT_OPT_INFOHASH_ONLY 2
/* torrent functions */
/**
* Add a file info into the batch of files of given torrent.
*
* @param ctx rhash context
* @param filepath file path
* @param filesize file size
* @return non-zero on success, zero on fail
*/
RHASH_API int rhash_torrent_add_file(rhash ctx, const char* filepath, uint64_t filesize);
/**
* Set the torrent algorithm options.
*
* @param ctx rhash context
* @param options the options to set
*/
RHASH_API void rhash_torrent_set_options(rhash ctx, unsigned options);
/**
* Add an torrent announcement-URL for storing into torrent file.
*
* @param ctx rhash context
* @param announce_url the announcement-URL
* @return non-zero on success, zero on error
*/
RHASH_API int rhash_torrent_add_announce(rhash ctx, const char* announce_url);
/**
* Set optional name of the program generating the torrent
* for storing into torrent file.
*
* @param ctx rhash context
* @param name the program name
* @return non-zero on success, zero on error
*/
RHASH_API int rhash_torrent_set_program_name(rhash ctx, const char* name);
/**
* Set length of a file piece.
*
* @param ctx rhash context
* @param piece_length the piece length in bytes
*/
RHASH_API void rhash_torrent_set_piece_length(rhash ctx, size_t piece_length);
/**
* Calculate, using uTorrent algorithm, the default torrent piece length
* for a given torrent batch size.
*
* @param total_size the total size of files included into a torrent file
* @return piece length for the torrent file
*/
RHASH_API size_t rhash_torrent_get_default_piece_length(uint64_t total_size);
/*
* Macro to set a torrent batch size (the total size of files included into this torrent).
* It's defined as rhash_torrent_set_piece_length(ctx, rhash_torrent_get_default_piece_length(total_size))
*
* @param ctx rhash context
* @param total_size total size of files included into the torrent file
*/
#define rhash_torrent_set_batch_size(ctx, total_size) \
rhash_torrent_set_piece_length((ctx), rhash_torrent_get_default_piece_length(total_size))
/**
* Get the content of the generated torrent file.
*
* @param ctx rhash context
* @return binary string with the torrent file content, if successful.
* On fail the function returns NULL.
*/
RHASH_API const rhash_str* rhash_torrent_generate_content(rhash ctx);
#ifdef __cplusplus
} /* extern "C" */
#endif /* __cplusplus */
#endif /* RHASH_TORRENT_H */
|