1WRESTOOL(1) General Commands Manual WRESTOOL(1)
2
6 wrestool - extract resources from Microsoft Windows(R) binaries
7
9 wrestool [OPTIONS]... [FILE]...
10
12 This manual page documents briefly the wrestool command. This manual
13 page was written for the Debian GNU distribution because the original
14 program does not have a manual page.
15 Wrestool reads 16- or 32-bit Microsoft Windows(R) binaries and lists or
17 extracts the resources they contain. Some resources require processing
18 before they can be written to files; wrestool is able to do this with
19 icon and cursor resources.
20 Filters, specified as command line options, control what resources to
22 extract.
23
25 These programs follow the usual GNU command line syntax, with long
26 options starting with two dashes (`-').
27 -x, --extract
29 Extract resources. (By default, resources will be extracted to
30 standard out if --output was not specified.)
31 -l, --list
33 Output list of resources (default).
34 -t, --type=[+|-]ID
36 Resource type identifier of affected resources. If preceded with
37 a dash (``-''), id must be numeric; if preceded with a plus sign
38 (``+''), id must be a string.
39 The type ID may also be the name of a resource type. (If this is
41 the case, a leading dash or plus sign may not be included.) A
42 list of resource types can be found in the ``Resource Types''
43 section.
44 -n, --name=[+|-]ID
46 Resource name identifier of affected resources. Like the --type
47 option, a leading dash or plus sign controls the datatype of the
48 id.
49 -L, --language=[+|-]ID
51 Resource language identifier. Has no effect when processing
52 16-bit libraries.
53 -a, --all
55 Perform operation on all resource (default).
56 -o, --output=PATH
58 Where to place extracted resources. If ``PATH'' does not refer
59 to an existing directory, and does not end with a slash (``/''),
60 all output will be written to the file ``PATH''. (This means
61 that if you extract multiple resources, PATH will contain the
62 last resource only.)
63 -R, --raw
65 Do not parse resource contents - extract raw data. (This option
66 will probably be replaced with --format=raw in future version of
67 icoutils.)
68 -v, --verbose
70 Explain what is being done. The verbose option may be specified
71 more than once, like ``-vv'', to make wrestool even more ver‐
72 bose.
73 --help Display a help message and exit.
75 --version
77 Output version information and exit.
78
80 The wrestool program recognizes the resource types listed below. The
81 ids of these resources are always numeric and not strings.
82 cursor (1)
84 A single cursor bitmap image. Read as part of group_cursor
85 resources.
86 bitmap (2)
88 A bitmap image.
89 icon (3)
91 A single icon bitmap image. Read as part of group_icon
92 resources. This resource is similar to cursor resources; cur‐
93 sors contain four additional bytes of hotspot coordinates.
94 menu (4)
96 Resources for menus (in popup and menubars). Currently wrestool
97 does not support this resource type.
98 dialog (5)
100 Definitions (widgets with locations) for dialog boxes. Cur‐
101 rently wrestool does not support this resource type.
102 string (6)
104 The string table resource, containing a number of unicode
105 strings. Currently wrestool does not support this resource type.
106 fontdir (7)
108 The font directory, containing information on a number of font
109 resources (8). Non-TTF font (.FON) files are actually libraries
110 with resources in them. Currently wrestool does not support this
111 resource type.
112 font (8)
114 A single font - the contents of a .FNT file. Read as part of
115 fontdir resources. Currently wrestool does not support this
116 resource type.
117 accelerator (9)
119 Keyboard accelerator tables. Currently wrestool does not sup‐
120 port this resource type.
121 rcdata (10)
123 Arbitrary resource data, user-defined. There are no restrictions
124 to the format of these resources.
125 messagelist (11)
127 Not supported.
128 group_cursor (12)
130 A set of cursors. With a few modifications (and with cursor
131 resources), this resource can be extracted as a .CUR file.
132 group_icon (14)
134 A set of icons. With a few modifications (and with icons
135 resources), this resource can be extracted as a .ICO file.
136 version (16)
138 Version information, stored as binary data. Could be extracted
139 without modifications, but the data is of probably little use.
140 Currently wrestool does not support this resource type.
141 dlginclude (17)
143 Not supported.
144 plugplay (19)
146 Not supported.
147 vxd (20)
149 Not supported.
150 anicursor (21)
152 Animated cursors. Currently wrestool does not support animated
153 cursor or icons, nor does icotool.
154 aniicon (22)
156 Animated icons. I have only seen these in Windows(R) 3.x. Cur‐
157 rently wrestool does not support animated cursor or icons, nor
158 does icotool.
159
161 List all resources in file `write.exe':
162 $ wrestool -l write.exe
163 --type=3 --name=1 --lang=1033 [type=icon offset=0x3120 size=752]
164 --type=3 --name=2 --lang=1033 [type=icon offset=0x3410 size=304]
165 --type=14 --name=1 --lang=1033 [type=group_icon offset=0x3540
166 size=34]
167 --type=16 --name=1 --lang=1033 [type=version offset=0x3564 size=808]
168 List all (group-) icon resource in file `write.exe':
170 $ wrestool -l --type=group_icon write.exe
171 --type=14 --name=1 --lang=1033 [type=group_icon offset=0x3540
172 size=34]
173 Extract all icons to current directory, naming the destination files
175 `write.exe_T_N.ico':
176 $ wrestool -x --output=. -t14 write.exe
177 $ ls *.ico
178 write.exe_14_1.ico
179
181 extresso(1), genresscript(1), icotool(1).
182
184 This manual page was written by Colin Watson <cjwatson@debian.org> for
185 the Debian GNU system (but may be used by others). It was later modi‐
186 fied by Oskar Liljeblad <oskar@osk.mine.nu>.
187
189 Copyright © 2001 Colin Watson
190 Copyright © 2001 Oskar Liljeblad
192 This is free software; see the source for copying conditions. There is
194 NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
195 PURPOSE.
196
198 Windows is a registered trademark of Microsoft Corporation in the
199 United States and other countries.
200wrestool (icoutils) April 18, 2005 WRESTOOL(1)