X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=bacula%2Fsrc%2Fstored%2Fdev.h;h=4abc2d7faf03d96cbaf484600c97e7105ecfd3ea;hb=72bb41e91a81474b9bf1af1097d721728ef857b2;hp=c57a49fcd210b3e0da9615b0f2b9d583db8979b0;hpb=772e8a408020ba3795e3be77a14ce3c9e899a49c;p=bacula%2Fbacula diff --git a/bacula/src/stored/dev.h b/bacula/src/stored/dev.h index c57a49fcd2..4abc2d7faf 100644 --- a/bacula/src/stored/dev.h +++ b/bacula/src/stored/dev.h @@ -35,6 +35,37 @@ * */ +/* + * Some details of how volume and device reservations work + * + * class VOLRES: + * set_in_use() volume being used on current drive + * clear_in_use() no longer being used. Can be re-used or moved. + * set_swapping() set volume being moved to another drive + * is_swapping() volume is being moved to another drive + * clear_swapping() volume normal + * + * class DEVICE: + * set_load() set to load volume + * needs_load() volume must be loaded (i.e. set_load done) + * clear_load() load done. + * set_unload() set to unload volume + * needs_unload() volume must be unloaded + * clear_unload() volume unloaded + * + * reservations are temporary until the drive is acquired + * inc_reserved() increments num of reservations + * dec_reserved() decrements num of reservations + * num_reserved() number of reservations + * + * class DCR: + * set_reserved() sets local reserve flag and calls dev->inc_reserved() + * clear_reserved() clears local reserve flag and calls dev->dec_reserved() + * is_reserved() returns local reserved flag + * unreserve_device() much more complete unreservation + * + */ + #ifndef __DEV_H #define __DEV_H 1 @@ -64,7 +95,8 @@ enum { B_TAPE_DEV, B_DVD_DEV, B_FIFO_DEV, - B_VTL_DEV + B_VTAPE_DEV, /* change to B_TAPE_DEV after init */ + B_VTL_DEV }; /* Generic status bits returned from status_dev() */ @@ -166,11 +198,9 @@ struct VOLUME_CAT_INFO { class DEVRES; /* Device resource defined in stored_conf.h */ - class DCR; /* forward reference */ class VOLRES; /* forward reference */ - /* * Device structure definition. There is one of these for * each physical device. Everything here is "global" to @@ -182,7 +212,13 @@ private: int m_blocked; /* set if we must wait (i.e. change tape) */ int m_count; /* Mutex use count -- DEBUG only */ pthread_t m_pid; /* Thread that locked -- DEBUG only */ + bool m_unload; /* set when Volume must be unloaded */ + bool m_load; /* set when Volume must be loaded */ + int m_num_reserved; /* counter of device reservations */ + int32_t m_slot; /* slot loaded in drive or -1 if none */ + public: + DEVICE * volatile swap_dev; /* Swap vol from this device */ dlist *attached_dcrs; /* attached DCR list */ pthread_mutex_t m_mutex; /* access control */ pthread_mutex_t spool_mutex; /* mutex for updating spool_size */ @@ -192,7 +228,6 @@ public: int dev_prev_blocked; /* previous blocked state */ int num_waiting; /* number of threads waiting */ int num_writers; /* number of writing threads */ - int reserved_device; /* number of device reservations */ int capabilities; /* capabilities mask */ int state; /* state mask */ int dev_errno; /* Our own errno */ @@ -203,11 +238,11 @@ public: bool initiated; /* set when init_dev() called */ int label_type; /* Bacula/ANSI/IBM label types */ uint32_t drive_index; /* Autochanger drive index (base 0) */ - int32_t Slot; /* Slot currently in drive (base 1) */ POOLMEM *dev_name; /* Physical device name */ POOLMEM *prt_name; /* Name used for display purposes */ char *errmsg; /* nicely edited error message */ uint32_t block_num; /* current block number base 0 */ + uint32_t LastBlock; /* last DEV_BLOCK number written to Volume */ uint32_t file; /* current file number base 0 */ uint64_t file_addr; /* Current file read/write address */ uint64_t file_size; /* Current file size */ @@ -273,20 +308,23 @@ public: int is_autochanger() const { return capabilities & CAP_AUTOCHANGER; } int requires_mount() const { return capabilities & CAP_REQMOUNT; } int is_removable() const { return capabilities & CAP_REM; } - int is_tape() const { return dev_type == B_TAPE_DEV; } + int is_tape() const { return (dev_type == B_TAPE_DEV || + dev_type == B_VTAPE_DEV); } int is_file() const { return dev_type == B_FILE_DEV; } int is_fifo() const { return dev_type == B_FIFO_DEV; } int is_dvd() const { return dev_type == B_DVD_DEV; } int is_vtl() const { return dev_type == B_VTL_DEV; } + int is_vtape() const { return dev_type == B_VTAPE_DEV; } int is_open() const { return m_fd >= 0; } int is_offline() const { return state & ST_OFFLINE; } int is_labeled() const { return state & ST_LABEL; } int is_mounted() const { return state & ST_MOUNTED; } int is_unmountable() const { return (is_dvd() || (is_file() && is_removable())); } + int num_reserved() const { return m_num_reserved; }; int is_part_spooled() const { return state & ST_PART_SPOOLED; } int have_media() const { return state & ST_MEDIA; } int is_short_block() const { return state & ST_SHORT; } - int is_busy() const { return (state & ST_READ) || num_writers || reserved_device; } + int is_busy() const { return (state & ST_READ) || num_writers || num_reserved(); } int at_eof() const { return state & ST_EOF; } int at_eot() const { return state & ST_EOT; } int at_weot() const { return state & ST_WEOT; } @@ -308,6 +346,8 @@ public: (m_blocked == BST_UNMOUNTED || m_blocked == BST_WAITING_FOR_SYSOP || m_blocked == BST_UNMOUNTED_WAITING_FOR_SYSOP); }; + bool must_unload() const { return m_unload; }; + bool must_load() const { return m_load; }; const char *strerror() const; const char *archive_name() const; const char *name() const; @@ -327,8 +367,12 @@ public: void set_part_spooled(int val) { if (val) state |= ST_PART_SPOOLED; \ else state &= ~ST_PART_SPOOLED; }; + void set_unload() { m_unload = true; }; + void set_load() { m_load = true; }; + void inc_reserved() { m_num_reserved++; } void set_mounted(int val) { if (val) state |= ST_MOUNTED; \ else state &= ~ST_MOUNTED; }; + void dec_reserved() { m_num_reserved--; ASSERT(m_num_reserved>=0); }; void clear_append() { state &= ~ST_APPEND; }; void clear_read() { state &= ~ST_READ; }; void clear_labeled() { state &= ~ST_LABEL; }; @@ -340,8 +384,11 @@ public: void clear_media() { state &= ~ST_MEDIA; }; void clear_short_block() { state &= ~ST_SHORT; }; void clear_freespace_ok() { state &= ~ST_FREESPACE_OK; }; + void clear_unload() { m_unload = false; }; + void clear_load() { m_load = false; }; char *bstrerror(void) { return errmsg; }; char *print_errmsg() { return errmsg; }; + int32_t get_slot() const { return m_slot; }; void clear_volhdr(); /* in dev.c */ @@ -372,12 +419,24 @@ public: void clrerror(int func); /* in dev.c */ boffset_t lseek(DCR *dcr, boffset_t offset, int whence); /* in dev.c */ bool update_pos(DCR *dcr); /* in dev.c */ + void set_slot(int32_t slot); /* in dev.c */ + void clear_slot(); /* in dev.c */ + + bool update_freespace(); /* in dvd.c */ uint32_t get_file() const { return file; }; uint32_t get_block_num() const { return block_num; }; int fd() const { return m_fd; }; + /* low level operations */ + void init_backend(); + int (*d_open)(const char *pathname, int flags, ...); + int (*d_close)(int fd); + int (*d_ioctl)(int fd, unsigned long int request, ...); + ssize_t (*d_read)(int fd, void *buffer, size_t count); + ssize_t (*d_write)(int fd, const void *buffer, size_t count); + /* * Locking and blocking calls */ @@ -421,12 +480,13 @@ inline const char *DEVICE::print_name() const { return prt_name; } class DCR { private: bool m_dev_locked; /* set if dev already locked */ + bool m_reserved; /* set if reserved device */ + bool m_found_in_use; /* set if a volume found in use */ public: dlink dev_link; /* link to attach to dev */ JCR *jcr; /* pointer to JCR */ DEVICE * volatile dev; /* pointer to device */ - DEVICE * volatile swap_dev; /* Swap vol from this device */ DEVRES *device; /* pointer to device resource */ DEV_BLOCK *block; /* pointer to block */ DEV_RECORD *rec; /* pointer to record */ @@ -439,13 +499,10 @@ public: bool NewVol; /* set if new Volume mounted */ bool WroteVol; /* set if Volume written */ bool NewFile; /* set when EOF written */ - bool reserved_device; /* set if reserve done */ bool reserved_volume; /* set if we reserved a volume */ bool any_volume; /* Any OK for dir_find_next... */ bool attached_to_dev; /* set when attached to dev */ - bool volume_in_use; /* set in dir_find_next_appendable_volume() */ bool keep_dcr; /* do not free dcr in release_dcr */ - bool unload_device; /* set if device must be unloaded */ uint32_t VolFirstIndex; /* First file index this Volume */ uint32_t VolLastIndex; /* Last file index this Volume */ uint32_t FileIndex; /* Current File Index */ @@ -466,19 +523,35 @@ public: VOLUME_CAT_INFO VolCatInfo; /* Catalog info for desired volume */ /* Methods */ + bool found_in_use() const { return m_found_in_use; }; + void set_found_in_use() { m_found_in_use = true; }; + void clear_found_in_use() { m_found_in_use = false; }; + bool is_reserved() const { return m_reserved; }; bool is_dev_locked() { return m_dev_locked; } void dlock() { dev->dlock(); m_dev_locked = true; } void dunlock() { m_dev_locked = false; dev->dunlock(); } void dblock(int why) { dev->dblock(why); } + + /* Methods in reserve.c */ + void clear_reserved(); + void set_reserved(); + void unreserve_device(); + bool can_i_use_volume(); + /* Methods in mount.c */ bool mount_next_write_volume(); + bool mount_next_read_volume(); void mark_volume_in_error(); void mark_volume_not_inchanger(); int try_autolabel(bool opened); + bool find_a_volume(); bool is_suitable_volume_mounted(); bool is_eod_valid(); int check_volume_label(bool &ask, bool &autochanger); + void release_volume(); + void do_swapping(bool is_writing); + bool is_tape_position_ok(); }; /* @@ -486,7 +559,8 @@ public: */ class VOLRES { bool m_swapping; /* set when swapping to another drive */ - bool m_reserved; /* set when volume reserved */ + bool m_in_use; /* set when volume reserved or in use */ + int32_t m_slot; /* slot of swapping volume */ public: dlink link; char *vol_name; /* Volume name */ @@ -495,9 +569,12 @@ public: bool is_swapping() const { return m_swapping; }; void set_swapping() { m_swapping = true; }; void clear_swapping() { m_swapping = false; }; - bool is_reserved() const { return m_reserved; }; - void set_reserved() { m_reserved = true; }; - void clear_reserved() { m_reserved = false; }; + bool is_in_use() const { return m_in_use; }; + void set_in_use() { m_in_use = true; }; + void clear_in_use() { m_in_use = false; }; + void set_slot(int32_t slot) { m_slot = slot; }; + void clear_slot() { m_slot = -1; }; + int32_t get_slot() const { return m_slot; }; };