3 * dev.c -- low level operations on device (storage device)
7 * NOTE!!!! None of these routines are reentrant. You must
8 * use lock_device() and unlock_device() at a higher level,
9 * or use the xxx_device() equivalents. By moving the
10 * thread synchronization to a higher level, we permit
11 * the higher level routines to "seize" the device and
12 * to carry out operations without worrying about who
13 * set what lock (i.e. race conditions).
15 * Note, this is the device dependent code, and my have
16 * to be modified for each system, but is meant to
17 * be as "generic" as possible.
19 * The purpose of this code is to develop a SIMPLE Storage
20 * daemon. More complicated coding (double buffering, writer
21 * thread, ...) is left for a later version.
23 * Unfortunately, I have had to add more and more complication
24 * to this code. This was not foreseen as noted above, and as
25 * a consequence has lead to something more contorted than is
26 * really necessary -- KES. Note, this contortion has been
27 * corrected to a large extent by a rewrite (Apr MMI).
32 Copyright (C) 2000, 2001, 2002 Kern Sibbald and John Walker
34 This program is free software; you can redistribute it and/or
35 modify it under the terms of the GNU General Public License as
36 published by the Free Software Foundation; either version 2 of
37 the License, or (at your option) any later version.
39 This program is distributed in the hope that it will be useful,
40 but WITHOUT ANY WARRANTY; without even the implied warranty of
41 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
42 General Public License for more details.
44 You should have received a copy of the GNU General Public
45 License along with this program; if not, write to the Free
46 Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
52 * Handling I/O errors and end of tape conditions are a bit tricky.
53 * This is how it is currently done when writting.
54 * On either an I/O error or end of tape,
55 * we will stop writing on the physical device (no I/O recovery is
56 * attempted at least in this daemon). The state flag will be sent
57 * to include ST_EOT, which is ephimeral, and ST_WEOT, which is
58 * persistent. Lots of routines clear ST_EOT, but ST_WEOT is
59 * cleared only when the problem goes away. Now when ST_WEOT
60 * is set all calls to write_dev() are handled as usual. However,
61 * in write_block() instead of attempting to write the block to
62 * the physical device, it is chained into a list of blocks written
63 * after the EOT condition. In addition, all threads are blocked
64 * from writing on the tape by calling lock(), and thread other
65 * than the first thread to hit the EOT will block on a condition
66 * variable. The first thread to hit the EOT will continue to
67 * be able to read and write the tape (he sort of tunnels through
68 * the locking mechanism -- see lock() for details).
70 * Now presumably somewhere higher in the chain of command
71 * (device.c), someone will notice the EOT condition and
72 * get a new tape up, get the tape label read, and mark
73 * the label for rewriting. Then this higher level routine
74 * will write the unwritten buffer to the new volume.
75 * Finally, he will release
76 * any blocked threads by doing a broadcast on the condition
77 * variable. At that point, we should be totally back in
78 * business with no lost data.
85 /* Forward referenced functions */
86 int dev_is_tape(DEVICE *dev);
87 void clrerror_dev(DEVICE *dev, int func);
88 int fsr_dev(DEVICE *dev, int num);
90 extern int debug_level;
93 * Allocate and initialize the DEVICE structure
94 * Note, if dev is non-NULL, it is already allocated,
95 * thus we neither allocate it nor free it. This allows
96 * the caller to put the packet in shared memory.
98 * Note, for a tape, the dev_name is the device name
99 * (e.g. /dev/nst0), and for a file, the device name
100 * is the directory in which the file will be placed.
104 init_dev(DEVICE *dev, char *dev_name)
110 /* Check that device is available */
111 if (stat(dev_name, &statp) < 0) {
113 dev->dev_errno = errno;
115 Emsg2(M_FATAL, 0, "Unable to stat device %s : %s\n", dev_name, strerror(errno));
119 if (S_ISDIR(statp.st_mode)) {
121 } else if (S_ISCHR(statp.st_mode)) {
125 dev->dev_errno = ENODEV;
127 Emsg2(M_FATAL, 0, "%s is an unknown device type. Must be tape or directory. st_mode=%x\n",
128 dev_name, statp.st_mode);
132 dev = (DEVICE *)get_memory(sizeof(DEVICE));
133 memset(dev, 0, sizeof(DEVICE));
134 dev->state = ST_MALLOC;
136 memset(dev, 0, sizeof(DEVICE));
139 dev->state |= ST_TAPE;
141 dev->dev_name = get_memory(strlen(dev_name)+1);
142 strcpy(dev->dev_name, dev_name);
144 dev->errmsg = get_pool_memory(PM_EMSG);
148 if ((errstat=rwl_init(&dev->lock)) != 0) {
149 Mmsg1(&dev->errmsg, _("Unable to initialize dev lock. ERR=%s\n"), strerror(errstat));
150 Emsg0(M_FATAL, 0, dev->errmsg);
154 if ((errstat = pthread_mutex_init(&dev->mutex, NULL)) != 0) {
155 dev->dev_errno = errstat;
156 Mmsg1(&dev->errmsg, _("Unable to init mutex: ERR=%s\n"), strerror(errstat));
157 Emsg0(M_FATAL, 0, dev->errmsg);
159 if ((errstat = pthread_cond_init(&dev->wait, NULL)) != 0) {
160 dev->dev_errno = errstat;
161 Mmsg1(&dev->errmsg, _("Unable to init cond variable: ERR=%s\n"), strerror(errstat));
162 Emsg0(M_FATAL, 0, dev->errmsg);
164 if ((errstat = pthread_cond_init(&dev->wait_next_vol, NULL)) != 0) {
165 dev->dev_errno = errstat;
166 Mmsg1(&dev->errmsg, _("Unable to init cond variable: ERR=%s\n"), strerror(errstat));
167 Emsg0(M_FATAL, 0, dev->errmsg);
170 Dmsg2(29, "init_dev: tape=%d dev_name=%s\n", dev_is_tape(dev), dev->dev_name);
174 /* Open the device with the operating system and
175 * initialize buffer pointers.
177 * Note, for a tape, the VolName is the name we give to the
178 * volume (not really used here), but for a file, the
179 * VolName represents the name of the file to be created/opened.
180 * In the case of a file, the full name is the device name
181 * (archive_name) with the VolName concatenated.
184 open_dev(DEVICE *dev, char *VolName, int mode)
186 POOLMEM *archive_name;
188 if (dev->state & ST_OPENED) {
190 * *****FIXME***** how to handle two threads wanting
191 * different volumes mounted???? E.g. one is waiting
192 * for the next volume to be mounted, and a new job
193 * starts and snatches up the device.
195 if (VolName && strcmp(dev->VolCatInfo.VolCatName, VolName) != 0) {
199 Mmsg2(&dev->errmsg, _("WARNING!!!! device %s opened %d times!!!\n"),
200 dev->dev_name, dev->use_count);
201 Emsg0(M_WARNING, 0, dev->errmsg);
205 strcpy(dev->VolCatInfo.VolCatName, VolName);
208 Dmsg3(29, "open_dev: tape=%d dev_name=%s vol=%s\n", dev_is_tape(dev),
209 dev->dev_name, dev->VolCatInfo.VolCatName);
210 dev->state &= ~(ST_LABEL|ST_APPEND|ST_READ|ST_EOT|ST_WEOT|ST_EOF);
211 if (dev->state & ST_TAPE) {
213 Dmsg0(29, "open_dev: device is tape\n");
214 if (mode == READ_WRITE) {
215 dev->mode = O_RDWR | O_BINARY;
217 dev->mode = O_RDONLY | O_BINARY;
219 timeout = dev->max_open_wait;
221 while ((dev->fd = open(dev->dev_name, dev->mode, MODE_RW)) < 0) {
222 if (errno == EBUSY && timeout-- > 0) {
223 Dmsg2(100, "Device %s busy. ERR=%s\n", dev->dev_name, strerror(errno));
227 dev->dev_errno = errno;
228 Mmsg2(&dev->errmsg, _("stored: unable to open device %s: ERR=%s\n"),
229 dev->dev_name, strerror(dev->dev_errno));
230 Emsg0(M_FATAL, 0, dev->errmsg);
235 dev->state |= ST_OPENED;
237 update_pos_dev(dev); /* update position */
239 Dmsg1(29, "open_dev: tape %d opened\n", dev->fd);
242 * Handle opening of file
244 archive_name = get_pool_memory(PM_FNAME);
245 strcpy(archive_name, dev->dev_name);
246 if (archive_name[strlen(archive_name)] != '/') {
247 strcat(archive_name, "/");
249 strcat(archive_name, VolName);
250 Dmsg1(29, "open_dev: device is disk %s\n", archive_name);
251 if (mode == READ_WRITE) {
252 dev->mode = O_CREAT | O_RDWR | O_BINARY;
254 dev->mode = O_RDONLY | O_BINARY;
256 if ((dev->fd = open(archive_name, dev->mode, MODE_RW)) < 0) {
257 dev->dev_errno = errno;
258 Mmsg2(&dev->errmsg, _("Could not open: %s, ERR=%s\n"), archive_name, strerror(dev->dev_errno));
259 Emsg0(M_FATAL, 0, dev->errmsg);
262 dev->state |= ST_OPENED;
264 update_pos_dev(dev); /* update position */
266 Dmsg1(29, "open_dev: disk fd=%d opened\n", dev->fd);
267 free_pool_memory(archive_name);
274 * Returns: 1 on success
277 int rewind_dev(DEVICE *dev)
282 Dmsg0(29, "rewind_dev\n");
284 dev->dev_errno = EBADF;
285 Mmsg1(&dev->errmsg, _("Bad call to rewind_dev. Device %s not open\n"),
287 Emsg0(M_FATAL, 0, dev->errmsg);
290 dev->state &= ~(ST_APPEND|ST_READ|ST_EOT | ST_EOF | ST_WEOT); /* remove EOF/EOT flags */
291 dev->block_num = dev->file = 0;
293 if (dev->state & ST_TAPE) {
294 mt_com.mt_op = MTREW;
296 /* If we get an I/O error on rewind, it is probably because
297 * the drive is actually busy. We loop for (about 5 minutes)
298 * retrying every 5 seconds.
300 for (i=dev->max_rewind_wait; ; i -= 5) {
301 if (ioctl(dev->fd, MTIOCTOP, (char *)&mt_com) < 0) {
302 if (i == dev->max_rewind_wait) {
303 Dmsg1(200, "Rewind error, %s. retrying ...\n", strerror(errno));
305 clrerror_dev(dev, MTREW);
306 if (dev->dev_errno == EIO && i > 0) {
307 Dmsg0(200, "Sleeping 5 seconds.\n");
311 Mmsg2(&dev->errmsg, _("Rewind error on %s. ERR=%s.\n"),
312 dev->dev_name, strerror(dev->dev_errno));
318 if (lseek(dev->fd, 0, SEEK_SET) < 0) {
319 dev->dev_errno = errno;
320 Mmsg2(&dev->errmsg, _("lseek error on %s. ERR=%s.\n"),
321 dev->dev_name, strerror(dev->dev_errno));
329 * Position device to end of medium (end of data)
330 * Returns: 1 on succes
337 struct mtget mt_stat;
341 Dmsg0(29, "eod_dev\n");
342 if (dev->state & ST_EOT) {
345 dev->state &= ~(ST_EOF); /* remove EOF flags */
346 dev->block_num = dev->file = 0;
348 if (!(dev->state & ST_TAPE)) {
349 pos = lseek(dev->fd, 0, SEEK_END);
352 dev->state |= ST_EOT;
357 if (dev->capabilities & CAP_EOM) {
358 mt_com.mt_op = MTEOM;
360 if ((stat=ioctl(dev->fd, MTIOCTOP, (char *)&mt_com)) < 0) {
361 Dmsg1(50, "ioctl error: %s\n", strerror(dev->dev_errno));
362 clrerror_dev(dev, mt_com.mt_op);
364 Mmsg2(&dev->errmsg, _("ioctl MTEOM error on %s. ERR=%s.\n"),
365 dev->dev_name, strerror(dev->dev_errno));
368 if (ioctl(dev->fd, MTIOCGET, (char *)&mt_stat) < 0) {
369 dev->dev_errno = errno;
370 Mmsg2(&dev->errmsg, _("ioctl MTIOCGET error on %s. ERR=%s.\n"),
371 dev->dev_name, strerror(dev->dev_errno));
374 Dmsg2(200, "EOD file=%d block=%d\n", mt_stat.mt_fileno, mt_stat.mt_blkno);
375 dev->file = mt_stat.mt_fileno;
378 * Rewind then use FSF until EOT reached
381 if (!rewind_dev(dev)) {
384 while (!(dev->state & ST_EOT)) {
385 Dmsg0(200, "Do fsf 1\n");
386 if (fsf_dev(dev, 1) < 0) {
387 Dmsg0(200, "fsf_dev return < 0\n");
392 update_pos_dev(dev); /* update position */
393 Dmsg1(200, "EOD dev->file=%d\n", dev->file);
398 * Set the position of the device.
399 * Returns: 1 on succes
402 int update_pos_dev(DEVICE *dev)
405 struct mtget mt_stat;
411 dev->dev_errno = EBADF;
412 Mmsg0(&dev->errmsg, _("Bad device call. Archive not open\n"));
413 Emsg0(M_FATAL, 0, dev->errmsg);
417 /* Find out where we are */
418 if (!(dev->state & ST_TAPE)) {
421 pos = lseek(dev->fd, 0, SEEK_CUR);
423 Dmsg1(200, "Seek error: ERR=%s\n", strerror(dev->dev_errno));
425 dev->dev_errno = errno;
426 Mmsg2(&dev->errmsg, _("lseek error on %s. ERR=%s.\n"),
427 dev->dev_name, strerror(dev->dev_errno));
434 #ifdef REALLY_IMPLEMENTED
435 if (ioctl(dev->fd, MTIOCGET, (char *)&mt_stat) < 0) {
436 Dmsg1(50, "MTIOCGET error: %s\n", strerror(dev->dev_errno));
437 dev->dev_errno = errno;
438 Mmsg2(&dev->errmsg, _("ioctl MTIOCGET error on %s. ERR=%s.\n"),
439 dev->dev_name, strerror(dev->dev_errno));
450 * Return the status of the device. This was meant
451 * to be a generic routine. Unfortunately, it doesn't
452 * seem possible (at least I do not know how to do it
453 * currently), which means that for the moment, this
454 * routine has very little value.
456 * Returns: 1 on success
460 status_dev(DEVICE *dev, uint32_t *status)
462 struct mtget mt_stat;
465 if (dev->state & (ST_EOT | ST_WEOT)) {
469 if (dev->state & ST_EOF) {
473 if (dev->state & ST_TAPE) {
475 Dmsg0(-20," Driver status:");
476 Dmsg2(-20," file=%d block=%d\n", dev->file, dev->block_num);
477 if (ioctl(dev->fd, MTIOCGET, (char *)&mt_stat) < 0) {
478 dev->dev_errno = errno;
479 Mmsg2(&dev->errmsg, _("ioctl MTIOCGET error on %s. ERR=%s.\n"),
480 dev->dev_name, strerror(dev->dev_errno));
483 Dmsg0(-20, " Device status:");
485 #if defined(HAVE_LINUX_OS)
486 if (GMT_EOF(mt_stat.mt_gstat)) {
490 if (GMT_BOT(mt_stat.mt_gstat)) {
494 if (GMT_EOT(mt_stat.mt_gstat)) {
498 if (GMT_SM(mt_stat.mt_gstat)) {
502 if (GMT_EOD(mt_stat.mt_gstat)) {
506 if (GMT_WR_PROT(mt_stat.mt_gstat)) {
508 Dmsg0(-20, " WR_PROT");
510 if (GMT_ONLINE(mt_stat.mt_gstat)) {
512 Dmsg0(-20, " ONLINE");
514 if (GMT_DR_OPEN(mt_stat.mt_gstat)) {
516 Dmsg0(-20, " DR_OPEN");
518 if (GMT_IM_REP_EN(mt_stat.mt_gstat)) {
519 stat |= MT_IM_REP_EN;
520 Dmsg0(-20, " IM_REP_EN");
522 #endif /* !SunOS && !OSF */
523 Dmsg2(-20, " file=%d block=%d\n", mt_stat.mt_fileno, mt_stat.mt_blkno);
525 stat |= MT_ONLINE | MT_BOT;
533 * Load medium in device
534 * Returns: 1 on success
537 int load_dev(DEVICE *dev)
544 dev->dev_errno = EBADF;
545 Mmsg0(&dev->errmsg, _("Bad call to load_dev. Archive not open\n"));
546 Emsg0(M_FATAL, 0, dev->errmsg);
549 if (!(dev->state & ST_TAPE)) {
553 Dmsg0(200, "stored: MTLOAD command not available\n");
554 dev->dev_errno = ENOTTY; /* function not available */
555 Mmsg2(&dev->errmsg, _("ioctl MTLOAD error on %s. ERR=%s.\n"),
556 dev->dev_name, strerror(dev->dev_errno)); return 0;
560 dev->block_num = dev->file = 0;
562 mt_com.mt_op = MTLOAD;
564 if (ioctl(dev->fd, MTIOCTOP, (char *)&mt_com) < 0) {
565 dev->dev_errno = errno;
566 Mmsg2(&dev->errmsg, _("ioctl MTLOAD error on %s. ERR=%s.\n"),
567 dev->dev_name, strerror(dev->dev_errno)); return 0;
574 * Rewind device and put it offline
575 * Returns: 1 on success
578 int offline_dev(DEVICE *dev)
583 dev->dev_errno = EBADF;
584 Mmsg0(&dev->errmsg, _("Bad call to load_dev. Archive not open\n"));
585 Emsg0(M_FATAL, 0, dev->errmsg);
588 if (!(dev->state & ST_TAPE)) {
592 dev->block_num = dev->file = 0;
595 mt_com.mt_op = MTUNLOCK;
597 ioctl(dev->fd, MTIOCTOP, (char *)&mt_com);
599 mt_com.mt_op = MTOFFL;
601 if (ioctl(dev->fd, MTIOCTOP, (char *)&mt_com) < 0) {
602 dev->dev_errno = errno;
603 Mmsg2(&dev->errmsg, _("ioctl MTOFFL error on %s. ERR=%s.\n"),
604 dev->dev_name, strerror(dev->dev_errno));
607 Dmsg1(100, "Offlined device %s\n", dev->dev_name);
613 * Foward space a file
616 fsf_dev(DEVICE *dev, int num)
623 dev->dev_errno = EBADF;
624 Mmsg0(&dev->errmsg, _("Bad call to fsf_dev. Archive not open\n"));
625 Emsg0(M_FATAL, 0, dev->errmsg);
629 if (!(dev->state & ST_TAPE)) {
632 if (dev->state & ST_EOT) {
634 Mmsg1(&dev->errmsg, _("Device %s at End of Tape.\n"), dev->dev_name);
637 if (dev->state & ST_EOF)
638 Dmsg0(200, "ST_EOF set on entry to FSF\n");
639 if (dev->state & ST_EOT)
640 Dmsg0(200, "ST_EOT set on entry to FSF\n");
642 Dmsg0(29, "fsf_dev\n");
644 if (dev->capabilities & CAP_FSF) {
645 Dmsg0(200, "FSF has cap_fsf\n");
646 mt_com.mt_op = MTFSF;
648 while (num-- && !(dev->state & ST_EOT)) {
649 Dmsg0(200, "Doing read for fsf\n");
650 if ((stat = read(dev->fd, rbuf, sizeof(rbuf))) < 0) {
651 if (errno == ENOMEM) { /* tape record exceeds buf len */
652 stat = sizeof(rbuf); /* This is OK */
654 dev->state |= ST_EOT;
655 clrerror_dev(dev, -1);
656 Dmsg1(200, "Set ST_EOT read error %d\n", dev->dev_errno);
657 Mmsg2(&dev->errmsg, _("read error on %s. ERR=%s.\n"),
658 dev->dev_name, strerror(dev->dev_errno));
659 Dmsg1(200, "%s", dev->errmsg);
663 if (stat == 0) { /* EOF */
665 Dmsg1(200, "End of File mark from read. File=%d\n", dev->file+1);
666 /* Two reads of zero means end of tape */
667 if (dev->state & ST_EOF) {
668 dev->state |= ST_EOT;
669 Dmsg0(200, "Set ST_EOT\n");
672 dev->state |= ST_EOF;
677 } else { /* Got data */
678 dev->state &= ~(ST_EOF|ST_EOT);
681 Dmsg0(200, "Doing MT_FSF\n");
682 stat = ioctl(dev->fd, MTIOCTOP, (char *)&mt_com);
683 if (stat < 0) { /* error => EOT */
684 dev->state |= ST_EOT;
685 Dmsg0(200, "Set ST_EOT\n");
686 clrerror_dev(dev, MTFSF);
687 Mmsg2(&dev->errmsg, _("ioctl MTFSF error on %s. ERR=%s.\n"),
688 dev->dev_name, strerror(dev->dev_errno));
689 Dmsg0(200, "Got < 0 for MT_FSF\n");
690 Dmsg1(200, "%s", dev->errmsg);
692 dev->state |= ST_EOF; /* just read EOF */
699 * No FSF, so use FSR to simulate it
702 Dmsg0(200, "Doing FSR for FSF\n");
703 while (num-- && !(dev->state & ST_EOT)) {
704 fsr_dev(dev, INT32_MAX); /* returns -1 on EOF or EOT */
706 if (dev->state & ST_EOT) {
708 Mmsg1(&dev->errmsg, _("Device %s at End of Tape.\n"), dev->dev_name);
715 Dmsg1(200, "Return %d from FSF\n", stat);
716 if (dev->state & ST_EOF)
717 Dmsg0(200, "ST_EOF set on exit FSF\n");
718 if (dev->state & ST_EOT)
719 Dmsg0(200, "ST_EOT set on exit FSF\n");
720 Dmsg1(200, "Return from FSF file=%d\n", dev->file);
725 * Backward space a file
728 bsf_dev(DEVICE *dev, int num)
734 dev->dev_errno = EBADF;
735 Mmsg0(&dev->errmsg, _("Bad call to fsf_dev. Archive not open\n"));
736 Emsg0(M_FATAL, 0, dev->errmsg);
740 if (!(dev->state & ST_TAPE)) {
743 Dmsg0(29, "bsf_dev\n");
744 dev->state &= ~(ST_EOT|ST_EOF);
747 mt_com.mt_op = MTBSF;
748 mt_com.mt_count = num;
749 stat = ioctl(dev->fd, MTIOCTOP, (char *)&mt_com);
751 clrerror_dev(dev, MTBSF);
752 Mmsg2(&dev->errmsg, _("ioctl MTBSF error on %s. ERR=%s.\n"),
753 dev->dev_name, strerror(dev->dev_errno));
761 * Foward space a record
764 fsr_dev(DEVICE *dev, int num)
770 dev->dev_errno = EBADF;
771 Mmsg0(&dev->errmsg, _("Bad call to fsf_dev. Archive not open\n"));
772 Emsg0(M_FATAL, 0, dev->errmsg);
776 if (!(dev->state & ST_TAPE)) {
779 Dmsg0(29, "fsr_dev\n");
780 dev->block_num += num;
781 mt_com.mt_op = MTFSR;
782 mt_com.mt_count = num;
783 stat = ioctl(dev->fd, MTIOCTOP, (char *)&mt_com);
785 dev->state &= ~ST_EOF;
787 if (dev->state & ST_EOF) {
788 dev->state |= ST_EOT;
790 dev->state |= ST_EOF; /* assume EOF */
794 clrerror_dev(dev, MTFSR);
795 Mmsg2(&dev->errmsg, _("ioctl MTFSR error on %s. ERR=%s.\n"),
796 dev->dev_name, strerror(dev->dev_errno));
803 * Backward space a record
806 bsr_dev(DEVICE *dev, int num)
812 dev->dev_errno = EBADF;
813 Mmsg0(&dev->errmsg, _("Bad call to fsf_dev. Archive not open\n"));
814 Emsg0(M_FATAL, 0, dev->errmsg);
818 if (!(dev->state & ST_TAPE)) {
821 Dmsg0(29, "bsr_dev\n");
822 dev->block_num -= num;
823 dev->state &= ~(ST_EOF|ST_EOT|ST_EOF);
824 mt_com.mt_op = MTBSR;
825 mt_com.mt_count = num;
826 stat = ioctl(dev->fd, MTIOCTOP, (char *)&mt_com);
828 clrerror_dev(dev, MTBSR);
829 Mmsg2(&dev->errmsg, _("ioctl MTBSR error on %s. ERR=%s.\n"),
830 dev->dev_name, strerror(dev->dev_errno));
839 * Write an end of file on the device
842 weof_dev(DEVICE *dev, int num)
848 dev->dev_errno = EBADF;
849 Mmsg0(&dev->errmsg, _("Bad call to fsf_dev. Archive not open\n"));
850 Emsg0(M_FATAL, 0, dev->errmsg);
854 if (!(dev->state & ST_TAPE)) {
857 dev->state &= ~(ST_EOT | ST_EOF); /* remove EOF/EOT flags */
859 Dmsg0(29, "weof_dev\n");
860 mt_com.mt_op = MTWEOF;
861 mt_com.mt_count = num;
862 stat = ioctl(dev->fd, MTIOCTOP, (char *)&mt_com);
867 clrerror_dev(dev, MTWEOF);
868 Mmsg2(&dev->errmsg, _("ioctl MTWEOF error on %s. ERR=%s.\n"),
869 dev->dev_name, strerror(dev->dev_errno));
875 * Return string message with last error in English
876 * Be careful not to call this routine from within dev.c
877 * while editing an Mmsg(&) or you will end up in a recursive
878 * loop creating a Segmentation Violation.
881 strerror_dev(DEVICE *dev)
888 * If implemented in system, clear the tape
892 clrerror_dev(DEVICE *dev, int func)
896 dev->dev_errno = errno; /* save errno */
898 dev->VolCatInfo.VolCatErrors++;
901 if (!(dev->state & ST_TAPE)) {
904 if (errno == ENOTTY || errno == ENOSYS) { /* Function not implemented */
907 Emsg0(M_ABORT, 0, "Got ENOTTY on read/write!\n");
911 dev->capabilities &= ~CAP_EOF; /* turn off feature */
915 dev->capabilities &= ~CAP_EOM; /* turn off feature */
919 dev->capabilities &= ~CAP_FSF; /* turn off feature */
923 dev->capabilities &= ~CAP_BSF; /* turn off feature */
927 dev->capabilities &= ~CAP_FSR; /* turn off feature */
931 dev->capabilities &= ~CAP_BSR; /* turn off feature */
938 dev->dev_errno = ENOSYS;
939 Mmsg1(&dev->errmsg, _("This device does not support %s.\n"), msg);
940 Emsg0(M_ERROR, 0, dev->errmsg);
947 mt_com.mt_op = MTIOCLRERR;
949 stat = ioctl(dev->fd, MTIOCTOP, (char *)&mt_com);
950 Dmsg0(200, "Did MTIOCLRERR\n");
956 * Flush buffer contents
959 int flush_dev(DEVICE *dev)
964 static void do_close(DEVICE *dev)
967 Dmsg0(29, "really close_dev\n");
969 /* Clean up device packet so it can be reused */
971 dev->state &= ~(ST_OPENED|ST_LABEL|ST_READ|ST_APPEND|ST_EOT|ST_WEOT|ST_EOF);
975 dev->LastBlockNumWritten = 0;
976 memset(&dev->VolCatInfo, 0, sizeof(dev->VolCatInfo));
977 memset(&dev->VolHdr, 0, sizeof(dev->VolHdr));
985 close_dev(DEVICE *dev)
988 Mmsg0(&dev->errmsg, _("Bad call to fsf_dev. Archive not open\n"));
989 Emsg0(M_FATAL, 0, dev->errmsg);
992 if (dev->fd >= 0 && dev->use_count == 1) {
995 Dmsg0(29, "close_dev but in use so leave open.\n");
1001 * Used when unmounting the device
1003 void force_close_dev(DEVICE *dev)
1006 Mmsg0(&dev->errmsg, _("Bad call to fsf_dev. Archive not open\n"));
1007 Emsg0(M_FATAL, 0, dev->errmsg);
1010 Dmsg0(29, "really close_dev\n");
1014 int truncate_dev(DEVICE *dev)
1016 if (dev->state & ST_TAPE) {
1019 if (ftruncate(dev->fd, 0) != 0) {
1020 Mmsg1(&dev->errmsg, _("Unable to truncate device. ERR=%s\n"), strerror(errno));
1027 dev_is_tape(DEVICE *dev)
1029 return (dev->state & ST_TAPE) ? 1 : 0;
1033 dev_name(DEVICE *dev)
1035 return dev->dev_name;
1039 dev_vol_name(DEVICE *dev)
1041 return dev->VolCatInfo.VolCatName;
1044 uint32_t dev_block(DEVICE *dev)
1046 update_pos_dev(dev);
1047 return dev->block_num;
1050 uint32_t dev_file(DEVICE *dev)
1052 update_pos_dev(dev);
1057 * Free memory allocated for the device
1060 term_dev(DEVICE *dev)
1063 dev->dev_errno = EBADF;
1064 Mmsg0(&dev->errmsg, _("Bad call to fsf_dev. Archive not open\n"));
1065 Emsg0(M_FATAL, 0, dev->errmsg);
1069 Dmsg0(29, "term_dev\n");
1070 if (dev->dev_name) {
1071 free_memory(dev->dev_name);
1072 dev->dev_name = NULL;
1075 free_pool_memory(dev->errmsg);
1079 rwl_destroy(&dev->lock);
1081 pthread_mutex_destroy(&dev->mutex);
1082 pthread_cond_destroy(&dev->wait);
1083 pthread_cond_destroy(&dev->wait_next_vol);
1084 if (dev->state & ST_MALLOC) {
1085 free_pool_memory((POOLMEM *)dev);
1090 /* To make following two functions more readable */
1092 #define attached_jcrs ((JCR *)(dev->attached_jcrs))
1094 void attach_jcr_to_device(DEVICE *dev, JCR *jcr)
1096 jcr->prev_dev = NULL;
1097 jcr->next_dev = attached_jcrs;
1098 if (attached_jcrs) {
1099 attached_jcrs->prev_dev = jcr;
1101 attached_jcrs = jcr;
1102 Dmsg1(100, "Attached Job %s\n", jcr->Job);
1105 void detach_jcr_from_device(DEVICE *dev, JCR *jcr)
1107 if (!jcr->prev_dev) {
1108 attached_jcrs = jcr->next_dev;
1110 jcr->prev_dev->next_dev = jcr->next_dev;
1112 if (jcr->next_dev) {
1113 jcr->next_dev->prev_dev = jcr->prev_dev;
1115 jcr->next_dev = jcr->prev_dev = NULL;
1116 Dmsg1(100, "Detached Job %s\n", jcr->Job);
1119 JCR *next_attached_jcr(DEVICE *dev, JCR *jcr)
1122 return attached_jcrs;
1124 return jcr->next_dev;