]> git.sur5r.net Git - bacula/bacula/blob - bacula/src/stored/mount.c
Update doc, default working directory bscan
[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    Copyright (C) 2000, 2001, 2002 Kern Sibbald and John Walker
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 as
15    published by the Free Software Foundation; either version 2 of
16    the License, or (at your option) any later version.
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 GNU
21    General Public License for more details.
22
23    You should have received a copy of the GNU General Public
24    License along with this program; if not, write to the Free
25    Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
26    MA 02111-1307, USA.
27
28  */
29
30 #include "bacula.h"                   /* pull in global headers */
31 #include "stored.h"                   /* pull in Storage Deamon headers */
32
33 /* Forward referenced functions */
34 static char *edit_device_codes(JCR *jcr, char *omsg, char *imsg, char *cmd);
35
36
37 /*
38  * If release is set, we rewind the current volume, 
39  * which we no longer want, and ask the user (console) 
40  * to mount the next volume.
41  *
42  *  Continue trying until we get it, and then ensure
43  *  that we can write on it.
44  *
45  * This routine returns a 0 only if it is REALLY
46  *  impossible to get the requested Volume.
47  */
48 int mount_next_write_volume(JCR *jcr, DEVICE *dev, DEV_BLOCK *block, int release)
49 {
50    int recycle, ask, retry = 0, autochanger;
51
52    Dmsg0(100, "Enter mount_next_volume()\n");
53
54 mount_next_vol:
55    if (retry++ > 5) {
56       Jmsg(jcr, M_FATAL, 0, _("Too many errors trying to mount device %s.\n"), dev_name(dev));
57       return 0;
58    }
59    if (job_cancelled(jcr)) {
60       Jmsg(jcr, M_FATAL, 0, _("Job cancelled.\n"));
61       return 0;
62    }
63    recycle = ask = autochanger = 0;
64    if (release) {
65       Dmsg0(100, "mount_next_volume release=1\n");
66       /* 
67        * First erase all memory of the current volume   
68        */
69       dev->block_num = dev->file = 0;
70       dev->EndBlock = dev->EndFile = 0;
71       memset(&dev->VolCatInfo, 0, sizeof(dev->VolCatInfo));
72       memset(&jcr->VolCatInfo, 0, sizeof(jcr->VolCatInfo));
73       memset(&dev->VolHdr, 0, sizeof(dev->VolHdr));
74       dev->state &= ~ST_LABEL;        /* label not yet read */
75       jcr->VolumeName[0] = 0;
76
77       if (!dev_is_tape(dev) || !(dev->capabilities & CAP_ALWAYSOPEN)) {
78          if (dev->capabilities & CAP_OFFLINEUNMOUNT) {
79             offline_dev(dev);
80          }
81          close_dev(dev);
82       }
83
84       /* If we have not closed the device, then at least rewind the tape */
85       if (dev->state & ST_OPENED) {
86          if (dev->capabilities & CAP_OFFLINEUNMOUNT) {
87             offline_dev(dev);
88          }
89          if (!rewind_dev(dev)) {
90             Jmsg2(jcr, M_WARNING, 0, _("Rewind error on device %s. ERR=%s\n"), 
91                   dev_name(dev), strerror_dev(dev));
92          }
93       }
94       ask = 1;                        /* ask operator to mount tape */
95    }
96
97    /* 
98     * Get Director's idea of what tape we should have mounted. 
99     */
100    if (!dir_find_next_appendable_volume(jcr)) {
101       ask = 1;                     /* we must ask */
102       Dmsg0(100, "did not find next volume. Must ask.\n");
103    }
104    Dmsg2(100, "After find_next_append. Vol=%s Slot=%d\n",
105       jcr->VolCatInfo.VolCatName, jcr->VolCatInfo.Slot);
106    release = 1;                       /* release if we "recurse" */
107
108    /* 
109     * Get next volume and ready it for append
110     * This code ensures that the device is ready for
111     * writing. We start from the assumption that there
112     * may not be a tape mounted. 
113     *
114     * If the device is a file, we create the output
115     * file. If it is a tape, we check the volume name
116     * and move the tape to the end of data.
117     *
118     * It assumes that the device is not already in use!
119     *
120     */
121
122    Dmsg0(100, "Enter ready_dev_for_append\n");
123
124    dev->state &= ~(ST_APPEND|ST_READ|ST_EOT|ST_WEOT|ST_EOF);
125
126    jcr->VolFirstFile = jcr->JobFiles; /* first update of Vol FileIndex */
127    for ( ;; ) {
128       autochanger = autoload_device(jcr, dev, 1, NULL);
129       if (autochanger) {
130          ask = 0;                     /* if autochange no need to ask sysop */
131       }
132
133       if (ask && !dir_ask_sysop_to_mount_next_volume(jcr, dev)) {
134          Dmsg0(100, "Error return ask_sysop ...\n");
135          return 0;              /* error return */
136       }
137       Dmsg1(100, "want vol=%s\n", jcr->VolumeName);
138
139       /* Open device */
140       for ( ; !(dev->state & ST_OPENED); ) {
141           if (open_dev(dev, jcr->VolCatInfo.VolCatName, READ_WRITE) < 0) {
142              if (dev->dev_errno == EAGAIN || dev->dev_errno == EBUSY) {
143                 sleep(30);
144              }
145              Jmsg2(jcr, M_FATAL, 0, _("Unable to open device %s. ERR=%s\n"), 
146                 dev_name(dev), strerror_dev(dev));
147              return 0;
148           }
149       }
150
151       /*
152        * Now make sure we have the right tape mounted
153        */
154 read_volume:
155       switch (read_dev_volume_label(jcr, dev, block)) {
156          case VOL_OK:
157             Dmsg1(100, "Vol OK name=%s\n", jcr->VolumeName);
158             memcpy(&dev->VolCatInfo, &jcr->VolCatInfo, sizeof(jcr->VolCatInfo));
159             if (strcmp(dev->VolCatInfo.VolCatStatus, "Recycle") == 0) {
160                recycle = 1;
161             }
162             break;                    /* got it */
163          case VOL_NAME_ERROR:
164             Dmsg1(100, "Vol NAME Error Name=%s\n", jcr->VolumeName);
165             /* 
166              * OK, we got a different volume mounted. First save the
167              *  requested Volume info in the dev structure, then query if
168              *  this volume is really OK. If not, put back the desired
169              *  volume name and continue.
170              */
171             memcpy(&dev->VolCatInfo, &jcr->VolCatInfo, sizeof(jcr->VolCatInfo));
172             /* Check if this is a valid Volume in the pool */
173             strcpy(jcr->VolumeName, dev->VolHdr.VolName);
174             if (!dir_get_volume_info(jcr, 1)) {
175                Mmsg(&jcr->errmsg, _("Wanted Volume \"%s\".\n\
176     Actual Volume \"%s\" not acceptable.\n"),
177                   dev->VolCatInfo.VolCatName, dev->VolHdr.VolName);
178                /* Restore desired volume name, note device info out of sync */
179                memcpy(&jcr->VolCatInfo, &dev->VolCatInfo, sizeof(jcr->VolCatInfo));
180                goto mount_error;
181             }
182             Dmsg1(100, "want new name=%s\n", jcr->VolumeName);
183             memcpy(&dev->VolCatInfo, &jcr->VolCatInfo, sizeof(jcr->VolCatInfo));
184             break;
185
186          case VOL_NO_LABEL:
187          case VOL_IO_ERROR:
188             Dmsg1(500, "Vol NO_LABEL or IO_ERROR name=%s\n", jcr->VolumeName);
189             /* If permitted, create a label */
190             if (dev->capabilities & CAP_LABEL) {
191                Dmsg0(100, "Create volume label\n");
192                if (!write_volume_label_to_dev(jcr, (DEVRES *)dev->device, jcr->VolumeName,
193                       jcr->pool_name)) {
194                   Dmsg0(100, "!write_vol_label\n");
195                   goto mount_next_vol;
196                }
197                Jmsg(jcr, M_INFO, 0, _("Created Volume label %s on device %s.\n"),
198                   jcr->VolumeName, dev_name(dev));
199                goto read_volume;      /* read label we just wrote */
200             } 
201             /* NOTE! Fall-through wanted. */
202          default:
203 mount_error:
204             /* Send error message */
205             Jmsg1(jcr, M_WARNING, 0, "%s", jcr->errmsg);                         
206             if (autochanger) {
207                Jmsg(jcr, M_ERROR, 0, _("Autochanger Volume \"%s\" not found in slot %d.\n\
208     Setting slot to zero in catalog.\n"),
209                   jcr->VolCatInfo.VolCatName, jcr->VolCatInfo.Slot);
210                jcr->VolCatInfo.Slot = 0; /* invalidate slot */
211                dir_update_volume_info(jcr, &jcr->VolCatInfo, 1);  /* set slot */
212             }
213             Dmsg0(100, "Default\n");
214             goto mount_next_vol;
215       }
216       break;
217    }
218
219    /* 
220     * See if we have a fresh tape or tape with data.
221     *
222     * Note, if the LabelType is PRE_LABEL, it was labeled
223     *  but never written. If so, rewrite the label but set as
224     *  VOL_LABEL.  We rewind and return the label (reconstructed)
225     *  in the block so that in the case of a new tape, data can
226     *  be appended just after the block label.  If we are writing
227     *  an second volume, the calling routine will write the label
228     *  before writing the overflow block.
229     *
230     *  If the tape is marked as Recycle, we rewrite the label.
231     */
232    if (dev->VolHdr.LabelType == PRE_LABEL || recycle) {
233       Dmsg1(190, "ready_for_append found freshly labeled volume. dev=%x\n", dev);
234       dev->VolHdr.LabelType = VOL_LABEL; /* set Volume label */
235       write_volume_label_to_block(jcr, dev, block);
236       /*
237        * Write the block now to ensure we have write permission.
238        *  It is better to find out now rather than later.
239        */
240       dev->VolCatInfo.VolCatBytes = 0;
241       if (!rewind_dev(dev)) {
242          Jmsg2(jcr, M_WARNING, 0, _("Rewind error on device %s. ERR=%s\n"), 
243                dev_name(dev), strerror_dev(dev));
244       }
245       if (recycle) {
246          if (!truncate_dev(dev)) {
247             Jmsg2(jcr, M_WARNING, 0, _("Truncate error on device %s. ERR=%s\n"), 
248                   dev_name(dev), strerror_dev(dev));
249          }
250       }
251       /* Attempt write to check write permission */
252       if (!write_block_to_dev(jcr, dev, block)) {
253          Jmsg2(jcr, M_ERROR, 0, _("Unable to write device %s. ERR=%s\n"),
254             dev_name(dev), strerror_dev(dev));
255          goto mount_next_vol;
256       }
257       if (!rewind_dev(dev)) {
258          Jmsg2(jcr, M_ERROR, 0, _("Unable to rewind device %s. ERR=%s\n"),
259             dev_name(dev), strerror_dev(dev));
260          goto mount_next_vol;
261       }
262
263       /* Recreate a correct volume label and return it in the block */
264       write_volume_label_to_block(jcr, dev, block);
265       /* Set or reset Volume statistics */
266       dev->VolCatInfo.VolCatJobs = 1;
267       dev->VolCatInfo.VolCatFiles = 1;
268       dev->VolCatInfo.VolCatErrors = 0;
269       dev->VolCatInfo.VolCatBlocks = 1;
270       if (recycle) {
271          dev->VolCatInfo.VolCatMounts++;  
272          dev->VolCatInfo.VolCatRecycles++;
273       } else {
274          dev->VolCatInfo.VolCatMounts = 1;
275          dev->VolCatInfo.VolCatRecycles = 0;
276          dev->VolCatInfo.VolCatWrites = 1;
277          dev->VolCatInfo.VolCatReads = 1;
278       }
279       strcpy(dev->VolCatInfo.VolCatStatus, "Append");
280       Dmsg0(100, "dir_update_vol_info. Set Append\n");
281       dir_update_volume_info(jcr, &dev->VolCatInfo, 1);  /* indicate doing relabel */
282       if (recycle) {
283          Jmsg(jcr, M_INFO, 0, _("Recycled volume %s on device %s, all previous data lost.\n"),
284             jcr->VolumeName, dev_name(dev));
285       } else {
286          Jmsg(jcr, M_INFO, 0, _("Wrote label to prelabeled Volume %s on device %s\n"),
287             jcr->VolumeName, dev_name(dev));
288       }
289
290    } else {
291       /*
292        * OK, at this point, we have a valid Bacula label, but
293        * we need to position to the end of the volume, since we are
294        * just now putting it into append mode.
295        */
296       Dmsg0(200, "Device previously written, moving to end of data\n");
297       Jmsg(jcr, M_INFO, 0, _("Volume %s previously written, moving to end of data.\n"),
298          jcr->VolumeName);
299       if (!eod_dev(dev)) {
300          Jmsg(jcr, M_ERROR, 0, _("Unable to position to end of data %s. ERR=%s\n"),
301             dev_name(dev), strerror_dev(dev));
302          Jmsg(jcr, M_INFO, 0, _("Marking Volume %s in Error in Catalog.\n"),
303             jcr->VolumeName);
304          strcpy(dev->VolCatInfo.VolCatStatus, "Error");
305          Dmsg0(100, "dir_update_vol_info. Set Error.\n");
306          dir_update_volume_info(jcr, &dev->VolCatInfo, 0);
307          goto mount_next_vol;
308       }
309       /* *****FIXME**** we should do some checking for files too */
310       if (dev_is_tape(dev)) {
311          /*
312           * Check if we are positioned on the tape at the same place
313           * that the database says we should be.
314           */
315          if (dev->VolCatInfo.VolCatFiles == dev_file(dev) + 1) {
316             Jmsg(jcr, M_INFO, 0, _("Ready to append to end of Volume at file=%d.\n"), 
317                  dev_file(dev));
318          } else {
319             Jmsg(jcr, M_ERROR, 0, _("I canot write on this volume because:\n\
320 The number of files mismatch! Volume=%d Catalog=%d\n"), 
321                  dev_file(dev)+1, dev->VolCatInfo.VolCatFiles);
322             strcpy(dev->VolCatInfo.VolCatStatus, "Error");
323             Dmsg0(100, "dir_update_vol_info. Set Error.\n");
324             dir_update_volume_info(jcr, &dev->VolCatInfo, 0);
325             goto mount_next_vol;
326          }
327       }
328       dev->VolCatInfo.VolCatMounts++;      /* Update mounts */
329       dir_update_volume_info(jcr, &dev->VolCatInfo, 0);
330       /* Return an empty block */
331       empty_block(block);             /* we used it for reading so set for write */
332    }
333    dev->state |= ST_APPEND;
334    Dmsg0(100, "Normal return from read_dev_for_append\n");
335    return 1; 
336 }
337
338
339 int mount_next_read_volume(JCR *jcr, DEVICE *dev, DEV_BLOCK *block)
340 {
341    Dmsg2(90, "NumVolumes=%d CurVolume=%d\n", jcr->NumVolumes, jcr->CurVolume);
342    /*
343     * End Of Tape -- mount next Volume (if another specified)
344     */
345    if (jcr->NumVolumes > 1 && jcr->CurVolume < jcr->NumVolumes) {
346       close_dev(dev);
347       dev->state &= ~ST_READ; 
348       if (!acquire_device_for_read(jcr, dev, block)) {
349          Emsg2(M_FATAL, 0, "Cannot open Dev=%s, Vol=%s\n", dev_name(dev),
350                jcr->VolumeName);
351          return 0;
352       }
353       return 1;                       /* next volume mounted */
354    }
355    Dmsg0(90, "End of Device reached.\n");
356    return 0;
357 }
358
359 /*
360  * Called here to do an autoload using the autochanger, if
361  *  configured, and if a Slot has been defined for this Volume.
362  *  On success this routine loads the indicated tape, but the
363  *  label is not read, so it must be verified.
364  *
365  *  Note if dir is not NULL, it is the console requesting the 
366  *   autoload for labeling, so we respond directly to the
367  *   dir bsock.
368  *
369  *  Returns: 1 on success
370  *           0 on failure
371  */
372 int autoload_device(JCR *jcr, DEVICE *dev, int writing, BSOCK *dir)
373 {
374    int slot = jcr->VolCatInfo.Slot;
375    int rtn_stat = 0;
376      
377    /*
378     * Handle autoloaders here.  If we cannot autoload it, we
379     *  will return FALSE to ask the sysop.
380     */
381    if (writing && dev->capabilities && CAP_AUTOCHANGER && slot <= 0) {
382       if (dir) {
383          return 0;                    /* For user, bail out right now */
384       }
385       if (dir_find_next_appendable_volume(jcr)) {
386          slot = jcr->VolCatInfo.Slot; 
387       }
388    }
389    Dmsg1(100, "Want changer slot=%d\n", slot);
390
391    if (slot > 0 && jcr->device->changer_name && jcr->device->changer_command) {
392       uint32_t timeout = jcr->device->max_changer_wait;
393       POOLMEM *changer, *results;
394       int status, loaded;
395
396       results = get_pool_memory(PM_MESSAGE);
397       changer = get_pool_memory(PM_FNAME);
398
399       /* Find out what is loaded, zero means device is unloaded */
400       changer = edit_device_codes(jcr, changer, jcr->device->changer_command, 
401                    "loaded");
402       status = run_program(changer, timeout, results);
403       if (status == 0) {
404          loaded = atoi(results);
405       } else {
406          loaded = -1;              /* force unload */
407       }
408       Dmsg1(100, "loaded=%s\n", results);
409
410       /* If bad status or tape we want is not loaded, load it. */
411       if (status != 0 || loaded != slot) { 
412          if (dev->capabilities & CAP_OFFLINEUNMOUNT) {
413             offline_dev(dev);
414          }
415          /* We are going to load a new tape, so close the device */
416          force_close_dev(dev);
417          if (loaded != 0) {        /* must unload drive */
418             Dmsg0(100, "Doing changer unload.\n");
419             if (dir) {
420                bnet_fsend(dir, _("3902 Issuing autochanger \"unload\" command.\n"));
421             } else {
422                Jmsg(jcr, M_INFO, 0, _("Issuing autochanger \"unload\" command.\n"));
423             }
424             changer = edit_device_codes(jcr, changer, 
425                         jcr->device->changer_command, "unload");
426             status = run_program(changer, timeout, NULL);
427             Dmsg1(100, "unload status=%d\n", status);
428          }
429          /*
430           * Load the desired cassette    
431           */
432          Dmsg1(100, "Doing changer load slot %d\n", slot);
433          if (dir) {
434             bnet_fsend(dir, _("3903 Issuing autochanger \"load slot %d\" command.\n"),
435                slot);
436          } else {
437             Jmsg(jcr, M_INFO, 0, _("Issuing autochanger \"load slot %d\" command.\n"),
438                slot);
439          }
440          changer = edit_device_codes(jcr, changer, 
441                       jcr->device->changer_command, "load");
442          status = run_program(changer, timeout, NULL);
443          Dmsg2(100, "load slot %d status=%d\n", slot, status);
444       }
445       free_pool_memory(changer);
446       free_pool_memory(results);
447       Dmsg1(100, "After changer, status=%d\n", status);
448       if (status == 0) {           /* did we succeed? */
449          rtn_stat = 1;             /* tape loaded by changer */
450       }
451    }
452    return rtn_stat;
453 }
454
455
456
457 /*
458  * Edit codes into ChangerCommand
459  *  %% = %
460  *  %a = archive device name
461  *  %c = changer device name
462  *  %f = Client's name
463  *  %j = Job name
464  *  %o = command
465  *  %s = Slot base 0
466  *  %S = Slot base 1
467  *  %v = Volume name
468  *
469  *
470  *  omsg = edited output message
471  *  imsg = input string containing edit codes (%x)
472  *  cmd = command string (load, unload, ...) 
473  *
474  */
475 static char *edit_device_codes(JCR *jcr, char *omsg, char *imsg, char *cmd) 
476 {
477    char *p;
478    const char *str;
479    char add[20];
480
481    *omsg = 0;
482    Dmsg1(200, "edit_device_codes: %s\n", imsg);
483    for (p=imsg; *p; p++) {
484       if (*p == '%') {
485          switch (*++p) {
486          case '%':
487             str = "%";
488             break;
489          case 'a':
490             str = jcr->device->dev->dev_name;
491             break;
492          case 'c':
493             str = NPRT(jcr->device->changer_name);
494             break;
495          case 'o':
496             str = NPRT(cmd);
497             break;
498          case 's':
499             sprintf(add, "%d", jcr->VolCatInfo.Slot - 1);
500             str = add;
501             break;
502          case 'S':
503             sprintf(add, "%d", jcr->VolCatInfo.Slot);
504             str = add;
505             break;
506          case 'j':                    /* Job name */
507             str = jcr->Job;
508             break;
509          case 'v':
510             str = NPRT(jcr->VolumeName);
511             break;
512          case 'f':
513             str = NPRT(jcr->client_name);
514             break;
515
516          default:
517             add[0] = '%';
518             add[1] = *p;
519             add[2] = 0;
520             str = add;
521             break;
522          }
523       } else {
524          add[0] = *p;
525          add[1] = 0;
526          str = add;
527       }
528       Dmsg1(200, "add_str %s\n", str);
529       pm_strcat(&omsg, (char *)str);
530       Dmsg1(200, "omsg=%s\n", omsg);
531    }
532    return omsg;
533 }