X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=bacula%2Fsrc%2Fstored%2Fprotos.h;h=c8563b69d7ded9de996bfbbb8561e17774ad8284;hb=3187e8fbe9f6821b7b6ae9f733c8daae3167735f;hp=6c32549aafeb0e4ea68ccc9c586a92875dc0fdc0;hpb=787823a1a5ba78e05a2feceed636bbe431ed9267;p=bacula%2Fbacula diff --git a/bacula/src/stored/protos.h b/bacula/src/stored/protos.h index 6c32549aaf..c8563b69d7 100644 --- a/bacula/src/stored/protos.h +++ b/bacula/src/stored/protos.h @@ -1,41 +1,49 @@ /* - * Protypes for stored - * - * Version $Id$ - */ + Bacula® - The Network Backup Solution -/* - Copyright (C) 2000-2005 Kern Sibbald + Copyright (C) 2000-2010 Free Software Foundation Europe e.V. - This program is free software; you can redistribute it and/or - modify it under the terms of the GNU General Public License as - published by the Free Software Foundation; either version 2 of - the License, or (at your option) any later version. + The main author of Bacula is Kern Sibbald, with contributions from + many others, a complete list can be found in the file AUTHORS. + This program is Free Software; you can redistribute it and/or + modify it under the terms of version two of the GNU General Public + License as published by the Free Software Foundation and included + in the file LICENSE. - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of + This program 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 General Public License for more details. - You should have received a copy of the GNU General Public - License along with this program; if not, write to the Free - Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, - MA 02111-1307, USA. + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + 02110-1301, USA. + Bacula® is a registered trademark of Kern Sibbald. + The licensor of Bacula is the Free Software Foundation Europe + (FSFE), Fiduciary Program, Sumatrastrasse 25, 8006 Zürich, + Switzerland, email:ftf@fsfeurope.org. +*/ +/* + * Protypes for stored -- Kern Sibbald MM + * */ /* From stored.c */ uint32_t new_VolSessionId(); /* From acquire.c */ -bool reserve_device_for_append(DCR *dcr); DCR *acquire_device_for_append(DCR *dcr); -bool reserve_device_for_read(DCR *dcr); -DCR *acquire_device_for_read(DCR *dcr); +bool acquire_device_for_read(DCR *dcr); bool release_device(DCR *dcr); -DCR *new_dcr(JCR *jcr, DEVICE *dev); +bool clean_device(DCR *dcr); +DCR *new_dcr(JCR *jcr, DCR *dcr, DEVICE *dev); void free_dcr(DCR *dcr); +/* From append.c */ +bool send_attrs_to_dir(JCR *jcr, DEV_RECORD *rec); + /* From askdir.c */ enum get_vol_info_rw { GET_VOL_INFO_FOR_WRITE, @@ -43,12 +51,12 @@ enum get_vol_info_rw { }; bool dir_get_volume_info(DCR *dcr, enum get_vol_info_rw); bool dir_find_next_appendable_volume(DCR *dcr); -bool dir_update_volume_info(DCR *dcr, bool label); +bool dir_update_volume_info(DCR *dcr, bool label, bool update_LastWritten); bool dir_ask_sysop_to_create_appendable_volume(DCR *dcr); -bool dir_ask_sysop_to_mount_volume(DCR *dcr); +bool dir_ask_sysop_to_mount_volume(DCR *dcr, int mode); bool dir_update_file_attributes(DCR *dcr, DEV_RECORD *rec); bool dir_send_job_status(JCR *jcr); -bool dir_create_jobmedia_record(DCR *dcr); +bool dir_create_jobmedia_record(DCR *dcr, bool zero=false); bool dir_update_device(JCR *jcr, DEVICE *dev); bool dir_update_changer(JCR *jcr, AUTOCHANGER *changer); @@ -57,10 +65,13 @@ int authenticate_director(JCR *jcr); int authenticate_filed(JCR *jcr); /* From autochanger.c */ +bool init_autochangers(); int autoload_device(DCR *dcr, int writing, BSOCK *dir); bool autochanger_cmd(DCR *dcr, BSOCK *dir, const char *cmd); -void mark_volume_not_inchanger(DCR *dcr); -char *edit_device_codes(DCR *dcr, char *omsg, const char *cmd); +bool unload_autochanger(DCR *dcr, int loaded); +bool unload_dev(DCR *dcr, DEVICE *dev); +char *edit_device_codes(DCR *dcr, char *omsg, const char *imsg, const char *cmd); +int get_autochanger_loaded_slot(DCR *dcr); /* From block.c */ void dump_block(DEV_BLOCK *b, const char *msg); @@ -87,65 +98,40 @@ void display_tape_error_status(JCR *jcr, DEVICE *dev); /* From dev.c */ -DEVICE *init_dev(JCR *jcr, DEVICE *dev, DEVRES *device); -int open_dev(DEVICE *dev, char *VolName, int mode); -off_t lseek_dev(DEVICE *dev, off_t offset, int whence); -int open_first_part(DEVICE *dev); -int open_next_part(DEVICE *dev); -int open_guess_name_dev(DEVICE *dev); -void close_dev(DEVICE *dev); -void force_close_dev(DEVICE *dev); -bool truncate_dev(DEVICE *dev); -void term_dev(DEVICE *dev); -char * strerror_dev(DEVICE *dev); -void clrerror_dev(DEVICE *dev, int func); -bool update_pos_dev(DEVICE *dev); -bool rewind_dev(DEVICE *dev); +DEVICE *init_dev(JCR *jcr, DEVRES *device); +bool can_open_mounted_dev(DEVICE *dev); bool load_dev(DEVICE *dev); -bool offline_dev(DEVICE *dev); -int flush_dev(DEVICE *dev); -int weof_dev(DEVICE *dev, int num); int write_block(DEVICE *dev); uint32_t status_dev(DEVICE *dev); -bool eod_dev(DEVICE *dev); -bool fsf_dev(DEVICE *dev, int num); -bool fsr_dev(DEVICE *dev, int num); -bool bsf_dev(DEVICE *dev, int num); -bool bsr_dev(DEVICE *dev, int num); void attach_jcr_to_device(DEVICE *dev, JCR *jcr); void detach_jcr_from_device(DEVICE *dev, JCR *jcr); JCR *next_attached_jcr(DEVICE *dev, JCR *jcr); -bool dev_can_write(DEVICE *dev); -bool offline_or_rewind_dev(DEVICE *dev); -bool reposition_dev(DEVICE *dev, uint32_t file, uint32_t block); void init_device_wait_timers(DCR *dcr); +void init_jcr_device_wait_timers(JCR *jcr); bool double_dev_wait_time(DEVICE *dev); /* Get info about device */ char * dev_vol_name(DEVICE *dev); -uint32_t dev_block(DEVICE *dev); -uint32_t dev_file(DEVICE *dev); /* From dvd.c */ -bool dvd_close_job(DCR *dcr); - +int dvd_open_next_part(DCR *dcr); +bool dvd_write_part(DCR *dcr); +bool dvd_close_job(DCR *dcr); +void make_mounted_dvd_filename(DEVICE *dev, POOL_MEM &archive_name); +void make_spooled_dvd_filename(DEVICE *dev, POOL_MEM &archive_name); +bool truncate_dvd(DCR *dcr); +bool check_can_write_on_non_blank_dvd(DCR *dcr); +int find_num_dvd_parts(DCR *dcr); +boffset_t lseek_dvd(DCR *dcr, boffset_t offset, int whence); +void dvd_remove_empty_part(DCR *dcr); /* From device.c */ bool open_device(DCR *dcr); -bool first_open_device(DEVICE *dev); -bool fixup_device_block_write_error(DCR *dcr); -void _lock_device(const char *file, int line, DEVICE *dev); -void _unlock_device(const char *file, int line, DEVICE *dev); -void _block_device(const char *file, int line, DEVICE *dev, int state); -void _unblock_device(const char *file, int line, DEVICE *dev); -void _steal_device_lock(const char *file, int line, DEVICE *dev, bsteal_lock_t *hold, int state); -void _give_back_device_lock(const char *file, int line, DEVICE *dev, bsteal_lock_t *hold); +bool first_open_device(DCR *dcr); +bool fixup_device_block_write_error(DCR *dcr, int retries=4); +void set_start_vol_position(DCR *dcr); void set_new_volume_parameters(DCR *dcr); void set_new_file_parameters(DCR *dcr); -bool device_is_unmounted(DEVICE *dev); -void dev_lock(DEVICE *dev); -void dev_unlock(DEVICE *dev); -const char *edit_blocked_reason(DEVICE *dev); /* From dircmd.c */ void *handle_connection_request(void *arg); @@ -153,7 +139,7 @@ void *handle_connection_request(void *arg); /* From fd_cmds.c */ void run_job(JCR *jcr); -bool bootstrap_cmd(JCR *jcr); +void do_fd_commands(JCR *jcr); /* From job.c */ void stored_free_jcr(JCR *jcr); @@ -162,10 +148,11 @@ void handle_filed_connection(BSOCK *fd, char *job_name); /* From label.c */ int read_dev_volume_label(DCR *dcr); -int read_dev_volume_label_guess(DCR *dcr, bool write); +int read_dvd_volume_label(DCR *dcr, bool write); void create_session_label(DCR *dcr, DEV_RECORD *rec, int label); -void create_volume_label(DEVICE *dev, const char *VolName, const char *PoolName); -bool write_new_volume_label_to_dev(DCR *dcr, const char *VolName, const char *PoolName); +void create_volume_label(DEVICE *dev, const char *VolName, const char *PoolName, bool dvdnow); +bool write_new_volume_label_to_dev(DCR *dcr, const char *VolName, + const char *PoolName, bool relabel, bool dvdnow); #define ANSI_VOL_LABEL 0 #define ANSI_EOF_LABEL 1 #define ANSI_EOV_LABEL 2 @@ -179,44 +166,125 @@ void dump_label_record(DEVICE *dev, DEV_RECORD *rec, int verbose); bool unser_volume_label(DEVICE *dev, DEV_RECORD *rec); bool unser_session_label(SESSION_LABEL *label, DEV_RECORD *rec); +/* From locks.c */ +void _lock_device(const char *file, int line, DEVICE *dev); +void _unlock_device(const char *file, int line, DEVICE *dev); +void _block_device(const char *file, int line, DEVICE *dev, int state); +void _unblock_device(const char *file, int line, DEVICE *dev); +void _steal_device_lock(const char *file, int line, DEVICE *dev, bsteal_lock_t *hold, int state); +void _give_back_device_lock(const char *file, int line, DEVICE *dev, bsteal_lock_t *hold); + + /* From match_bsr.c */ int match_bsr(BSR *bsr, DEV_RECORD *rec, VOLUME_LABEL *volrec, - SESSION_LABEL *sesrec); + SESSION_LABEL *sesrec, JCR *jcr); int match_bsr_block(BSR *bsr, DEV_BLOCK *block); void position_bsr_block(BSR *bsr, DEV_BLOCK *block); BSR *find_next_bsr(BSR *root_bsr, DEVICE *dev); -bool match_set_eof(BSR *bsr, DEV_RECORD *rec); +bool is_this_bsr_done(BSR *bsr, DEV_RECORD *rec); +uint64_t get_bsr_start_addr(BSR *bsr, + uint32_t *file=NULL, + uint32_t *block=NULL); + /* From mount.c */ -bool mount_next_write_volume(DCR *dcr, bool release); bool mount_next_read_volume(DCR *dcr); -void release_volume(DCR *ddr); -void mark_volume_in_error(DCR *dcr); /* From parse_bsr.c */ BSR *parse_bsr(JCR *jcr, char *lf); void dump_bsr(BSR *bsr, bool recurse); void free_bsr(BSR *bsr); -VOL_LIST *new_vol(); -int add_vol(JCR *jcr, VOL_LIST *vol); -void free_vol_list(JCR *jcr); -void create_vol_list(JCR *jcr); +void free_restore_volume_list(JCR *jcr); +void create_restore_volume_list(JCR *jcr); /* From record.c */ -const char *FI_to_ascii(int fi); -const char *stream_to_ascii(int stream, int fi); +const char *FI_to_ascii(char *buf, int fi); +const char *stream_to_ascii(char *buf, int stream, int fi); bool write_record_to_block(DEV_BLOCK *block, DEV_RECORD *rec); bool can_write_record_to_block(DEV_BLOCK *block, DEV_RECORD *rec); -bool read_record_from_block(DEV_BLOCK *block, DEV_RECORD *rec); +bool read_record_from_block(DCR *dcr, DEV_BLOCK *block, DEV_RECORD *rec); DEV_RECORD *new_record(); void free_record(DEV_RECORD *rec); void empty_record(DEV_RECORD *rec); +uint64_t get_record_address(DEV_RECORD *rec); /* From read_record.c */ bool read_records(DCR *dcr, bool record_cb(DCR *dcr, DEV_RECORD *rec), bool mount_cb(DCR *dcr)); +/* From reserve.c */ +void init_reservations_lock(); +void term_reservations_lock(); +void _lock_reservations(const char *file="**Unknown**", int line=0); +void _unlock_reservations(); +void _lock_volumes(const char *file="**Unknown**", int line=0); +void _unlock_volumes(); +void unreserve_device(DCR *dcr); +void send_drive_reserve_messages(JCR *jcr, void sendit(const char *msg, int len, void *sarg), void *arg); +bool find_suitable_device_for_job(JCR *jcr, RCTX &rctx); +int search_res_for_device(RCTX &rctx); +void release_reserve_messages(JCR *jcr); + +extern int reservations_lock_count; + +#ifdef SD_DEBUG_LOCK + +#define lock_reservations() \ + do { Dmsg3(sd_dbglvl, "lock_reservations at %s:%d precnt=%d\n", \ + __FILE__, __LINE__, \ + reservations_lock_count); \ + _lock_reservations(__FILE__, __LINE__); \ + Dmsg0(sd_dbglvl, "lock_reservations: got lock\n"); \ + } while (0) +#define unlock_reservations() \ + do { Dmsg3(sd_dbglvl, "unlock_reservations at %s:%d precnt=%d\n", \ + __FILE__, __LINE__, \ + reservations_lock_count); \ + _unlock_reservations(); } while (0) + +#define lock_volumes() \ + do { Dmsg3(sd_dbglvl, "lock_volumes at %s:%d precnt=%d\n", \ + __FILE__, __LINE__, \ + vol_list_lock_count); \ + _lock_volumes(__FILE__, __LINE__); \ + Dmsg0(sd_dbglvl, "lock_volumes: got lock\n"); \ + } while (0) + +#define unlock_volumes() \ + do { Dmsg3(sd_dbglvl, "unlock_volumes at %s:%d precnt=%d\n", \ + __FILE__, __LINE__, \ + vol_list_lock_count); \ + _unlock_volumes(); } while (0) + +#else + +#define lock_reservations() _lock_reservations(__FILE__, __LINE__) +#define unlock_reservations() _unlock_reservations() +#define lock_volumes() _lock_volumes(__FILE__, __LINE__) +#define unlock_volumes() _unlock_volumes() + +#endif + +/* From vol_mgr.c */ +void init_vol_list_lock(); +void term_vol_list_lock(); +VOLRES *reserve_volume(DCR *dcr, const char *VolumeName); +VOLRES *find_volume(const char *VolumeName); +bool free_volume(DEVICE *dev); +bool is_vol_list_empty(); +dlist *dup_vol_list(JCR *jcr); +void free_temp_vol_list(dlist *temp_vol_list); +bool volume_unused(DCR *dcr); +void create_volume_lists(); +void free_volume_lists(); +void list_volumes(void sendit(const char *msg, int len, void *sarg), void *arg); +bool is_volume_in_use(DCR *dcr); +extern int vol_list_lock_count; +void add_read_volume(JCR *jcr, const char *VolumeName); +void remove_read_volume(JCR *jcr, const char *VolumeName); + + /* From spool.c */ bool begin_data_spool (DCR *dcr); bool discard_data_spool (DCR *dcr); @@ -226,8 +294,8 @@ bool begin_attribute_spool (JCR *jcr); bool discard_attribute_spool (JCR *jcr); bool commit_attribute_spool (JCR *jcr); bool write_block_to_spool_file (DCR *dcr); -void list_spool_stats (BSOCK *bs); +void list_spool_stats (void sendit(const char *msg, int len, void *sarg), void *arg); /* From wait.c */ int wait_for_sysop(DCR *dcr); -bool wait_for_device(DCR *dcr, const char *msg, bool first); +bool wait_for_device(JCR *jcr, int &retries);