X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=bacula%2Fsrc%2Fstored%2Fdev.h;h=0ff099dc4c30870c6cdbaa130c29078439d692ff;hb=a839f0af80ae757becd93b472d39cad6955b6351;hp=d439e8c1447d1ad9efc9e5720c5341999390e580;hpb=4218cce44b3110254d128cb2369865a3f5c0d176;p=bacula%2Fbacula diff --git a/bacula/src/stored/dev.h b/bacula/src/stored/dev.h index d439e8c144..0ff099dc4c 100644 --- a/bacula/src/stored/dev.h +++ b/bacula/src/stored/dev.h @@ -8,24 +8,32 @@ * */ /* - Copyright (C) 2000-2005 Kern Sibbald + Bacula® - The Network Backup Solution - 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. + Copyright (C) 2000-2006 Free Software Foundation Europe e.V. - This program is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of + 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 plus additions + that are listed 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 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 John Walker. + The licensor of Bacula is the Free Software Foundation Europe + (FSFE), Fiduciary Program, Sumatrastrasse 25, 8006 Zürich, + Switzerland, email:ftf@fsfeurope.org. +*/ #ifndef __DEV_H @@ -46,13 +54,32 @@ #define steal_device_lock(d, p, s) _steal_device_lock(__FILE__, __LINE__, (d), (p), s) #define give_back_device_lock(d, p) _give_back_device_lock(__FILE__, __LINE__, (d), (p)) +/* Return values from wait_for_sysop() */ +enum { + W_ERROR = 1, + W_TIMEOUT, + W_POLL, + W_MOUNT, + W_WAKE +}; + /* Arguments to open_dev() */ enum { - OPEN_READ_WRITE = 0, + CREATE_READ_WRITE = 1, + OPEN_READ_WRITE, OPEN_READ_ONLY, OPEN_WRITE_ONLY }; +/* Device types */ +enum { + B_FILE_DEV = 1, + B_TAPE_DEV, + B_DVD_DEV, + B_FIFO_DEV, + B_PROG_DEV +}; + /* Generic status bits returned from status_dev() */ #define BMT_TAPE (1<<0) /* is tape device */ #define BMT_EOF (1<<1) /* just read EOF */ @@ -66,9 +93,6 @@ enum { #define BMT_IM_REP_EN (1<<9) /* immediate report enabled */ -/* Test capabilities */ -#define dev_cap(dev, cap) ((dev)->capabilities & (cap)) - /* Bits for device capabilities */ #define CAP_EOF (1<<0) /* has MTWEOF */ #define CAP_BSR (1<<1) /* has MTBSR */ @@ -98,12 +122,13 @@ enum { #define dev_state(dev, st_state) ((dev)->state & (st_state)) /* Device state bits */ -#define ST_OPENED (1<<0) /* set when device opened */ -#define ST_TAPE (1<<1) /* is a tape device */ -#define ST_FILE (1<<2) /* is a file device */ -#define ST_FIFO (1<<3) /* is a fifo device */ -#define ST_DVD (1<<4) /* is a DVD device */ -#define ST_PROG (1<<5) /* is a program device */ +#define ST_XXXXXX (1<<0) /* was ST_OPENED */ +#define ST_XXXXX (1<<1) /* was ST_TAPE */ +#define ST_XXXX (1<<2) /* was ST_FILE */ +#define ST_XXX (1<<3) /* was ST_FIFO */ +#define ST_XX (1<<4) /* was ST_DVD */ +#define ST_X (1<<5) /* was ST_PROG */ + #define ST_LABEL (1<<6) /* label found */ #define ST_MALLOC (1<<7) /* dev packet malloc'ed in init_dev() */ #define ST_APPEND (1<<8) /* ready for Bacula append */ @@ -114,7 +139,10 @@ enum { #define ST_NEXTVOL (1<<13) /* Start writing on next volume */ #define ST_SHORT (1<<14) /* Short block read */ #define ST_MOUNTED (1<<15) /* the device is mounted to the mount point */ -#define ST_OFFLINE (1<<16) /* set offline by operator */ +#define ST_MEDIA (1<<16) /* Media found in mounted device */ +#define ST_OFFLINE (1<<17) /* set offline by operator */ +#define ST_PART_SPOOLED (1<<18) /* spooling part */ +#define ST_FREESPACE_OK (1<<19) /* Have valid freespace for DVD */ /* dev_blocked states (mutually exclusive) */ enum { @@ -122,9 +150,9 @@ enum { BST_UNMOUNTED, /* User unmounted device */ BST_WAITING_FOR_SYSOP, /* Waiting for operator to mount tape */ BST_DOING_ACQUIRE, /* Opening/validating/moving tape */ - BST_WRITING_LABEL, /* Labeling a tape */ - BST_UNMOUNTED_WAITING_FOR_SYSOP, /* Closed by user during mount request */ - BST_MOUNT /* Mount request */ + BST_WRITING_LABEL, /* Labeling a tape */ + BST_UNMOUNTED_WAITING_FOR_SYSOP, /* User unmounted during wait for op */ + BST_MOUNT /* Mount request */ }; /* Volume Catalog Information structure definition */ @@ -144,14 +172,16 @@ struct VOLUME_CAT_INFO { uint32_t EndFile; /* Last file number */ uint32_t EndBlock; /* Last block number */ int32_t LabelType; /* Bacula/ANSI/IBM */ - int32_t Slot; /* Slot in changer */ - bool InChanger; /* Set if vol in current magazine */ + int32_t Slot; /* >0=Slot loaded, 0=nothing, -1=unknown */ uint32_t VolCatMaxJobs; /* Maximum Jobs to write to volume */ uint32_t VolCatMaxFiles; /* Maximum files to write to volume */ uint64_t VolCatMaxBytes; /* Max bytes to write to volume */ uint64_t VolCatCapacityBytes; /* capacity estimate */ uint64_t VolReadTime; /* time spent reading */ uint64_t VolWriteTime; /* time spent writing this Volume */ + int64_t VolMediaId; /* MediaId */ + utime_t VolFirstWritten; /* Time of first write */ + bool InChanger; /* Set if vol in current magazine */ char VolCatStatus[20]; /* Volume status */ char VolCatName[MAX_NAME_LENGTH]; /* Desired volume to mount */ }; @@ -163,8 +193,9 @@ typedef struct s_steal_lock { int dev_prev_blocked; /* previous blocked state */ } bsteal_lock_t; -struct DEVRES; /* Device resource defined in stored_conf.h */ +class DEVRES; /* Device resource defined in stored_conf.h */ +class DCR; /* forward reference */ /* * Device structure definition. There is one of these for * each physical device. Everything here is "global" to @@ -187,16 +218,19 @@ public: /* New access control in process of being implemented */ brwlock_t lock; /* New mutual exclusion lock */ - int use_count; /* usage count on this device */ int fd; /* file descriptor */ int capabilities; /* capabilities mask */ int state; /* state mask */ int dev_errno; /* Our own errno */ int mode; /* read/write modes */ int openmode; /* parameter passed to open_dev (useful to reopen the device) */ + int dev_type; /* device type */ + bool autoselect; /* Autoselect in autochanger */ int label_type; /* Bacula/ANSI/IBM label types */ - uint32_t drive_index; /* Autochanger drive index */ - POOLMEM *dev_name; /* device name */ + 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 file; /* current file number base 0 */ @@ -210,21 +244,22 @@ public: uint64_t max_file_size; /* max file size to put in one file on volume */ uint64_t volume_capacity; /* advisory capacity */ uint64_t max_spool_size; /* maximum spool file size */ - uint64_t spool_size; /* current spool size */ + uint64_t spool_size; /* current spool size for this device */ uint32_t max_rewind_wait; /* max secs to allow for rewind */ uint32_t max_open_wait; /* max secs to allow for open */ uint32_t max_open_vols; /* max simultaneous open volumes */ uint64_t max_part_size; /* max part size */ uint64_t part_size; /* current part size */ - uint32_t part; /* current part number */ + uint32_t part; /* current part number (starts at 0) */ uint64_t part_start; /* current part start address (relative to the whole volume) */ - uint32_t num_parts; /* number of parts (total) */ + uint32_t num_dvd_parts; /* number of parts WRITTEN on the DVD */ + /* state ST_FREESPACE_OK is set if free_space is valid */ uint64_t free_space; /* current free space on medium (without the current part) */ - int free_space_errno; /* indicates: - * - free_space_errno == 0: ignore free_space. - * - free_space_errno < 0: an error occured. - * - free_space_errno > 0: free_space is valid. */ + int free_space_errno; /* indicates errno getting freespace */ + bool truncating; /* if set, we are currently truncating the DVD */ + bool blank_dvd; /* if set, we have a blank DVD in the drive */ + utime_t vol_poll_interval; /* interval between polling Vol mount */ DEVRES *device; /* pointer to Device Resource */ @@ -232,6 +267,8 @@ public: VOLUME_CAT_INFO VolCatInfo; /* Volume Catalog Information */ VOLUME_LABEL VolHdr; /* Actual volume label */ + char pool_name[MAX_NAME_LENGTH]; /* pool name */ + char pool_type[MAX_NAME_LENGTH]; /* pool type */ /* Device wait times ***FIXME*** look at durations */ char BadVolName[MAX_NAME_LENGTH]; /* Last wrong Volume mounted */ @@ -243,54 +280,129 @@ public: int rem_wait_sec; int num_wait; - int is_tape() const; - int is_file() const; - int is_fifo() const; - int is_dvd() const; - int is_open() const; - int is_offline() const; - int is_labeled() const; - int is_busy() const; /* either reading or writing */ - int at_eof() const; - int at_eom() const; - int at_eot() const; - int can_append() const; - int can_read() const; + /* Methods */ + int has_cap(int cap) const { return capabilities & cap; } + void clear_cap(int cap) { capabilities &= ~cap; } + void set_cap(int cap) { capabilities |= cap; } + 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_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_prog() const { return dev_type == B_PROG_DEV; } + int is_open() const { return 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_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 at_eof() const { return state & ST_EOF; } + int at_eot() const { return state & ST_EOT; } + int at_weot() const { return state & ST_WEOT; } + int can_append() const { return state & ST_APPEND; } + int is_freespace_ok() const { return state & ST_FREESPACE_OK; } + /* + * can_write() is meant for checking at the end of a job to see + * if we still have a tape (perhaps not if at end of tape + * and the job is canceled). + */ + int can_write() const { return is_open() && can_append() && + is_labeled() && !at_weot(); } + int can_read() const { return state & ST_READ; } + bool can_steal_lock() const { return dev_blocked && + (dev_blocked == BST_UNMOUNTED || + dev_blocked == BST_WAITING_FOR_SYSOP || + dev_blocked == BST_UNMOUNTED_WAITING_FOR_SYSOP); }; + bool waiting_for_mount() const { return + (dev_blocked == BST_UNMOUNTED || + dev_blocked == BST_WAITING_FOR_SYSOP || + dev_blocked == BST_UNMOUNTED_WAITING_FOR_SYSOP); }; const char *strerror() const; const char *archive_name() const; - void set_eof(); - void set_eot(); - void set_append(); - void set_read(); - void set_offline(); - void clear_append(); - void clear_read(); - void clear_label(); - void clear_offline(); + const char *name() const; + const char *print_name() const; /* Name for display purposes */ + void set_ateof(); /* in dev.c */ + void set_ateot(); /* in dev.c */ + void set_eot() { state |= ST_EOT; }; + void set_eof() { state |= ST_EOF; }; + void set_append() { state |= ST_APPEND; }; + void set_labeled() { state |= ST_LABEL; }; + inline void set_read() { state |= ST_READ; }; + void set_offline() { state |= ST_OFFLINE; }; + void set_mounted() { state |= ST_MOUNTED; }; + void set_media() { state |= ST_MEDIA; }; + void set_short_block() { state |= ST_SHORT; }; + void set_freespace_ok() { state |= ST_FREESPACE_OK; } + void set_part_spooled(int val) { if (val) state |= ST_PART_SPOOLED; \ + else state &= ~ST_PART_SPOOLED; + }; + void set_mounted(int val) { if (val) state |= ST_MOUNTED; \ + else state &= ~ST_MOUNTED; }; + void clear_append() { state &= ~ST_APPEND; }; + void clear_read() { state &= ~ST_READ; }; + void clear_labeled() { state &= ~ST_LABEL; }; + void clear_offline() { state &= ~ST_OFFLINE; }; + void clear_eot() { state &= ~ST_EOT; }; + void clear_eof() { state &= ~ST_EOF; }; + void clear_opened() { fd = -1; }; + void clear_mounted() { state &= ~ST_MOUNTED; }; + void clear_media() { state &= ~ST_MEDIA; }; + void clear_short_block() { state &= ~ST_SHORT; }; + void clear_freespace_ok() { state &= ~ST_FREESPACE_OK; }; + char *bstrerror(void) { return errmsg; }; + char *print_errmsg() { return errmsg; }; + + void block(int why); /* in dev.c */ + void unblock(); /* in dev.c */ + void close(); /* in dev.c */ + void close_part(DCR *dcr); /* in dev.c */ + bool truncate(DCR *dcr); /* in dev.c */ + int open(DCR *dcr, int mode); /* in dev.c */ + void term(void); /* in dev.c */ + bool rewind(DCR *dcr); /* in dev.c */ + bool mount(int timeout); /* in dev.c */ + bool unmount(int timeout); /* in dev.c */ + void edit_mount_codes(POOL_MEM &omsg, const char *imsg); /* in dev.c */ + bool offline_or_rewind(); /* in dev.c */ + bool offline(); /* in dev.c */ + bool bsf(int count); /* in dev.c */ + bool eod(DCR *dcr); /* in dev.c */ + bool fsr(int num); /* in dev.c */ + bool fsf(int num); /* in dev.c */ + bool bsr(int num); /* in dev.c */ + bool weof(int num); /* in dev.c */ + void lock_door(); /* in dev.c */ + void unlock_door(); /* in dev.c */ + bool scan_dir_for_volume(DCR *dcr); /* in scan.c */ + bool reposition(DCR *dcr, uint32_t rfile, uint32_t rblock); /* in dev.c */ + 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 */ + bool update_freespace(); /* in dvd.c */ + + void set_blocked(int block) { dev_blocked = block; }; + int get_blocked() const { return dev_blocked; }; + uint32_t get_file() const { return file; }; + uint32_t get_block() const { return block_num; }; + const char *print_blocked() const; /* in dev.c */ + bool is_blocked() const { return dev_blocked != BST_NOT_BLOCKED; }; + +private: + bool do_mount(int mount, int timeout); /* in dev.c */ + void set_mode(int omode); /* in dev.c */ + void open_tape_device(DCR *dcr, int omode); /* in dev.c */ + void open_file_device(DCR *dcr, int omode); /* in dev.c */ + void open_dvd_device(DCR *dcr, int omode); /* in dev.c */ }; /* Note, these return int not bool! */ -inline int DEVICE::is_tape() const { return state & ST_TAPE; } -inline int DEVICE::is_file() const { return state & ST_FILE; } -inline int DEVICE::is_fifo() const { return state & ST_FIFO; } -inline int DEVICE::is_dvd() const { return state & ST_DVD; } -inline int DEVICE::is_open() const { return state & ST_OPENED; } -inline int DEVICE::is_offline() const { return state & ST_OFFLINE; } -inline int DEVICE::is_labeled() const { return state & ST_LABEL; } -inline int DEVICE::is_busy() const { return state & ST_READ || num_writers; } -inline int DEVICE::at_eof() const { return state & ST_EOF; } -inline int DEVICE::at_eot() const { return state & ST_EOT; } -inline int DEVICE::can_append() const { return state & ST_APPEND; } -inline int DEVICE::can_read() const { return state & ST_READ; } -inline void DEVICE::set_append() { state |= ST_APPEND; } -inline void DEVICE::set_read() { state |= ST_READ; } -inline void DEVICE::set_offline() { state |= ST_OFFLINE; } -inline void DEVICE::clear_append() { state &= ~ST_APPEND; } -inline void DEVICE::clear_read() { state &= ~ST_READ; } -inline void DEVICE::clear_label() { state &= ~ST_LABEL; } -inline void DEVICE::clear_offline() { state &= ~ST_OFFLINE; } inline const char *DEVICE::strerror() const { return errmsg; } inline const char *DEVICE::archive_name() const { return dev_name; } +inline const char *DEVICE::print_name() const { return prt_name; } /* * Device Context (or Control) Record. @@ -310,11 +422,15 @@ public: int spool_fd; /* fd if spooling */ bool spool_data; /* set to spool data */ bool spooling; /* set when actually spooling */ + bool despooling; /* set when despooling */ + bool despool_wait; /* waiting for despooling */ bool dev_locked; /* set if dev already locked */ 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 any_volume; /* Any OK for dir_find_next... */ + bool attached_to_dev; /* set when attached to dev */ uint32_t VolFirstIndex; /* First file index this Volume */ uint32_t VolLastIndex; /* Last file index this Volume */ uint32_t FileIndex; /* Current File Index */ @@ -322,16 +438,29 @@ public: uint32_t StartFile; /* Start write file */ uint32_t StartBlock; /* Start write block */ uint32_t EndBlock; /* Ending block written */ - int64_t spool_size; /* Current spool size */ - int64_t max_spool_size; /* Max job spool size */ + int64_t job_spool_size; /* Current job spool size */ + int64_t max_job_spool_size; /* Max job spool size */ char VolumeName[MAX_NAME_LENGTH]; /* Volume name */ char pool_name[MAX_NAME_LENGTH]; /* pool name */ char pool_type[MAX_NAME_LENGTH]; /* pool type */ char media_type[MAX_NAME_LENGTH]; /* media type */ char dev_name[MAX_NAME_LENGTH]; /* dev name */ + int Copy; /* identical copy number */ + int Stripe; /* RAIT stripe */ VOLUME_CAT_INFO VolCatInfo; /* Catalog info for desired volume */ }; +/* + * Volume reservation class -- see reserve.c + */ +class VOLRES { +public: + dlink link; + char *vol_name; + DEVICE *dev; + DCR *dcr; +}; + /* Get some definition of function to position * to the end of the medium in MTEOM. System