WineHQ
WineHQ

2.2. C library

There are two choices available to you regarding which C library to use: the native glibc C library or the msvcrt C library.

Note that under Wine, the crtdll library is implemented using msvcrt, so there is no benefit in trying to use it.

Using glibc in general has the lowest overhead, but this is really only important for file I/O, as many of the functions in msvcrt are simply resolved to glibc.

To use glibc, you don't need to make changes to your application; it should work straight away. There are a few situations in which using glibc is not possible:

  1. Your application uses Win32 and C library unicode functions.

  2. Your application uses MS specific calls like beginthread(), loadlibrary(), etc.

  3. You rely on the precise semantics of the calls, for example, returning -1 rather than non-zero. More likely, your application will rely on calls like fopen() taking a Windows path rather than a Unix one.

In these cases you should use msvcrt to provide your C runtime calls.

Add -mno-cygwin to your compiler flags. This will cause winebuild to resolve your C library calls to msvcrt.dll. Many simple calls which behave the same have been specified as non-importable from msvcrt; in these cases winebuild will not resolve them and the standard linker ld will link to the glibc version instead.

In order to avoid warnings in C (and potential errors in C++) from not having prototypes, you may need to use a set of MS compatible header files. These are scheduled for inclusion into Wine but at the time of writing are not available. Until they are, you can try prototyping the functions you need, or just live with the warnings.

If you have a set of include files (or when they are available in Wine), you need to use the -isystem include_path flag to gcc to tell it to use your headers in preference to the local system headers.

To use option 3, add the names of any symbols that you don't want to use from msvcrt into your applications .spec file. For example, if you wanted the MS specific functions, but not file I/O, you could have a list like:

@ignore = ( fopen fclose fwrite fread fputs fgets )

Obviously, the complete list would be much longer. Remember too that some functions are implemented with an underscore in their name and #defined to that name in the MS headers. So you may need to find out the name by examining dlls/msvcrt/msvcrt.spec to get the correct name for your @ignore entry.