mingw/doc/reimp/README

   1 README for reimp
   2 ================
   3
   4 * Overview
   5
   6 `reimp' is a tool to convert Microsoft's new-style (short) import
   7 libraries to import libraries for win32 ports of GNU tools (mingw32,
   8 cygwin).
   9
  10 `reimp' reads an MS import library and writes all imports to the
  11 corresponding .DEF file(s) that it feeds to `dlltool' that creates the
  12 import library.
  13
  14
  15 * Invocation
  16
  17 Usage: reimp [options] IMPLIB
  18
  19 Options:
  20   -s, --dump-symbols      dump symbols to stdout
  21   -d, --only-def          only create .def files
  22   -c, --keep-case         keep case in lib*.a file names
  23   --dlltool <name>        use <name> for dlltool
  24   --as <name>             use <name> for assembler
  25
  26 The `--dump-symbols' option makes `reimp' use a quick method for
  27 finding imported symbols and sending the names of found symbols to
  28 stdout. If the input library contain non-imported symbols they will be
  29 listed as well. The output symbols will have all decoration preserved
  30 (i.e '_' will prefix most symbols), so if you feed it to dlltool you
  31 should strip leading underscores. For example
  32
  33         echo EXPORTS > imp.def
  34         reimp imp.lib | sed 's/_//' >> imp.def
  35         dlltool -k --def imp.def --output-lib libimp.a --dllname imp.dll
  36
  37 The `--only-def' option makes `reimp' stop after generating the .DEF
  38 file(s).
  39
  40 By default `reimp' converts all output library names to lower-case. By
  41 using the `keep-case' option `reimp' will use exactly the case of the
  42 DLL imported from when creating an import library. KERNEL32.dll will
  43 generate libKERNEL32.a and not libkernel32.a as it would be default.
  44
  45
  46 * Notes on mixed libraries
  47
  48 If an input library contain regular objects (non-imports, i.e code and
  49 data) `reimp' will write out those objects unless you specify one of
  50 the `--only-def' and `--dump-symbols' options. You probably want to
  51 include those objects as well in the generated library. `reimp'
  52 doesn't do that automatically so you have to do it manually using
  53 `ar', like this
  54
  55         reimp imp.lib          # this generates several .o or .obj files.
  56         ar rcs libimp.a *.obj  # add them to library
  57
  58
  59 * Contact information
  60
  61 URL: http://www.acc.umu.se/~anorland/gnu-win32/
  62 Anders Norlander <anorland@hem2.passagen.se>