2 * This file handles accepting Director Commands
4 * Most Director commands are handled here, with the
5 * exception of the Job command command and subsequent
6 * subcommands that are handled
9 * N.B. in this file, in general we must use P(dev->mutex) rather
10 * than lock_device(dev) so that we can examine the blocked
11 * state rather than blocking ourselves. In some "safe" cases,
12 * we can do things to a blocked device. CAREFUL!!!!
14 * File daemon commands are handled in fdcmd.c
16 * Kern Sibbald, May MMI
22 Copyright (C) 2000-2003 Kern Sibbald and John Walker
24 This program is free software; you can redistribute it and/or
25 modify it under the terms of the GNU General Public License as
26 published by the Free Software Foundation; either version 2 of
27 the License, or (at your option) any later version.
29 This program is distributed in the hope that it will be useful,
30 but WITHOUT ANY WARRANTY; without even the implied warranty of
31 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
32 General Public License for more details.
34 You should have received a copy of the GNU General Public
35 License along with this program; if not, write to the Free
36 Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
44 /* Exported variables */
46 /* Imported variables */
47 extern BSOCK *filed_chan;
48 extern int r_first, r_last;
49 extern struct s_res resources[];
50 extern char my_name[];
51 extern time_t daemon_start_time;
52 extern struct s_last_job last_job;
54 /* Static variables */
55 static char derrmsg[] = "3900 Invalid command\n";
56 static char OKsetdebug[] = "3000 OK setdebug=%d\n";
59 /* Imported functions */
60 extern void terminate_child();
61 extern int job_cmd(JCR *jcr);
63 /* Forward referenced functions */
64 static int label_cmd(JCR *jcr);
65 static int setdebug_cmd(JCR *jcr);
66 static int cancel_cmd(JCR *cjcr);
67 static int mount_cmd(JCR *jcr);
68 static int unmount_cmd(JCR *jcr);
69 static int status_cmd(JCR *sjcr);
70 static void label_volume_if_ok(JCR *jcr, DEVICE *dev, char *vname, char *poolname,
72 static void send_blocked_status(JCR *jcr, DEVICE *dev);
76 int (*func)(JCR *jcr);
80 * The following are the recognized commands from the Director.
82 static struct s_cmds cmds[] = {
83 {"JobId=", job_cmd}, /* start Job */
84 {"setdebug=", setdebug_cmd}, /* set debug level */
85 {"cancel", cancel_cmd},
86 {"label", label_cmd}, /* label a tape */
88 {"unmount", unmount_cmd},
89 {"status", status_cmd},
90 {NULL, NULL} /* list terminator */
95 * Connection request. We accept connections either from the
96 * Director or a Client.
98 * Note, we are running as a seperate thread of the Storage daemon.
99 * and it is because a Director has made a connection with
100 * us on the "Message" channel.
102 * Basic tasks done here:
103 * - Create a JCR record
104 * - Authenticate the Director
105 * - We wait for a command
106 * - We execute the command
107 * - We continue or exit depending on the return status
109 void *connection_request(void *arg)
111 BSOCK *bs = (BSOCK *)arg;
115 char name[MAX_NAME_LENGTH];
117 if (bnet_recv(bs) <= 0) {
118 Emsg0(M_ERROR, 0, "Connection request failed.\n");
123 * See if this is a File daemon connection
125 if (sscanf(bs->msg, "Hello Start Job %127s calling\n", name) == 1) {
126 handle_filed_connection(bs, name);
130 jcr = new_jcr(sizeof(JCR), stored_free_jcr); /* create Job Control Record */
131 jcr->dir_bsock = bs; /* save Director bsock */
133 Dmsg0(1000, "stored in start_job\n");
136 * Authenticate the Director
138 if (!authenticate_director(jcr)) {
139 Jmsg(jcr, M_FATAL, 0, _("Unable to authenticate Director\n"));
143 Dmsg0(90, "Message channel init completed.\n");
145 for (quit=0; !quit;) {
148 if ((bnet_stat = bnet_recv(bs)) <= 0) {
149 break; /* connection terminated */
151 Dmsg1(9, "<dird: %s\n", bs->msg);
153 for (i=0; cmds[i].cmd; i++) {
154 if (strncmp(cmds[i].cmd, bs->msg, strlen(cmds[i].cmd)) == 0) {
155 if (!cmds[i].func(jcr)) { /* do command */
156 quit = TRUE; /* error, get out */
157 Dmsg1(90, "Command %s requsts quit\n", cmds[i].cmd);
159 found = TRUE; /* indicate command found */
163 if (!found) { /* command not found */
164 bnet_fsend(bs, derrmsg);
169 if (bnet_stat != BNET_TERMINATE) {
170 bnet_sig(bs, BNET_TERMINATE);
177 * Set debug level as requested by the Director
180 static int setdebug_cmd(JCR *jcr)
182 BSOCK *dir = jcr->dir_bsock;
185 Dmsg1(10, "setdebug_cmd: %s", dir->msg);
186 if (sscanf(dir->msg, "setdebug=%d", &level) != 1 || level < 0) {
187 bnet_fsend(dir, "3991 Bad setdebug command: %s\n", dir->msg);
191 return bnet_fsend(dir, OKsetdebug, level);
198 static int cancel_cmd(JCR *cjcr)
200 BSOCK *dir = cjcr->dir_bsock;
202 char Job[MAX_NAME_LENGTH];
205 if (sscanf(dir->msg, "cancel Job=%127s", Job) == 1) {
206 if (!(jcr=get_jcr_by_full_name(Job))) {
207 bnet_fsend(dir, _("3992 Job %s not found.\n"), Job);
210 oldStatus = jcr->JobStatus;
211 set_jcr_job_status(jcr, JS_Cancelled);
212 if (!jcr->authenticated && oldStatus == JS_WaitFD) {
213 pthread_cond_signal(&jcr->job_start_wait); /* wake waiting thread */
216 if (jcr->file_bsock) {
217 bnet_sig(jcr->file_bsock, BNET_TERMINATE);
219 bnet_fsend(dir, _("3000 Job %s marked to be cancelled.\n"), jcr->Job);
223 bnet_fsend(dir, _("3993 Error scanning cancel command.\n"));
225 bnet_sig(dir, BNET_EOD);
233 static int label_cmd(JCR *jcr)
235 POOLMEM *dname, *volname, *poolname, *mtype;
236 BSOCK *dir = jcr->dir_bsock;
242 dname = get_memory(dir->msglen+1);
243 volname = get_memory(dir->msglen+1);
244 poolname = get_memory(dir->msglen+1);
245 mtype = get_memory(dir->msglen+1);
246 if (sscanf(dir->msg, "label %s VolumeName=%s PoolName=%s MediaType=%s Slot=%d",
247 dname, volname, poolname, mtype, &slot) == 5) {
248 unbash_spaces(dname);
249 unbash_spaces(volname);
250 unbash_spaces(poolname);
251 unbash_spaces(mtype);
254 while ((device=(DEVRES *)GetNextRes(R_DEVICE, (RES *)device))) {
255 /* Find resource, and make sure we were able to open it */
256 if (strcmp(device->hdr.name, dname) == 0 && device->dev) {
257 Dmsg1(20, "Found device %s\n", device->hdr.name);
264 /******FIXME**** compare MediaTypes */
265 jcr->device = device;
268 P(dev->mutex); /* Use P to avoid indefinite block */
269 if (!(dev->state & ST_OPENED)) {
270 if (open_dev(dev, volname, READ_WRITE) < 0) {
271 bnet_fsend(dir, _("3994 Connot open device: %s\n"), strerror_dev(dev));
273 label_volume_if_ok(jcr, dev, volname, poolname, slot);
274 force_close_dev(dev);
276 /* Under certain "safe" conditions, we can steal the lock */
277 } else if (dev->dev_blocked &&
278 (dev->dev_blocked == BST_UNMOUNTED ||
279 dev->dev_blocked == BST_WAITING_FOR_SYSOP ||
280 dev->dev_blocked == BST_UNMOUNTED_WAITING_FOR_SYSOP)) {
281 label_volume_if_ok(jcr, dev, volname, poolname, slot);
282 } else if (dev->state & ST_READ || dev->num_writers) {
283 if (dev->state & ST_READ) {
284 bnet_fsend(dir, _("3901 Device %s is busy with 1 reader.\n"),
287 bnet_fsend(dir, _("3902 Device %s is busy with %d writer(s).\n"),
288 dev_name(dev), dev->num_writers);
290 } else { /* device not being used */
291 label_volume_if_ok(jcr, dev, volname, poolname, slot);
295 bnet_fsend(dir, _("3999 Device %s not found\n"), dname);
298 /* NB dir->msg gets clobbered in bnet_fsend, so save command */
299 strcpy(dname, dir->msg);
300 bnet_fsend(dir, _("3903 Error scanning label command: %s\n"), dname);
303 free_memory(volname);
304 free_memory(poolname);
306 bnet_sig(dir, BNET_EOD);
311 * Read the tape label and determine if we can safely
312 * label the tape (not a Bacula volume), then label it.
314 * Enter with the mutex set
316 static void label_volume_if_ok(JCR *jcr, DEVICE *dev, char *vname, char *poolname,
319 BSOCK *dir = jcr->dir_bsock;
323 steal_device_lock(dev, &hold, BST_WRITING_LABEL);
325 strcpy(jcr->VolumeName, vname);
326 jcr->VolCatInfo.Slot = slot;
327 autoload_device(jcr, dev, 0, dir); /* autoload if possible */
328 block = new_block(dev);
330 /* Ensure that the device is open -- not autoload_device() closes it */
331 for ( ; !(dev->state & ST_OPENED); ) {
332 if (open_dev(dev, jcr->VolumeName, READ_WRITE) < 0) {
333 if (dev->dev_errno == EAGAIN || dev->dev_errno == EBUSY) {
336 bnet_fsend(dir, _("3903 Unable to open device %s. ERR=%s\n"),
337 dev_name(dev), strerror_dev(dev));
342 /* See what we have for a Volume */
343 switch (read_dev_volume_label(jcr, dev, block)) {
345 case VOL_VERSION_ERROR:
346 case VOL_LABEL_ERROR:
348 bnet_fsend(dir, _("3901 Cannot label Volume because it is \
349 already labeled: %s\n"), dev->VolHdr.VolName);
353 if (!write_volume_label_to_dev(jcr, jcr->device, vname, poolname)) {
354 bnet_fsend(dir, _("3903 Failed to label Volume: ERR=%s\n"), strerror_dev(dev));
357 strcpy(jcr->VolumeName, vname);
358 bnet_fsend(dir, _("3000 OK label. Volume=%s Device=%s\n"),
359 vname, dev->dev_name);
362 bnet_fsend(dir, _("3902 Cannot label Volume. \
363 Unknown status %d from read_volume_label()\n"), jcr->label_status);
368 return_device_lock(dev, &hold);
373 * Read the tape label
375 * Enter with the mutex set
377 static int read_label(JCR *jcr, DEVICE *dev)
380 BSOCK *dir = jcr->dir_bsock;
385 steal_device_lock(dev, &hold, BST_DOING_ACQUIRE);
388 jcr->VolumeName[0] = 0;
389 block = new_block(dev);
390 dev->state &= ~ST_LABEL; /* force read of label */
391 switch (read_dev_volume_label(jcr, dev, block)) {
393 bnet_fsend(dir, _("3001 Mounted Volume: %s\n"), dev->VolHdr.VolName);
397 bnet_fsend(dir, _("3902 Cannot mount Volume on Storage Device \"%s\" because:\n%s\n"),
398 dev->dev_name, jcr->errmsg);
404 return_device_lock(dev, &hold);
410 * Mount command from Director
412 static int mount_cmd(JCR *jcr)
415 BSOCK *dir = jcr->dir_bsock;
420 dev_name = (char *) get_memory(dir->msglen);
421 if (sscanf(dir->msg, "mount %s", dev_name) == 1) {
422 unbash_spaces(dev_name);
425 while ((device=(DEVRES *)GetNextRes(R_DEVICE, (RES *)device))) {
426 /* Find resource, and make sure we were able to open it */
427 if (strcmp(device->hdr.name, dev_name) == 0 && device->dev) {
428 Dmsg1(20, "Found device %s\n", device->hdr.name);
435 jcr->device = device;
437 P(dev->mutex); /* Use P to avoid indefinite block */
438 switch (dev->dev_blocked) { /* device blocked? */
440 case BST_WAITING_FOR_SYSOP:
441 /* Someone is waiting, wake him */
442 Dmsg0(90, "Waiting for mount attempt to wake thread\n");
443 pthread_cond_signal(&dev->wait_next_vol);
444 bnet_fsend(dir, "3001 OK mount. Device=%s\n", dev->dev_name);
447 case BST_UNMOUNTED_WAITING_FOR_SYSOP:
449 /* We freed the device, so reopen it and wake any waiting threads */
450 if (open_dev(dev, NULL, READ_WRITE) < 0) {
451 bnet_fsend(dir, _("3901 open device failed: ERR=%s\n"),
455 block = new_block(dev);
456 read_dev_volume_label(jcr, dev, block);
458 if (dev->dev_blocked == BST_UNMOUNTED) {
459 Dmsg0(90, "Unmounted unblocking device\n");
460 read_label(jcr, dev);
463 Dmsg0(90, "Unmounted waiting for mount attempt to wake thread\n");
464 dev->dev_blocked = BST_WAITING_FOR_SYSOP;
465 pthread_cond_signal(&dev->wait_next_vol);
467 if (dev->state & ST_LABEL) {
468 bnet_fsend(dir, _("3001 Device %s is mounted with Volume %s\n"),
469 dev->dev_name, dev->VolHdr.VolName);
471 bnet_fsend(dir, _("3905 Device %s open but no Bacula volume is mounted.\n"
472 "Try unmounting and remounting the Volume.\n"),
477 case BST_DOING_ACQUIRE:
478 bnet_fsend(dir, _("3001 Device %s is mounted; doing acquire.\n"),
482 case BST_WRITING_LABEL:
483 bnet_fsend(dir, _("3903 Device %s is being labeled.\n"), dev->dev_name);
486 case BST_NOT_BLOCKED:
487 if (dev->state & ST_OPENED) {
488 if (dev->state & ST_LABEL) {
489 bnet_fsend(dir, _("3001 Device %s is mounted with Volume %s\n"),
490 dev->dev_name, dev->VolHdr.VolName);
492 bnet_fsend(dir, _("3905 Device %s open but no Bacula volume is mounted.\n"
493 "Try unmounting and remounting the Volume.\n"),
497 if (!dev_is_tape(dev)) {
498 bnet_fsend(dir, _("3906 cannot mount non-tape.\n"));
501 if (open_dev(dev, NULL, READ_WRITE) < 0) {
502 bnet_fsend(dir, _("3901 open device failed: ERR=%s\n"),
506 read_label(jcr, dev);
507 if (dev->state & ST_LABEL) {
508 bnet_fsend(dir, _("3001 Device %s is mounted with Volume %s\n"),
509 dev->dev_name, dev->VolHdr.VolName);
511 bnet_fsend(dir, _("3905 Device %s open but no Bacula volume is mounted.\n"
512 "Try unmounting and remounting the Volume.\n"),
519 bnet_fsend(dir, _("3905 Bizarre wait state %d\n"), dev->dev_blocked);
524 bnet_fsend(dir, _("3999 Device %s not found\n"), dev_name);
527 strcpy(dev_name, dir->msg);
528 bnet_fsend(dir, _("3906 Error scanning mount command: %s\n"), dev_name);
530 free_memory(dev_name);
531 bnet_sig(dir, BNET_EOD);
536 * unmount command from Director
538 static int unmount_cmd(JCR *jcr)
541 BSOCK *dir = jcr->dir_bsock;
546 dname = (char *) get_memory(dir->msglen+1);
547 if (sscanf(dir->msg, "unmount %s", dname) == 1) {
548 unbash_spaces(dname);
551 while ((device=(DEVRES *)GetNextRes(R_DEVICE, (RES *)device))) {
552 /* Find resource, and make sure we were able to open it */
553 if (strcmp(device->hdr.name, dname) == 0 && device->dev) {
554 Dmsg1(20, "Found device %s\n", device->hdr.name);
561 jcr->device = device;
563 P(dev->mutex); /* Use P to avoid indefinite block */
564 if (!(dev->state & ST_OPENED)) {
565 Dmsg0(90, "Device already unmounted\n");
566 bnet_fsend(dir, _("3901 Device %s is already unmounted.\n"), dev_name(dev));
568 } else if (dev->dev_blocked == BST_WAITING_FOR_SYSOP) {
569 Dmsg2(90, "%d waiter dev_block=%d. doing unmount\n", dev->num_waiting,
571 if (dev_cap(dev, CAP_OFFLINEUNMOUNT)) {
574 force_close_dev(dev);
575 dev->dev_blocked = BST_UNMOUNTED_WAITING_FOR_SYSOP;
576 bnet_fsend(dir, _("3001 Device %s unmounted.\n"), dev_name(dev));
578 } else if (dev->dev_blocked == BST_DOING_ACQUIRE) {
579 bnet_fsend(dir, _("3902 Device %s is busy in acquire.\n"),
582 } else if (dev->dev_blocked == BST_WRITING_LABEL) {
583 bnet_fsend(dir, _("3903 Device %s is being labeled.\n"),
586 } else if (dev->state & ST_READ || dev->num_writers) {
587 if (dev->state & ST_READ) {
588 Dmsg0(90, "Device in read mode\n");
589 bnet_fsend(dir, _("3904 Device %s is busy with 1 reader.\n"),
592 Dmsg1(90, "Device busy with %d writers\n", dev->num_writers);
593 bnet_fsend(dir, _("3905 Device %s is busy with %d writer(s).\n"),
594 dev_name(dev), dev->num_writers);
597 } else { /* device not being used */
598 Dmsg0(90, "Device not in use, unmounting\n");
599 block_device(dev, BST_UNMOUNTED);
600 if (dev_cap(dev, CAP_OFFLINEUNMOUNT)) {
603 force_close_dev(dev);
604 bnet_fsend(dir, _("3002 Device %s unmounted.\n"), dev_name(dev));
608 bnet_fsend(dir, _("3999 Device %s not found\n"), dname);
611 /* NB dir->msg gets clobbered in bnet_fsend, so save command */
612 strcpy(dname, dir->msg);
613 bnet_fsend(dir, _("3907 Error scanning unmount command: %s\n"), dname);
616 bnet_sig(dir, BNET_EOD);
621 * Status command from Director
623 static int status_cmd(JCR *jcr)
627 int found, bps, sec, bpb;
628 BSOCK *user = jcr->dir_bsock;
629 char dt[MAX_TIME_LENGTH];
630 char b1[30], b2[30], b3[30];
632 bnet_fsend(user, "\n%s Version: " VERSION " (" BDATE ")\n", my_name);
633 bstrftime(dt, sizeof(dt), daemon_start_time);
634 bnet_fsend(user, _("Daemon started %s, %d Job%s run.\n"), dt, last_job.NumJobs,
635 last_job.NumJobs == 1 ? "" : "s");
636 if (last_job.NumJobs > 0) {
639 bstrftime(dt, sizeof(dt), last_job.end_time);
640 bnet_fsend(user, _("Last Job %s finished at %s\n"), last_job.Job, dt);
642 jobstatus_to_ascii(last_job.JobStatus, termstat, sizeof(termstat));
643 bnet_fsend(user, _(" Files=%s Bytes=%s Termination Status=%s\n"),
644 edit_uint64_with_commas(last_job.JobFiles, b1),
645 edit_uint64_with_commas(last_job.JobBytes, b2),
650 for (device=NULL; (device=(DEVRES *)GetNextRes(R_DEVICE, (RES *)device)); ) {
651 for (dev=device->dev; dev; dev=dev->next) {
652 if (dev->state & ST_OPENED) {
653 if (dev->state & ST_LABEL) {
654 bnet_fsend(user, _("Device %s is mounted with Volume %s\n"),
655 dev_name(dev), dev->VolHdr.VolName);
657 bnet_fsend(user, _("Device %s open but no Bacula volume is mounted.\n"), dev_name(dev));
659 send_blocked_status(jcr, dev);
660 bpb = dev->VolCatInfo.VolCatBlocks;
664 bpb = dev->VolCatInfo.VolCatBytes / bpb;
665 bnet_fsend(user, _(" Total Bytes=%s Blocks=%s Bytes/block=%s\n"),
666 edit_uint64_with_commas(dev->VolCatInfo.VolCatBytes, b1),
667 edit_uint64_with_commas(dev->VolCatInfo.VolCatBlocks, b2),
668 edit_uint64_with_commas(bpb, b3));
669 bnet_fsend(user, _(" Positioned at File=%s Block=%s\n"),
670 edit_uint64_with_commas(dev->file, b1),
671 edit_uint64_with_commas(dev->block_num, b2));
674 bnet_fsend(user, _("Device %s is not open.\n"), dev_name(dev));
675 send_blocked_status(jcr, dev);
683 /* NOTE, we reuse a calling argument jcr. Be warned! */
684 for (jcr=NULL; (jcr=get_next_jcr(jcr)); ) {
685 if (jcr->JobStatus == JS_WaitFD) {
686 bnet_fsend(user, _("%s Job %s waiting for Client connection.\n"),
687 job_type_to_str(jcr->JobType), jcr->Job);
690 bnet_fsend(user, _("%s %s job %s is using device %s volume %s\n"),
691 job_level_to_str(jcr->JobLevel),
692 job_type_to_str(jcr->JobType),
693 jcr->Job, jcr->device->device_name,
695 sec = time(NULL) - jcr->run_time;
699 bps = jcr->JobBytes / sec;
700 bnet_fsend(user, _(" Files=%s Bytes=%s Bytes/sec=%s\n"),
701 edit_uint64_with_commas(jcr->JobFiles, b1),
702 edit_uint64_with_commas(jcr->JobBytes, b2),
703 edit_uint64_with_commas(bps, b3));
706 if (jcr->file_bsock) {
707 bnet_fsend(user, " FDReadSeqNo=%" lld " fd=%d\n",
708 jcr->file_bsock->read_seqno, jcr->file_bsock->fd);
710 bnet_fsend(user, " FDSocket closed\n");
714 free_locked_jcr(jcr);
718 bnet_fsend(user, _("No jobs running.\n"));
722 bnet_fsend(user, "\n\n");
723 dump_resource(R_DEVICE, resources[R_DEVICE-r_first].res_head, sendit, user);
725 bnet_fsend(user, "====\n");
727 bnet_sig(user, BNET_EOD);
731 static void send_blocked_status(JCR *jcr, DEVICE *dev)
733 BSOCK *user = jcr->dir_bsock;
735 switch (dev->dev_blocked) {
737 bnet_fsend(user, _(" Device is BLOCKED. User unmounted.\n"));
739 case BST_UNMOUNTED_WAITING_FOR_SYSOP:
740 bnet_fsend(user, _(" Device is BLOCKED. User unmounted during wait for media/mount.\n"));
742 case BST_WAITING_FOR_SYSOP:
743 if (jcr->JobStatus == JS_WaitMount) {
744 bnet_fsend(user, _(" Device is BLOCKED waiting for mount.\n"));
746 bnet_fsend(user, _(" Device is BLOCKED waiting for appendable media.\n"));
749 case BST_DOING_ACQUIRE:
750 bnet_fsend(user, _(" Device is being initialized.\n"));
752 case BST_WRITING_LABEL:
753 bnet_fsend(user, _(" Device is blocked labeling a Volume.\n"));