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 com-
       piler under Linux. This is most useful to Win32 developers who can sim-
       ply  take their MinGW code from Windows,	and recompile it without modi-
       fications under Winelib on Linux.  wineg++ accepts mostly the same  op-
       tions 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	prece-
	      dence 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
	      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 Cyg-
	      win libc.	Sharing	the syntax with	MinGW makes it	very  easy  to
	      write  Makefiles that work under Wine, MinGW+MSYS, or MinGW+Cyg-
	      win.

       -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	wineb-
	      uild  to build graphical applications.  -munix Set when building
	      the Unix counterpart of a	builtin	module.

       -nodefaultlibs
	      Do not use the standard system libraries when linking. These in-
	      clude at a minimum -lkernel32, -luser32, -ladvapi32, and any de-
	      fault libraries used by the backend compiler. The	-mwindows  op-
	      tion 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.

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
       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 re-
       sult, the -static, --static, and	-Wl,-static options will  generate  an
       error.

       Bugs can	be reported on the Wine	bug tracker <https://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 <https://www.winehq.org/>.

SEE ALSO
       gcc(1), winebuild(1), wrc(1), wine(1),
       Wine documentation and support <https://www.winehq.org/help>.

Wine 5.15			 October 2005			    WINEGCC(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | DEFINES | BUGS | AUTHORS | AVAILABILITY | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=winegcc&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help