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.
119 lines
3.6 KiB
C
119 lines
3.6 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
|
|
|
|
#include "transmission.h"
|
|
#include "net.h"
|
|
|
|
/**
|
|
* @addtogroup file_io File IO
|
|
* @{
|
|
*/
|
|
|
|
void tr_fdSetFileLimit( tr_session * session, int limit );
|
|
|
|
int tr_fdGetFileLimit( tr_session * session );
|
|
|
|
void tr_fdSetGlobalPeerLimit( tr_session * session, int limit );
|
|
|
|
/***
|
|
****
|
|
***/
|
|
|
|
void tr_set_file_for_single_pass( int fd );
|
|
|
|
int tr_open_file_for_scanning( const char * filename );
|
|
|
|
int tr_open_file_for_writing( const char * filename );
|
|
|
|
void tr_close_file( int fd );
|
|
|
|
ssize_t tr_pread(int fd, void *buf, size_t count, off_t offset);
|
|
ssize_t tr_pwrite(int fd, const void *buf, size_t count, off_t offset);
|
|
int tr_prefetch(int fd, off_t offset, size_t count);
|
|
|
|
|
|
/**
|
|
* Returns an fd to the specified filename.
|
|
*
|
|
* A small pool of open files is kept to avoid the overhead of
|
|
* continually opening and closing the same files when downloading
|
|
* piece data.
|
|
*
|
|
* - if doWrite is true, subfolders in torrentFile are created if necessary.
|
|
* - if doWrite is true, the target file is created if necessary.
|
|
*
|
|
* on success, a file descriptor >= 0 is returned.
|
|
* on failure, a -1 is returned and errno is set.
|
|
*
|
|
* @see tr_fdFileClose
|
|
*/
|
|
int tr_fdFileCheckout( tr_session * session,
|
|
int torrentId,
|
|
tr_file_index_t fileNum,
|
|
const char * fileName,
|
|
tr_bool doWrite,
|
|
tr_preallocation_mode preallocationMode,
|
|
uint64_t desiredFileSize );
|
|
|
|
int tr_fdFileGetCached( tr_session * session,
|
|
int torrentId,
|
|
tr_file_index_t fileNum,
|
|
tr_bool doWrite );
|
|
|
|
/**
|
|
* Closes a file that's being held by our file repository.
|
|
*
|
|
* If the file isn't checked out, it's closed immediately.
|
|
* If the file is currently checked out, it will be closed upon its return.
|
|
*
|
|
* @see tr_fdFileCheckout
|
|
*/
|
|
void tr_fdFileClose( tr_session * session,
|
|
const tr_torrent * tor,
|
|
tr_file_index_t fileNo );
|
|
|
|
|
|
/**
|
|
* Closes all the files associated with a given torrent id
|
|
*/
|
|
void tr_fdTorrentClose( tr_session * session, int torrentId );
|
|
|
|
|
|
/***********************************************************************
|
|
* Sockets
|
|
**********************************************************************/
|
|
int tr_fdSocketCreate( tr_session * session, int domain, int type );
|
|
|
|
int tr_fdSocketAccept( tr_session * session,
|
|
int listening_sockfd,
|
|
tr_address * addr,
|
|
tr_port * port );
|
|
|
|
void tr_fdSocketClose( tr_session * session, int s );
|
|
|
|
/***********************************************************************
|
|
* tr_fdClose
|
|
***********************************************************************
|
|
* Frees resources allocated by tr_fdInit.
|
|
**********************************************************************/
|
|
void tr_fdClose( tr_session * session );
|
|
|
|
|
|
void tr_fdSetPeerLimit( tr_session * session, int n );
|
|
|
|
int tr_fdGetPeerLimit( const tr_session * );
|
|
|
|
/* @} */
|