]> git.sur5r.net Git - bacula/bacula/blobdiff - bacula/src/stored/acquire.c
ebl rename faketape to vtape
[bacula/bacula] / bacula / src / stored / acquire.c
index 215e2b2fb3df5ebdd25967dedbbc9e86b1b3fec4..9823d4bb2c36ddbee23440b7eb5257bc7098e7de 100644 (file)
 /*
- *  Routines to acquire and release a device for read/write
- *
- *   Kern Sibbald, August MMII
- *                           
- *   Version $Id$
- */
-/*
-   Copyright (C) 2002-2003 Kern Sibbald and John Walker
+   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) 2002-2008 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 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
    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.
+*/
+/*
+ *  Routines to acquire and release a device for read/write
+ *
+ *   Kern Sibbald, August MMII
+ *
+ *   Version $Id$
  */
 
 #include "bacula.h"                   /* pull in global headers */
 #include "stored.h"                   /* pull in Storage Deamon headers */
 
+/* Forward referenced functions */
+static void attach_dcr_to_dev(DCR *dcr);
+
 
-/********************************************************************* 
- * Acquire device for reading. We permit (for the moment)
- *  only one reader.  We read the Volume label from the block and
+/*********************************************************************
+ * Acquire device for reading. 
+ *  The drive should have previously been reserved by calling 
+ *  reserve_device_for_read(). We read the Volume label from the block and
  *  leave the block pointers just after the label.
  *
- *  Returns: 0 if failed for any reason
- *          1 if successful
+ *  Returns: NULL if failed for any reason
+ *           dcr  if successful
  */
-int acquire_device_for_read(JCR *jcr, DEVICE *dev, DEV_BLOCK *block)
+bool acquire_device_for_read(DCR *dcr)
 {
-   int stat = 0;
-   int tape_previously_mounted;
+   DEVICE *dev = dcr->dev;
+   JCR *jcr = dcr->jcr;
+   bool ok = false;
+   bool tape_previously_mounted;
+   bool tape_initially_mounted;
    VOL_LIST *vol;
+   bool try_autochanger = true;
+   int i;
+   int vol_label_status;
+   int retry = 0;
+   
+   Dmsg1(950, "jcr->dcr=%p\n", jcr->dcr);
+   dev->dblock(BST_DOING_ACQUIRE);
 
-   lock_device(dev);
-   block_device(dev, BST_DOING_ACQUIRE);
-   unlock_device(dev);
-
-   tape_previously_mounted = (dev->state & ST_READ) || (dev->state & ST_APPEND);
-
-   if (dev->state & ST_READ || dev->num_writers > 0) {
-      Jmsg1(jcr, M_FATAL, 0, _("Device %s is busy. Job cancelled.\n"), dev_name(dev));
+   if (dev->num_writers > 0) {
+      Jmsg2(jcr, M_FATAL, 0, _("Acquire read: num_writers=%d not zero. Job %d canceled.\n"), 
+         dev->num_writers, jcr->JobId);
       goto get_out;
    }
 
    /* Find next Volume, if any */
    vol = jcr->VolList;
    if (!vol) {
-      Jmsg(jcr, M_FATAL, 0, _("No volumes specified. Job cancelled.\n"));
+      char ed1[50];
+      Jmsg(jcr, M_FATAL, 0, _("No volumes specified for reading. Job %s canceled.\n"), 
+         edit_int64(jcr->JobId, ed1));
       goto get_out;
    }
-   jcr->CurVolume++;
-   for (int i=1; i<jcr->CurVolume; i++) {
+   jcr->CurReadVolume++;
+   for (i=1; i<jcr->CurReadVolume; i++) {
       vol = vol->next;
    }
-   pm_strcpy(&jcr->VolumeName, vol->VolumeName);
+   if (!vol) {
+      Jmsg(jcr, M_FATAL, 0, _("Logic error: no next volume to read. Numvol=%d Curvol=%d\n"),
+         jcr->NumReadVolumes, jcr->CurReadVolume);
+      goto get_out;                   /* should not happen */   
+   }
+   /*    
+    * Note, if we want to be able to work from a .bsr file only          
+    *  for disaster recovery, we must "simulate" reading the catalog
+    */
+   bstrncpy(dcr->VolumeName, vol->VolumeName, sizeof(dcr->VolumeName));
+   bstrncpy(dcr->VolCatInfo.VolCatName, vol->VolumeName, sizeof(dcr->VolCatInfo.VolCatName));
+   bstrncpy(dcr->media_type, vol->MediaType, sizeof(dcr->media_type));
+   dcr->VolCatInfo.Slot = vol->Slot;
+   dcr->VolCatInfo.InChanger = vol->Slot > 0; 
+    
+   /*
+    * If the MediaType requested for this volume is not the
+    *  same as the current drive, we attempt to find the same
+    *  device that was used to write the orginal volume.  If
+    *  found, we switch to using that device.
+    *
+    *  N.B. A lot of routines rely on the dcr pointer not changing
+    *    read_records.c even has multiple dcrs cached, so we take care
+    *    here to release all important parts of the dcr and re-acquire
+    *    them such as the block pointer (size may change), but we do
+    *    not release the dcr.
+    */
+   Dmsg2(50, "MediaType dcr=%s dev=%s\n", dcr->media_type, dev->device->media_type);
+   if (dcr->media_type[0] && strcmp(dcr->media_type, dev->device->media_type) != 0) {
+      RCTX rctx;
+      DIRSTORE *store;
+      int stat;
+
+      Jmsg3(jcr, M_INFO, 0, _("Changing device. Want Media Type=\"%s\" have=\"%s\"\n"
+                              "  device=%s\n"), 
+            dcr->media_type, dev->device->media_type, dev->print_name());
+      Dmsg3(50, "Changing device. Want Media Type=\"%s\" have=\"%s\"\n"
+                              "  device=%s\n", 
+            dcr->media_type, dev->device->media_type, dev->print_name());
+
+      dev->dunblock(DEV_UNLOCKED);
+
+      lock_reservations();
+      memset(&rctx, 0, sizeof(RCTX));
+      rctx.jcr = jcr;
+      jcr->reserve_msgs = New(alist(10, not_owned_by_alist));
+      rctx.any_drive = true;
+      rctx.device_name = vol->device;
+      store = new DIRSTORE;
+      memset(store, 0, sizeof(DIRSTORE));
+      store->name[0] = 0; /* No dir name */
+      bstrncpy(store->media_type, vol->MediaType, sizeof(store->media_type));
+      bstrncpy(store->pool_name, dcr->pool_name, sizeof(store->pool_name));
+      bstrncpy(store->pool_type, dcr->pool_type, sizeof(store->pool_type));
+      store->append = false;
+      rctx.store = store;
+      clean_device(dcr);                     /* clean up the dcr */
+      
+      /*
+       * Search for a new device
+       */
+      stat = search_res_for_device(rctx);
+      release_reserve_messages(jcr);         /* release queued messages */
+      unlock_reservations();
+
+      if (stat == 1) {
+         dev = dcr->dev;                     /* get new device pointer */
+         dev->dblock(BST_DOING_ACQUIRE); 
+         dcr->VolumeName[0] = 0;
+         Jmsg(jcr, M_INFO, 0, _("Media Type change.  New device %s chosen.\n"),
+            dev->print_name());
+         Dmsg1(50, "Media Type change.  New device %s chosen.\n", dev->print_name());
 
-   for (;;) {
-      if (job_cancelled(jcr)) {
-         Mmsg0(&dev->errmsg, _("Job cancelled.\n"));
-        goto get_out;                /* error return */
+         bstrncpy(dcr->VolumeName, vol->VolumeName, sizeof(dcr->VolumeName));
+         bstrncpy(dcr->VolCatInfo.VolCatName, vol->VolumeName, sizeof(dcr->VolCatInfo.VolCatName));
+         bstrncpy(dcr->media_type, vol->MediaType, sizeof(dcr->media_type));
+         dcr->VolCatInfo.Slot = vol->Slot;
+         dcr->VolCatInfo.InChanger = vol->Slot > 0; 
+         bstrncpy(dcr->pool_name, store->pool_name, sizeof(dcr->pool_name));
+         bstrncpy(dcr->pool_type, store->pool_type, sizeof(dcr->pool_type));
+      } else {
+         /* error */
+         Jmsg1(jcr, M_FATAL, 0, _("No suitable device found to read Volume \"%s\"\n"),
+            vol->VolumeName);
+         Dmsg1(50, "No suitable device found to read Volume \"%s\"\n", vol->VolumeName);
+         goto get_out;
       }
+   }
+
+   if (reserve_volume(dcr, dcr->VolumeName) == NULL) {
+      Dmsg2(100, "Could not reserve volume %s on %s\n", dcr->VolumeName,
+            dcr->dev->print_name());
+      Jmsg2(jcr, M_FATAL, 0, _("Could not reserve volume %s on %s\n"), dcr->VolumeName,
+            dcr->dev->print_name());
+      goto get_out;
+   }
+   if (dev->vol && dev->vol->is_swapping()) {
+      dev->vol->set_slot(vol->Slot);
+      Dmsg3(100, "swapping: slot=%d Vol=%s dev=%s\n", dev->vol->get_slot(),
+         dev->vol->vol_name, dev->print_name());
+   }
+
+
+   init_device_wait_timers(dcr);
+
+   tape_previously_mounted = dev->can_read() || dev->can_append() ||
+                             dev->is_labeled();
+   tape_initially_mounted = tape_previously_mounted;
+
+
+   /* Volume info is always needed because of VolParts */
+   Dmsg1(150, "dir_get_volume_info vol=%s\n", dcr->VolumeName);
+   if (!dir_get_volume_info(dcr, GET_VOL_INFO_FOR_READ)) {
+      Jmsg1(jcr, M_WARNING, 0, "%s", jcr->errmsg);
+   }
+   dev->set_load();                /* set to load volume */
+   
+   for ( ;; ) {
+      /* If not polling limit retries */
+      if (!dev->poll && retry++ > 10) {
+         break;
+      }
+      dev->clear_labeled();              /* force reread of label */
+      if (job_canceled(jcr)) {
+         char ed1[50];
+         Mmsg1(dev->errmsg, _("Job %s canceled.\n"), edit_int64(jcr->JobId, ed1));
+         Jmsg(jcr, M_INFO, 0, dev->errmsg);
+         goto get_out;                /* error return */
+      }
+
+      dcr->do_swapping(false/*is_writing*/);
+
       /*
        * This code ensures that the device is ready for
        * reading. If it is a file, it opens it.
-       * If it is a tape, it checks the volume name 
+       * If it is a tape, it checks the volume name
        */
-      for ( ; !(dev->state & ST_OPENED); ) {
-          Dmsg1(120, "bstored: open vol=%s\n", jcr->VolumeName);
-         if (open_dev(dev, jcr->VolumeName, READ_ONLY) < 0) {
-             Jmsg(jcr, M_FATAL, 0, _("Open device %s volume %s failed, ERR=%s\n"), 
-                dev_name(dev), jcr->VolumeName, strerror_dev(dev));
-            goto get_out;
-         }
-          Dmsg1(129, "open_dev %s OK\n", dev_name(dev));
+      Dmsg1(100, "bstored: open vol=%s\n", dcr->VolumeName);
+      if (dev->open(dcr, OPEN_READ_ONLY) < 0) {
+         if (!dev->poll) {
+            Jmsg3(jcr, M_WARNING, 0, _("Read open device %s Volume \"%s\" failed: ERR=%s\n"),
+                  dev->print_name(), dcr->VolumeName, dev->bstrerror());
+         }
+         goto default_path;
       }
-      dev->state &= ~ST_LABEL;          /* force reread of label */
-      Dmsg0(200, "calling read-vol-label\n");
-      switch (read_dev_volume_label(jcr, dev, block)) {
-        case VOL_OK:
-           break;                    /* got it */
-        case VOL_IO_ERROR:
-           /*
-            * Send error message generated by read_dev_volume_label()
-            *  only we really had a tape mounted. This supresses superfluous
-            *  error messages when nothing is mounted.
-            */
-           if (tape_previously_mounted) {
-               Jmsg1(jcr, M_WARNING, 0, "%s", jcr->errmsg);                         
-           }
-           goto default_path;
-        default:
-            Jmsg1(jcr, M_WARNING, 0, "%s", jcr->errmsg);
+      Dmsg1(50, "opened dev %s OK\n", dev->print_name());
+      
+      /* Read Volume Label */
+      Dmsg0(50, "calling read-vol-label\n");
+      vol_label_status = read_dev_volume_label(dcr);
+      switch (vol_label_status) {
+      case VOL_OK:
+         ok = true;
+         memcpy(&dev->VolCatInfo, &dcr->VolCatInfo, sizeof(dev->VolCatInfo));
+         break;                    /* got it */
+      case VOL_IO_ERROR:
+         /*
+          * Send error message generated by read_dev_volume_label()
+          *  only we really had a tape mounted. This supresses superfluous
+          *  error messages when nothing is mounted.
+          */
+         if (tape_previously_mounted) {
+            Jmsg(jcr, M_WARNING, 0, "%s", jcr->errmsg);
+         }
+         goto default_path;
+      case VOL_NAME_ERROR:
+         if (tape_initially_mounted) {
+            tape_initially_mounted = false;
+            goto default_path;
+         }
+         /* If polling and got a previous bad name, ignore it */
+         if (dev->poll && strcmp(dev->BadVolName, dev->VolHdr.VolumeName) == 0) {
+            goto default_path;
+         } else {
+             bstrncpy(dev->BadVolName, dev->VolHdr.VolumeName, sizeof(dev->BadVolName));
+         }
+         if (!unload_autochanger(dcr, -1)) {
+            /* at least free the device so we can re-open with correct volume */
+            dev->close();                                                          
+         }
+         /* Fall through */
+      default:
+         Jmsg1(jcr, M_WARNING, 0, "%s", jcr->errmsg);
 default_path:
-           tape_previously_mounted = 0;
-            Dmsg0(200, "dir_get_volume_info\n");
-           if (!dir_get_volume_info(jcr, 0)) { 
-               Jmsg1(jcr, M_WARNING, 0, "%s", jcr->errmsg);
-           }
+         tape_previously_mounted = true;
+         
+         /*
+          * If the device requires mount, close it, so the device can be ejected.
+          */
+         if (dev->requires_mount()) {
+            dev->close();
+         }
+         
+         /* Call autochanger only once unless ask_sysop called */
+         if (try_autochanger) {
+            int stat;
             Dmsg2(200, "calling autoload Vol=%s Slot=%d\n",
-              jcr->VolumeName, jcr->VolCatInfo.Slot);                         
-           if (autoload_device(jcr, dev, 0, NULL)) {
-              continue;
-           }
-           /* Mount a specific volume and no other */
-            Dmsg0(200, "calling dir_ask_sysop\n");
-           if (!dir_ask_sysop_to_mount_volume(jcr, dev)) {
-              goto get_out;          /* error return */
-           }
-           continue;                 /* try reading again */
-      }
+               dcr->VolumeName, dcr->VolCatInfo.Slot);
+            stat = autoload_device(dcr, 0, NULL);
+            if (stat > 0) {
+               try_autochanger = false;
+               continue;              /* try reading volume mounted */
+            }
+            /* Try closing and re-opening */
+            dev->close();
+            dev->clear_unload();
+            if (dev->open(dcr, OPEN_READ_ONLY) >= 0) {
+               continue;
+            }
+            if (!dev->poll) {
+               Jmsg3(jcr, M_WARNING, 0, _("Read open device %s Volume \"%s\" failed: ERR=%s\n"),
+                     dev->print_name(), dcr->VolumeName, dev->bstrerror());
+            }
+         }
+         
+         /* Mount a specific volume and no other */
+         Dmsg0(200, "calling dir_ask_sysop\n");
+         if (!dir_ask_sysop_to_mount_volume(dcr, ST_READ)) {
+            goto get_out;             /* error return */
+         }
+         try_autochanger = true;      /* permit using autochanger again */
+         continue;                    /* try reading again */
+      } /* end switch */
       break;
+   } /* end for loop */
+   if (!ok) {
+      Jmsg1(jcr, M_FATAL, 0, _("Too many errors trying to mount device %s for reading.\n"),
+            dev->print_name());
+      goto get_out;
    }
 
-   dev->state |= ST_READ;
-   attach_jcr_to_device(dev, jcr);    /* attach jcr to device */
-   stat = 1;                         /* good return */
-   if ((dev->state & ST_TAPE) && vol->start_file > 0) {
-      Dmsg1(200, "====== Got start_file = %d\n", vol->start_file);
-      Jmsg(jcr, M_INFO, 0, _("Forward spacing to file %d.\n"), vol->start_file);
-      fsf_dev(dev, vol->start_file);
-   }
+   dev->clear_append();
+   dev->set_read();
+   set_jcr_job_status(jcr, JS_Running);
+   dir_send_job_status(jcr);
+   Jmsg(jcr, M_INFO, 0, _("Ready to read from volume \"%s\" on device %s.\n"),
+      dcr->VolumeName, dev->print_name());
 
 get_out:
-   P(dev->mutex); 
-   unblock_device(dev);
-   V(dev->mutex);
-   return stat;
+   dev->dlock();
+   dcr->clear_reserved();
+   /* 
+    * Normally we are blocked, but in at least one error case above 
+    *   we are not blocked because we unsuccessfully tried changing
+    *   devices.  
+    */
+   if (dev->is_blocked()) {
+      dev->dunblock(DEV_LOCKED);
+   }
+   Dmsg1(950, "jcr->dcr=%p\n", jcr->dcr);
+   return ok;
 }
 
+
 /*
  * Acquire device for writing. We permit multiple writers.
  *  If this is the first one, we read the label.
  *
- *  Returns: 0 if failed for any reason
- *          1 if successful
+ *  Returns: NULL if failed for any reason
+ *           dcr if successful.
+ *   Note, normally reserve_device_for_append() is called
+ *   before this routine.
  */
-int acquire_device_for_append(JCR *jcr, DEVICE *dev, DEV_BLOCK *block)
+DCR *acquire_device_for_append(DCR *dcr)
 {
-   int release = 0;
-   int do_mount = 0;
-   int stat = 0;
+   DEVICE *dev = dcr->dev;
+   JCR *jcr = dcr->jcr;
+   bool ok = false;
+   bool have_vol = false;
 
-   lock_device(dev);
-   block_device(dev, BST_DOING_ACQUIRE);
-   unlock_device(dev);
-   Dmsg1(190, "acquire_append device is %s\n", dev_is_tape(dev)?"tape":"disk");
+   init_device_wait_timers(dcr);
 
+   dev->dblock(BST_DOING_ACQUIRE);
+   Dmsg1(100, "acquire_append device is %s\n", dev->is_tape()?"tape":
+        (dev->is_dvd()?"DVD":"disk"));
 
-   if (dev->state & ST_APPEND) {
-      /* 
-       * Device already in append mode  
-       *
-       * Check if we have the right Volume mounted   
-       *   OK if current volume info OK
-       *   OK if next volume matches current volume
-       *   otherwise mount desired volume obtained from
-       *    dir_find_next_appendable_volume
+   /*
+    * With the reservation system, this should not happen
+    */
+   if (dev->can_read()) {
+      Jmsg1(jcr, M_FATAL, 0, _("Want to append, but device %s is busy reading.\n"), dev->print_name());
+      Dmsg1(200, "Want to append but device %s is busy reading.\n", dev->print_name());
+      goto get_out;
+   }
+
+   /*
+    * have_vol defines whether or not mount_next_write_volume should
+    *   ask the Director again about what Volume to use.
+    */
+   if (dev->can_append() && dcr->is_suitable_volume_mounted() &&
+       strcmp(dcr->VolCatInfo.VolCatStatus, "Recycle") != 0) {
+      Dmsg0(190, "device already in append.\n");
+      /*
+       * At this point, the correct tape is already mounted, so
+       *   we do not need to do mount_next_write_volume(), unless
+       *   we need to recycle the tape.
        */
-      strcpy(jcr->VolumeName, dev->VolHdr.VolName);
-      if (!dir_get_volume_info(jcr, 1) ||
-         !(dir_find_next_appendable_volume(jcr) &&
-           strcmp(dev->VolHdr.VolName, jcr->VolumeName) == 0)) { /* wrong tape mounted */
-        if (dev->num_writers != 0) {
-           /*
-            * ***FIXME*** add multiple writers here if permitted   
-            *  find end of dev chain 
-            *   dev->next = init_dev(NULL, dev->device);
-            *   ...
-            */
-            Jmsg(jcr, M_FATAL, 0, _("Device %s is busy writing on another Volume.\n"), dev_name(dev));
-           goto get_out;
-        }
-        /* Wrong tape mounted, release it, then fall through to get correct one */
-        release = 1;
-        do_mount = 1;
-      }
-   } else { 
-      /* Not already in append mode, so mount the device */
-      if (dev->state & ST_READ) {
-         Jmsg(jcr, M_FATAL, 0, _("Device %s is busy reading.\n"), dev_name(dev));
-        goto get_out;
-      } 
-      ASSERT(dev->num_writers == 0);
-      do_mount = 1;
+       if (dev->num_writers == 0) {
+          memcpy(&dev->VolCatInfo, &dcr->VolCatInfo, sizeof(dev->VolCatInfo));
+       }
+       have_vol = dcr->is_tape_position_ok();
    }
 
-   if (do_mount) {
-      if (!mount_next_write_volume(jcr, dev, block, release)) {
-         Jmsg(jcr, M_FATAL, 0, _("Could not ready device %s for append.\n"),
-           dev_name(dev));
-        goto get_out;
+   if (!have_vol) {
+      Dmsg1(190, "jid=%u Do mount_next_write_vol\n", (uint32_t)jcr->JobId);
+      if (!dcr->mount_next_write_volume()) {
+         if (!job_canceled(jcr)) {
+            /* Reduce "noise" -- don't print if job canceled */
+            Jmsg(jcr, M_FATAL, 0, _("Could not ready device %s for append.\n"),
+               dev->print_name());
+            Dmsg1(200, "Could not ready device %s for append.\n", 
+               dev->print_name());
+         }
+         goto get_out;
       }
+      Dmsg2(190, "Output pos=%u:%u\n", dcr->dev->file, dcr->dev->block_num);
    }
 
-   dev->num_writers++;
-   if (dev->num_writers > 1) {
-      Dmsg2(100, "Hey!!!! There are %d writers on device %s\n", dev->num_writers,
-        dev_name(dev));
-   }
-   if (jcr->NumVolumes == 0) {
-      jcr->NumVolumes = 1;
+   dev->num_writers++;                /* we are now a writer */
+   if (jcr->NumWriteVolumes == 0) {
+      jcr->NumWriteVolumes = 1;
    }
-   attach_jcr_to_device(dev, jcr);    /* attach jcr to device */
-   stat = 1;                         /* good return */
+   dev->VolCatInfo.VolCatJobs++;              /* increment number of jobs on vol */
+   dir_update_volume_info(dcr, false, false); /* send Volume info to Director */
+   ok = true;
 
 get_out:
-   P(dev->mutex); 
-   unblock_device(dev);
-   V(dev->mutex);
-   return stat;
+   dev->dlock();
+   dcr->clear_reserved();
+   dev->dunblock(DEV_LOCKED);
+   return ok ? dcr : NULL;
 }
 
 /*
  * This job is done, so release the device. From a Unix standpoint,
  *  the device remains open.
  *
+ * Note, if we are spooling, we may enter with the device locked.
+ * However, in all cases, unlock the device when leaving.
+ *
  */
-int release_device(JCR *jcr, DEVICE *dev)
+bool release_device(DCR *dcr)
 {
-   lock_device(dev);
-   Dmsg1(100, "release_device device is %s\n", dev_is_tape(dev)?"tape":"disk");
-   if (dev->state & ST_READ) {
-      dev->state &= ~ST_READ;        /* clear read bit */
-      if (!dev_is_tape(dev) || !dev_cap(dev, CAP_ALWAYSOPEN)) {
-        if (dev_cap(dev, CAP_OFFLINEUNMOUNT)) {
-           offline_dev(dev);
-        }
-        close_dev(dev);
-      }
-      /******FIXME**** send read volume usage statistics to director */
+   JCR *jcr = dcr->jcr;
+   DEVICE *dev = dcr->dev;
+   bool ok = true;
+   char tbuf[100];
+
+   /* lock only if not already locked by this thread */
+   if (!dcr->is_dev_locked()) {
+      dev->r_dlock();
+   }
+   lock_volumes();
+   Dmsg2(100, "release_device device %s is %s\n", dev->print_name(), dev->is_tape()?"tape":"disk");
+
+   /* if device is reserved, job never started, so release the reserve here */
+   dcr->clear_reserved();
+
+   if (dev->can_read()) {
+      dev->clear_read();              /* clear read bit */
+      Dmsg0(100, "dir_update_vol_info. Release0\n");
+      dir_update_volume_info(dcr, false, false); /* send Volume info to Director */
+      volume_unused(dcr);
 
    } else if (dev->num_writers > 0) {
+      /* 
+       * Note if WEOT is set, we are at the end of the tape
+       *   and may not be positioned correctly, so the
+       *   job_media_record and update_vol_info have already been
+       *   done, which means we skip them here.
+       */
       dev->num_writers--;
-      if (dev->state & ST_TAPE) {
-        jcr->EndBlock = dev->EndBlock;
-        jcr->EndFile  = dev->EndFile;
-         Dmsg2(200, "Release device: EndFile=%u EndBlock=%u\n", jcr->EndFile, jcr->EndBlock);
-      } else {
-        jcr->EndBlock = (uint32_t)dev->file_addr;
-        jcr->EndFile = (uint32_t)(dev->file_addr >> 32);
-      }
       Dmsg1(100, "There are %d writers in release_device\n", dev->num_writers);
-      if (dev->num_writers == 0) {
-         Dmsg0(100, "dir_create_jobmedia_record. Release\n");
-        dir_create_jobmedia_record(jcr);
-        weof_dev(dev, 1);
-        dev->VolCatInfo.VolCatFiles = dev->file;   /* set number of files */
-        dev->VolCatInfo.VolCatJobs++;              /* increment number of jobs */
-        /* Note! do volume update before close, which zaps VolCatInfo */
-         Dmsg0(200, "dir_update_vol_info. Release0\n");
-        dir_update_volume_info(jcr, &dev->VolCatInfo, 0); /* send Volume info to Director */
-
-        if (!dev_is_tape(dev) || !dev_cap(dev, CAP_ALWAYSOPEN)) {
-           if (dev_cap(dev, CAP_OFFLINEUNMOUNT)) {
-              offline_dev(dev);
-           }
-           close_dev(dev);
-        }
+      if (dev->is_labeled()) {
+         Dmsg2(200, "dir_create_jobmedia. Release vol=%s dev=%s\n", 
+               dev->VolCatInfo.VolCatName, dev->print_name());
+         if (!dev->at_weot() && !dir_create_jobmedia_record(dcr)) {
+            Jmsg(jcr, M_FATAL, 0, _("Could not create JobMedia record for Volume=\"%s\" Job=%s\n"),
+               dcr->VolCatInfo.VolCatName, jcr->Job);
+         }
+         /* If no more writers, and no errors, and wrote something, write an EOF */
+         if (!dev->num_writers && dev->can_write() && dev->block_num > 0) {
+            dev->weof(1);
+            write_ansi_ibm_labels(dcr, ANSI_EOF_LABEL, dev->VolHdr.VolumeName);
+         }
+         if (!dev->at_weot()) {
+            dev->VolCatInfo.VolCatFiles = dev->file;   /* set number of files */
+            /* Note! do volume update before close, which zaps VolCatInfo */
+            dir_update_volume_info(dcr, false, false); /* send Volume info to Director */
+            Dmsg2(200, "dir_update_vol_info. Release vol=%s dev=%s\n", 
+                  dev->VolCatInfo.VolCatName, dev->print_name());
+         }
+         if (dev->num_writers == 0) {         /* if not being used */
+            volume_unused(dcr);               /*  we obviously are not using the volume */
+         }
+      }
+
+   } else {
+      /*                
+       * If we reach here, it is most likely because the job
+       *   has failed, since the device is not in read mode and
+       *   there are no writers. It was probably reserved.
+       */
+      volume_unused(dcr);
+   }
+   unlock_volumes();
+   Dmsg3(100, "%d writers, %d reserve, dev=%s\n", dev->num_writers, dev->num_reserved(),
+         dev->print_name());
+   debug_list_volumes("acquire:release_device()");
+
+
+   /* If no writers, close if file or !CAP_ALWAYS_OPEN */
+   if (dev->num_writers == 0 && (!dev->is_tape() || !dev->has_cap(CAP_ALWAYSOPEN))) {
+      dvd_remove_empty_part(dcr);        /* get rid of any empty spool part */
+      dev->close();
+   }
+
+   /* Fire off Alert command and include any output */
+   if (!job_canceled(jcr) && dcr->device->alert_command) {
+      POOLMEM *alert;
+      int status = 1;
+      BPIPE *bpipe;
+      char line[MAXSTRING];
+      alert = get_pool_memory(PM_FNAME);
+      alert = edit_device_codes(dcr, alert, dcr->device->alert_command, "");
+      bpipe = open_bpipe(alert, 0, "r");
+      if (bpipe) {
+         while (fgets(line, sizeof(line), bpipe->rfd)) {
+            Jmsg(jcr, M_ALERT, 0, _("Alert: %s"), line);
+         }
+         status = close_bpipe(bpipe);
       } else {
-         Dmsg0(100, "dir_create_jobmedia_record. Release\n");
-        dir_create_jobmedia_record(jcr);
-         Dmsg0(200, "dir_update_vol_info. Release1\n");
-        dev->VolCatInfo.VolCatFiles = dev->file;   /* set number of files */
-        dev->VolCatInfo.VolCatJobs++;              /* increment number of jobs */
-        dir_update_volume_info(jcr, &dev->VolCatInfo, 0); /* send Volume info to Director */
+         status = errno;
       }
+      if (status != 0) {
+         berrno be;
+         Jmsg(jcr, M_ALERT, 0, _("3997 Bad alert command: %s: ERR=%s.\n"),
+              alert, be.bstrerror(status));
+      }
+
+      Dmsg1(400, "alert status=%d\n", status);
+      free_pool_memory(alert);
+   }
+   pthread_cond_broadcast(&dev->wait_next_vol);
+   Dmsg2(100, "JobId=%u broadcast wait_device_release at %s\n", 
+         (uint32_t)jcr->JobId, bstrftimes(tbuf, sizeof(tbuf), (utime_t)time(NULL)));
+   pthread_cond_broadcast(&wait_device_release);
+   dev->dunlock();
+   if (dcr->keep_dcr) {
+      detach_dcr_from_dev(dcr);
    } else {
-      Jmsg2(jcr, M_ERROR, 0, _("BAD ERROR: release_device %s, Volume %s not in use.\n"), 
-           dev_name(dev), NPRT(jcr->VolumeName));
+      if (jcr->read_dcr == dcr) {
+         jcr->read_dcr = NULL;
+      }
+      if (jcr->dcr == dcr) {
+         jcr->dcr = NULL;
+      }
+      free_dcr(dcr);
+   }
+   Dmsg2(100, "===== Device %s released by JobId=%u\n", dev->print_name(),
+         (uint32_t)jcr->JobId);
+   return ok;
+}
+
+/*
+ * Clean up the device for reuse without freeing the memory
+ */
+bool clean_device(DCR *dcr)
+{
+   bool ok;
+   dcr->keep_dcr = true;                  /* do not free the dcr */
+   ok = release_device(dcr);
+   dcr->keep_dcr = false;
+   return ok;
+}
+
+/*
+ * Create a new Device Control Record and attach
+ *   it to the device (if this is a real job).
+ * Note, this has been updated so that it can be called first 
+ *   without a DEVICE, then a second or third time with a DEVICE,
+ *   and each time, it should cleanup and point to the new device.
+ *   This should facilitate switching devices.
+ * Note, each dcr must point to the controlling job (jcr).  However,
+ *   a job can have multiple dcrs, so we must not store in the jcr's
+ *   structure as previously. The higher level routine must store
+ *   this dcr in the right place
+ *
+ */
+DCR *new_dcr(JCR *jcr, DCR *dcr, DEVICE *dev)
+{
+   if (!dcr) {
+      dcr = (DCR *)malloc(sizeof(DCR));
+      memset(dcr, 0, sizeof(DCR));
+      dcr->tid = pthread_self();
+      dcr->spool_fd = -1;
+   }
+   dcr->jcr = jcr;                 /* point back to jcr */
+   /* Set device information, possibly change device */
+   if (dev) {
+      if (dcr->block) {
+         free_block(dcr->block);
+      }
+      dcr->block = new_block(dev);
+      if (dcr->rec) {
+         free_record(dcr->rec);
+      }
+      dcr->rec = new_record();
+      if (dcr->attached_to_dev) {
+         detach_dcr_from_dev(dcr);
+      }
+      /* Use job spoolsize prior to device spoolsize */
+      if (jcr->spool_size) {
+         dcr->max_job_spool_size = jcr->spool_size;
+      } else {
+         dcr->max_job_spool_size = dev->device->max_job_spool_size;
+      }
+      dcr->device = dev->device;
+      dcr->dev = dev;
+      attach_dcr_to_dev(dcr);
+   }
+   return dcr;
+}
+
+/*
+ * Search the dcrs list for the given dcr. If it is found,
+ *  as it should be, then remove it. Also zap the jcr pointer
+ *  to the dcr if it is the same one.
+ *
+ * Note, this code will be turned on when we can write to multiple
+ *  dcrs at the same time.
+ */
+#ifdef needed
+static void remove_dcr_from_dcrs(DCR *dcr)
+{
+   JCR *jcr = dcr->jcr;
+   if (jcr->dcrs) {
+      int i = 0;
+      DCR *ldcr;
+      int num = jcr->dcrs->size();
+      for (i=0; i < num; i++) {
+         ldcr = (DCR *)jcr->dcrs->get(i);
+         if (ldcr == dcr) {
+            jcr->dcrs->remove(i);
+            if (jcr->dcr == dcr) {
+               jcr->dcr = NULL;
+            }
+         }
+      }
+   }
+}
+#endif
+
+static void attach_dcr_to_dev(DCR *dcr)
+{
+   DEVICE *dev = dcr->dev;
+   JCR *jcr = dcr->jcr;
+
+   if (jcr) Dmsg1(500, "JobId=%u enter attach_dcr_to_dev\n", (uint32_t)jcr->JobId);
+   if (!dcr->attached_to_dev && dev->initiated && jcr && jcr->JobType != JT_SYSTEM) {
+      dev->attached_dcrs->append(dcr);  /* attach dcr to device */
+      dcr->attached_to_dev = true;
+      Dmsg1(500, "JobId=%u attach_dcr_to_dev\n", (uint32_t)jcr->JobId);
+   }
+}
+
+void detach_dcr_from_dev(DCR *dcr)
+{
+   DEVICE *dev = dcr->dev;
+   Dmsg0(500, "Enter detach_dcr_from_dev\n"); /* jcr is NULL in some cases */
+
+   /* Detach this dcr only if attached */
+   if (dcr->attached_to_dev && dev) {
+      dev->dlock();
+      dcr->unreserve_device();
+      dcr->dev->attached_dcrs->remove(dcr);  /* detach dcr from device */
+      dcr->attached_to_dev = false;
+//    remove_dcr_from_dcrs(dcr);      /* remove dcr from jcr list */
+      dev->dunlock();
+   }
+}
+
+/*
+ * Free up all aspects of the given dcr -- i.e. dechain it,
+ *  release allocated memory, zap pointers, ...
+ */
+void free_dcr(DCR *dcr)
+{
+   JCR *jcr = dcr->jcr;
+
+   detach_dcr_from_dev(dcr);
+
+   if (dcr->block) {
+      free_block(dcr->block);
+   }
+   if (dcr->rec) {
+      free_record(dcr->rec);
+   }
+   if (jcr && jcr->dcr == dcr) {
+      jcr->dcr = NULL;
    }
-   detach_jcr_from_device(dev, jcr);
-   unlock_device(dev);
-   return 1;
+   free(dcr);
 }