mirror/transmission
1
0
Fork 0
mirror of https://github.com/transmission/transmission synced 2024-12-26 01:27:28 +00:00
Code Issues Releases Wiki Activity

add a callback to notify clients when a torrent's state changes

Browse source
This commit is contained in:
Charles Kerr 2007-09-28 14:51:34 +00:00
parent 788a925fb0
commit f0c9f9a99a
3 changed files with 54 additions and 45 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

3
libtransmission/internal.h
View file

@ -157,7 +157,8 @@ struct tr_torrent
uint64_t stopDate;
uint64_t activityDate;
uint8_t hasChangedState;
tr_torrent_status_func * status_func;
void * status_func_user_data;
unsigned int runStatusToSaveIsSet : 1;
unsigned int pexDisabled : 1;

58
libtransmission/torrent.c
View file

@ -304,7 +304,6 @@ torrentRealInit( tr_handle * h,
tor->destination = tr_strdup( destination );
tor->handle = h;
tor->hasChangedState = -1;
tor->pexDisabled = 0;
tor->runStatusToSaveIsSet = FALSE;
@ -692,31 +691,6 @@ tr_torrentDisablePex( tr_torrent * tor, int disable )
tor->pexDisabled = disable;
}
static int tr_didStateChangeTo ( tr_torrent * tor, int status )
{
int ret;
tr_torrentLock( tor );
if (( ret = tor->hasChangedState == status ))
tor->hasChangedState = -1;
tr_torrentUnlock( tor );
return ret;
}
int tr_getIncomplete( tr_torrent * tor )
{
return tr_didStateChangeTo( tor, TR_CP_INCOMPLETE );
}
int tr_getDone( tr_torrent * tor )
{
return tr_didStateChangeTo( tor, TR_CP_DONE );
}
int tr_getComplete( tr_torrent * tor )
{
return tr_didStateChangeTo( tor, TR_CP_COMPLETE );
}
void
tr_manualUpdate( tr_torrent * tor )
{
@ -1117,6 +1091,36 @@ tr_torrentClose( tr_torrent * tor )
tr_timerNew( tor->handle, freeWhenStopped, tor, 250 );
}
/**
*** Completeness
**/
static void
fireStatusChange( tr_torrent * tor, cp_status_t status )
{
assert( tor != NULL );
assert( status==TR_CP_INCOMPLETE || status==TR_CP_DONE || status==TR_CP_COMPLETE );
if( tor->status_func != NULL )
(tor->status_func)( tor, status, tor->status_func_user_data );
}
void
tr_torrentSetStatusCallback( tr_torrent * tor,
tr_torrent_status_func func,
void * user_data )
{
assert( tor != NULL );
tor->status_func = func;
tor->status_func_user_data = user_data;
}
void
tr_torrentClearStatusCallback( tr_torrent * torrent )
{
tr_torrentSetStatusCallback( torrent, NULL, NULL );
}
void
tr_torrentRecheckCompleteness( tr_torrent * tor )
{
@ -1127,7 +1131,7 @@ tr_torrentRecheckCompleteness( tr_torrent * tor )
cpStatus = tr_cpGetStatus( tor->completion );
if( cpStatus != tor->cpStatus ) {
tor->cpStatus = cpStatus;
tor->hasChangedState = tor->cpStatus; /* tell the client... */
fireStatusChange( tor, cpStatus );
if( (cpStatus == TR_CP_COMPLETE) /* ...and if we're complete */
&& tor->downloadedCur ) { /* and it just happened */
tr_trackerCompleted( tor->tracker ); /* tell the tracker */

38
libtransmission/transmission.h
View file

@ -443,16 +443,28 @@ void tr_torrentStart( tr_torrent * );
**********************************************************************/
void tr_torrentStop( tr_torrent * );
/***********************************************************************
* tr_getComplete, tr_getIncomplete and tr_getPartial
***********************************************************************
* The first call after a torrent changed state returns 1. Returns 0
* in other cases.
**********************************************************************/
int tr_getIncomplete( tr_torrent * tor );
int tr_getDone( tr_torrent * tor );
int tr_getComplete( tr_torrent * tor );
/**
*** Register to be notified whenever a torrent's state changes.
**/
typedef enum
{
TR_CP_INCOMPLETE, /* doesn't have all the desired pieces */
TR_CP_DONE, /* has all the pieces but the DND ones */
TR_CP_COMPLETE /* has every piece */
}
cp_status_t;
typedef void (tr_torrent_status_func)(tr_torrent * torrent,
cp_status_t status,
void * user_data );
void tr_torrentSetStatusCallback( tr_torrent * torrent,
tr_torrent_status_func func,
void * user_data );
void tr_torrentClearStatusCallback( tr_torrent * torrent );
/**
* MANUAL ANNOUNCE
@ -611,14 +623,6 @@ torrent_status_t;
#define TR_STATUS_INACTIVE \
(TR_STATUS_STOPPING|TR_STATUS_STOPPED)
typedef enum
{
TR_CP_INCOMPLETE, /* doesn't have all the desired pieces */
TR_CP_DONE, /* has all the pieces but the DND ones */
TR_CP_COMPLETE /* has every piece */
}
cp_status_t;
/***********************************************************************
* tr_stat
**********************************************************************/