| blob | 5542c8aec173e9f85436ed88a66209b67f373b50 |
1 '\" te
2 .\" Copyright (c) 1999 Sun Microsystems, Inc. All Rights Reserved.
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH FSDB_UDFS 1M "Jun 11, 1999"
7 .SH NAME
8 fsdb_udfs \- udfs file system debugger
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fBfsdb \fR [\fB-F\fR] udfs [\fIgeneric_option\fR] [\fB-o \fR\fIspecific_option\fR] \fIspecial\fR
13 .fi
15 .SH DESCRIPTION
16 .sp
17 .LP
18 The \fBfsdb_udfs\fR command is an interactive tool that can be used to patch up
19 a damaged \fBudfs\fR file system. \fBfsdb_udfs\fR has conversions to translate
20 block and i-numbers into their corresponding disk addresses. Mnemonic offsets
21 to access different parts of an inode are also included. Mnemonic offsets
22 greatly simplify the process of correcting control block entries or descending
23 the file system tree.
24 .sp
25 .LP
26 \fBfsdb\fR contains several error-checking routines to verify inode and block
27 addresses. These can be disabled if necessary by invoking \fBfsdb\fR with the
28 \fB-o\fR option or by using the \fBo\fR command.
29 .sp
30 .LP
31 \fBfsdb\fR reads one block at a time, and therefore works with raw as well as
32 block \fBI/O\fR devices. A buffer management routine is used to retain commonly
33 used blocks of data in order to reduce the number of read system calls. All
34 assignment operations result in an immediate write-through of the corresponding
35 block. In order to modify any portion of the disk, \fBfsdb\fR must be invoked
36 with the \fB-w\fR option.
37 .sp
38 .LP
39 Wherever possible, \fBadb\fR-like syntax has been adopted to promote the use of
40 \fBfsdb\fR through familiarity.
41 .SH OPTIONS
42 .sp
43 .LP
44 The following options are supported:
45 .sp
46 .ne 2
47 .na
48 \fB\fB-o\fR \fIspecific_option\fR\fR
49 .ad
50 .RS 22n
51 Specify \fBudfs\fR file system specific options in a comma-separated list with
52 no intervening spaces. The following specific options are supported:
53 .sp
54 .ne 2
55 .na
56 \fBo\fR
57 .ad
58 .RS 12n
59 Override some error conditions.
60 .RE
62 .sp
63 .ne 2
64 .na
65 \fBp=\fIstring\fR\fR
66 .ad
67 .RS 12n
68 Set prompt to \fIstring\fR.
69 .RE
71 .sp
72 .ne 2
73 .na
74 \fBw\fR
75 .ad
76 .RS 12n
77 Open for write.
78 .RE
80 .sp
81 .ne 2
82 .na
83 \fB?\fR
84 .ad
85 .RS 12n
86 Display usage.
87 .RE
89 .RE
91 .SH USAGE
92 .sp
93 .LP
94 Numbers are considered hexadecimal by default. The user has control over how
95 data is to be displayed or accepted. The \fBbase\fR command displays or sets
96 the input and output base. Once set, all input defaults to this base and all
97 output displays in this base. The base can be overriden temporarily for input
98 by preceding hexadecimal numbers by \fB0x\fR, preceding decimal numbers with a
99 \fB0t\fR, or octal numbers with a \fB0\fR. Hexadecimal numbers beginning with
100 \fBa\fR-\fBf\fR or \fBA\fR -\fBF\fR must be preceded with a \fB0x\fR to
101 distinguish them from commands.
102 .sp
103 .LP
104 Disk addressing by \fBfsdb\fR is at the byte level. However, \fBfsdb\fR offers
105 many commands to convert a desired inode, directory entry, block, and so forth,
106 to a byte address. After the address has been calculated, \fBfsdb\fR records
107 the result in the current address (\fBdot\fR).
108 .sp
109 .LP
110 Several global values are maintained by \fBfsdb\fR\fB\fR:
111 .RS +4
112 .TP
113 .ie t \(bu
114 .el o
115 Current base (referred to as \fBbase\fR)
116 .RE
117 .RS +4
118 .TP
119 .ie t \(bu
120 .el o
121 Current address (referred to as \fBdot\fR)
122 .RE
123 .RS +4
124 .TP
125 .ie t \(bu
126 .el o
127 Current inode (referred to as \fBinode\fR)
128 .RE
129 .RS +4
130 .TP
131 .ie t \(bu
132 .el o
133 Current count (referred to as \fBcount\fR)
134 .RE
135 .RS +4
136 .TP
137 .ie t \(bu
138 .el o
139 Current type (referred to as \fBtype\fR)
140 .RE
141 .sp
142 .LP
143 Most commands use the preset value of \fBdot\fR in their execution. For
144 example,
145 .sp
146 .in +2
147 .nf
148 > 2:inode
149 .fi
150 .in -2
151 .sp
153 .sp
154 .LP
155 first sets the value of dot (\fB\&.\fR) to \fB2\fR, colon (\fB:\fR), signifies
156 the start of a command, and the \fBinode\fR command sets \fBinode\fR to
157 \fB2\fR. A count is specified after a comma (\fB,\fR). Once set, count remains
158 at this value until a new command is encountered that resets the value back to
159 \fB1\fR (the default).
160 .sp
161 .LP
162 So, if
163 .sp
164 .in +2
165 .nf
166 > 2000,400/X
167 .fi
168 .in -2
169 .sp
171 .sp
172 .LP
173 is entered, \fB400\fR hex longs are listed from \fB2000\fR, and when completed,
174 the value of dot is \fB 2000 + 400 * sizeof\fR (long). If a RETURN is then
175 entered, the output routine uses the current values of \fBdot\fR, \fBcount\fR,
176 and \fBtype\fR and displays \fB400 \fRmore hex longs. An asterisk (\fB*\fR)
177 causes the entire block to be displayed. An example showing several commands
178 and the use of RETURN would be:
179 .sp
180 .in +2
181 .nf
182 > 2:ino; 0:dir?d
183 .fi
184 .in -2
185 .sp
187 .sp
188 .LP
189 or
190 .sp
191 .in +2
192 .nf
193 > 2:ino; 0:db:block?d
194 .fi
195 .in -2
196 .sp
198 .sp
199 .LP
200 The two examples are synonymous for getting to the first directory entry of the
201 root of the file system. Once there, subsequently entering a RETURN, plus
202 (\fB+\fR), or minus (\fB-\fR) advances to subsequent entries. Notice that
203 .sp
204 .in +2
205 .nf
206 > 2:inode; :ls
207 .fi
208 .in -2
209 .sp
211 .sp
212 .LP
213 or
214 .sp
215 .in +2
216 .nf
217 > :ls /
218 .fi
219 .in -2
220 .sp
222 .sp
223 .LP
224 is again synonymous.
225 .SS "Expressions"
226 .sp
227 .LP
228 The following symbols are recognized by \fBfsdb\fR:
229 .sp
230 .ne 2
231 .na
232 \fBRETURN\fR
233 .ad
234 .RS 13n
235 Update the value of dot by the current value of \fItype\fR and \fIdisplay\fR
236 using the current value of \fIcount\fR.
237 .RE
239 .sp
240 .ne 2
241 .na
242 \fB\fI#\fR\fR
243 .ad
244 .RS 13n
245 Update the value of dot by specifying a numeric expression. Specify numeric
246 expressions using addition, subtraction, mulitiplication, and division
247 operators ( \fB+\fR, \fB-\fR, \fB*\fR, and \fB%\fR). Numeric expressions are
248 evaluated from left to right and can use parentheses. After evaluation, the
249 value of dot is updated.
250 .RE
252 .sp
253 .ne 2
254 .na
255 \fB, \fIcount\fR\fR
256 .ad
257 .RS 13n
258 Update the count indicator. The global value of \fIcount\fR is updated to
259 \fIcount\fR. The value of \fIcount\fR remains until a new command is run. A
260 \fIcount\fR specifier of \fB*\fR attempts to show a blocks's worth of
261 information. The default for \fIcount\fR is \fB1\fR.
262 .RE
264 .sp
265 .ne 2
266 .na
267 \fB? \fI f\fR\fR
268 .ad
269 .RS 13n
270 Display in structured style with format specifier \fBf\fR. See \fBFormatted
271 Output\fR.
272 .RE
274 .sp
275 .ne 2
276 .na
277 \fB/ \fIf\fR\fR
278 .ad
279 .RS 13n
280 Display in unstructured style with format specifier \fBf\fR. See \fBFormatted
281 Output\fR.
282 .RE
284 .sp
285 .ne 2
286 .na
287 \fB\&.\fR
288 .ad
289 .RS 13n
290 Display the value of dot.
291 .RE
293 .sp
294 .ne 2
295 .na
296 \fB+\fIe\fR\fR
297 .ad
298 .RS 13n
299 Increment the value of dot by the expression \fIe\fR. The amount actually
300 incremented is dependent on the size of type: \fBdot = dot + \fR\fIe \fR\fB*
301 \fR\fBsizeof\fR (\fItype\fR) The default for \fIe\fR is \fB1\fR.
302 .RE
304 .sp
305 .ne 2
306 .na
307 \fB\(mi\fIe\fR\fR
308 .ad
309 .RS 13n
310 Decrement the value of dot by the expression \fIe \fR. See \fB+\fR.
311 .RE
313 .sp
314 .ne 2
315 .na
316 \fB*\fIe\fR\fR
317 .ad
318 .RS 13n
319 Multiply the value of dot by the expression \fIe\fR. Multiplication and
320 division don't use \fItype\fR. In the above calculation of dot, consider the
321 \fBsizeof\fR (\fItype\fR) to be \fB1\fR.
322 .RE
324 .sp
325 .ne 2
326 .na
327 \fB%\fIe\fR\fR
328 .ad
329 .RS 13n
330 Divide the value of dot by the expression \fIe\fR. See \fB*\fR.
331 .RE
333 .sp
334 .ne 2
335 .na
336 \fB< \fIname\fR\fR
337 .ad
338 .RS 13n
339 Restore an address saved in register \fIname\fR. \fIname\fR must be a single
340 letter or digit.
341 .RE
343 .sp
344 .ne 2
345 .na
346 \fB> \fIname\fR\fR
347 .ad
348 .RS 13n
349 Save an address in register \fIname\fR. \fIname\fR must be a single letter or
350 digit.
351 .RE
353 .sp
354 .ne 2
355 .na
356 \fB= \fIf\fR\fR
357 .ad
358 .RS 13n
359 Display indicator. If \fIf\fR is a legitimate format specifier (see
360 \fBFormatted Output\fR), then the value of dot is displayed using format
361 specifier \fIf\fR. Otherwise, assignment is assumed. See \fB= [s] [e]\fR.
362 .RE
364 .sp
365 .ne 2
366 .na
367 \fB= [\fIs\fR] [\fIe\fR]\fR
368 .ad
369 .RS 13n
370 Change the value of dot using an assignment indicator. The address pointed to
371 by dot has its contents changed to the value of the expression \fIe\fR or to
372 the \fBASCII\fR representation of the quoted (\fB"\fR) string \fIs\fR. This can
373 be useful for changing directory names or \fBASCII\fR file information.
374 .RE
376 .sp
377 .ne 2
378 .na
379 \fB=+ \fIe\fR\fR
380 .ad
381 .RS 13n
382 Change the value of dot using an incremental assignment. The address pointed to
383 by dot has its contents incremented by expression \fIe\fR.
384 .RE
386 .sp
387 .ne 2
388 .na
389 \fB=- e\fR
390 .ad
391 .RS 13n
392 Change the value of dot using a decremental assignment. Decrement the contents
393 of the address pointed to by dot by expression \fIe\fR.
394 .RE
396 .SS "Commands"
397 .sp
398 .LP
399 A command must be prefixed by a colon (\fB:\fR). Only enough letters of the
400 command to uniquely distinguish it are needed. Multiple commands can be entered
401 on one line by separating them by a SPACE, TAB, or semicolon (\fB;\fR).
402 .sp
403 .LP
404 To view a potentially unmounted disk in a reasonable manner, \fBfsdb\fR
405 supports the \fBcd\fR, \fBpwd\fR, \fBls\fR, and \fBfind\fR commands. The
406 functionality of each of these commands basically matches that of its UNIX
407 counterpart. See \fBcd\fR(1), \fBpwd\fR(1),\fBls\fR(1), and\fBfind\fR(1) for
408 details. The \fB*\fR, \fB,\fR, \fB?\fR, and \fB-\fR wildcard characters are
409 also supported.
410 .sp
411 .LP
412 The following commands are supported:
413 .sp
414 .ne 2
415 .na
416 \fBbase[=\fIb\fR]\fR
417 .ad
418 .sp .6
419 .RS 4n
420 Display or set the base. All input and output is governed by the current base.
421 Without the \fB=\fR \fIb\fR, displays the current base. Otherwise, sets the
422 current base to \fIb\fR. Base is interpreted using the old value of base, so to
423 ensure correctness use the \fB0\fR, \fB0t\fR, or \fB0x\fR prefix when changing
424 the base. The default for base is hexadecimal.
425 .RE
427 .sp
428 .ne 2
429 .na
430 \fBblock\fR
431 .ad
432 .sp .6
433 .RS 4n
434 Convert the value of dot to a block address.
435 .RE
437 .sp
438 .ne 2
439 .na
440 \fBcd [\fIdir\fR]\fR
441 .ad
442 .sp .6
443 .RS 4n
444 Change the current directory to directory \fIdir\fR. The current values of
445 inode and dot are also updated. If \fBdir\fR is not specified, changes
446 directories to inode 2, root (\fB/\fR).
447 .RE
449 .sp
450 .ne 2
451 .na
452 \fBdirectory\fR
453 .ad
454 .sp .6
455 .RS 4n
456 If the current inode is a directory, converts the value of dot to a directory
457 slot offset in that directory, and dot now points to this entry.
458 .RE
460 .sp
461 .ne 2
462 .na
463 \fBfile\fR
464 .ad
465 .sp .6
466 .RS 4n
467 Set the value of dot as a relative block count from the beginning of the file.
468 The value of dot is updated to the first byte of this block.
469 .RE
471 .sp
472 .ne 2
473 .na
474 \fBfind \fIdir\fR [\fB-name\fR \fIn\fR] | [\fB-inum\fR\fI i\fR]\fR
475 .ad
476 .sp .6
477 .RS 4n
478 Find files by name or i-number. Recursively searches directory \fIdir\fR and
479 below for file names whose i-number matches\fB i\fR or whose name matches
480 pattern \fIn\fR. Only one of the two options (\fB-name\fR or \fB-inum\fR) can
481 be used at one time. The find \fB-print\fR is not necessary or accepted.
482 .RE
484 .sp
485 .ne 2
486 .na
487 \fBfill=\fIp\fR\fR
488 .ad
489 .sp .6
490 .RS 4n
491 Fill an area of disk with pattern \fIp\fR. The area of disk is delimited by dot
492 and count.
493 .RE
495 .sp
496 .ne 2
497 .na
498 \fBinode\fR
499 .ad
500 .sp .6
501 .RS 4n
502 Convert the value of dot to an inode address. If successful, the current value
503 of inode is updated as well as the value of dot. As a convenient shorthand, if
504 \fB:inode\fR appears at the beginning of the line, the value of dot is set to
505 the current inode and that inode is displayed in inode format.
506 .RE
508 .sp
509 .ne 2
510 .na
511 \fBls [ \fB-R\fR ] [\fB-l\fR ] \fIpat1\fR \fIpat2\fR...\fR
512 .ad
513 .sp .6
514 .RS 4n
515 List directories or files. If no file is specified, the current directory is
516 assumed. Either or both of the options can be used (but, if used, must be
517 specified before the filename specifiers). Wild card characters are available
518 and multiple arguments are acceptable. The long listing shows only the i-number
519 and the name; use the inode command with \fB?i\fR to get more information.
520 .RE
522 .sp
523 .ne 2
524 .na
525 \fBoverride\fR
526 .ad
527 .sp .6
528 .RS 4n
529 Toggle the value of override. Some error conditions might be overridden if
530 override is toggled to \fBon\fR.
531 .RE
533 .sp
534 .ne 2
535 .na
536 \fBprompt "\fIp\fR"\fR
537 .ad
538 .sp .6
539 .RS 4n
540 Change the \fBfsdb\fR prompt to \fIp\fR. \fIp\fR must be enclosed in quotes.
541 .RE
543 .sp
544 .ne 2
545 .na
546 \fBpwd\fR
547 .ad
548 .sp .6
549 .RS 4n
550 Display the current working directory.
551 .RE
553 .sp
554 .ne 2
555 .na
556 \fBquit\fR
557 .ad
558 .sp .6
559 .RS 4n
560 Quit \fBfsdb\fR.
561 .RE
563 .sp
564 .ne 2
565 .na
566 \fBtag\fR
567 .ad
568 .sp .6
569 .RS 4n
570 Convert the value of dot and if this is a valid tag, print the volume structure
571 according to the tag.
572 .RE
574 .sp
575 .ne 2
576 .na
577 \fB!\fR
578 .ad
579 .sp .6
580 .RS 4n
581 Escape to the shell.
582 .RE
584 .SS "Inode Commands"
585 .sp
586 .LP
587 In addition to the above commands, several other commands deal with inode
588 fields and operate directly on the current inode (they still require the colon
589 (\fB:\fR). They can be used to more easily display or change the particular
590 fields. The value of dot is only used by the \fB:db\fR and \fB:ib\fR commands.
591 Upon completion of the command, the value of dot is changed so that it points
592 to that particular field. For example,
593 .sp
594 .in +2
595 .nf
596 > :ln=+1
597 .fi
598 .in -2
599 .sp
601 .sp
602 .LP
603 increments the link count of the current inode and sets the value of dot to the
604 address of the link count field.
605 .sp
606 .LP
607 The following inode commands are supported:
608 .sp
609 .ne 2
610 .na
611 \fBat\fR
612 .ad
613 .RS 8n
614 Access time
615 .RE
617 .sp
618 .ne 2
619 .na
620 \fBbs\fR
621 .ad
622 .RS 8n
623 Block size
624 .RE
626 .sp
627 .ne 2
628 .na
629 \fBct\fR
630 .ad
631 .RS 8n
632 Creation time
633 .RE
635 .sp
636 .ne 2
637 .na
638 \fBgid\fR
639 .ad
640 .RS 8n
641 Group id
642 .RE
644 .sp
645 .ne 2
646 .na
647 \fBln\fR
648 .ad
649 .RS 8n
650 Link number
651 .RE
653 .sp
654 .ne 2
655 .na
656 \fBmt\fR
657 .ad
658 .RS 8n
659 Modification time
660 .RE
662 .sp
663 .ne 2
664 .na
665 \fBmd\fR
666 .ad
667 .RS 8n
668 Mode
669 .RE
671 .sp
672 .ne 2
673 .na
674 \fBmaj\fR
675 .ad
676 .RS 8n
677 Major device number
678 .RE
680 .sp
681 .ne 2
682 .na
683 \fBmin\fR
684 .ad
685 .RS 8n
686 Minor device number
687 .RE
689 .sp
690 .ne 2
691 .na
692 \fBnm\fR
693 .ad
694 .RS 8n
695 This command actually operates on the directory name field. Once poised at
696 the desired directory entry (using the \fBdirectory\fR command), this command
697 allows you to change or display the directory name. For example,
698 .sp
699 .in +2
700 .nf
701 > 7:dir:nm="foo"
702 .fi
703 .in -2
704 .sp
706 gets the \fB7\fRth directory entry of the current inode and changes its name to
707 \fBfoo\fR. Directory names cannot be made larger than the field allows. If an
708 attempt is made to make a directory name larger than the field allows,, the
709 string is truncated to fit and a warning message is displayed.
710 .RE
712 .sp
713 .ne 2
714 .na
715 \fBsz\fR
716 .ad
717 .RS 8n
718 File size
719 .RE
721 .sp
722 .ne 2
723 .na
724 \fBuid\fR
725 .ad
726 .RS 8n
727 User \fBID\fR
728 .RE
730 .sp
731 .ne 2
732 .na
733 \fBuniq\fR
734 .ad
735 .RS 8n
736 Unique \fBID\fR
737 .RE
739 .SS "Formatted Output"
740 .sp
741 .LP
742 Formatted output comes in two styles and many format types. The two styles of
743 formatted output are: structured and unstructured. Structured output is used to
744 display inodes, directories, and so forth. Unstructured output displays raw
745 data.
746 .sp
747 .LP
748 Format specifiers are preceded by the slash (\fB/\fR) or question mark
749 (\fB?\fR) character. \fItype\fR is updated as necessary upon completion.
750 .sp
751 .LP
752 The following format specifiers are preceded by the \fB?\fR character:
753 .sp
754 .ne 2
755 .na
756 \fBi\fR
757 .ad
758 .RS 5n
759 Display as inodes in the current base.
760 .RE
762 .sp
763 .ne 2
764 .na
765 \fBd\fR
766 .ad
767 .RS 5n
768 Display as directories in the current base.
769 .RE
771 .sp
772 .LP
773 The following format specifiers are preceded by the \fB/\fR character:
774 .sp
775 .ne 2
776 .na
777 \fBb\fR
778 .ad
779 .RS 9n
780 Display as bytes in the current base.
781 .RE
783 .sp
784 .ne 2
785 .na
786 \fBc\fR
787 .ad
788 .RS 9n
789 Display as characters.
790 .RE
792 .sp
793 .ne 2
794 .na
795 \fBo | O\fR
796 .ad
797 .RS 9n
798 Display as octal shorts or longs.
799 .RE
801 .sp
802 .ne 2
803 .na
804 \fBd | D\fR
805 .ad
806 .RS 9n
807 Display as decimal shorts or longs.
808 .RE
810 .sp
811 .ne 2
812 .na
813 \fBx | X\fR
814 .ad
815 .RS 9n
816 Display as hexadecimal shorts or longs.
817 .RE
819 .SH EXAMPLES
820 .LP
821 \fBExample 1 \fRUsing fsdb as a calculator for complex arithmetic
822 .sp
823 .LP
824 The following command displays \fB2010\fR in decimal format, and is an example
825 of using \fBfsdb\fR as a calculator for complex arithmetic.
827 .sp
828 .in +2
829 .nf
830 > 2000+400%(20+20)=D
831 .fi
832 .in -2
833 .sp
835 .LP
836 \fBExample 2 \fRUsing fsdb to display an i-number in idode fomat
837 .sp
838 .LP
839 The following command displays the i-number \fB386\fR in inode format.\fB386\fR
840 becomes the current inode.
842 .sp
843 .in +2
844 .nf
845 > 386:ino?i
846 .fi
847 .in -2
848 .sp
850 .LP
851 \fBExample 3 \fRUsing fsdb to change the link count
852 .sp
853 .LP
854 The following command changes the link count for the current inode to \fB4\fR.
856 .sp
857 .in +2
858 .nf
859 > :ln=4
860 .fi
861 .in -2
862 .sp
864 .LP
865 \fBExample 4 \fRUsing fsdb to increment the link count
866 .sp
867 .LP
868 The following command increments the link count by \fB1\fR.
870 .sp
871 .in +2
872 .nf
873 > :ln=+1
874 .fi
875 .in -2
876 .sp
878 .LP
879 \fBExample 5 \fRUsing fsdb to display the creation time as a hexadecimal long
880 .sp
881 .LP
882 The following command displays the creation time as a hexadecimal long.
884 .sp
885 .in +2
886 .nf
887 > :ct=X
888 .fi
889 .in -2
890 .sp
892 .LP
893 \fBExample 6 \fRUsing fsdb to display the modification time in time format
894 .sp
895 .LP
896 The following command displays the modification time in time format.
898 .sp
899 .in +2
900 .nf
901 > :mt=t
902 .fi
903 .in -2
904 .sp
906 .LP
907 \fBExample 7 \fRUsing fsdb to display in ASCII
908 .sp
909 .LP
910 The following command displays, in \fBASCII\fR, block \fB0\fR of the file
911 associated with the current inode.
913 .sp
914 .in +2
915 .nf
916 > 0:file/c
917 .fi
918 .in -2
919 .sp
921 .LP
922 \fBExample 8 \fRUsing fsdb to display the directory enteries for the root inode
923 .sp
924 .LP
925 The following command displays the first block's directory entries for the root
926 inode of this file system. This command stops prematurely if the \fBEOF\fR is
927 reached.
929 .sp
930 .in +2
931 .nf
932 > 2:ino,*?d
933 .fi
934 .in -2
935 .sp
937 .LP
938 \fBExample 9 \fRUsing fsdb to change the current inode
939 .sp
940 .LP
941 The following command changes the current inode to that associated with the
942 \fB5\fRth directory entry (numbered from \fB0\fR) of the current inode. The
943 first logical block of the file is then displayed in \fBASCII\fR.
945 .sp
946 .in +2
947 .nf
948 > 5:dir:inode; 0:file,*/c
949 .fi
950 .in -2
951 .sp
953 .LP
954 \fBExample 10 \fRUsing fsdb to change the i-number
955 .sp
956 .LP
957 The following command changes the i-number for the \fB7\fRth directory slot in
958 the root directory to \fB3\fR.
960 .sp
961 .in +2
962 .nf
963 > 2:inode; 7:dir=3
964 .fi
965 .in -2
966 .sp
968 .LP
969 \fBExample 11 \fRUsing fsdb to change the name field
970 .sp
971 .LP
972 The following command changes the \fIname\fR field in the directory slot to
973 \fBname\fR.
975 .sp
976 .in +2
977 .nf
978 > 7:dir:nm="name"
979 .fi
980 .in -2
981 .sp
983 .LP
984 \fBExample 12 \fRUsing fsdb to display the a block
985 .sp
986 .LP
987 The following command displays the \fB3\fRrd block of the current inode as
988 directory entries.
990 .LP
991 \fBExample 13 \fRUsing fsdb to set the contents of address
992 .sp
993 .LP
994 The following command sets the contents of address \fB2050\fR to
995 \fB0xffffffff\fR. \fB0xffffffff\fR can be truncated, depending on the current
996 type.
998 .sp
999 .in +2
1000 .nf
1001 > 2050=0xffff
1002 .fi
1003 .in -2
1004 .sp
1006 .LP
1007 \fBExample 14 \fRUsing fsdb to place an ASCII string at an address
1008 .sp
1009 .LP
1010 The following command places the \fBASCII\fR string \fBthis is some text\fR at
1011 address \fB1c92434\fR.
1013 .sp
1014 .in +2
1015 .nf
1016 > 1c92434="this is some text"
1017 .fi
1018 .in -2
1019 .sp
1021 .SH SEE ALSO
1022 .sp
1023 .LP
1024 \fBclri\fR(1M), \fBfsck_udfs\fR(1M), \fBdir\fR(4), \fBattributes\fR(5)