git.sur5r.net Git - bacula/bacula/blob - bacula/src/stored/mount.c

   1 /*
   2  *
   3  *  Routines for handling mounting tapes for reading and for
   4  *    writing.
   5  *
   6  *   Kern Sibbald, August MMII
   7  *
   8  *   Version $Id$
   9  */
  10 /*
  11    Bacula® - The Network Backup Solution
  12
  13    Copyright (C) 2002-2006 Free Software Foundation Europe e.V.
  14
  15    The main author of Bacula is Kern Sibbald, with contributions from
  16    many others, a complete list can be found in the file AUTHORS.
  17    This program is Free Software; you can redistribute it and/or
  18    modify it under the terms of version two of the GNU General Public
  19    License as published by the Free Software Foundation plus additions
  20    that are listed in the file LICENSE.
  21
  22    This program is distributed in the hope that it will be useful, but
  23    WITHOUT ANY WARRANTY; without even the implied warranty of
  24    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  25    General Public License for more details.
  26
  27    You should have received a copy of the GNU General Public License
  28    along with this program; if not, write to the Free Software
  29    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  30    02110-1301, USA.
  31
  32    Bacula® is a registered trademark of John Walker.
  33    The licensor of Bacula is the Free Software Foundation Europe
  34    (FSFE), Fiduciary Program, Sumatrastrasse 25, 8006 Zürich,
  35    Switzerland, email:ftf@fsfeurope.org.
  36 */
  37
  38 #include "bacula.h"                   /* pull in global headers */
  39 #include "stored.h"                   /* pull in Storage Deamon headers */
  40
  41 static void mark_volume_not_inchanger(DCR *dcr);
  42 static int try_autolabel(DCR *dcr);
  43
  44 enum {
  45    try_next_vol = 1,
  46    try_read_vol,
  47    try_error,
  48    try_default
  49 };
  50
  51 /*
  52  * If release is set, we rewind the current volume,
  53  * which we no longer want, and ask the user (console)
  54  * to mount the next volume.
  55  *
  56  *  Continue trying until we get it, and then ensure
  57  *  that we can write on it.
  58  *
  59  * This routine returns a 0 only if it is REALLY
  60  *  impossible to get the requested Volume.
  61  *
  62  */
  63 bool mount_next_write_volume(DCR *dcr, bool release)
  64 {
  65    int retry = 0;
  66    bool ask = false, recycle, autochanger;
  67    int vol_label_status;
  68    DEVICE *dev = dcr->dev;
  69    JCR *jcr = dcr->jcr;
  70    DEV_BLOCK *block = dcr->block;
  71    int mode;
  72
  73    Dmsg2(150, "Enter mount_next_volume(release=%d) dev=%s\n", release,
  74       dev->print_name());
  75
  76    init_device_wait_timers(dcr);
  77
  78    /*
  79     * Attempt to mount the next volume. If something non-fatal goes
  80     *  wrong, we come back here to re-try (new op messages, re-read
  81     *  Volume, ...)
  82     */
  83 mount_next_vol:
  84    Dmsg1(150, "mount_next_vol retry=%d\n", retry);
  85    /* Ignore retry if this is poll request */
  86    if (!dev->poll && retry++ > 4) {
  87       /* Last ditch effort before giving up, force operator to respond */
  88       dcr->VolCatInfo.Slot = 0;
  89       if (!dir_ask_sysop_to_mount_volume(dcr)) {
  90          Jmsg(jcr, M_FATAL, 0, _("Too many errors trying to mount device %s.\n"),
  91               dev->print_name());
  92          return false;
  93       }
  94    }
  95    if (job_canceled(jcr)) {
  96       Jmsg(jcr, M_FATAL, 0, _("Job %d canceled.\n"), jcr->JobId);
  97       return false;
  98    }
  99    recycle = false;
 100    if (release) {
 101       Dmsg0(150, "mount_next_volume release=1\n");
 102       release_volume(dcr);
 103       ask = true;                     /* ask operator to mount tape */
 104    }
 105
 106    /*
 107     * Get Director's idea of what tape we should have mounted.
 108     *    in dcr->VolCatInfo
 109     */
 110    Dmsg0(200, "Before dir_find_next_appendable_volume.\n");
 111    while (!dir_find_next_appendable_volume(dcr)) {
 112        Dmsg0(200, "not dir_find_next\n");
 113        if (!dir_ask_sysop_to_create_appendable_volume(dcr)) {
 114          return false;
 115        }
 116        Dmsg0(200, "Again dir_find_next_append...\n");
 117    }
 118    if (job_canceled(jcr)) {
 119       return false;
 120    }
 121    Dmsg3(150, "After find_next_append. Vol=%s Slot=%d Parts=%d\n",
 122          dcr->VolCatInfo.VolCatName, dcr->VolCatInfo.Slot, dcr->VolCatInfo.VolCatParts);
 123
 124    /*
 125     * Get next volume and ready it for append
 126     * This code ensures that the device is ready for
 127     * writing. We start from the assumption that there
 128     * may not be a tape mounted.
 129     *
 130     * If the device is a file, we create the output
 131     * file. If it is a tape, we check the volume name
 132     * and move the tape to the end of data.
 133     *
 134     */
 135    if (autoload_device(dcr, 1, NULL) > 0) {
 136       autochanger = true;
 137       ask = false;
 138    } else {
 139       autochanger = false;
 140       dcr->VolCatInfo.Slot = 0;
 141    }
 142    Dmsg1(200, "autoload_dev returns %d\n", autochanger);
 143    /*
 144     * If we autochanged to correct Volume or (we have not just
 145     *   released the Volume AND we can automount) we go ahead
 146     *   and read the label. If there is no tape in the drive,
 147     *   we will err, recurse and ask the operator the next time.
 148     */
 149    if (!release && dev->is_tape() && dev->has_cap(CAP_AUTOMOUNT)) {
 150       Dmsg0(150, "(1)Ask=0\n");
 151       ask = false;                 /* don't ask SYSOP this time */
 152    }
 153    /* Don't ask if not removable */
 154    if (!dev->is_removable()) {
 155       Dmsg0(150, "(2)Ask=0\n");
 156       ask = false;
 157    }
 158    Dmsg2(150, "Ask=%d autochanger=%d\n", ask, autochanger);
 159    release = true;                /* release next time if we "recurse" */
 160
 161    if (ask && !dir_ask_sysop_to_mount_volume(dcr)) {
 162       Dmsg0(150, "Error return ask_sysop ...\n");
 163       return false;          /* error return */
 164    }
 165    if (job_canceled(jcr)) {
 166       return false;
 167    }
 168    Dmsg1(150, "want vol=%s\n", dcr->VolumeName);
 169
 170    if (dev->poll && dev->has_cap(CAP_CLOSEONPOLL)) {
 171       dev->close();
 172    }
 173
 174    /* Ensure the device is open */
 175    if (dev->has_cap(CAP_STREAM)) {
 176       mode = OPEN_WRITE_ONLY;
 177    } else {
 178       mode = OPEN_READ_WRITE;
 179    }
 180    /* Try autolabel if enabled */
 181    if (dev->open(dcr, mode) < 0) {
 182       try_autolabel(dcr);
 183    }
 184    while (dev->open(dcr, mode) < 0) {
 185       Dmsg1(150, "open_device failed: ERR=%s\n", dev->bstrerror());
 186       if ((dev->is_file() && dev->is_removable()) || dev->is_dvd()) {
 187          bool ok = true;
 188          Dmsg0(150, "call scan_dir_for_vol\n");
 189          if (dev->is_dvd()) {
 190             if (!dev->mount(0)) {
 191                ok = false;
 192             }
 193          }
 194          if (ok && dev->scan_dir_for_volume(dcr)) {
 195             if (dev->open(dcr, mode) >= 0) {
 196                break;                    /* got a valid volume */
 197             }
 198          }
 199          if (ok && dev->is_dvd()) {
 200             dev->unmount(0);
 201          }
 202       }
 203       if (try_autolabel(dcr) == try_read_vol) {
 204          break;                       /* created a new volume label */
 205       }
 206       /* If DVD, ignore the error, very often you cannot open the device
 207        * (when there is no DVD, or when the one inserted is a wrong one) */
 208       if (dev->poll || dev->is_dvd() || dev->is_removable()) {
 209          goto mount_next_vol;
 210       } else {
 211          Jmsg(jcr, M_ERROR, 0, _("Could not open device %s: ERR=%s\n"),
 212             dev->print_name(), dev->print_errmsg());
 213          return false;
 214       }
 215    }
 216
 217    /*
 218     * Now make sure we have the right tape mounted
 219     */
 220 read_volume:
 221    /*
 222     * If we are writing to a stream device, ASSUME the volume label
 223     *  is correct.
 224     */
 225    if (dev->has_cap(CAP_STREAM)) {
 226       vol_label_status = VOL_OK;
 227       create_volume_label(dev, dcr->VolumeName, "Default", false /* not DVD */);
 228       dev->VolHdr.LabelType = PRE_LABEL;
 229    } else {
 230       vol_label_status = read_dev_volume_label(dcr);
 231    }
 232    if (job_canceled(jcr)) {
 233       return false;
 234    }
 235
 236    Dmsg2(150, "Want dirVol=%s dirStat=%s\n", dcr->VolumeName,
 237       dcr->VolCatInfo.VolCatStatus);
 238    /*
 239     * At this point, dev->VolCatInfo has what is in the drive, if anything,
 240     *          and   dcr->VolCatInfo has what the Director wants.
 241     */
 242    switch (vol_label_status) {
 243    case VOL_OK:
 244       Dmsg1(150, "Vol OK name=%s\n", dcr->VolumeName);
 245       dev->VolCatInfo = dcr->VolCatInfo;       /* structure assignment */
 246       recycle = strcmp(dev->VolCatInfo.VolCatStatus, "Recycle") == 0;
 247       break;                    /* got a Volume */
 248    case VOL_NAME_ERROR:
 249       VOLUME_CAT_INFO dcrVolCatInfo, devVolCatInfo;
 250
 251       /* If not removable, Volume is broken */
 252       if (!dev->is_removable()) {
 253          Jmsg(jcr, M_WARNING, 0, _("Volume \"%s\" not on device %s.\n"),
 254             dcr->VolumeName, dev->print_name());
 255          mark_volume_in_error(dcr);
 256          goto mount_next_vol;
 257       }
 258
 259       Dmsg1(150, "Vol NAME Error Name=%s\n", dcr->VolumeName);
 260       /* If polling and got a previous bad name, ignore it */
 261       if (dev->poll && strcmp(dev->BadVolName, dev->VolHdr.VolumeName) == 0) {
 262          ask = true;
 263          Dmsg1(200, "Vol Name error supress due to poll. Name=%s\n", dcr->VolumeName);
 264          goto mount_next_vol;
 265       }
 266       /*
 267        * OK, we got a different volume mounted. First save the
 268        *  requested Volume info (dcr) structure, then query if
 269        *  this volume is really OK. If not, put back the desired
 270        *  volume name, mark it not in changer and continue.
 271        */
 272       dcrVolCatInfo = dcr->VolCatInfo;      /* structure assignment */
 273       devVolCatInfo = dev->VolCatInfo;      /* structure assignment */
 274       /* Check if this is a valid Volume in the pool */
 275       bstrncpy(dcr->VolumeName, dev->VolHdr.VolumeName, sizeof(dcr->VolumeName));
 276       if (!dir_get_volume_info(dcr, GET_VOL_INFO_FOR_WRITE)) {
 277          /* Restore desired volume name, note device info out of sync */
 278          /* This gets the info regardless of the Pool */
 279          bstrncpy(dcr->VolumeName, dev->VolHdr.VolumeName, sizeof(dcr->VolumeName));
 280          if (autochanger && !dir_get_volume_info(dcr, GET_VOL_INFO_FOR_READ)) {
 281             /*
 282              * If we get here, we know we cannot write on the Volume,
 283              *  and we know that we cannot read it either, so it
 284              *  is not in the autochanger.
 285              */
 286             mark_volume_not_inchanger(dcr);
 287          }
 288          dev->VolCatInfo = devVolCatInfo;    /* structure assignment */
 289          bstrncpy(dev->BadVolName, dev->VolHdr.VolumeName, sizeof(dev->BadVolName));
 290          Jmsg(jcr, M_WARNING, 0, _("Director wanted Volume \"%s\".\n"
 291               "    Current Volume \"%s\" not acceptable because:\n"
 292               "    %s"),
 293              dcrVolCatInfo.VolCatName, dev->VolHdr.VolumeName,
 294              jcr->dir_bsock->msg);
 295          ask = true;
 296          /* Restore saved DCR before continuing */
 297          dcr->VolCatInfo = dcrVolCatInfo;  /* structure assignment */
 298          goto mount_next_vol;
 299       }
 300       /*
 301        * This was not the volume we expected, but it is OK with
 302        * the Director, so use it.
 303        */
 304       Dmsg1(150, "want new name=%s\n", dcr->VolumeName);
 305       dev->VolCatInfo = dcr->VolCatInfo;   /* structure assignment */
 306       recycle = strcmp(dev->VolCatInfo.VolCatStatus, "Recycle") == 0;
 307       break;                /* got a Volume */
 308    /*
 309     * At this point, we assume we have a blank tape mounted.
 310     */
 311    case VOL_IO_ERROR:
 312       if (dev->is_dvd()) {
 313          Jmsg(jcr, M_FATAL, 0, "%s", jcr->errmsg);
 314          mark_volume_in_error(dcr);
 315          return false;       /* we could not write on DVD */
 316       }
 317       /* Fall through wanted */
 318    case VOL_NO_LABEL:
 319       switch (try_autolabel(dcr)) {
 320       case try_next_vol:
 321          goto mount_next_vol;
 322       case try_read_vol:
 323          goto read_volume;
 324       case try_error:
 325          return false;
 326       case try_default:
 327          break;
 328       }
 329
 330       /* NOTE! Fall-through wanted. */
 331    case VOL_NO_MEDIA:
 332    default:
 333       Dmsg0(200, "VOL_NO_MEDIA or default.\n");
 334       /* Send error message */
 335       if (!dev->poll) {
 336       } else {
 337          Dmsg1(200, "Msg suppressed by poll: %s\n", jcr->errmsg);
 338       }
 339       ask = true;
 340       /* Needed, so the medium can be changed */
 341       if (dev->requires_mount()) {
 342          dev->close();
 343       }
 344       goto mount_next_vol;
 345    }
 346
 347    /*
 348     * See if we have a fresh tape or a tape with data.
 349     *
 350     * Note, if the LabelType is PRE_LABEL, it was labeled
 351     *  but never written. If so, rewrite the label but set as
 352     *  VOL_LABEL.  We rewind and return the label (reconstructed)
 353     *  in the block so that in the case of a new tape, data can
 354     *  be appended just after the block label.  If we are writing
 355     *  a second volume, the calling routine will write the label
 356     *  before writing the overflow block.
 357     *
 358     *  If the tape is marked as Recycle, we rewrite the label.
 359     */
 360    if (dev->VolHdr.LabelType == PRE_LABEL || recycle) {
 361       if (!rewrite_volume_label(dcr, recycle)) {
 362          mark_volume_in_error(dcr);
 363          goto mount_next_vol;
 364       }
 365    } else {
 366       /*
 367        * OK, at this point, we have a valid Bacula label, but
 368        * we need to position to the end of the volume, since we are
 369        * just now putting it into append mode.
 370        */
 371       Dmsg0(200, "Device previously written, moving to end of data\n");
 372       Jmsg(jcr, M_INFO, 0, _("Volume \"%s\" previously written, moving to end of data.\n"),
 373          dcr->VolumeName);
 374       if (!dev->eod(dcr)) {
 375          Jmsg(jcr, M_ERROR, 0, _("Unable to position to end of data on device %s: ERR=%s\n"),
 376             dev->print_name(), dev->bstrerror());
 377          mark_volume_in_error(dcr);
 378          goto mount_next_vol;
 379       }
 380       if (dev->is_dvd()) {
 381          char ed1[50], ed2[50];
 382          if (dev->VolCatInfo.VolCatBytes == dev->part_start + dev->part_size) {
 383             Jmsg(jcr, M_INFO, 0, _("Ready to append to end of Volume \"%s\""
 384                  " part=%d size=%s\n"), dcr->VolumeName,
 385                  dev->part, edit_uint64(dev->VolCatInfo.VolCatBytes,ed1));
 386          } else {
 387             Jmsg(jcr, M_ERROR, 0, _("I cannot write on Volume \"%s\" because: "
 388                  "The sizes do not match! Volume=%s Catalog=%s\n"),
 389                  dcr->VolumeName,
 390                  edit_uint64(dev->part_start + dev->part_size, ed1),
 391                  edit_uint64(dev->VolCatInfo.VolCatBytes, ed2));
 392             mark_volume_in_error(dcr);
 393             goto mount_next_vol;
 394          }
 395       }
 396       /* *****FIXME**** we should do some checking for files too */
 397       if (dev->is_tape()) {
 398          /*
 399           * Check if we are positioned on the tape at the same place
 400           * that the database says we should be.
 401           */
 402          if (dev->VolCatInfo.VolCatFiles == dev->get_file()) {
 403             Jmsg(jcr, M_INFO, 0, _("Ready to append to end of Volume \"%s\" at file=%d.\n"),
 404                  dcr->VolumeName, dev->get_file());
 405          } else {
 406             Jmsg(jcr, M_ERROR, 0, _("I cannot write on Volume \"%s\" because:\n"
 407                  "The number of files mismatch! Volume=%u Catalog=%u\n"),
 408                  dcr->VolumeName, dev->get_file(), dev->VolCatInfo.VolCatFiles);
 409             mark_volume_in_error(dcr);
 410             goto mount_next_vol;
 411          }
 412       }
 413       dev->VolCatInfo.VolCatMounts++;      /* Update mounts */
 414       Dmsg1(150, "update volinfo mounts=%d\n", dev->VolCatInfo.VolCatMounts);
 415       if (!dir_update_volume_info(dcr, false)) {
 416          return false;
 417       }
 418
 419       /*
 420        * DVD : check if the last part was removed or truncated, or if a written
 421        * part was overwritten.
 422        * We need to do it after dir_update_volume_info, so we have the EndBlock
 423        * info. (nb: I don't understand why VolCatFiles is set (used to check
 424        * tape file number), but not EndBlock)
 425        * Maybe could it be changed "dev->is_file()" (would remove the fixme above)
 426        *
 427        * Disabled: I had problems with this code...
 428        * (maybe is it related to the seek bug ?)
 429        */
 430 #ifdef xxx
 431       if (dev->is_dvd()) {
 432          Dmsg2(150, "DVD/File sanity check addr=%u vs endblock=%u\n", (unsigned int)dev->file_addr, (unsigned int)dev->VolCatInfo.EndBlock);
 433          if (dev->file_addr == dev->VolCatInfo.EndBlock+1) {
 434             Jmsg(jcr, M_INFO, 0, _("Ready to append to end of Volume \"%s\" at file address=%u.\n"),
 435                  dcr->VolumeName, (unsigned int)dev->file_addr);
 436          }
 437          else {
 438             Jmsg(jcr, M_ERROR, 0, _("I cannot write on Volume \"%s\" because:\n"
 439                                     "The EOD file address is wrong: Volume file address=%u != Catalog Endblock=%u(+1)\n"
 440                                     "You probably removed DVD last part in spool directory.\n"),
 441                  dcr->VolumeName, (unsigned int)dev->file_addr, (unsigned int)dev->VolCatInfo.EndBlock);
 442             mark_volume_in_error(dcr);
 443             goto mount_next_vol;
 444          }
 445       }
 446 #endif
 447
 448       /* Return an empty block */
 449       empty_block(block);             /* we used it for reading so set for write */
 450    }
 451    dev->set_append();
 452    Dmsg1(150, "set APPEND, normal return from mount_next_write_volume. dev=%s\n",
 453       dev->print_name());
 454
 455    return true;
 456 }
 457
 458 /*
 459  * If permitted, we label the device, make sure we can do
 460  *   it by checking that the VolCatBytes is zero => not labeled,
 461  *   once the Volume is labeled we don't want to label another
 462  *   blank tape with the same name.  For disk, we go ahead and
 463  *   label it anyway, because the OS insures that there is only
 464  *   one Volume with that name.
 465  * As noted above, at this point dcr->VolCatInfo has what
 466  *   the Director wants and dev->VolCatInfo has info on the
 467  *   previous tape (or nothing).
 468  */
 469 static int try_autolabel(DCR *dcr)
 470 {
 471    DEVICE *dev = dcr->dev;
 472    if (dev->has_cap(CAP_LABEL) && (dcr->VolCatInfo.VolCatBytes == 0 ||
 473          (!dev->is_tape() && strcmp(dcr->VolCatInfo.VolCatStatus,
 474                                 "Recycle") == 0))) {
 475       Dmsg0(150, "Create volume label\n");
 476       /* Create a new Volume label and write it to the device */
 477       if (!write_new_volume_label_to_dev(dcr, dcr->VolumeName,
 478              dcr->pool_name, false, /* no relabel */ false /* defer DVD label */)) {
 479          Dmsg0(150, "!write_vol_label\n");
 480          mark_volume_in_error(dcr);
 481          return try_next_vol;
 482       }
 483       Dmsg0(150, "dir_update_vol_info. Set Append\n");
 484       /* Copy Director's info into the device info */
 485       dev->VolCatInfo = dcr->VolCatInfo;    /* structure assignment */
 486       if (!dir_update_volume_info(dcr, true)) {  /* indicate tape labeled */
 487          return try_error;
 488       }
 489       Jmsg(dcr->jcr, M_INFO, 0, _("Labeled new Volume \"%s\" on device %s.\n"),
 490          dcr->VolumeName, dev->print_name());
 491       return try_read_vol;   /* read label we just wrote */
 492    }
 493    if (!dev->has_cap(CAP_LABEL) && dcr->VolCatInfo.VolCatBytes == 0) {
 494       Jmsg(dcr->jcr, M_INFO, 0, _("Warning device %s not configured to autolabel Volumes.\n"),
 495          dev->print_name());
 496    }
 497    /* If not removable, Volume is broken */
 498    if (!dev->is_removable()) {
 499       Jmsg(dcr->jcr, M_WARNING, 0, _("Volume \"%s\" not on device %s.\n"),
 500          dcr->VolumeName, dev->print_name());
 501       mark_volume_in_error(dcr);
 502       return try_next_vol;
 503    }
 504    return try_default;
 505 }
 506
 507
 508 /*
 509  * Mark volume in error in catalog
 510  */
 511 void mark_volume_in_error(DCR *dcr)
 512 {
 513    DEVICE *dev = dcr->dev;
 514    Jmsg(dcr->jcr, M_INFO, 0, _("Marking Volume \"%s\" in Error in Catalog.\n"),
 515         dcr->VolumeName);
 516    dev->VolCatInfo = dcr->VolCatInfo;     /* structure assignment */
 517    bstrncpy(dev->VolCatInfo.VolCatStatus, "Error", sizeof(dev->VolCatInfo.VolCatStatus));
 518    Dmsg0(150, "dir_update_vol_info. Set Error.\n");
 519    dir_update_volume_info(dcr, false);
 520 }
 521
 522 /*
 523  * The Volume is not in the correct slot, so mark this
 524  *   Volume as not being in the Changer.
 525  */
 526 static void mark_volume_not_inchanger(DCR *dcr)
 527 {
 528    JCR *jcr = dcr->jcr;
 529    DEVICE *dev = dcr->dev;
 530    Jmsg(jcr, M_ERROR, 0, _("Autochanger Volume \"%s\" not found in slot %d.\n"
 531 "    Setting InChanger to zero in catalog.\n"),
 532         dcr->VolCatInfo.VolCatName, dcr->VolCatInfo.Slot);
 533    dev->VolCatInfo = dcr->VolCatInfo;    /* structure assignment */
 534    dcr->VolCatInfo.InChanger = false;
 535    dev->VolCatInfo.InChanger = false;
 536    Dmsg0(400, "update vol info in mount\n");
 537    dir_update_volume_info(dcr, true);  /* set new status */
 538 }
 539
 540 /*
 541  * Either because we are going to hang a new volume, or because
 542  *  of explicit user request, we release the current volume.
 543  */
 544 void release_volume(DCR *dcr)
 545 {
 546    JCR *jcr = dcr->jcr;
 547    DEVICE *dev = dcr->dev;
 548    if (dcr->WroteVol) {
 549       Jmsg0(jcr, M_ERROR, 0, _("Hey!!!!! WroteVol non-zero !!!!!\n"));
 550       Dmsg0(190, "Hey!!!!! WroteVol non-zero !!!!!\n");
 551    }
 552    /*
 553     * First erase all memory of the current volume
 554     */
 555    dev->block_num = dev->file = 0;
 556    dev->EndBlock = dev->EndFile = 0;
 557    memset(&dev->VolCatInfo, 0, sizeof(dev->VolCatInfo));
 558    memset(&dcr->VolCatInfo, 0, sizeof(dcr->VolCatInfo));
 559    free_volume(dev);
 560    memset(&dev->VolHdr, 0, sizeof(dev->VolHdr));
 561    /* Force re-read of label */
 562    dev->clear_labeled();
 563    dev->clear_read();
 564    dev->clear_append();
 565    dev->label_type = B_BACULA_LABEL;
 566    dcr->VolumeName[0] = 0;
 567
 568    if (dev->is_open() && (!dev->is_tape() || !dev->has_cap(CAP_ALWAYSOPEN))) {
 569       dev->close();
 570    }
 571
 572    /* If we have not closed the device, then at least rewind the tape */
 573    if (dev->is_open()) {
 574       dev->offline_or_rewind();
 575    }
 576    Dmsg0(190, "release_volume\n");
 577 }
 578
 579 /*
 580  * If we are reading, we come here at the end of the tape
 581  *  and see if there are more volumes to be mounted.
 582  */
 583 bool mount_next_read_volume(DCR *dcr)
 584 {
 585    DEVICE *dev = dcr->dev;
 586    JCR *jcr = dcr->jcr;
 587    Dmsg2(90, "NumReadVolumes=%d CurReadVolume=%d\n", jcr->NumReadVolumes, jcr->CurReadVolume);
 588    /*
 589     * End Of Tape -- mount next Volume (if another specified)
 590     */
 591    if (jcr->NumReadVolumes > 1 && jcr->CurReadVolume < jcr->NumReadVolumes) {
 592       dev->close();
 593       if (!acquire_device_for_read(dcr)) {
 594          Jmsg2(jcr, M_FATAL, 0, _("Cannot open Dev=%s, Vol=%s\n"), dev->print_name(),
 595                dcr->VolumeName);
 596          return false;
 597       }
 598       return true;                    /* next volume mounted */
 599    }
 600    Dmsg0(90, "End of Device reached.\n");
 601    return false;
 602 }