2005-01-20 23:22:22 +00:00
|
|
|
// Berkeley Open Infrastructure for Network Computing
|
|
|
|
// http://boinc.berkeley.edu
|
|
|
|
// Copyright (C) 2005 University of California
|
2003-07-23 22:24:28 +00:00
|
|
|
//
|
2005-01-20 23:22:22 +00:00
|
|
|
// This is free software; you can redistribute it and/or
|
|
|
|
// modify it under the terms of the GNU Lesser General Public
|
|
|
|
// License as published by the Free Software Foundation;
|
|
|
|
// either version 2.1 of the License, or (at your option) any later version.
|
2003-07-23 22:24:28 +00:00
|
|
|
//
|
2005-01-20 23:22:22 +00:00
|
|
|
// This software is distributed in the hope that it will be useful,
|
|
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
|
|
// See the GNU Lesser General Public License for more details.
|
2002-06-10 06:14:18 +00:00
|
|
|
//
|
2005-01-20 23:22:22 +00:00
|
|
|
// To view the GNU Lesser General Public License visit
|
|
|
|
// http://www.gnu.org/copyleft/lesser.html
|
|
|
|
// or write to the Free Software Foundation, Inc.,
|
|
|
|
// 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
2002-06-10 06:14:18 +00:00
|
|
|
|
2003-10-27 17:10:48 +00:00
|
|
|
#ifndef _PERS_FILE_XFER_H
|
|
|
|
#define _PERS_FILE_XFER_H
|
|
|
|
|
2002-08-07 22:52:10 +00:00
|
|
|
#include "client_types.h"
|
|
|
|
#include "file_xfer.h"
|
|
|
|
|
2002-12-20 02:12:27 +00:00
|
|
|
|
2002-06-10 06:14:18 +00:00
|
|
|
// PERS_FILE_XFER represents a persistent file transfer.
|
|
|
|
// A set of URL is given in the FILE_INFO.
|
|
|
|
|
|
|
|
// For download, the object attempts to download the file
|
|
|
|
// from any of the URLs.
|
|
|
|
// If one fails or is not available, try another,
|
|
|
|
// using an exponential backoff policy to avoid flooding servers.
|
|
|
|
|
|
|
|
// For upload, try to upload the file to the first URL;
|
2003-05-06 21:43:26 +00:00
|
|
|
// if that gets transient failure, try the others.
|
2002-06-10 06:14:18 +00:00
|
|
|
|
2003-06-11 22:15:25 +00:00
|
|
|
// Default values for exponential backoff
|
2002-12-20 02:12:27 +00:00
|
|
|
#define PERS_RETRY_DELAY_MIN 60 // 1 minute
|
2002-11-19 22:57:05 +00:00
|
|
|
#define PERS_RETRY_DELAY_MAX (60*60*4) // 4 hours
|
2003-02-04 21:47:12 +00:00
|
|
|
#define PERS_GIVEUP (60*60*24*7*2) // 2 weeks
|
2003-05-06 21:43:26 +00:00
|
|
|
// give up on xfer if this time elapses since last byte xferred
|
2002-12-20 02:12:27 +00:00
|
|
|
|
2002-06-10 06:14:18 +00:00
|
|
|
class PERS_FILE_XFER {
|
2002-11-19 22:57:05 +00:00
|
|
|
int nretry; // # of retries so far
|
2004-10-25 20:16:30 +00:00
|
|
|
double first_request_time; // time of first transfer request
|
2002-06-10 06:14:18 +00:00
|
|
|
|
2002-08-07 22:52:10 +00:00
|
|
|
public:
|
2004-12-01 20:56:20 +00:00
|
|
|
bool is_upload;
|
2004-10-25 20:16:30 +00:00
|
|
|
double next_request_time; // UNIX time to next retry the file request
|
2004-04-05 06:55:09 +00:00
|
|
|
double time_so_far;
|
|
|
|
// Total time there's been an active FILE_XFER for this PFX
|
|
|
|
// Currently not used for anything; not meaningful for throughput
|
|
|
|
// because could include repeated transfer
|
|
|
|
double last_time;
|
|
|
|
// when the above was last updated.
|
|
|
|
// Defined only while a transfer is active
|
2004-09-04 05:21:33 +00:00
|
|
|
bool pers_xfer_done;
|
2002-08-07 22:52:10 +00:00
|
|
|
FILE_XFER* fxp; // nonzero if file xfer in progress
|
|
|
|
FILE_INFO* fip;
|
2003-07-23 22:24:28 +00:00
|
|
|
|
2003-02-06 19:01:49 +00:00
|
|
|
PERS_FILE_XFER();
|
2003-07-23 22:24:28 +00:00
|
|
|
~PERS_FILE_XFER();
|
2002-08-07 22:52:10 +00:00
|
|
|
int init(FILE_INFO*, bool is_file_upload);
|
2004-10-14 22:01:05 +00:00
|
|
|
bool poll(double);
|
2003-05-20 00:03:39 +00:00
|
|
|
void handle_xfer_failure();
|
|
|
|
void retry_or_backoff();
|
2004-07-06 17:37:58 +00:00
|
|
|
void check_giveup(char*);
|
2004-09-26 04:16:52 +00:00
|
|
|
void abort();
|
2004-06-12 04:45:36 +00:00
|
|
|
int write(MIOFILE& fout);
|
|
|
|
int parse(MIOFILE& fin);
|
2003-05-16 19:22:57 +00:00
|
|
|
int start_xfer();
|
2003-07-29 23:26:32 +00:00
|
|
|
void suspend();
|
2002-06-10 06:14:18 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
class PERS_FILE_XFER_SET {
|
|
|
|
FILE_XFER_SET* file_xfers;
|
|
|
|
public:
|
2004-06-30 18:17:21 +00:00
|
|
|
std::vector<PERS_FILE_XFER*>pers_file_xfers;
|
2003-07-23 22:24:28 +00:00
|
|
|
|
2002-06-10 06:14:18 +00:00
|
|
|
PERS_FILE_XFER_SET(FILE_XFER_SET*);
|
|
|
|
int insert(PERS_FILE_XFER*);
|
|
|
|
int remove(PERS_FILE_XFER*);
|
2004-10-14 22:01:05 +00:00
|
|
|
bool poll(double);
|
2003-07-29 23:26:32 +00:00
|
|
|
void suspend();
|
2002-06-10 06:14:18 +00:00
|
|
|
};
|
2003-10-27 17:10:48 +00:00
|
|
|
|
|
|
|
#endif
|