1WRESTOOL(1)                 General Commands Manual                WRESTOOL(1)
2
3
4

NAME

6       wrestool - extract resources from Microsoft Windows(R) binaries
7

SYNOPSIS

9       wrestool [OPTIONS]... [FILE]...
10

DESCRIPTION

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
16       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
21       Filters, specified as command line options, control what  resources  to
22       extract.
23

OPTIONS

25       These  programs  follow  the  usual  GNU command line syntax, with long
26       options starting with two dashes (`-').
27
28       -x, --extract
29              Extract resources. (By default, resources will be  extracted  to
30              standard out if --output was not specified.)
31
32       -l, --list
33              Output list of resources (default).
34
35       -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
40              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
45       -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
50       -L, --language=[+|-]ID
51              Resource language identifier.  Has  no  effect  when  processing
52              16-bit libraries.
53
54       -a, --all
55              Perform operation on all resource (default).
56
57       -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
64       -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
69       -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
74       --help Display a help message and exit.
75
76       --version
77              Output version information and exit.
78

RESOURCE TYPES

80       The  wrestool  program recognizes the resource types listed below.  The
81       ids of these resources are always numeric and not strings.
82
83       cursor (1)
84              A single cursor bitmap  image.  Read  as  part  of  group_cursor
85              resources.
86
87       bitmap (2)
88              A bitmap image.
89
90       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
95       menu (4)
96              Resources for menus (in popup and menubars).  Currently wrestool
97              does not support this resource type.
98
99       dialog (5)
100              Definitions (widgets with locations)  for  dialog  boxes.   Cur‐
101              rently wrestool does not support this resource type.
102
103       string (6)
104              The  string  table  resource,  containing  a  number  of unicode
105              strings. Currently wrestool does not support this resource type.
106
107       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
113       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
118       accelerator (9)
119              Keyboard  accelerator  tables.  Currently wrestool does not sup‐
120              port this resource type.
121
122       rcdata (10)
123              Arbitrary resource data, user-defined. There are no restrictions
124              to the format of these resources.
125
126       messagelist (11)
127              Not supported.
128
129       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
133       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
137       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
142       dlginclude (17)
143              Not supported.
144
145       plugplay (19)
146              Not supported.
147
148       vxd (20)
149              Not supported.
150
151       anicursor (21)
152              Animated  cursors.  Currently wrestool does not support animated
153              cursor or icons, nor does icotool.
154
155       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

EXAMPLES

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
169       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
174       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

SEE ALSO

181       extresso(1), genresscript(1), icotool(1).
182

AUTHOR

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
191       Copyright © 2001 Oskar Liljeblad
192
193       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

TRADEMARKS

198       Windows  is  a  registered  trademark  of  Microsoft Corporation in the
199       United States and other countries.
200
201
202
203wrestool (icoutils)             April 18, 2005                     WRESTOOL(1)
Impressum