reactos/media/doc/README.WINE

   1 # ReactOS WINE porting guide for 0.3
   2 # Update this file when you port a dll/program from WINE.
   3
   4 The ReactOS Project shares quite a bit of code with the WINE project.
   5 This document should provide a compleate reference for all of the
   6 locations in the ReactOS source tree where code is shared between the
   7 two projects. If you find something is missing from this documentation
   8 please add it.
   9
  10 If you find that a function in ReactOS that is not implemented properly
  11 and is based on WINE sources, check the latest Winehq CVS and see if
  12 it has been fixed there. If so, please submit a patch to
  13 ros-dev@reactos.org. Otherwise please send a patch to both
  14 wine-patches@winehq.com and ros-dev@reactos.org
  15
  16 When porting a new DLL from Wine to ReactOS, please do the following steps
  17 - Create a new directory in dll/win32/ of the same name as the new Wine DLL
  18 - Add a new entry in dll/win32/win32.rbuild
  19 - Follow the guide "Update process for autosync DLLs" at the bottom of this file
  20
  21
  22 The following build tools are shared with Wine.
  23
  24 reactos/tools/unicode             # Synced to Wine-1.5.19
  25 reactos/tools/widl                # Synced to Wine-1.5.11
  26 reactos/tools/wpp                 # Synced to Wine-1.7.1
  27
  28 The following libraries are shared with Wine.
  29
  30 reactos/dll/directx/amstream            # Synced to Wine-1.3.37
  31 reactos/dll/directx/dinput              # Synced to Wine-1.5.26
  32 reactos/dll/directx/dinput8             # Synced to Wine-1.5.26
  33 reactos/dll/directx/dmusic              # Synced to Wine-1.5.26
  34 reactos/dll/directx/dplay               # Synced to Wine-1.5.26
  35 reactos/dll/directx/dplayx              # Synced to Wine-1.5.26
  36 reactos/dll/directx/dsound              # Synced to Wine-1.5.26
  37 reactos/dll/directx/dxdiagn             # Synced to Wine-0_9_5
  38 reactos/dll/directx/dxgi                # Synced to Wine-1.7.1
  39 reactos/dll/directx/msdmo               # Autosync
  40 reactos/dll/directx/qedit               # Autosync
  41 reactos/dll/directx/quartz              # Synced to Wine-1.5.26
  42 reactos/dll/directx/wine/d3d8           # Synced to Wine-1.7.1
  43 reactos/dll/directx/wine/d3d9           # Synced to Wine-1.7.1
  44 reactos/dll/directx/wine/d3dcompiler_43 # Synced to Wine-1.7.1
  45 reactos/dll/directx/wine/d3dx9_24 => 43 # Synced to Wine-1.7.1
  46 reactos/dll/directx/wine/d3dxof         # Synced to Wine-1.7.1
  47 reactos/dll/directx/wine/ddraw          # Synced to Wine-1.7.1
  48 reactos/dll/directx/wine/wined3d        # Synced to Wine-1.7.1
  49
  50 reactos/dll/win32/activeds        # Synced to Wine-1.1.43?
  51 reactos/dll/win32/actxprxy        # Synced to Wine-1.5.26
  52 reactos/dll/win32/advpack         # Synced to Wine-1.7.1
  53 reactos/dll/win32/atl             # Synced to Wine-1.5.19
  54 reactos/dll/win32/atl100          # Synced to Wine-1.7.1
  55 reactos/dll/win32/avifil32        # Synced to Wine-1.5.26
  56 reactos/dll/win32/bcrypt          # Synced to Wine-1.5.26
  57 reactos/dll/win32/browseui        # Out of sync
  58 reactos/dll/win32/cabinet         # Synced to Wine-1.5.26
  59 reactos/dll/win32/clusapi         # Synced to Wine-1.5.26
  60 reactos/dll/win32/comcat          # Synced to Wine-1.5.4
  61 reactos/dll/win32/comctl32        # Synced to Wine 1.5.26
  62 reactos/dll/win32/comdlg32        # Synced to Wine 1.3.37
  63 reactos/dll/win32/compstui        # Synced to Wine-1.5.19
  64 reactos/dll/win32/credui          # Synced to Wine-1.5.4
  65 reactos/dll/win32/crypt32         # Synced to Wine-1.5.26
  66 reactos/dll/win32/cryptdlg        # Synced to Wine-1.5.26
  67 reactos/dll/win32/cryptdll        # Synced to Wine-1.5.26
  68 reactos/dll/win32/cryptnet        # Synced to Wine-1.5.26
  69 reactos/dll/win32/cryptui         # Synced to Wine-1.5.26
  70 reactos/dll/win32/dbghelp         # Synced to Wine-1.5.26
  71 reactos/dll/win32/dciman32        # Synced to Wine-1.5.19
  72 reactos/dll/win32/dwmapi          # Synced to Wine-1.5.19
  73 reactos/dll/win32/faultrep        # Synced to Wine-1.5.4
  74 reactos/dll/win32/fusion          # Synced to Wine-1.5.26
  75 reactos/dll/win32/gdiplus         # Synced to Wine-1.5.26
  76 reactos/dll/win32/hhctrl.ocx      # Synced to Wine-1.5.26
  77 reactos/dll/win32/hlink           # Synced to Wine-1.5.4
  78 reactos/dll/win32/hnetcfg         # Synced to Wine-1.5.4
  79 reactos/dll/win32/httpapi         # Synced to Wine-1.5.4
  80 reactos/dll/win32/iccvid          # Synced to Wine-1.5.19
  81 reactos/dll/win32/icmp            # Synced to Wine-0_9_10
  82 reactos/dll/win32/ieframe         # Synced to Wine-1.5.26
  83 reactos/dll/win32/imaadp32.acm    # Synced to Wine-1.5.4
  84 reactos/dll/win32/imagehlp        # Synced to Wine-1.5.4
  85 reactos/dll/win32/imm32           # Synced to Wine-1.5.19
  86 reactos/dll/win32/inetcomm        # Synced to Wine-1.5.4
  87 reactos/dll/win32/inetmib1        # Synced to Wine-1.5.4
  88 reactos/dll/win32/initpki         # Synced to Wine-1.5.19
  89 reactos/dll/win32/inseng          # Synced to Wine-1.5.4
  90 reactos/dll/win32/iphlpapi        # Out of sync
  91 reactos/dll/win32/itircl          # Synced to Wine-1.5.19
  92 reactos/dll/win32/itss            # Synced to Wine-1.5.4
  93 reactos/dll/win32/jscript         # Synced to Wine-1.5.26
  94 reactos/dll/win32/loadperf        # Synced to Wine-1.5.19
  95 reactos/dll/win32/localspl        # Synced to Wine-1.5.26
  96 reactos/dll/win32/localui         # Synced to Wine-1.5.19
  97 reactos/dll/win32/lz32            # Synced to Wine-1.5.19
  98 reactos/dll/win32/mapi32          # Autosync
  99 reactos/dll/win32/mciavi32        # Synced to Wine-1.5.4
 100 reactos/dll/win32/mcicda          # Synced to Wine-1.5.19
 101 reactos/dll/win32/mciqtz32        # Synced to Wine-1.5.4
 102 reactos/dll/win32/mciseq          # Synced to Wine-1.5.4
 103 reactos/dll/win32/mciwave         # Synced to Wine-1.5.19
 104 reactos/dll/win32/mlang           # Synced to Wine-1.5.4
 105 reactos/dll/win32/mpr             # Autosync
 106 reactos/dll/win32/mprapi          # Synced to Wine-1.5.19
 107 reactos/dll/win32/msacm32         # Autosync
 108 reactos/dll/win32/msadp32.acm     # Synced to Wine-1.5.19
 109 reactos/dll/win32/mscat32         # Synced to Wine-1.5.19
 110 reactos/dll/win32/mscms           # Synced to Wine-1.5.4
 111 reactos/dll/win32/mscoree         # Synced to Wine-1.5.4
 112 reactos/dll/win32/msctf           # Synced to Wine-1.5.4
 113 reactos/dll/win32/msftedit        # Synced to Wine-1.5.19
 114 reactos/dll/win32/msg711.acm      # Synced to Wine-1.5.19
 115 reactos/dll/win32/msgsm32.acm     # Synced to Wine-1.5.4
 116 reactos/dll/win32/mshtml          # Synced to Wine-1.5.26
 117 reactos/dll/win32/mshtml.tlb      # Synced to Wine-1.5.26
 118 reactos/dll/win32/msi             # Synced to Wine-1.5.26
 119 reactos/dll/win32/msimg32         # Synced to Wine-1.5.19
 120 reactos/dll/win32/msimtf          # Synced to Wine-1.5.19
 121 reactos/dll/win32/msisip          # Synced to Wine-1.5.19
 122 reactos/dll/win32/msisys.ocx      # Synced to Wine-1.5.4
 123 reactos/dll/win32/msnet32         # Synced to Wine-1.5.19
 124 reactos/dll/win32/msrle32         # Autosync
 125 reactos/dll/win32/mssign32        # Synced to Wine-1.5.19
 126 reactos/dll/win32/mssip32         # Synced to Wine-1.5.19
 127 reactos/dll/win32/mstask          # Synced to Wine-1.5.4
 128 reactos/dll/win32/msvcrt20        # Out of sync
 129 reactos/dll/win32/msvcrt40        # Out of sync
 130 reactos/dll/win32/msvfw32         # Autosync
 131 reactos/dll/win32/msvidc32        # Autosync
 132 reactos/dll/win32/msxml           # Synced to Wine-1.5.19
 133 reactos/dll/win32/msxml2          # Synced to Wine-1.5.19
 134 reactos/dll/win32/msxml3          # Synced to Wine-1.5.26
 135 reactos/dll/win32/msxml4          # Synced to Wine-1.5.19
 136 reactos/dll/win32/msxml6          # Synced to Wine-1.5.19
 137 reactos/dll/win32/nddeapi         # Synced to Wine-1.5.19
 138 reactos/dll/win32/netapi32        # Forked at Wine-1.3.34
 139 reactos/dll/win32/ntdsapi         # Synced to Wine-1.5.19
 140 reactos/dll/win32/ntprint         # Synced to Wine-1.5.4
 141 reactos/dll/win32/objsel          # Synced to Wine-1.5.19
 142 reactos/dll/win32/odbc32          # Out of sync. Depends on port of Linux ODBC.
 143 reactos/dll/win32/odbccp32        # Synced to Wine-1.5.19
 144 reactos/dll/win32/ole32           # Synced to Wine-1.5.26
 145 reactos/dll/win32/oleacc          # Autosync
 146 reactos/dll/win32/oleaut32        # Synced to Wine-1.5.26
 147 reactos/dll/win32/olecli32        # Synced to Wine-1.5.19
 148 reactos/dll/win32/oledlg          # Autosync
 149 reactos/dll/win32/olepro32        # Autosync
 150 reactos/dll/win32/olesvr32        # Synced to Wine-1.5.19
 151 reactos/dll/win32/olethk32        # Synced to Wine-1.5.19
 152 reactos/dll/win32/pdh             # Autosync
 153 reactos/dll/win32/pidgen          # Synced to Wine-1.5.19
 154 reactos/dll/win32/powrprof        # Forked at Wine-1.0rc5
 155 reactos/dll/win32/printui         # Synced to Wine-1.5.4
 156 reactos/dll/win32/propsys         # Synced to Wine-1.5.26
 157 reactos/dll/win32/pstorec         # Synced to Wine-1.5.4
 158 reactos/dll/win32/qmgr            # Synced to Wine-1.5.26
 159 reactos/dll/win32/qmgrprxy        # Synced to Wine-1.5.26
 160 reactos/dll/win32/query           # Synced to Wine-1.5.19
 161 reactos/dll/win32/rasapi32        # Synced to Wine-1.5.4
 162 reactos/dll/win32/resutils        # Synced to Wine-1.5.19
 163 reactos/dll/win32/riched20        # Synced to Wine-1.5.19
 164 reactos/dll/win32/riched32        # Synced to Wine-1.5.19
 165 reactos/dll/win32/rpcrt4          # Synced to Wine-1.3.26
 166 reactos/dll/win32/rsabase         # Autosync
 167 reactos/dll/win32/rsaenh          # Synced to Wine-1.5.4
 168 reactos/dll/win32/sccbase         # Synced to Wine-1.5.19
 169 reactos/dll/win32/schannel        # Synced to Wine-1.5.19
 170 reactos/dll/win32/scrrun          # Synced to Wine-1.7.1
 171 reactos/dll/win32/secur32         # Forked
 172 reactos/dll/win32/security        # Forked (different .spec)
 173 reactos/dll/win32/sensapi         # Synced to Wine-1.5.4
 174 reactos/dll/win32/setupapi        # Forked at Wine-20050524
 175 reactos/dll/win32/shdoclc         # Synced to Wine-1.5.19
 176 reactos/dll/win32/shdocvw         # Synced to Wine-1.5.26
 177 reactos/dll/win32/shell32         # Forked at Wine-20071011
 178 reactos/dll/win32/shfolder        # Autosync
 179 reactos/dll/win32/shlwapi         # Synced to Wine-1.5.26
 180 reactos/dll/win32/slbcsp          # Synced to Wine-1.5.19
 181 reactos/dll/win32/snmpapi         # Synced to Wine-1.5.19
 182 reactos/dll/win32/softpub         # Synced to Wine-1.5.19
 183 reactos/dll/win32/spoolss         # Synced to Wine-1.5.19
 184 reactos/dll/win32/stdole2.tlb     # Synced to Wine-1.5.19
 185 reactos/dll/win32/stdole32.tlb    # Synced to Wine-1.5.19
 186 reactos/dll/win32/sti             # Synced to Wine-1.5.4
 187 reactos/dll/win32/sxs             # Synced to Wine-1.5.4
 188 reactos/dll/win32/tapi32          # Autosync
 189 reactos/dll/win32/traffic         # Synced to Wine-1.5.19
 190 reactos/dll/win32/twain_32        # Out of sync
 191 reactos/dll/win32/unicows         # Synced to Wine-1.3.32 (Win9x only, why do we need this?!)
 192 reactos/dll/win32/updspapi        # Synced to Wine-1.5.4
 193 reactos/dll/win32/url             # Synced to Wine-1.5.19
 194 reactos/dll/win32/urlmon          # Synced to Wine-1.5.26
 195 reactos/dll/win32/usp10           # Synced to Wine-1.5.26
 196 reactos/dll/win32/uxtheme         # Forked
 197 reactos/dll/win32/vbscript        # Synced to Wine-1.5.26
 198 reactos/dll/win32/version         # Autosync
 199 reactos/dll/win32/wbemprox        # Synced to Wine-1.5.26
 200 reactos/dll/win32/wer             # Autosync
 201 reactos/dll/win32/windowscodecs   # Synced to Wine-1.5.26
 202 reactos/dll/win32/winemp3.acm     # Synced to Wine-1.5.19
 203 reactos/dll/win32/wing32          # Out of sync
 204 reactos/dll/win32/winhttp         # Synced to Wine-1.5.26
 205 reactos/dll/win32/wininet         # Synced to Wine-1.5.26
 206 reactos/dll/win32/winmm           # Forked at Wine-20050628
 207 reactos/dll/win32/winmm/midimap   # Forked at Wine-20050628
 208 reactos/dll/win32/winmm/wavemap   # Forked at Wine-20050628
 209 reactos/dll/win32/wintrust        # Synced to Wine-1.5.4
 210 reactos/dll/win32/wldap32         # Autosync
 211 reactos/dll/win32/wmi             # Synced to Wine-1.5.19
 212 reactos/dll/win32/wtsapi32        # Synced to Wine-1.5.4
 213 reactos/dll/win32/wuapi           # Synced to Wine-1.5.19
 214 reactos/dll/win32/xinput1_1       # Synced to Wine-1.5.19
 215 reactos/dll/win32/xinput1_2       # Synced to Wine-1.5.19
 216 reactos/dll/win32/xinput1_3       # Synced to Wine-1.5.19
 217 reactos/dll/win32/xinput9_1_0     # Synced to Wine-1.5.19
 218 reactos/dll/win32/xmllite         # Synced to Wine-1.5.26
 219
 220 reactos/dll/cpl/inetcpl           # Synced to Wine-1.3.21
 221
 222 ReactOS shares the following programs with Winehq.
 223
 224 reactos/base/applications/cmdutils/xcopy  # Synced to Wine-1.3.37
 225 reactos/base/applications/games/winmine   # Forked at Wine-1_3_5
 226 reactos/base/applications/extrac32        # Autosync
 227 reactos/base/applications/iexplore        # Synced to Wine-1.5.26
 228 reactos/base/applications/notepad         # Forked at Wine-20041201
 229 reactos/base/applications/reg             # Autosync
 230 reactos/base/applications/regedit         # Out of sync
 231 reactos/base/applications/winhlp32        # Synced to Wine-1.5.26
 232 reactos/base/applications/wordpad         # Synced to Wine-1.5.26
 233 reactos/base/services/rpcss               # Synced to Wine-20081105
 234 reactos/base/system/expand                # Synced to Wine-1.5.26
 235 reactos/base/system/msiexec               # Synced to Wine-1.5.26
 236 reactos/modules/rosapps/winfile           # Autosync
 237
 238 In addition the following libs, dlls and source files are mostly based on code ported
 239 from Winehq CVS. If you are looking to update something in these files
 240 check Wine current souces first as it may already be fixed.
 241
 242 reactos/lib/3rdparty/strmbase             # Synced to Wine-1.5.26
 243 reactos/lib/sdk/uuid                      # Synced to Wine-1.1.42
 244
 245 advapi32 -
 246   reactos/dll/win32/advapi32/crypt/*.c          # Unknown
 247   reactos/dll/win32/advapi32/sec/cred.c         # Out of Sync
 248   reactos/dll/win32/advapi32/sec/sid.c          # Out of Sync
 249
 250 gdi32 -
 251   reactos/dll/win32/gdi32/objects/linedda.c     # Synced at 20090410
 252
 253 kernel32 -
 254   reactos/dll/win32/kernel32/wine/actctx.c               # Partly synced
 255   reactos/dll/win32/kernel32/wine/comm.c                 # Synced in r52754
 256   reactos/dll/win32/kernel32/wine/lzexpand.c             # Synced in r52754
 257   reactos/dll/win32/kernel32/wine/profile.c              # Synced in r52754
 258   reactos/dll/win32/kernel32/wine/res.c                  # Synced in r52754
 259   reactos/dll/win32/kernel32/winnls/string/casemap.c     # Synced in r52754
 260   reactos/dll/win32/kernel32/winnls/string/chartype.c    # Synced in r52754
 261   reactos/dll/win32/kernel32/winnls/string/collation.c   # Synced in r52754
 262   reactos/dll/win32/kernel32/winnls/string/format_msg.c  # Synced to Wine-1.5.4
 263   reactos/dll/win32/kernel32/winnls/string/lang.c        # Synced in r52754
 264   reactos/dll/win32/kernel32/winnls/string/lcformat.c    # Synced in r52754
 265   reactos/dll/win32/kernel32/winnls/string/nls.c         # Synced in r52754
 266   reactos/dll/win32/kernel32/winnls/string/sortkey.c     # Synced in r52754
 267
 268 msvcrt -
 269   reactos/lib/sdk/crt/except/cpp.c              # Synced at 20080528
 270   reactos/lib/sdk/crt/except/cppexcept.c        # Synced at 20071111
 271   reactos/lib/sdk/crt/string/scanf.c/h          # Synced to Wine-1_1_27
 272   reactos/lib/sdk/crt/strings/wcs.c             # Synced at 20080611
 273   reactos/lib/sdk/crt/wine/heap.c               # Synced at 20080529
 274   reactos/lib/sdk/crt/wine/undname.c            # Synced at 20081130
 275   reactos/lib/sdk/crt/thread/thread.c           # Synced at 20080604
 276
 277 User32 -
 278   reactos/dll/win32/user32/controls/button.c    # Synced to Wine-1_1_39
 279   reactos/dll/win32/user32/controls/combo.c     # Synced to Wine-1.5.10
 280   reactos/dll/win32/user32/controls/edit.c      # Synced to Wine-1_1_40
 281   reactos/dll/win32/user32/controls/icontitle.c # Synced to Wine-1_1_39
 282   reactos/dll/win32/user32/controls/listbox.c   # Synced to Wine-1_1_39
 283   reactos/dll/win32/user32/controls/scrollbar.c # Forked
 284   reactos/dll/win32/user32/controls/static.c    # Synced to Wine-1_1_39
 285
 286   reactos/dll/win32/user32/include/dde_private.h # Synced to wine 1.1.24
 287
 288   reactos/dll/win32/user32/misc/dde.c           # Synced to wine 1.1.24 (dde_misc.c)
 289   reactos/dll/win32/user32/misc/ddeclient.c     # Synced to Wine-1_1_23
 290   reactos/dll/win32/user32/misc/ddeserver.c     # Synced to Wine-1_1_23
 291   reactos/dll/win32/user32/misc/exticon.c       # Synced to Wine-1_1_22
 292   reactos/dll/win32/user32/misc/resources.c     # Forked?
 293   reactos/dll/win32/user32/misc/winhelp.c       # Last sync date unknown
 294   reactos/dll/win32/user32/misc/wsprintf.c      # Synced to Wine-1_1_23
 295
 296   reactos/dll/win32/user32/windows/cursoricon   # Forked from wine 1.2-rc7
 297   reactos/dll/win32/user32/windows/defwnd.c     # Forked
 298   reactos/dll/win32/user32/windows/draw.c       # Forked at Wine-20020904 (uitools.c)
 299   reactos/dll/win32/user32/windows/mdi.c        # Synced to Wine-1_1_40
 300   reactos/dll/win32/user32/windows/menu.c       # Forked
 301   reactos/dll/win32/user32/windows/messagebox.c # Forked
 302   reactos/dll/win32/user32/windows/rect.c       # Forked (uitools.c)
 303   reactos/dll/win32/user32/windows/spy.c        # Synced to Wine-1_1_40
 304   reactos/dll/win32/user32/windows/text.c       # Forked (lstr.c)
 305   reactos/dll/win32/user32/windows/winpos.c     # Forked
 306
 307 ws2_32 -
 308   reactos/dll/win32/ws2_32/misc/async.c         # Synced to Wine-1.5.4
 309
 310 Update process for autosync DLLs
 311
 312 *** This process can only be done on Microsoft Windows ***
 313 - Download wineimport.cmd at svn://svn.reactos.org/project-tools/trunk/
 314 - Download cvs command line program and be sure to put it in your path
 315   (available at http://ftp.gnu.org/non-gnu/cvs/binary/stable/x86-woe/ )
 316 - Download svn command line program and be sure to put it in your path
 317   (available at http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91 )
 318 - Download patch command line program and be sure to put it in your path
 319   (available at http://gnuwin32.sourceforge.net/packages/patch.htm )
 320 - Optionally, download junction.exe and put it in your path
 321   (available at http://www.sysinternals.com/Utilities/Junction.html )
 322 - Cd to the directory containing wineimport.cmd
 323 - Run
 324   "wineimport.cmd fullprocessing {path_to_your_reactos_directory} {name_of_the_wine_dll}"
 325 - In case of error, you can
 326   1) add missing definitions to ReactOS headers
 327   2) fix {name_of_the_wine_dll}_ros.diff patch file, by removing outdated changes
 328   3) or modify Wine code, by adding a {name_of_the_wine_dll}_ros.diff patch,
 329      which will be applied after Wine source checkout
 330      DO NOT DIRECTLY MODIFY WINE SOURCE CODE
 331 - Once Wine DLL compiles, install and run ReactOS and search for regressions
 332 - In case of regression, you can
 333   1) Fix ReactOS code (not in the shared DLL)
 334   2) or update the {name_of_the_wine_dll}_ros.diff patch file
 335 - Commit your changes with the "Autosyncing with Wine HEAD" commit message