mirror of
https://github.com/transmission/transmission
synced 2024-12-26 09:37:56 +00:00
879a2afcbd
The Berne Convention says that the copyright year is moot, so instead of adding another year to each file as in previous years, I've removed the year altogether from the source code comments in libtransmission, gtk, qt, utils, daemon, and cli. Juliusz's copyright notice in tr-dht and Johannes' copyright notice in tr-lpd have been left alone; it didn't seem appropriate to modify them.
71 lines
2 KiB
C
71 lines
2 KiB
C
/*
|
|
* This file Copyright (C) Mnemosyne LLC
|
|
*
|
|
* This file is licensed by the GPL version 2. Works owned by the
|
|
* Transmission project are granted a special exemption to clause 2(b)
|
|
* so that the bulk of its code can remain under the MIT license.
|
|
* This exemption does not extend to derived works not owned by
|
|
* the Transmission project.
|
|
*
|
|
* $Id$
|
|
*/
|
|
|
|
#ifndef __TRANSMISSION__
|
|
#error only libtransmission should #include this header.
|
|
#endif
|
|
|
|
#ifndef TR_IO_H
|
|
#define TR_IO_H 1
|
|
|
|
struct tr_torrent;
|
|
|
|
/**
|
|
* @addtogroup file_io File IO
|
|
* @{
|
|
*/
|
|
|
|
/**
|
|
* Reads the block specified by the piece index, offset, and length.
|
|
* @return 0 on success, or an errno value on failure.
|
|
*/
|
|
int tr_ioRead( struct tr_torrent * tor,
|
|
tr_piece_index_t pieceIndex,
|
|
uint32_t offset,
|
|
uint32_t len,
|
|
uint8_t * setme );
|
|
|
|
int
|
|
tr_ioPrefetch( tr_torrent * tor,
|
|
tr_piece_index_t pieceIndex,
|
|
uint32_t begin,
|
|
uint32_t len );
|
|
|
|
/**
|
|
* Writes the block specified by the piece index, offset, and length.
|
|
* @return 0 on success, or an errno value on failure.
|
|
*/
|
|
int tr_ioWrite( struct tr_torrent * tor,
|
|
tr_piece_index_t pieceIndex,
|
|
uint32_t offset,
|
|
uint32_t len,
|
|
const uint8_t * writeme );
|
|
|
|
/**
|
|
* @brief Test to see if the piece matches its metainfo's SHA1 checksum.
|
|
*/
|
|
tr_bool tr_ioTestPiece( tr_torrent * tor,
|
|
tr_piece_index_t piece );
|
|
|
|
|
|
/**
|
|
* Converts a piece index + offset into a file index + offset.
|
|
*/
|
|
void tr_ioFindFileLocation( const tr_torrent * tor,
|
|
tr_piece_index_t pieceIndex,
|
|
uint32_t pieceOffset,
|
|
tr_file_index_t * fileIndex,
|
|
uint64_t * fileOffset );
|
|
|
|
|
|
/* @} */
|
|
#endif
|