2 * Copyright (c) 2011-2012 The DragonFly Project. All rights reserved.
4 * This code is derived from software contributed to The DragonFly Project
5 * by Matthew Dillon <dillon@dragonflybsd.org>
6 * by Venkatesh Srinivas <vsrinivas@dragonflybsd.org>
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in
16 * the documentation and/or other materials provided with the
18 * 3. Neither the name of The DragonFly Project nor the names of its
19 * contributors may be used to endorse or promote products derived
20 * from this software without specific, prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
25 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
26 * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
27 * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
28 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
29 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
30 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
31 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
32 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
40 static void shell_msghandler(dmsg_msg_t *msg, int unmanaged);
41 static void shell_ttymsg(dmsg_iocom_t *iocom);
43 /************************************************************************
45 ************************************************************************/
48 cmd_shell(const char *hostname)
50 dmsg_master_service_info_t *info;
54 fd = dmsg_connect(hostname);
58 info = malloc(sizeof(*info));
59 bzero(info, sizeof(*info));
62 info->usrmsg_callback = shell_msghandler;
63 info->altmsg_callback = shell_ttymsg;
64 info->label = strdup("debug");
65 pthread_create(&thread, NULL, dmsg_master_service, info);
66 pthread_join(thread, NULL);
73 cmd_shell(const char *hostname)
75 struct dmsg_iocom iocom;
80 * Connect to the target
82 fd = dmsg_connect(hostname);
87 * Initialize the session and transmit an empty DMSG_DBG_SHELL
88 * to cause the remote end to generate a prompt.
90 dmsg_iocom_init(&iocom, fd, 0,
95 fcntl(0, F_SETFL, O_NONBLOCK);
96 printf("debug: connected\n");
98 msg = dmsg_msg_alloc(&iocom.state0, 0, DMSG_DBG_SHELL, NULL, NULL);
100 dmsg_iocom_core(&iocom);
101 fprintf(stderr, "debug: disconnected\n");
108 * Debug session front-end
110 * Callback from dmsg_iocom_core() when messages might be present
115 shell_msghandler(dmsg_msg_t *msg, int unmanaged)
122 case DMSG_LNK_ERROR | DMSGF_REPLY:
124 * One-way non-transactional LNK_ERROR messages typically
125 * indicate a connection failure. Error code 0 is used by
126 * the debug shell to indicate no more results from last cmd.
128 if (msg->any.head.error) {
129 fprintf(stderr, "Stream failure: %s\n",
132 write(1, "debug> ", 7);
135 case DMSG_LNK_ERROR | DMSGF_DELETE:
136 /* ignore termination of LNK_CONN */
141 * We send the commands, not accept them.
142 * (one-way message, not transactional)
145 dmsg_msg_reply(msg, DMSG_ERR_NOSUPP);
147 case DMSG_DBG_SHELL | DMSGF_REPLY:
149 * A reply from the remote is data we copy to stdout.
150 * (one-way message, not transactional)
153 msg->aux_data[msg->aux_size - 1] = 0;
154 write(1, msg->aux_data, strlen(msg->aux_data));
158 case DMSG_LNK_CONN | DMSGF_CREATE:
159 fprintf(stderr, "Debug Shell received LNK_CONN\n");
160 nmsg = dmsg_msg_alloc(&msg->state->iocom->state0, 0,
163 dmsg_msg_write(nmsg);
164 dmsg_msg_reply(msg, DMSG_ERR_NOSUPP);
166 case DMSG_LNK_CONN | DMSGF_DELETE:
171 * Ignore any unknown messages, Terminate any unknown
172 * transactions with an error.
174 fprintf(stderr, "Unknown message: %s\n", dmsg_msg_str(msg));
176 if (msg->any.head.cmd & DMSGF_CREATE)
177 dmsg_msg_reply(msg, DMSG_ERR_NOSUPP);
178 if (msg->any.head.cmd & DMSGF_DELETE)
179 dmsg_msg_reply(msg, DMSG_ERR_NOSUPP);
186 * Debug session front-end
190 shell_ttymsg(dmsg_iocom_t *iocom)
192 dmsg_state_t *pstate;
198 if (fgets(buf, sizeof(buf), stdin) != NULL) {
200 pstate = dmsg_findspan(strtok(buf + 1, " \t\n"));
201 cmd = strtok(NULL, "\n");
203 pstate = &iocom->state0;
204 cmd = strtok(buf, "\n");
207 len = strlen(cmd) + 1;
208 msg = dmsg_msg_alloc(pstate, len, DMSG_DBG_SHELL,
210 bcopy(cmd, msg->aux_data, len);
213 fprintf(stderr, "@msgid not found\n");
216 * This should cause the remote end to generate
217 * a debug> prompt (and thus shows that there is
220 msg = dmsg_msg_alloc(pstate, 0, DMSG_DBG_SHELL,
224 } else if (feof(stdin)) {
226 * Set EOF flag without setting any error code for normal
229 iocom->flags |= DMSG_IOCOMF_EOF;
236 * Debug session back-end (on remote side)
238 static void shell_span(dmsg_msg_t *msg, char *cmdbuf);
239 static void shell_ping(dmsg_msg_t *msg, char *cmdbuf);
242 hammer2_shell_parse(dmsg_msg_t *msg, int unmanaged)
244 dmsg_iocom_t *iocom = msg->state->iocom;
250 * Filter on debug shell commands and ping responses only
252 cmd = msg->any.head.cmd;
253 if ((cmd & DMSGF_CMDSWMASK) == (DMSG_LNK_PING | DMSGF_REPLY)) {
254 dmsg_printf(iocom, "ping reply\n");
258 if ((cmd & DMSGF_PROTOS) != DMSG_PROTO_DBG) {
260 dmsg_msg_reply(msg, DMSG_ERR_NOSUPP);
263 if ((cmd & DMSGF_CMDSWMASK) != DMSG_DBG_SHELL) {
265 dmsg_msg_reply(msg, DMSG_ERR_NOSUPP);
270 * Debug shell command
272 cmdbuf = msg->aux_data;
273 cmdp = strsep(&cmdbuf, " \t");
275 if (cmdp == NULL || *cmdp == 0) {
277 } else if (strcmp(cmdp, "ping") == 0) {
278 shell_ping(msg, cmdbuf);
279 } else if (strcmp(cmdp, "span") == 0) {
280 shell_span(msg, cmdbuf);
281 } else if (strcmp(cmdp, "tree") == 0) {
282 dmsg_shell_tree(iocom, cmdbuf); /* dump spanning tree */
283 } else if (strcmp(cmdp, "help") == 0 || strcmp(cmdp, "?") == 0) {
284 dmsg_printf(iocom, "help Command help\n");
285 dmsg_printf(iocom, "span <host> Span to target host\n");
286 dmsg_printf(iocom, "tree Dump spanning tree\n");
287 dmsg_printf(iocom, "@span <cmd> Issue via circuit\n");
289 dmsg_printf(iocom, "Unrecognized command: %s\n", cmdp);
291 dmsg_printf(iocom, "debug> ");
295 shell_ping(dmsg_msg_t *msg, char *cmdbuf __unused)
297 dmsg_iocom_t *iocom = msg->state->iocom;
300 dmsg_printf(iocom, "sending ping\n");
301 m2 = dmsg_msg_alloc(msg->state, 0, DMSG_LNK_PING, NULL, NULL);
306 shell_span(dmsg_msg_t *msg, char *cmdbuf)
308 dmsg_iocom_t *iocom = msg->state->iocom;
309 dmsg_master_service_info_t *info;
310 const char *hostname = strsep(&cmdbuf, " \t");
315 * Connect to the target
317 if (hostname == NULL) {
320 fd = dmsg_connect(hostname);
324 * Start master service
327 dmsg_printf(iocom, "Connection to %s failed\n", hostname);
329 dmsg_printf(iocom, "Connected to %s\n", hostname);
331 info = malloc(sizeof(*info));
332 bzero(info, sizeof(*info));
335 info->usrmsg_callback = hammer2_shell_parse;
336 info->label = strdup("client");
338 pthread_create(&thread, NULL, dmsg_master_service, info);
339 /*pthread_join(thread, &res);*/
343 /************************************************************************
345 ************************************************************************
347 * Connect to the target manually (not via the cluster list embedded in
348 * a hammer2 filesystem) and initiate the SPAN protocol.
351 cmd_debugspan(const char *hostname)
358 * Connect to the target
360 fd = dmsg_connect(hostname);
364 printf("debugspan: connected to %s, starting CONN/SPAN\n", hostname);
365 pthread_create(&thread, NULL,
366 dmsg_master_service, (void *)(intptr_t)fd);
367 pthread_join(thread, &res);
371 /************************************************************************
373 ************************************************************************/
375 static void show_bref(int fd, int tab, int bi, hammer2_blockref_t *bref,
377 static void tabprintf(int tab, const char *ctl, ...);
380 cmd_show(const char *devpath, int dofreemap)
382 hammer2_blockref_t broot;
383 hammer2_blockref_t best;
384 hammer2_media_data_t media;
389 fd = open(devpath, O_RDONLY);
396 * Show the tree using the best volume header.
397 * -vvv will show the tree for all four volume headers.
400 bzero(&best, sizeof(best));
401 for (i = 0; i < 4; ++i) {
402 bzero(&broot, sizeof(broot));
403 broot.type = HAMMER2_BREF_TYPE_VOLUME;
404 broot.data_off = (i * HAMMER2_ZONE_BYTES64) |
406 lseek(fd, broot.data_off & ~HAMMER2_OFF_MASK_RADIX, 0);
407 if (read(fd, &media, HAMMER2_PBUFSIZE) ==
408 (ssize_t)HAMMER2_PBUFSIZE) {
409 broot.mirror_tid = media.voldata.mirror_tid;
410 if (best_i < 0 || best.mirror_tid < broot.mirror_tid) {
415 show_bref(fd, 0, i, &broot, dofreemap);
419 show_bref(fd, 0, best_i, &best, dofreemap);
425 extern uint32_t iscsi_crc32(const void *buf, size_t size);
427 show_bref(int fd, int tab, int bi, hammer2_blockref_t *bref, int dofreemap)
429 hammer2_media_data_t media;
430 hammer2_blockref_t *bscan;
437 const char *type_str;
443 case HAMMER2_BREF_TYPE_EMPTY:
446 case HAMMER2_BREF_TYPE_DIRENT:
449 case HAMMER2_BREF_TYPE_INODE:
452 case HAMMER2_BREF_TYPE_INDIRECT:
455 case HAMMER2_BREF_TYPE_DATA:
458 case HAMMER2_BREF_TYPE_VOLUME:
461 case HAMMER2_BREF_TYPE_FREEMAP:
462 type_str = "freemap";
464 case HAMMER2_BREF_TYPE_FREEMAP_NODE:
465 type_str = "fmapnode";
467 case HAMMER2_BREF_TYPE_FREEMAP_LEAF:
468 type_str = "fbitmap";
471 type_str = "unknown";
475 tabprintf(tab, "%s.%-3d %016jx %016jx/%-2d mir=%016jx mod=%016jx ",
476 type_str, bi, (intmax_t)bref->data_off,
477 (intmax_t)bref->key, (intmax_t)bref->keybits,
478 (intmax_t)bref->mirror_tid, (intmax_t)bref->modify_tid);
481 printf("flags=%02x ", bref->flags);
483 bytes = (bref->data_off & HAMMER2_OFF_MASK_RADIX);
485 bytes = (size_t)1 << bytes;
487 hammer2_off_t io_off;
488 hammer2_off_t io_base;
492 io_off = bref->data_off & ~HAMMER2_OFF_MASK_RADIX;
493 io_base = io_off & ~(hammer2_off_t)(HAMMER2_MINIOSIZE - 1);
495 boff = io_off - io_base;
497 io_bytes = HAMMER2_MINIOSIZE;
498 while (io_bytes + boff < bytes)
501 if (io_bytes > sizeof(media)) {
502 printf("(bad block size %zd)\n", bytes);
505 if (bref->type != HAMMER2_BREF_TYPE_DATA || VerboseOpt >= 1) {
506 lseek(fd, io_base, 0);
507 if (read(fd, &media, io_bytes) != (ssize_t)io_bytes) {
508 printf("(media read failed)\n");
512 bcopy((char *)&media + boff, &media, bytes);
522 * Check data integrity in verbose mode, otherwise we are just doing
523 * a quick meta-data scan. Meta-data integrity is always checked.
524 * (Also see the check above that ensures the media data is loaded,
525 * otherwise there's no data to check!).
527 * WARNING! bref->check state may be used for other things when
528 * bref has no data (bytes == 0).
531 (bref->type != HAMMER2_BREF_TYPE_DATA || VerboseOpt >= 1)) {
532 switch(HAMMER2_DEC_CHECK(bref->methods)) {
533 case HAMMER2_CHECK_NONE:
534 printf("(meth %02x) ", bref->methods);
536 case HAMMER2_CHECK_DISABLED:
537 printf("(meth %02x) ", bref->methods);
539 case HAMMER2_CHECK_ISCSI32:
540 cv = hammer2_icrc32(&media, bytes);
541 if (bref->check.iscsi32.value != cv) {
542 printf("(icrc %02x:%08x/%08x failed) ",
544 bref->check.iscsi32.value,
547 printf("(meth %02x, iscsi32=%08x) ",
551 case HAMMER2_CHECK_XXHASH64:
552 cv64 = XXH64(&media, bytes, XXH_HAMMER2_SEED);
553 if (bref->check.xxhash64.value != cv64) {
554 printf("(xxhash64 %02x:%016jx/%016jx failed) ",
556 bref->check.xxhash64.value,
559 printf("(meth %02x, xxh=%016jx) ",
560 bref->methods, cv64);
563 case HAMMER2_CHECK_SHA192:
564 printf("(meth %02x) ", bref->methods);
566 case HAMMER2_CHECK_FREEMAP:
567 cv = hammer2_icrc32(&media, bytes);
568 if (bref->check.freemap.icrc32 != cv) {
569 printf("(fcrc %02x:%08x/%08x failed) ",
571 bref->check.freemap.icrc32,
574 printf("(meth %02x, fcrc=%08x) ",
582 case HAMMER2_BREF_TYPE_EMPTY:
585 case HAMMER2_BREF_TYPE_DIRENT:
587 if (bref->embed.dirent.namlen <= sizeof(bref->check.buf)) {
588 tabprintf(tab, "filename \"%*.*s\"\n",
589 bref->embed.dirent.namlen,
590 bref->embed.dirent.namlen,
593 tabprintf(tab, "filename \"%*.*s\"\n",
594 bref->embed.dirent.namlen,
595 bref->embed.dirent.namlen,
598 tabprintf(tab, "inum 0x%016jx\n",
599 (uintmax_t)bref->embed.dirent.inum);
600 tabprintf(tab, "type %s\n",
601 hammer2_iptype_to_str(bref->embed.dirent.type));
603 case HAMMER2_BREF_TYPE_INODE:
605 if (media.ipdata.meta.op_flags & HAMMER2_OPFLAG_DIRECTDATA) {
608 bscan = &media.ipdata.u.blockset.blockref[0];
609 bcount = HAMMER2_SET_COUNT;
611 namelen = media.ipdata.meta.name_len;
612 if (namelen > HAMMER2_INODE_MAXNAME)
614 tabprintf(tab, "filename \"%*.*s\"\n",
615 namelen, namelen, media.ipdata.filename);
616 tabprintf(tab, "version %d\n", media.ipdata.meta.version);
617 tabprintf(tab, "uflags 0x%08x\n",
618 media.ipdata.meta.uflags);
619 if (media.ipdata.meta.rmajor || media.ipdata.meta.rminor) {
620 tabprintf(tab, "rmajor %d\n",
621 media.ipdata.meta.rmajor);
622 tabprintf(tab, "rminor %d\n",
623 media.ipdata.meta.rminor);
625 tabprintf(tab, "ctime %s\n",
626 hammer2_time64_to_str(media.ipdata.meta.ctime, &str));
627 tabprintf(tab, "mtime %s\n",
628 hammer2_time64_to_str(media.ipdata.meta.mtime, &str));
629 tabprintf(tab, "atime %s\n",
630 hammer2_time64_to_str(media.ipdata.meta.atime, &str));
631 tabprintf(tab, "btime %s\n",
632 hammer2_time64_to_str(media.ipdata.meta.btime, &str));
633 tabprintf(tab, "uid %s\n",
634 hammer2_uuid_to_str(&media.ipdata.meta.uid, &str));
635 tabprintf(tab, "gid %s\n",
636 hammer2_uuid_to_str(&media.ipdata.meta.gid, &str));
637 tabprintf(tab, "type %s\n",
638 hammer2_iptype_to_str(media.ipdata.meta.type));
639 tabprintf(tab, "opflgs 0x%02x\n",
640 media.ipdata.meta.op_flags);
641 tabprintf(tab, "capflgs 0x%04x\n",
642 media.ipdata.meta.cap_flags);
643 tabprintf(tab, "mode %-7o\n",
644 media.ipdata.meta.mode);
645 tabprintf(tab, "inum 0x%016jx\n",
646 media.ipdata.meta.inum);
647 tabprintf(tab, "size %ju\n",
648 (uintmax_t)media.ipdata.meta.size);
649 tabprintf(tab, "nlinks %ju\n",
650 (uintmax_t)media.ipdata.meta.nlinks);
651 tabprintf(tab, "iparent 0x%016jx\n",
652 (uintmax_t)media.ipdata.meta.iparent);
653 tabprintf(tab, "name_key 0x%016jx\n",
654 (uintmax_t)media.ipdata.meta.name_key);
655 tabprintf(tab, "name_len %u\n",
656 media.ipdata.meta.name_len);
657 tabprintf(tab, "ncopies %u\n",
658 media.ipdata.meta.ncopies);
659 tabprintf(tab, "compalg %u\n",
660 media.ipdata.meta.comp_algo);
661 tabprintf(tab, "checkalg %u\n",
662 media.ipdata.meta.check_algo);
663 if ((media.ipdata.meta.op_flags & HAMMER2_OPFLAG_PFSROOT) ||
664 media.ipdata.meta.pfs_type == HAMMER2_PFSTYPE_SUPROOT) {
665 tabprintf(tab, "pfs_type %u (%s)\n",
666 media.ipdata.meta.pfs_type,
667 hammer2_pfstype_to_str(media.ipdata.meta.pfs_type));
668 tabprintf(tab, "pfs_inum 0x%016jx\n",
669 (uintmax_t)media.ipdata.meta.pfs_inum);
670 tabprintf(tab, "pfs_clid %s\n",
671 hammer2_uuid_to_str(&media.ipdata.meta.pfs_clid,
673 tabprintf(tab, "pfs_fsid %s\n",
674 hammer2_uuid_to_str(&media.ipdata.meta.pfs_fsid,
676 tabprintf(tab, "pfs_lsnap_tid 0x%016jx\n",
677 (uintmax_t)media.ipdata.meta.pfs_lsnap_tid);
679 tabprintf(tab, "data_quota %ju\n",
680 (uintmax_t)media.ipdata.meta.data_quota);
681 tabprintf(tab, "data_count %ju\n",
682 (uintmax_t)bref->embed.stats.data_count);
683 tabprintf(tab, "inode_quota %ju\n",
684 (uintmax_t)media.ipdata.meta.inode_quota);
685 tabprintf(tab, "inode_count %ju\n",
686 (uintmax_t)bref->embed.stats.inode_count);
688 case HAMMER2_BREF_TYPE_INDIRECT:
689 bscan = &media.npdata[0];
690 bcount = bytes / sizeof(hammer2_blockref_t);
694 case HAMMER2_BREF_TYPE_DATA:
696 if (VerboseOpt >= 2) {
705 case HAMMER2_BREF_TYPE_VOLUME:
706 printf("mirror_tid=%016jx freemap_tid=%016jx ",
707 media.voldata.mirror_tid,
708 media.voldata.freemap_tid);
710 bscan = &media.voldata.freemap_blockset.blockref[0];
711 bcount = HAMMER2_SET_COUNT;
713 bscan = &media.voldata.sroot_blockset.blockref[0];
714 bcount = HAMMER2_SET_COUNT;
718 case HAMMER2_BREF_TYPE_FREEMAP_LEAF:
720 for (i = 0; i < HAMMER2_FREEMAP_COUNT; ++i) {
722 if (media.bmdata[i].class == 0 &&
723 media.bmdata[i].avail == 0) {
727 #if HAMMER2_BMAP_ELEMENTS != 8
728 #error "cmd_debug.c: HAMMER2_BMAP_ELEMENTS expected to be 8"
731 tabprintf(tab + 4, "%016jx %04d.%04x (avail=%7d) "
732 "%016jx %016jx %016jx %016jx "
733 "%016jx %016jx %016jx %016jx\n",
735 i * 256 * HAMMER2_FREEMAP_BLOCK_SIZE,
736 i, media.bmdata[i].class,
737 media.bmdata[i].avail,
738 media.bmdata[i].bitmapq[0],
739 media.bmdata[i].bitmapq[1],
740 media.bmdata[i].bitmapq[2],
741 media.bmdata[i].bitmapq[3],
742 media.bmdata[i].bitmapq[4],
743 media.bmdata[i].bitmapq[5],
744 media.bmdata[i].bitmapq[6],
745 media.bmdata[i].bitmapq[7]);
747 tabprintf(tab, "}\n");
749 case HAMMER2_BREF_TYPE_FREEMAP_NODE:
751 bscan = &media.npdata[0];
752 bcount = bytes / sizeof(hammer2_blockref_t);
761 for (i = 0; i < bcount; ++i) {
762 if (bscan[i].type != HAMMER2_BREF_TYPE_EMPTY) {
767 show_bref(fd, tab, i, &bscan[i], dofreemap);
772 if (bref->type == HAMMER2_BREF_TYPE_INODE)
773 tabprintf(tab, "} (%s.%d, \"%*.*s\")\n",
775 namelen, namelen, media.ipdata.filename);
777 tabprintf(tab, "} (%s.%d)\n", type_str,bi);
782 cmd_hash(int ac, const char **av)
786 for (i = 0; i < ac; ++i) {
787 printf("%016jx %s\n", dirhash(av[i], strlen(av[i])), av[i]);
793 cmd_chaindump(const char *path)
798 fd = open(path, O_RDONLY);
800 ioctl(fd, HAMMER2IOC_DEBUG_DUMP, &dummy);
803 fprintf(stderr, "unable to open %s\n", path);
811 tabprintf(int tab, const char *ctl, ...)
815 printf("%*.*s", tab, tab, "");