1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
|
/*
* Copyright (c) International Business Machines Corp., 2000-2002
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
* the GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/
/*
* FUNCTION: Explain how to use the jfs_debugfs utility
*/
#include <config.h>
#include <stdio.h>
#include <string.h>
void help(void)
{
char *cmd;
int cmd_len;
cmd = strtok(0, " \t\n"); /* space & tab */
if (strtok(0, " \t\n")) {
fputs("help: called with too many arguments\n\n", stderr);
return;
}
if (cmd == 0) {
fputs("\t\tjfs_debugfs Commands\n\n", stdout);
fputs("a[lter] <block> <offset> <hex string>\n", stdout);
fputs("b[tree] <block> [<offset>]\n", stdout);
fputs("cb[blfsck]\n", stdout);
fputs("dir[ectory] <inode number> [<fileset>]\n", stdout);
fputs("d[isplay] [<block> [<offset> [<format> [<count>]]]]\n", stdout);
fputs("dm[ap]\n", stdout);
fputs("dt[ree] <inode number> [<fileset>]\n", stdout);
fputs("fsckw[sphdr]\n", stdout);
fputs("h[elp] [<command>]\n", stdout);
fputs("ia[g] [<IAG number>] [a | s | <fileset>]\n", stdout);
fputs("i[node] [<inode number>] [a | s | <fileset>]\n", stdout);
fputs("logs[uper]\n", stdout);
fputs("q[uit]\n", stdout);
fputs("se[t] [<variable> <value>]\n", stdout);
fputs("su[perblock] [p | s]\n", stdout);
fputs("s2p[erblock] [p | s]\n", stdout);
fputs("u[nset] <variable>\n", stdout);
fputs("xt[ree] <inode number> [<fileset>]\n\n", stdout);
return;
}
cmd_len = strlen(cmd);
if (strncmp(cmd, "alter", cmd_len) == 0) {
fputs("a[lter] <block> <offset> <hex string>\n", stdout);
fputs("\t<block>\t\tblock number (decimal)\n", stdout);
fputs("\t<offset>\toffset within block (hex)\n", stdout);
fputs("\t<hex string>\tstring of hex digits\n\n", stdout);
fputs("alters disk data. <hex string> should contain an even number of digits\n\n",
stdout);
} else if (strncmp(cmd, "btree", cmd_len) == 0) {
fputs("b[tree] <block> [<offset>]\n", stdout);
fputs("\t<block>\t\tblock number (decimal)\n", stdout);
fputs("\t<offset>\toffset within block (hex)\n\n", stdout);
fputs("displays one node of a btree and enters a subcommand mode in which to\n",
stdout);
fputs("navigate the btree. Subcommands:\n", stdout);
fputs("\tl\tvisit left sibling\n", stdout);
fputs("\tm\tmodify current node\n", stdout);
fputs("\tp\tvisit parent node\n", stdout);
fputs("\tr\tvisit right sibling\n", stdout);
fputs("\t[0-9]\tvisit the nth child node\n", stdout);
fputs("\tx\texit subcommand mode\n\n", stdout);
} else if (cmd_len > 1 && strncmp(cmd, "cbblfsck", cmd_len) == 0) {
fputs("cb[blfsck]\n\n", stdout);
fputs("Displays the area used by ClearBadBlockList \n", stdout);
fputs("for communication with fsck.\n\n", stdout);
} else if (cmd_len > 2 && strncmp(cmd, "directory", cmd_len) == 0) {
fputs("dir[ectory] <inode number> [<fileset>]\n", stdout);
fputs("\t<inode number>\tinode number of directory (decimal)\n", stdout);
fputs("\t<fileset>\tfileset number, currently must be zero\n\n", stdout);
fputs("Displays directory entries. Subcommands\n", stdout);
fputs("\tm\tmodify entries\n", stdout);
fputs("\tx\texit subcommand mode\n\n", stdout);
} else if (cmd_len > 1 && strncmp(cmd, "dtree", cmd_len) == 0) {
fputs("dt[ree] <inode number> [<fileset>]\n", stdout);
fputs("\t<inode number>\tinode number of directory (decimal)\n", stdout);
fputs("\t<fileset>\tfileset number, currently must be zero\n\n", stdout);
fputs
("Displays root of the directory btree and enters a subcommand mode in which to\n",
stdout);
fputs("navigate the btree. Subcommands:\n", stdout);
fputs("\tl\tvisit left sibling\n", stdout);
fputs("\tm\tmodify current node\n", stdout);
fputs("\tp\tvisit parent node (not parent directory)\n", stdout);
fputs("\tr\tvisit right sibling\n", stdout);
fputs("\t[0-9]\tvisit the nth child node\n", stdout);
fputs("\tx\texit subcommand mode\n\n", stdout);
} else if (strncmp(cmd, "display", cmd_len) == 0) {
fputs("d[isplay] [<block> [<offset> [<format> [<count>]]]]\n", stdout);
fputs("\t<block>\t\tblock number (decimal)\n", stdout);
fputs("\t<offset>\toffset within block (hex)\n", stdout);
fputs("\t<format>\tformat in which to display data (see below)\n", stdout);
fputs("\t<count>\t\tnumber of objects to display (decimal)\n", stdout);
fputs
("displays data in a variety of formats. Format may be one of the following:\n",
stdout);
fputs("\ta\tascii\n", stdout);
fputs("\tb\tblock allocation map\n", stdout);
fputs("\td\tdecimal\n", stdout);
fputs("\ti\tinode\t\t\t\tstruct dinode\n", stdout);
fputs("\tI\tinode allocation map\t\tixad_t\n", stdout);
fputs("\ts\tsuperblock\t\t\tstruct superblock\n", stdout);
fputs("\tx\thexadecimal\n", stdout);
fputs("\tX\textent allocation descriptor\txad_t\n\n", stdout);
} else if (cmd_len > 1 && strncmp(cmd, "dmap", cmd_len) == 0) {
fputs("dm[ap]\n", stdout);
fputs("Displays Aggregate Disk (Block) Map\n\n", stdout);
} else if (cmd_len > 4 && strncmp(cmd, "fsckwsphdr", cmd_len) == 0) {
fputs("fsckw[sphdr]\n\n", stdout);
fputs("Displays the header of the fsck workspace in the aggregate.\n\n", stdout);
} else if (strncmp(cmd, "help", cmd_len) == 0) {
fputs("h[elp] [<command>]\n", stdout);
fputs("\t<command>\tcommand name\n\n", stdout);
fputs("prints help text. Lists all commands if no parameter\n\n", stdout);
} else if (cmd_len > 1 && strncmp(cmd, "iag", cmd_len) == 0) {
fputs("ia[g] [<IAG number>] [a | <fileset>]\n", stdout);
fputs("\t<IAG number>\tIAG number (decimal)\n", stdout);
fputs("\ta\t\tuse primary aggragate inode table\n", stdout);
fputs("\ts\t\tuse secondary aggragate inode table\n", stdout);
fputs("\t<fileset>\tfileset number (currently must be zero)\n\n", stdout);
fputs("Display iag information and enters subcommand mode. Subcommands:\n",
stdout);
fputs("\te\tdisplay/modify inode extents map\n", stdout);
fputs("\tm\tmodify iag\n", stdout);
fputs("\tp\tdisplay/modify persistent map\n", stdout);
fputs("\tw\tdisplay/modify working map\n\n", stdout);
} else if (strncmp(cmd, "inode", cmd_len) == 0) {
fputs("i[node] [<inode number>] [a | <fileset>]\n", stdout);
fputs("\t<inode number>\tinode number (decimal)\n", stdout);
fputs("\ta\t\tuse primary aggragate inode table\n", stdout);
fputs("\ts\t\tuse secondary aggragate inode table\n", stdout);
fputs("\t<fileset>\tfileset number (currently must be zero)\n\n", stdout);
fputs("Display inode information and enters subcommand mode. Subcommands:\n",
stdout);
fputs("\ta\tdisplay/modify inode's ACL\n", stdout);
fputs("\tm\tmodify inode\n", stdout);
} else if (cmd_len > 3 && strncmp(cmd, "logsuper", cmd_len) == 0) {
fputs("logs[uper]\n\n", stdout);
fputs("Displays the journal log superblock.\n\n", stdout);
} else if (strncmp(cmd, "quit", cmd_len) == 0) {
fputs("q[uit]\n\n", stdout);
fputs("exit jfs_debugfs\n\n", stdout);
} else if (cmd_len > 1 && strncmp(cmd, "set", cmd_len) == 0) {
fputs("se[t] [<variable> <value>]\n", stdout);
fputs("\t<variable>\tvariable to define. First character must be alpha\n", stdout);
fputs("\t<value>\t\tvalue to assign to variable.\n\n", stdout);
fputs("Sets a user-defined variable. With no arguments, set lists all\n", stdout);
fputs("defined variables.\n", stdout);
} else if (cmd_len > 1 && strncmp(cmd, "superblock", cmd_len) == 0) {
fputs("su[perblock] [p | s]\n", stdout);
fputs("\tp\tDisplay primary superblock\n", stdout);
fputs("\ts\tDisplay secondary superblock\n\n", stdout);
fputs("Displays superblock data\n\n", stdout);
} else if (cmd_len > 2 && strncmp(cmd, "s2perblock", cmd_len) == 0) {
fputs("su[perblock] [p | s]\n", stdout);
fputs("\tp\tDisplay primary superblock\n", stdout);
fputs("\ts\tDisplay secondary superblock\n\n", stdout);
fputs("Displays alternate superblock data\n\n", stdout);
} else if (strncmp(cmd, "unset", cmd_len) == 0) {
fputs("u[nset] <variable>\n\n", stdout);
fputs("\t<variable>\tvariable to delete.\n\n", stdout);
fputs("Deletes variables defined with set command\n\n", stdout);
} else if (cmd_len > 1 && strncmp(cmd, "xtree", cmd_len) == 0) {
fputs("xt[ree] <inode number> [<fileset>]\n", stdout);
fputs("\t<inode number>\tinode number of non-directory (decimal)\n", stdout);
fputs("\t<fileset>\tfileset number, currently must be zero\n\n", stdout);
fputs
("Displays root of the non-directory btree and enters a subcommand mode in which to\n",
stdout);
fputs("navigate the btree. Subcommands:\n", stdout);
fputs("\tl\tvisit left sibling\n", stdout);
fputs("\tm\tmodify current node\n", stdout);
fputs("\tp\tvisit parent node (not parent directory)\n", stdout);
fputs("\tr\tvisit right sibling\n", stdout);
fputs("\t[0-9]\tvisit the nth child node\n", stdout);
fputs("\tx\texit subcommand mode\n\n", stdout);
} else
fprintf(stderr, "help: Unknown command '%s'\n\n", cmd);
}
|
