xenial (1) winegcc.1.gz

NAME

       winegcc - Wine C and C++ MinGW Compatible Compiler

SYNOPSIS

       winegcc [options] infile...

DESCRIPTION

       winegcc  is  a  gcc  wrapper which tries to provide a MinGW compatible compiler under Linux. This is most
       useful to Win32 developers who can simply take their MinGW code from Windows, and  recompile  it  without
       modifications under Winelib on Linux.  wineg++ accepts mostly the same options as winegcc.

       The  goal  of winegcc is to be able to simply replace gcc/g++/windres with winegcc/wineg++/wrc in a MinGW
       Makefile, and just recompile the application using Winelib under Wine. While typically  there  are  small
       adjustments that must be made to the application source code and/or Makefile, it is quite easy to do them
       in a fashion that is compatible between the MinGW and Wine environments.

       This manual will document only the  differences  from  gcc;  please  consult  the  gcc  manual  for  more
       information on those options.

OPTIONS

       gcc options: All gcc options are supported, and are passed along to the backend compiler.

       -Bprefix
              This  option  specifies where to find the executables, libraries, include files, and data files of
              the compiler itself. This is a standard gcc option that has been extended to  recognize  a  prefix
              ending  with  '/tools/winebuild',  in  which  case winegcc enters a special mode for building Wine
              itself. Developers should avoid prefixes ending with the magic suffix, or if that is not possible,
              simply express it differently, such as '/tools/winebuild/', to avoid the special behaviour.

       -fno-short-wchar
              Override  the underlying type for wchar_t to be the default for the target, instead of using short
              unsigned int, which is the default for Win32.

       -mconsole
              This option passes '--subsystem console' to winebuild, to build console applications.  It  is  the
              default.

       -mno-cygwin
              Use  Wine  implementation  of  MSVCRT,  instead  of  linking against the host system libc. This is
              necessary for the vast majority of  Win32  applications,  as  they  typically  depend  on  various
              features  of  MSVCRT.  This  switch  is  also used by the MinGW compiler to link against MSVCRT on
              Windows, instead of linking against Cygwin libc. Sharing the syntax with MinGW makes it very  easy
              to write Makefiles that work under Wine, MinGW+MSYS, or MinGW+Cygwin.

       -municode
              Set  the  default entry point of the application to be the Unicode wmain() instead of the standard
              main().

       -mwindows
              This option adds -lgdi32, -lcomdlg32, and -lshell32 to the list of default libraries,  and  passes
              '--subsystem windows' to winebuild to build graphical applications.

       -nodefaultlibs
              Do  not  use  the  standard  system libraries when linking. These include at a minimum -lkernel32,
              -luser32, -ladvapi32, and any default libraries used by the backend compiler. The -mwindows option
              augments the list of default libraries as described above.

       -nostartfiles
              Do not add the winecrt0 library when linking.

       -Wb,option
              Pass  an option to winebuild.  If option contains commas, it is split into multiple options at the
              commas.

DEFINES

       winegcc defines __WINE__, for code that needs to know when it is  being  compiled  under  Wine.  It  also
       defines WIN32, _WIN32, __WIN32, __WIN32__, __WINNT, and __WINNT__ for compatibility with MinGW.

BUGS

       The  dllimport/dllexport  attributes  are  not  supported at the moment, due to lack of support for these
       features in the ELF version of gcc.

       Static linking is not currently supported against Wine DLLs. As a  result,  the  -static,  --static,  and
       -Wl,-static options will generate an error.

       Bugs can be reported on the Wine bug tracker ⟨http://bugs.winehq.org⟩.

AUTHORS

       winegcc was written by Dimitrie O. Paun.

AVAILABILITY

       winegcc  is  part  of  the  Wine  distribution,  which  is available through WineHQ, the Wine development
       headquarters ⟨http://www.winehq.org/⟩.

SEE ALSO

       gcc(1), winebuild(1), wrc(1), wine(1),
       Wine documentation and support ⟨http://www.winehq.org/help⟩.