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 preceeded
37 with a dash (``-''), id must be numeric; if preceeded with a
38 plus sign (``+''), 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 --all Perform operation on all resource (default).
55 -o, --output=PATH
57 Where to place extracted resources. If ``PATH'' does not refer
58 to an existing directory, and does not end with a slash (``/''),
59 all output will be written to the file ``PATH''. (This means
60 that if you extract multiple resources, PATH will contain the
61 last resource only.)
62 -R, --raw
64 Do not parse resource contents - extract raw data. (This option
65 will probably be replaced with --format=raw in future version of
66 icoutils.)
67 -v, --verbose
69 Explain what is being done. The verbose option may be specified
70 more than once, like ``-vv'', to make wrestool even more ver‐
71 bose.
72 --help Display a help message and exit.
74 --version
76 Output version information and exit.
77
79 The wrestool program recognizes the resource types listed below. The
80 ids of these resources are always numeric and not strings.
81 cursor (1)
83 A single cursor bitmap image. Read as part of group_cursor
84 resources.
85 bitmap (2)
87 A bitmap image.
88 icon (3)
90 A single icon bitmap image. Read as part of group_icon
91 resources. This resource is similar to cursor resources; cur‐
92 sors contain four additional bytes of hotspot coordinates.
93 menu (4)
95 Resources for menus (in popup and menubars). Currently wrestool
96 does not support this resource type.
97 dialog (5)
99 Definitions (widgets with locations) for dialog boxes. Cur‐
100 rently wrestool does not support this resource type.
101 string (6)
103 The string table resource, containing a number of unicode
104 strings. Currently wrestool does not support this resource type.
105 fontdir (7)
107 The font directory, containing information on a number of font
108 resources (8). Non-TTF font (.FON) files are actually libraries
109 with resources in them. Currently wrestool does not support this
110 resource type.
111 font (8)
113 A single font - the contents of a .FNT file. Read as part of
114 fontdir resources. Currently wrestool does not support this
115 resource type.
116 accelerator (9)
118 Keyboard accelerator tables. Currently wrestool does not sup‐
119 port this resource type.
120 rcdata (10)
122 Arbitrary resource data, user-defined. There are no restrictions
123 to the format of these resources.
124 messagelist (11)
126 Not supported.
127 group_cursor (12)
129 A set of cursors. With a few modifications (and with cursor
130 resources), this resource can be extracted as a .CUR file.
131 group_icon (14)
133 A set of icons. With a few modifications (and with icons
134 resources), this resource can be extracted as a .ICO file.
135 version (16)
137 Version information, stored as binary data. Could be extracted
138 without modifications, but the data is of probably little use.
139 Currently wrestool does not support this resource type.
140 dlginclude (17)
142 Not supported.
143 plugplay (19)
145 Not supported.
146 vxd (20)
148 Not supported.
149 anicursor (21)
151 Animated cursors. Currently wrestool does not support animated
152 cursor or icons, nor does icotool.
153 aniicon (22)
155 Animated icons. I have only seen these in Windows(R) 3.x. Cur‐
156 rently wrestool does not support animated cursor or icons, nor
157 does icotool.
158
160 List all resources in file `write.exe':
161 $ wrestool -l write.exe
162 --type=3 --name=1 --lang=1033 [type=icon offset=0x3120 size=752]
163 --type=3 --name=2 --lang=1033 [type=icon offset=0x3410 size=304]
164 --type=14 --name=1 --lang=1033 [type=group_icon offset=0x3540
165 size=34]
166 --type=16 --name=1 --lang=1033 [type=version offset=0x3564 size=808]
167 List all (group-) icon resource in file `write.exe':
169 $ wrestool -l --type=group_icon write.exe
170 --type=14 --name=1 --lang=1033 [type=group_icon offset=0x3540
171 size=34]
172 Extract all icons to current directory, naming the destination files
174 `write.exe_T_N.ico':
175 $ wrestool -x --output=. -t14 write.exe
176 $ ls *.ico
177 write.exe_14_1.ico
178
180 extresso(1), genresscript(1), icotool(1).
181
183 This manual page was written by Colin Watson <cjwatson@debian.org> for
184 the Debian GNU system (but may be used by others). It was later modi‐
185 fied by Oskar Liljeblad <oskar@osk.mine.nu>.
186
188 Copyright © 2001 Colin Watson
189 Copyright © 2001 Oskar Liljeblad
191 This is free software; see the source for copying conditions. There is
193 NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
194 PURPOSE.
195
197 Windows is a registered trademark of Microsoft Corporation in the
198 United States and other countries.
199wrestool (icoutils) April 18, 2005 WRESTOOL(1)