Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
WINEGCC(1)		     Wine Developers Manual		      WINEGCC(1)

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.

     -b,--target target
	    Specify the target architecture triplet for cross-compiling. winegcc
	    will then invoke target-gcc instead of gcc.

     --wine-objdir dir
	    Specify  the  Wine object directory. This is used when building Wine
	    itself, to use the includes and  libraries	from  inside  the  build
	    tree.

     --winebuild name
	    Specifies  the  path  and  name of the winebuild binary that will be
	    launched automatically by winegcc.	If not set,  winegcc  will  look
	    for  a  file named winebuild in the path. This takes precedence over
	    the WINEBUILD environment variable.

     -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 con-
	    sole 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 li-
	    braries 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.

     -Wl,--out-implib,lib.a
	    When linking a dll, also create its corresponding import library.

ENVIRONMENT
     WINEBUILD
	    Specifies  the  path  and  name of the winebuild binary that will be
	    launched automatically by winegcc.	If not set,  winegcc  will  look
	    for a file named winebuild in the path.

DEFINES
     winegcc defines __WINE__, for code that needs to know when it is being com-
     piled  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.

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.

SEE ALSO
     gcc(1), winebuild(1), wrc(1), wine(1),
     Wine documentation and support.

Wine 11.5			  October 2005			      WINEGCC(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=winecpp&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help