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