boinc/tools/backend_lib.h

161 lines
4.2 KiB
C

// This file is part of BOINC.
// http://boinc.berkeley.edu
// Copyright (C) 2008 University of California
//
// BOINC 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 3 of the License, or (at your option) any later version.
//
// BOINC 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.
//
// You should have received a copy of the GNU Lesser General Public License
// along with BOINC. If not, see <http://www.gnu.org/licenses/>.
#ifndef H_BACKEND_LIB
#define H_BACKEND_LIB
#include <limits.h>
#include "crypt.h"
#include "sched_config.h"
#include "boinc_db.h"
// describes an input file, possibly remote
//
struct INFILE_DESC {
bool is_remote;
// the following defined if remote (physical name is jf_MD5)
//
double nbytes;
char md5[64];
char url[1024]; // make this a vector to support multiple URLs
// the following defined if not remote
//
char name[1024]; // physical name
};
extern int add_signatures(char*, R_RSA_PRIVATE_KEY&);
extern int remove_signatures(char*);
extern int process_result_template(
char* result_template,
R_RSA_PRIVATE_KEY& key,
char* base_filename,
SCHED_CONFIG&
);
extern int read_file(FILE*, char* buf);
extern int read_filename(const char* path, char* buf, int len);
extern void initialize_result(DB_RESULT&, DB_WORKUNIT&);
extern int create_result(
WORKUNIT&,
char* result_template_filename,
char* suffix,
R_RSA_PRIVATE_KEY& key,
SCHED_CONFIG& config,
char* query_string=0,
int priority_increase=0
);
extern int create_result_ti(
TRANSITIONER_ITEM&,
char* result_template_filename,
char* suffix,
R_RSA_PRIVATE_KEY& key,
SCHED_CONFIG& config,
char* query_string=0,
int priority_increase=0
);
extern int create_work(
DB_WORKUNIT& wu,
const char* wu_template,
const char* result_template_filename,
const char* result_template_filepath,
const char** infiles,
int ninfiles,
SCHED_CONFIG&,
const char* command_line = NULL,
const char* additional_xml = NULL,
char* query_string = 0
);
extern int create_work2(
DB_WORKUNIT& wu,
const char* wu_template,
const char* result_template_filename,
const char* result_template_filepath,
vector<INFILE_DESC>&,
SCHED_CONFIG&,
const char* command_line = NULL,
const char* additional_xml = NULL,
char* query_string = 0
);
extern int stage_file(const char*, bool);
// the following functions return XML that can be put in
// scheduler replies to do file operations
//
extern int put_file_xml(
const char* file_name, vector<const char*> urls,
const char* md5, double nbytes, double report_deadline,
char* buf
);
extern int get_file_xml(
const char* file_name, vector<const char*> urls,
double max_nbytes,
double report_deadline,
bool generate_upload_certificate,
R_RSA_PRIVATE_KEY& key,
char* buf
);
extern int delete_file_xml(
const char* file_name,
char* buf
);
// the following 3 functions are for programs other than the scheduler
// to do file operations.
// They work by creating MSG_TO_HOST records in the DB,
// containing the needed XML
//
extern int create_put_file_msg(
int host_id, const char* file_name, vector<const char*> urls,
const char* md5, double nbytes, double report_deadline
);
extern int create_get_file_msg(
int host_id, const char* file_name, vector<const char*> urls,
double max_nbytes,
double report_deadline,
bool generate_upload_certificate,
R_RSA_PRIVATE_KEY& key
);
extern int create_delete_file_msg(
int host_id,
const char* file_name
);
// cancel jobs from min_id to max_id inclusive
//
extern int cancel_jobs(int min_id, int max_id);
// cancel a particular job
//
extern int cancel_job(DB_WORKUNIT&);
extern int get_total_quota(double&);
extern int get_project_flops(double&);
extern double user_priority_delta(DB_USER_SUBMIT&, double, double, double);
#endif