BTGCALLBACK

NAME

btg event callback

DESCRIPTION

The btg daemon is capable of calling a user specified script or executable in order to report events. The location of the script or executable is specified in the passwd file.

INTERFACE

/path/to/script <EVENT> <EVENTPARAMETERS>

The daemon executes a script or executable specified for an user when an event happends. The first parameter is the event name. The following parameters depends on the event.

EVENTS

The following events.

ADD
Description

Event reported when a torrent file is added.

Parameters

<EVENT> is set to "ADD". <EVENTPARAMETERS> is set to the file name of the torrent file which was added.

REMOVE
Description

Event reported when a torrent file is removed.

Parameters

<EVENT> is set to "REMOVE". <EVENTPARAMETERS> is set to the file name of the torrent file which was removed.

FINISHED
Description

Event reported when a torrent file finishes downloading and is stopped. This can happen because of a set seed timer.

Parameters

<EVENT> is set to "FINISHED". <EVENTPARAMETERS> is set to the file name of the torrent file which finished downloading.

SEEDING
Description

Event reported when a torrent file begins seeding.

Parameters

<EVENT> is set to "SEEDING".

<EVENTPARAMETERS> is set to the file name of the torrent file which began seeding.

CLEAN
Description

Event reported when a torrent file is cleaned - which means that it is moved from the user work directory to the users destination directory.

Parameters

<EVENT> is set to "CLEAN".

<EVENTPARAMETERS> is as follows. The first parameter is the name of the torrent file which was cleaned. The following parameters are all unique top directories or file names contained in the torrent file which was cleaned.

EXAMPLE SCRIPT

#!/bin/sh

LOGFILE="/tmp/btgdaemon.callback.log"

echo "New event." >> $LOGFILE
date >> $LOGFILE
echo "Arguments: $*" >> $LOGFILE

# Check the different events.

case "$1" in
ADD)
echo "Torrent file ’$2’ was added." >> $LOGFILE
;;

REMOVE)
echo "Torrent file ’$2’ was removed." >> $LOGFILE
;;

FINISHED)
echo "Torrent file ’$2’ finished." >> $LOGFILE
;;

SEEDING)
echo "Torrent file ’$2’ began seeding." >> $LOGFILE
;;

CLEAN)
echo "Torrent file ’$2’ was cleaned." >> $LOGFILE
;;

*)
echo "Unknown option." >> $LOGFILE
;;
esac

FILES

~/.btg/passwd - the daemon passwd file.

AUTHOR

Written by Michael Wojciechowski.

SEE ALSO

btgdaemon(5)