139 lines
4.1 KiB
C
139 lines
4.1 KiB
C
/******************************************************************************
|
|
* $Id$
|
|
*
|
|
* Copyright (c) 2006-2007 Transmission authors and contributors
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a
|
|
* copy of this software and associated documentation files (the "Software"),
|
|
* to deal in the Software without restriction, including without limitation
|
|
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
* and/or sell copies of the Software, and to permit persons to whom the
|
|
* Software is furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
|
* DEALINGS IN THE SOFTWARE.
|
|
*****************************************************************************/
|
|
|
|
#ifndef TR_TORRENT_H
|
|
#define TR_TORRENT_H
|
|
|
|
#include <glib-object.h>
|
|
|
|
#include "transmission.h"
|
|
#include "bencode.h"
|
|
|
|
#include "util.h"
|
|
|
|
/* boxed type for tr_tracker_info_t */
|
|
#define TR_TRACKER_BOXED_TYPE (tr_tracker_boxed_get_type ())
|
|
GType
|
|
tr_tracker_boxed_get_type( void );
|
|
|
|
#define TR_TORRENT_TYPE (tr_torrent_get_type ())
|
|
#define TR_TORRENT(obj) \
|
|
(G_TYPE_CHECK_INSTANCE_CAST ((obj), TR_TORRENT_TYPE, TrTorrent))
|
|
#define TR_TORRENT_CLASS(klass) \
|
|
(G_TYPE_CHECK_CLASS_CAST ((klass), TR_TORRENT_TYPE, TrTorrentClass))
|
|
#define TR_IS_TORRENT(obj) \
|
|
(G_TYPE_CHECK_INSTANCE_TYPE ((obj), TR_TORRENT_TYPE))
|
|
#define TR_IS_TORRENT_CLASS(klass) \
|
|
(G_TYPE_CHECK_CLASS_TYPE ((klass), TR_TORRENT_TYPE))
|
|
#define TR_TORRENT_GET_CLASS(obj) \
|
|
(G_TYPE_INSTANCE_GET_CLASS ((obj), TR_TORRENT_TYPE, TrTorrentClass))
|
|
|
|
typedef struct _TrTorrent TrTorrent;
|
|
typedef struct _TrTorrentClass TrTorrentClass;
|
|
|
|
/* treat the contents of this structure as private */
|
|
struct _TrTorrent {
|
|
GObject parent;
|
|
tr_torrent_t *handle;
|
|
char *dir;
|
|
char *delfile;
|
|
tr_stat_t stat;
|
|
time_t lastStatTime;
|
|
|
|
/* FIXME: hm, are these heavyweight enough to deserve their own properties? */
|
|
gboolean severed;
|
|
gboolean disposed;
|
|
gboolean ul_cap_enabled;
|
|
gboolean dl_cap_enabled;
|
|
gboolean seeding_cap_enabled;
|
|
gint ul_cap; /* KiB/sec */
|
|
gint dl_cap; /* KiB/sec */
|
|
gdouble seeding_cap; /* ratio to stop seeding at */
|
|
};
|
|
|
|
struct _TrTorrentClass {
|
|
GObjectClass parent;
|
|
};
|
|
|
|
GType
|
|
tr_torrent_get_type(void);
|
|
|
|
tr_torrent_t *
|
|
tr_torrent_handle(TrTorrent *tor);
|
|
|
|
const tr_stat_t *
|
|
tr_torrent_stat(TrTorrent *tor);
|
|
|
|
const tr_info_t *
|
|
tr_torrent_info(TrTorrent *tor);
|
|
|
|
void
|
|
tr_torrent_start( TrTorrent * tor );
|
|
|
|
void
|
|
tr_torrent_stop( TrTorrent * tor );
|
|
|
|
char*
|
|
tr_torrent_status_str ( TrTorrent * tor );
|
|
|
|
void
|
|
tr_torrent_set_upload_cap_speed ( TrTorrent*, int KiB_sec );
|
|
void
|
|
tr_torrent_set_upload_cap_enabled ( TrTorrent*, gboolean );
|
|
|
|
void
|
|
tr_torrent_set_download_cap_speed ( TrTorrent*, int KiB_sec );
|
|
void
|
|
tr_torrent_set_download_cap_enabled ( TrTorrent*, gboolean );
|
|
|
|
void
|
|
tr_torrent_check_seeding_cap ( TrTorrent* );
|
|
void
|
|
tr_torrent_set_seeding_cap_ratio ( TrTorrent*, gdouble ratio );
|
|
void
|
|
tr_torrent_set_seeding_cap_enabled ( TrTorrent*, gboolean );
|
|
|
|
TrTorrent *
|
|
tr_torrent_new( tr_handle_t * handle, const char * path, const char * dir,
|
|
enum tr_torrent_action act, gboolean paused, char ** err);
|
|
|
|
TrTorrent *
|
|
tr_torrent_new_with_data( tr_handle_t * handle, uint8_t * data, size_t size,
|
|
const char * dir, gboolean paused, char ** err );
|
|
|
|
TrTorrent *
|
|
tr_torrent_new_with_state( tr_handle_t * handle, benc_val_t * state,
|
|
gboolean forcepaused, char ** err );
|
|
|
|
gboolean
|
|
tr_torrent_get_state( TrTorrent * tor, benc_val_t * state );
|
|
|
|
void
|
|
tr_torrent_state_saved(TrTorrent *tor);
|
|
|
|
void
|
|
tr_torrent_sever( TrTorrent * tor );
|
|
|
|
#endif
|