]> git.sur5r.net Git - bacula/bacula/blob - bacula/src/stored/mount.c
kes Add code in catreq.c to reject volumes not marked Enabled.
[bacula/bacula] / 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, bool opened);
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, false);      /* try to create a new volume label */
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, false) == 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       char VolumeName[MAX_NAME_LENGTH];
251
252       /* If not removable, Volume is broken */
253       if (!dev->is_removable()) {
254          Jmsg(jcr, M_WARNING, 0, _("Volume \"%s\" not on device %s.\n"),
255             dcr->VolumeName, dev->print_name());
256          mark_volume_in_error(dcr);
257          goto mount_next_vol;
258       }
259
260       Dmsg1(150, "Vol NAME Error Name=%s\n", dcr->VolumeName);
261       /* If polling and got a previous bad name, ignore it */
262       if (dev->poll && strcmp(dev->BadVolName, dev->VolHdr.VolumeName) == 0) {
263          ask = true;
264          Dmsg1(200, "Vol Name error supress due to poll. Name=%s\n", dcr->VolumeName);
265          goto mount_next_vol;
266       }
267       /*
268        * OK, we got a different volume mounted. First save the
269        *  requested Volume info (dcr) structure, then query if
270        *  this volume is really OK. If not, put back the desired
271        *  volume name, mark it not in changer and continue.
272        */
273       dcrVolCatInfo = dcr->VolCatInfo;      /* structure assignment */
274       devVolCatInfo = dev->VolCatInfo;      /* structure assignment */
275       /* Check if this is a valid Volume in the pool */
276       bstrncpy(VolumeName, dcr->VolumeName, sizeof(VolumeName));
277       bstrncpy(dcr->VolumeName, dev->VolHdr.VolumeName, sizeof(dcr->VolumeName));
278       if (!dir_get_volume_info(dcr, GET_VOL_INFO_FOR_WRITE)) {
279          /* Restore desired volume name, note device info out of sync */
280          /* This gets the info regardless of the Pool */
281          bstrncpy(dcr->VolumeName, dev->VolHdr.VolumeName, sizeof(dcr->VolumeName));
282          if (autochanger && !dir_get_volume_info(dcr, GET_VOL_INFO_FOR_READ)) {
283             /*
284              * If we get here, we know we cannot write on the Volume,
285              *  and we know that we cannot read it either, so it 
286              *  is not in the autochanger.
287              */
288             mark_volume_not_inchanger(dcr);
289          }
290          dev->VolCatInfo = devVolCatInfo;    /* structure assignment */
291          bstrncpy(dev->BadVolName, dev->VolHdr.VolumeName, sizeof(dev->BadVolName));
292          Jmsg(jcr, M_WARNING, 0, _("Director wanted Volume \"%s\".\n"
293               "    Current Volume \"%s\" not acceptable because:\n"
294               "    %s"),
295              dcrVolCatInfo.VolCatName, dev->VolHdr.VolumeName,
296              jcr->dir_bsock->msg);
297          ask = true;
298          /* Restore saved DCR before continuing */
299          bstrncpy(dcr->VolumeName, VolumeName, sizeof(dcr->VolumeName));
300          dcr->VolCatInfo = dcrVolCatInfo;  /* structure assignment */
301          goto mount_next_vol;
302       }
303       /*
304        * This was not the volume we expected, but it is OK with
305        * the Director, so use it.
306        */
307       Dmsg1(150, "want new name=%s\n", dcr->VolumeName);
308       dev->VolCatInfo = dcr->VolCatInfo;   /* structure assignment */
309       recycle = strcmp(dev->VolCatInfo.VolCatStatus, "Recycle") == 0;
310       break;                /* got a Volume */
311    /*
312     * At this point, we assume we have a blank tape mounted.
313     */
314    case VOL_IO_ERROR:
315       if (dev->is_dvd()) {
316          Jmsg(jcr, M_FATAL, 0, "%s", jcr->errmsg);
317          mark_volume_in_error(dcr);
318          return false;       /* we could not write on DVD */
319       }
320       /* Fall through wanted */
321    case VOL_NO_LABEL:
322       switch (try_autolabel(dcr, true)) {
323       case try_next_vol:
324          goto mount_next_vol;
325       case try_read_vol:
326          goto read_volume;
327       case try_error:
328          return false;
329       case try_default:
330          break;
331       }
332
333       /* NOTE! Fall-through wanted. */
334    case VOL_NO_MEDIA:
335    default:
336       Dmsg0(200, "VOL_NO_MEDIA or default.\n");
337       /* Send error message */
338       if (!dev->poll) {
339       } else {
340          Dmsg1(200, "Msg suppressed by poll: %s\n", jcr->errmsg);
341       }
342       ask = true;
343       /* Needed, so the medium can be changed */
344       if (dev->requires_mount()) {
345          dev->close();
346       }
347       goto mount_next_vol;
348    }
349
350    /*
351     * See if we have a fresh tape or a tape with data.
352     *
353     * Note, if the LabelType is PRE_LABEL, it was labeled
354     *  but never written. If so, rewrite the label but set as
355     *  VOL_LABEL.  We rewind and return the label (reconstructed)
356     *  in the block so that in the case of a new tape, data can
357     *  be appended just after the block label.  If we are writing
358     *  a second volume, the calling routine will write the label
359     *  before writing the overflow block.
360     *
361     *  If the tape is marked as Recycle, we rewrite the label.
362     */
363    if (dev->VolHdr.LabelType == PRE_LABEL || recycle) {
364       if (!rewrite_volume_label(dcr, recycle)) {
365          mark_volume_in_error(dcr);
366          goto mount_next_vol;
367       }
368    } else {
369       /*
370        * OK, at this point, we have a valid Bacula label, but
371        * we need to position to the end of the volume, since we are
372        * just now putting it into append mode.
373        */
374       Dmsg0(200, "Device previously written, moving to end of data\n");
375       Jmsg(jcr, M_INFO, 0, _("Volume \"%s\" previously written, moving to end of data.\n"),
376          dcr->VolumeName);
377       if (!dev->eod(dcr)) {
378          Jmsg(jcr, M_ERROR, 0, _("Unable to position to end of data on device %s: ERR=%s\n"),
379             dev->print_name(), dev->bstrerror());
380          mark_volume_in_error(dcr);
381          goto mount_next_vol;
382       }
383       if (dev->is_dvd()) {
384          char ed1[50], ed2[50];
385          if (dev->VolCatInfo.VolCatBytes == dev->part_start + dev->part_size) {
386             Jmsg(jcr, M_INFO, 0, _("Ready to append to end of Volume \"%s\""
387                  " part=%d size=%s\n"), dcr->VolumeName, 
388                  dev->part, edit_uint64(dev->VolCatInfo.VolCatBytes,ed1));
389          } else {
390             Jmsg(jcr, M_ERROR, 0, _("I cannot write on Volume \"%s\" because: "
391                  "The sizes do not match! Volume=%s Catalog=%s\n"),
392                  dcr->VolumeName,
393                  edit_uint64(dev->part_start + dev->part_size, ed1),
394                  edit_uint64(dev->VolCatInfo.VolCatBytes, ed2));
395             mark_volume_in_error(dcr);
396             goto mount_next_vol;
397          }
398       }
399       /* *****FIXME**** we should do some checking for files too */
400       if (dev->is_tape()) {
401          /*
402           * Check if we are positioned on the tape at the same place
403           * that the database says we should be.
404           */
405          if (dev->VolCatInfo.VolCatFiles == dev->get_file()) {
406             Jmsg(jcr, M_INFO, 0, _("Ready to append to end of Volume \"%s\" at file=%d.\n"),
407                  dcr->VolumeName, dev->get_file());
408          } else {
409             Jmsg(jcr, M_ERROR, 0, _("I cannot write on Volume \"%s\" because:\n"
410                  "The number of files mismatch! Volume=%u Catalog=%u\n"),
411                  dcr->VolumeName, dev->get_file(), dev->VolCatInfo.VolCatFiles);
412             mark_volume_in_error(dcr);
413             goto mount_next_vol;
414          }
415       }
416       dev->VolCatInfo.VolCatMounts++;      /* Update mounts */
417       Dmsg1(150, "update volinfo mounts=%d\n", dev->VolCatInfo.VolCatMounts);
418       if (!dir_update_volume_info(dcr, false)) {
419          return false;
420       }
421       
422       /*
423        * DVD : check if the last part was removed or truncated, or if a written
424        * part was overwritten.   
425        * We need to do it after dir_update_volume_info, so we have the EndBlock
426        * info. (nb: I don't understand why VolCatFiles is set (used to check
427        * tape file number), but not EndBlock)
428        * Maybe could it be changed "dev->is_file()" (would remove the fixme above)   
429        *
430        * Disabled: I had problems with this code... 
431        * (maybe is it related to the seek bug ?)   
432        */
433 #ifdef xxx
434       if (dev->is_dvd()) {
435          Dmsg2(150, "DVD/File sanity check addr=%u vs endblock=%u\n", (unsigned int)dev->file_addr, (unsigned int)dev->VolCatInfo.EndBlock);
436          if (dev->file_addr == dev->VolCatInfo.EndBlock+1) {
437             Jmsg(jcr, M_INFO, 0, _("Ready to append to end of Volume \"%s\" at file address=%u.\n"),
438                  dcr->VolumeName, (unsigned int)dev->file_addr);
439          }
440          else {
441             Jmsg(jcr, M_ERROR, 0, _("I cannot write on Volume \"%s\" because:\n"
442                                     "The EOD file address is wrong: Volume file address=%u != Catalog Endblock=%u(+1)\n"
443                                     "You probably removed DVD last part in spool directory.\n"),
444                  dcr->VolumeName, (unsigned int)dev->file_addr, (unsigned int)dev->VolCatInfo.EndBlock);
445             mark_volume_in_error(dcr);
446             goto mount_next_vol;
447          }
448       }
449 #endif
450       
451       /* Return an empty block */
452       empty_block(block);             /* we used it for reading so set for write */
453    }
454    dev->set_append();
455    Dmsg1(150, "set APPEND, normal return from mount_next_write_volume. dev=%s\n",
456       dev->print_name());
457
458    return true;
459 }
460
461 /*
462  * If permitted, we label the device, make sure we can do
463  *   it by checking that the VolCatBytes is zero => not labeled,
464  *   once the Volume is labeled we don't want to label another
465  *   blank tape with the same name.  For disk, we go ahead and
466  *   label it anyway, because the OS insures that there is only
467  *   one Volume with that name.
468  * As noted above, at this point dcr->VolCatInfo has what
469  *   the Director wants and dev->VolCatInfo has info on the
470  *   previous tape (or nothing).
471  *
472  * Return codes are:
473  *   try_next_vol        label failed, look for another volume
474  *   try_read_vol        labeled volume, now re-read the label
475  *   try_error           hard error (catalog update)
476  *   try_default         I couldn't do anything
477  */
478 static int try_autolabel(DCR *dcr, bool opened)
479 {
480    DEVICE *dev = dcr->dev;
481
482    if (dev->poll && !dev->is_tape()) {
483       return try_default;       /* if polling, don't try to create new labels */
484    }
485    /* For a tape require it to be opened and read before labeling */
486    if (!opened && dev->is_tape()) {
487       return try_default;
488    }
489    if (dev->has_cap(CAP_LABEL) && (dcr->VolCatInfo.VolCatBytes == 0 ||
490          (!dev->is_tape() && strcmp(dcr->VolCatInfo.VolCatStatus,
491                                 "Recycle") == 0))) {
492       Dmsg0(150, "Create volume label\n");
493       /* Create a new Volume label and write it to the device */
494       if (!write_new_volume_label_to_dev(dcr, dcr->VolumeName,
495              dcr->pool_name, false, /* no relabel */ false /* defer DVD label */)) {
496          Dmsg0(150, "!write_vol_label\n");
497          if (opened) { 
498             mark_volume_in_error(dcr);
499          }
500          return try_next_vol;
501       }
502       Dmsg0(150, "dir_update_vol_info. Set Append\n");
503       /* Copy Director's info into the device info */
504       dev->VolCatInfo = dcr->VolCatInfo;    /* structure assignment */
505       if (!dir_update_volume_info(dcr, true)) {  /* indicate tape labeled */
506          return try_error;
507       }
508       Jmsg(dcr->jcr, M_INFO, 0, _("Labeled new Volume \"%s\" on device %s.\n"),
509          dcr->VolumeName, dev->print_name());
510       return try_read_vol;   /* read label we just wrote */
511    }
512    if (!dev->has_cap(CAP_LABEL) && dcr->VolCatInfo.VolCatBytes == 0) {
513       Jmsg(dcr->jcr, M_INFO, 0, _("Warning device %s not configured to autolabel Volumes.\n"), 
514          dev->print_name());
515    }
516    /* If not removable, Volume is broken */
517    if (!dev->is_removable()) {
518       Jmsg(dcr->jcr, M_WARNING, 0, _("Volume \"%s\" not on device %s.\n"),
519          dcr->VolumeName, dev->print_name());
520       mark_volume_in_error(dcr);
521       return try_next_vol;
522    }
523    return try_default;
524 }
525
526
527 /*
528  * Mark volume in error in catalog
529  */
530 void mark_volume_in_error(DCR *dcr)
531 {
532    DEVICE *dev = dcr->dev;
533    Jmsg(dcr->jcr, M_INFO, 0, _("Marking Volume \"%s\" in Error in Catalog.\n"),
534         dcr->VolumeName);
535    dev->VolCatInfo = dcr->VolCatInfo;     /* structure assignment */
536    bstrncpy(dev->VolCatInfo.VolCatStatus, "Error", sizeof(dev->VolCatInfo.VolCatStatus));
537    Dmsg0(150, "dir_update_vol_info. Set Error.\n");
538    dir_update_volume_info(dcr, false);
539 }
540
541 /*
542  * The Volume is not in the correct slot, so mark this
543  *   Volume as not being in the Changer.
544  */
545 static void mark_volume_not_inchanger(DCR *dcr)
546 {
547    JCR *jcr = dcr->jcr;
548    DEVICE *dev = dcr->dev;
549    Jmsg(jcr, M_ERROR, 0, _("Autochanger Volume \"%s\" not found in slot %d.\n"
550 "    Setting InChanger to zero in catalog.\n"),
551         dcr->VolCatInfo.VolCatName, dcr->VolCatInfo.Slot);
552    dev->VolCatInfo = dcr->VolCatInfo;    /* structure assignment */
553    dcr->VolCatInfo.InChanger = false;
554    dev->VolCatInfo.InChanger = false;
555    Dmsg0(400, "update vol info in mount\n");
556    dir_update_volume_info(dcr, true);  /* set new status */
557 }
558
559 /*
560  * Either because we are going to hang a new volume, or because
561  *  of explicit user request, we release the current volume.
562  */
563 void release_volume(DCR *dcr)
564 {
565    JCR *jcr = dcr->jcr;
566    DEVICE *dev = dcr->dev;
567    if (dcr->WroteVol) {
568       Jmsg0(jcr, M_ERROR, 0, _("Hey!!!!! WroteVol non-zero !!!!!\n"));
569       Dmsg0(190, "Hey!!!!! WroteVol non-zero !!!!!\n");
570    }
571    /*
572     * First erase all memory of the current volume
573     */
574    dev->block_num = dev->file = 0;
575    dev->EndBlock = dev->EndFile = 0;
576    memset(&dev->VolCatInfo, 0, sizeof(dev->VolCatInfo));
577    memset(&dcr->VolCatInfo, 0, sizeof(dcr->VolCatInfo));
578    free_volume(dev);
579    memset(&dev->VolHdr, 0, sizeof(dev->VolHdr));
580    /* Force re-read of label */
581    dev->clear_labeled();
582    dev->clear_read();
583    dev->clear_append();
584    dev->label_type = B_BACULA_LABEL;
585    dcr->VolumeName[0] = 0;
586
587    if (dev->is_open() && (!dev->is_tape() || !dev->has_cap(CAP_ALWAYSOPEN))) {
588       dev->close();
589    }
590
591    /* If we have not closed the device, then at least rewind the tape */
592    if (dev->is_open()) {
593       dev->offline_or_rewind();
594    }
595    Dmsg0(190, "release_volume\n");
596 }
597
598 /*
599  * If we are reading, we come here at the end of the tape
600  *  and see if there are more volumes to be mounted.
601  */
602 bool mount_next_read_volume(DCR *dcr)
603 {
604    DEVICE *dev = dcr->dev;
605    JCR *jcr = dcr->jcr;
606    Dmsg2(90, "NumReadVolumes=%d CurReadVolume=%d\n", jcr->NumReadVolumes, jcr->CurReadVolume);
607    /*
608     * End Of Tape -- mount next Volume (if another specified)
609     */
610    if (jcr->NumReadVolumes > 1 && jcr->CurReadVolume < jcr->NumReadVolumes) {
611       dev->close();
612       if (!acquire_device_for_read(dcr)) {
613          Jmsg2(jcr, M_FATAL, 0, _("Cannot open Dev=%s, Vol=%s\n"), dev->print_name(),
614                dcr->VolumeName);
615          return false;
616       }
617       return true;                    /* next volume mounted */
618    }
619    Dmsg0(90, "End of Device reached.\n");
620    return false;
621 }