3 * Higher Level Device routines.
4 * Knows about Bacula tape labels and such
6 * NOTE! In general, subroutines that have the word
7 * "device" in the name do locking. Subroutines
8 * that have the word "dev" in the name do not
9 * do locking. Thus if xxx_device() calls
10 * yyy_dev(), all is OK, but if xxx_device()
11 * calls yyy_device(), everything will hang.
12 * Obviously, no zzz_dev() is allowed to call
13 * a www_device() or everything falls apart.
15 * Concerning the routines lock_device() and block_device()
16 * see the end of this module for details. In general,
17 * blocking a device leaves it in a state where all threads
18 * other than the current thread block when they attempt to
19 * lock the device. They remain suspended (blocked) until the device
20 * is unblocked. So, a device is blocked during an operation
21 * that takes a long time (initialization, mounting a new
22 * volume, ...) locking a device is done for an operation
23 * that takes a short time such as writing data to the
27 * Kern Sibbald, MM, 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,
51 #include "bacula.h" /* pull in global headers */
52 #include "stored.h" /* pull in Storage Deamon headers */
54 /* Forward referenced functions */
56 extern char my_name[];
57 extern int debug_level;
60 * This is the dreaded moment. We either have an end of
61 * medium condition or worse, and error condition.
62 * Attempt to "recover" by obtaining a new Volume.
64 * We enter with device locked, and
65 * exit with device locked.
67 * Note, we are called only from one place in block.c
69 * Returns: 1 on success
72 int fixup_device_block_write_error(JCR *jcr, DEVICE *dev, DEV_BLOCK *block)
75 char PrevVolName[MAX_NAME_LENGTH];
76 DEV_BLOCK *label_blk = NULL;
80 wait_time = time(NULL);
81 status_dev(dev, &stat);
83 Dmsg0(190, "======= Got EOD ========\n");
85 new_lock_device_state(dev, BST_DOING_ACQUIRE);
86 block_device(dev, BST_DOING_ACQUIRE);
89 * Walk through all attached jcrs creating a jobmedia_record()
91 Dmsg1(100, "Walk attached jcrs. Volume=%s\n", dev->VolCatInfo.VolCatName);
92 for (JCR *mjcr=NULL; (mjcr=next_attached_jcr(dev, mjcr)); ) {
93 Dmsg1(100, "create JobMedia for Job %s\n", mjcr->Job);
94 mjcr->end_block = dev->block_num;
95 mjcr->end_file = dev->file;
96 if (!dir_create_jobmedia_record(mjcr)) {
97 Jmsg(mjcr, M_ERROR, 0, _("Could not create JobMedia record for Volume=%s Job=%s\n"),
98 dev->VolCatInfo.VolCatName, mjcr->Job);
103 strcpy(dev->VolCatInfo.VolCatStatus, "Full");
104 Dmsg2(100, "Call update_vol_info Stat=%s Vol=%s\n",
105 dev->VolCatInfo.VolCatStatus, dev->VolCatInfo.VolCatName);
106 if (!dir_update_volume_info(jcr, &dev->VolCatInfo, 0)) { /* send Volume info to Director */
107 Jmsg(jcr, M_ERROR, 0, _("Could not update Volume info Volume=%s Job=%s\n"),
108 dev->VolCatInfo.VolCatName, jcr->Job);
109 new_unlock_device(dev);
110 return 0; /* device locked */
112 Dmsg0(190, "Back from update_vol_info\n");
114 strcpy(PrevVolName, dev->VolCatInfo.VolCatName);
115 strcpy(dev->VolHdr.PrevVolName, PrevVolName);
117 label_blk = new_block(dev);
119 /* Inform User about end of media */
120 Jmsg(jcr, M_INFO, 0, _("End of media on Volume %s Bytes=%s Blocks=%s.\n"),
121 PrevVolName, edit_uint64_with_commas(dev->VolCatInfo.VolCatBytes, b1),
122 edit_uint64_with_commas(dev->VolCatInfo.VolCatBlocks, b2));
124 /* Unlock, but leave BLOCKED */
126 if (!mount_next_write_volume(jcr, dev, label_blk, 1)) {
127 new_unlock_device(dev);
132 return 0; /* device locked */
135 P(dev->mutex); /* lock again */
138 Jmsg(jcr, M_INFO, 0, _("New volume %s mounted on device %s\n"),
139 jcr->VolumeName, dev_name(dev));
142 * If this is a new tape, the label_blk will contain the
143 * label, so write it now. If this is a previously
144 * used tape, mount_next_write_volume() will return an
145 * empty label_blk, and nothing will be written.
147 Dmsg0(190, "write label block to dev\n");
148 if (!write_block_to_dev(dev, label_blk)) {
149 Pmsg1(0, "write_block_to_device Volume label failed. ERR=%s",
151 free_block(label_blk);
152 new_unlock_device(dev);
154 return 0; /* device locked */
157 /* Write overflow block to tape */
158 Dmsg0(190, "Write overflow block to dev\n");
159 if (!write_block_to_dev(dev, block)) {
160 Pmsg1(0, "write_block_to_device overflow block failed. ERR=%s",
162 free_block(label_blk);
163 new_unlock_device(dev);
165 return 0; /* device locked */
169 Dmsg0(190, "Wake up any waiting threads.\n");
170 free_block(label_blk);
171 for (JCR *mjcr=NULL; (mjcr=next_attached_jcr(dev, mjcr)); ) {
172 /* Set new start/end positions */
173 mjcr->start_block = dev->block_num;
174 mjcr->start_file = dev->file;
175 mjcr->VolFirstFile = mjcr->JobFiles;
176 mjcr->run_time += time(NULL) - wait_time; /* correct run time */
178 new_unlock_device(dev);
180 return 1; /* device locked */
183 free_block(label_blk);
185 new_unlock_device(dev);
186 return 0; /* device locked */
191 * Open the device. Expect dev to already be initialized.
193 * This routine is used only when the Storage daemon starts
194 * and always_open is set, and in the stand-alone utility
195 * routines such as bextract.
197 * Note, opening of a normal file is deferred to later so
198 * that we can get the filename; the device_name for
199 * a file is the directory only.
201 * Retuns: 0 on failure
204 int open_device(DEVICE *dev)
206 Dmsg0(120, "start open_output_device()\n");
211 new_lock_device(dev);
214 /* Defer opening files */
215 if (!dev_is_tape(dev)) {
216 Dmsg0(129, "Device is file, deferring open.\n");
217 new_unlock_device(dev);
222 if (!(dev->state & ST_OPENED)) {
223 Dmsg0(129, "Opening device.\n");
224 if (open_dev(dev, NULL, READ_WRITE) < 0) {
225 Emsg1(M_FATAL, 0, _("dev open failed: %s\n"), dev->errmsg);
226 new_unlock_device(dev);
231 Dmsg1(129, "open_dev %s OK\n", dev_name(dev));
233 new_unlock_device(dev);
239 * When dev_blocked is set, all threads EXCEPT thread with id no_wait_id
240 * must wait. The no_wait_id thread is out obtaining a new volume
241 * and preparing the label.
243 void lock_device(DEVICE *dev)
247 Dmsg1(190, "lock %d\n", dev->dev_blocked);
249 if (dev->dev_blocked && !pthread_equal(dev->no_wait_id, pthread_self())) {
250 dev->num_waiting++; /* indicate that I am waiting */
251 while (dev->dev_blocked) {
252 if ((stat = pthread_cond_wait(&dev->wait, &dev->mutex)) != 0) {
254 Emsg1(M_ABORT, 0, _("pthread_cond_wait failure. ERR=%s\n"),
258 dev->num_waiting--; /* no longer waiting */
263 void unlock_device(DEVICE *dev)
266 Dmsg0(190, "unlock\n");
272 * Block all other threads from using the device
273 * Device must already be locked. After this call,
274 * the device is blocked to any thread calling lock_device(),
275 * but the device is not locked (i.e. no P on device). Also,
276 * the current thread can do slip through the lock_device()
277 * calls without blocking.
279 void block_device(DEVICE *dev, int state)
282 Dmsg1(190, "block set %d\n", state);
283 ASSERT(dev->dev_blocked == BST_NOT_BLOCKED);
284 dev->dev_blocked = state; /* make other threads wait */
285 dev->no_wait_id = pthread_self(); /* allow us to continue */
290 * Unblock the device, and wake up anyone who went to sleep.
292 void unblock_device(DEVICE *dev)
295 Dmsg1(190, "unblock %d\n", dev->dev_blocked);
296 ASSERT(dev->dev_blocked);
297 dev->dev_blocked = BST_NOT_BLOCKED;
298 if (dev->num_waiting > 0) {
299 pthread_cond_broadcast(&dev->wait); /* wake them up */
304 void steal_device_lock(DEVICE *dev, bsteal_lock_t *hold, int state)
307 hold->dev_blocked = dev->dev_blocked;
308 hold->no_wait_id = dev->no_wait_id;
309 dev->dev_blocked = state;
310 dev->no_wait_id = pthread_self();
315 void return_device_lock(DEVICE *dev, bsteal_lock_t *hold)
319 dev->dev_blocked = hold->dev_blocked;
320 dev->no_wait_id = hold->no_wait_id;
326 /* ==================================================================
327 * New device locking code. It is not currently used.
328 * ==================================================================
332 * New device locking scheme
334 void _lock_device(char *file, int line, DEVICE *dev)
338 if ((errstat=rwl_writelock(&dev->lock)) != 0) {
339 e_msg(file, line, M_ABORT, 0, "rwl_writelock failure. ERR=%s\n",
345 void _lock_device(char *file, int line, DEVICE *dev, int state)
349 if ((errstat=rwl_writelock(&dev->lock)) != 0) {
350 e_msg(file, line, M_ABORT, 0, "rwl_writelock failure. ERR=%s\n",
353 dev->dev_blocked = state;
357 void _unlock_device(char *file, int line, DEVICE *dev)
361 if (dev->lock.w_active == 1) {
362 dev->dev_blocked = BST_NOT_BLOCKED;
364 if ((errstat=rwl_writeunlock(&dev->lock)) != 0) {
365 e_msg(file, line, M_ABORT, 0, "rwl_writeunlock failure. ERR=%s\n",
371 void new_steal_device_lock(DEVICE *dev, brwsteal_t *hold, int state)
374 hold->state = dev->dev_blocked;
375 hold->writer_id = dev->lock.writer_id;
376 dev->dev_blocked = state;
377 dev->lock.writer_id = pthread_self();
382 void new_return_device_lock(DEVICE *dev, brwsteal_t *hold)
386 dev->dev_blocked = hold->state;
387 dev->lock.writer_id = hold->writer_id;