NAME

       wrestool - extract resources from Microsoft Windows(R) binaries

SYNOPSIS

       wrestool [OPTIONS]... [FILE]...

DESCRIPTION

       This manual page documents briefly the wrestool command.  This manual page was written for the Debian GNU
       distribution because the original program does not have a manual page.

       Wrestool reads 16- or 32-bit Microsoft Windows(R) binaries and  lists  or  extracts  the  resources  they
       contain.  Some  resources  require processing before they can be written to files; wrestool is able to do
       this with icon and cursor resources.

       Filters, specified as command line options, control what resources to extract.

OPTIONS

       These programs follow the usual GNU command line syntax, with  long  options  starting  with  two  dashes
       (`-').

       -x, --extract
              Extract  resources.  (By  default, resources will be extracted to standard out if --output was not
              specified.)

       -l, --list
              Output list of resources (default).

       -t, --type=[+|-]ID
              Resource type identifier of affected resources. If preceded  with  a  dash  (``-''),  id  must  be
              numeric; if preceded with a plus sign (``+''), id must be a string.

              The  type ID may also be the name of a resource type. (If this is the case, a leading dash or plus
              sign may not be included.) A list of resource  types  can  be  found  in  the  ``Resource  Types''
              section.

       -n, --name=[+|-]ID
              Resource  name  identifier  of  affected resources. Like the --type option, a leading dash or plus
              sign controls the datatype of the id.

       -L, --language=[+|-]ID
              Resource language identifier. Has no effect when processing 16-bit libraries.

       -a, --all
              Perform operation on all resource (default).

       -o, --output=PATH
              Where to place extracted resources. If ``PATH'' does not refer to an existing directory, and  does
              not end with a slash (``/''), all output will be written to the file ``PATH''. (This means that if
              you extract multiple resources, PATH will contain the last resource only.)

       -R, --raw
              Do not parse resource contents - extract raw data. (This option will  probably  be  replaced  with
              --format=raw in future version of icoutils.)

       -v, --verbose
              Explain  what  is being done. The verbose option may be specified more than once, like ``-vv'', to
              make wrestool even more verbose.

       --help Display a help message and exit.

       --version
              Output version information and exit.

RESOURCE TYPES

       The wrestool program recognizes the resource types listed below.  The ids of these resources  are  always
       numeric and not strings.

       cursor (1)
              A single cursor bitmap image. Read as part of group_cursor resources.

       bitmap (2)
              A bitmap image.

       icon (3)
              A  single  icon  bitmap  image. Read as part of group_icon resources.  This resource is similar to
              cursor resources; cursors contain four additional bytes of hotspot coordinates.

       menu (4)
              Resources for menus (in popup and menubars).  Currently wrestool does not  support  this  resource
              type.

       dialog (5)
              Definitions  (widgets  with locations) for dialog boxes.  Currently wrestool does not support this
              resource type.

       string (6)
              The string table resource, containing a number of unicode strings.  Currently  wrestool  does  not
              support this resource type.

       fontdir (7)
              The  font directory, containing information on a number of font resources (8). Non-TTF font (.FON)
              files are actually libraries with resources in them. Currently  wrestool  does  not  support  this
              resource type.

       font (8)
              A single font - the contents of a .FNT file. Read as part of fontdir resources. Currently wrestool
              does not support this resource type.

       accelerator (9)
              Keyboard accelerator tables.  Currently wrestool does not support this resource type.

       rcdata (10)
              Arbitrary resource data, user-defined. There are no restrictions to the format of these resources.

       messagelist (11)
              Not supported.

       group_cursor (12)
              A set of cursors. With a few modifications (and with  cursor  resources),  this  resource  can  be
              extracted as a .CUR file.

       group_icon (14)
              A  set  of  icons.  With  a  few  modifications  (and  with icons resources), this resource can be
              extracted as a .ICO file.

       version (16)
              Version information, stored as binary data. Could be extracted without modifications, but the data
              is of probably little use.  Currently wrestool does not support this resource type.

       dlginclude (17)
              Not supported.

       plugplay (19)
              Not supported.

       vxd (20)
              Not supported.

       anicursor (21)
              Animated cursors. Currently wrestool does not support animated cursor or icons, nor does icotool.

       aniicon (22)
              Animated  icons.  I  have  only seen these in Windows(R) 3.x.  Currently wrestool does not support
              animated cursor or icons, nor does icotool.

EXAMPLES

       List all resources in file `write.exe':
         $ wrestool -l write.exe
         --type=3 --name=1 --lang=1033 [type=icon offset=0x3120 size=752]
         --type=3 --name=2 --lang=1033 [type=icon offset=0x3410 size=304]
         --type=14 --name=1 --lang=1033 [type=group_icon offset=0x3540 size=34]
         --type=16 --name=1 --lang=1033 [type=version offset=0x3564 size=808]

       List all (group-) icon resource in file `write.exe':
         $ wrestool -l --type=group_icon write.exe
         --type=14 --name=1 --lang=1033 [type=group_icon offset=0x3540 size=34]

       Extract all icons to current directory, naming the destination files `write.exe_T_N.ico':
         $ wrestool -x --output=. -t14 write.exe
         $ ls *.ico
         write.exe_14_1.ico

SEE ALSO

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

AUTHOR

       This manual page was written by Colin Watson <cjwatson@debian.org> for the Debian GNU system (but may  be
       used by others). It was later modified by Oskar Liljeblad <oskar@osk.mine.nu>.

COPYRIGHT

       Copyright © 2001 Colin Watson

       Copyright © 2001 Oskar Liljeblad

       This  is  free  software;  see  the  source  for  copying conditions.  There is NO warranty; not even for
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

TRADEMARKS

       Windows is a registered trademark of Microsoft Corporation in the United States and other countries.