2006-03-15 12:20:27 +01:00
|
|
|
Windows building readme
|
|
|
|
|
======================================
|
|
|
|
|
|
|
|
|
|
----------------IMPORTANT----------------------------
|
|
|
|
|
This readme outlines the instructions for building
|
|
|
|
|
MySQL for Windows staring from version 5.1.
|
|
|
|
|
This readme does not apply to MySQL versions 5.0
|
|
|
|
|
or ealier.
|
|
|
|
|
-----------------------------------------------------
|
|
|
|
|
|
|
|
|
|
The Windows build system uses a tool named CMake to generate build files for
|
|
|
|
|
a variety of project systems. This tool is combined with a set of jscript
|
|
|
|
|
files to enable building of MySQL for Windows directly out of a bk clone.
|
|
|
|
|
The steps required are below.
|
|
|
|
|
|
2007-02-23 21:48:15 +01:00
|
|
|
Step 1:
|
|
|
|
|
-------
|
|
|
|
|
|
|
|
|
|
Install a Windows C++ compiler. If you don't have one, you can use
|
|
|
|
|
the free compiler "Visual C++ 2005 express edition", which from Cmake
|
|
|
|
|
point of view is same as Visual studio 8:
|
|
|
|
|
http://msdn.microsoft.com/vstudio/express/
|
|
|
|
|
|
|
|
|
|
Step 2
|
2006-03-15 12:20:27 +01:00
|
|
|
------
|
|
|
|
|
Download and install CMake. It can be downloaded from http://www.cmake.org.
|
|
|
|
|
Once it is installed, modify your path to make sure you can execute
|
|
|
|
|
the cmake binary.
|
|
|
|
|
|
2007-02-23 21:48:15 +01:00
|
|
|
Step 3
|
2006-03-15 12:20:27 +01:00
|
|
|
------
|
|
|
|
|
Download and install bison for Windows. It can be downloaded from
|
|
|
|
|
http://gnuwin32.sourceforge.net/packages/bison.htm. Please download using
|
|
|
|
|
the link named "Complete package, excluding sources". This includes an
|
|
|
|
|
installer that will install bison. After the installer finishes, modify
|
|
|
|
|
your path so that you can execute bison.
|
|
|
|
|
|
WL#3817: Simplify string / memory area types and make things more consistent (first part)
The following type conversions was done:
- Changed byte to uchar
- Changed gptr to uchar*
- Change my_string to char *
- Change my_size_t to size_t
- Change size_s to size_t
Removed declaration of byte, gptr, my_string, my_size_t and size_s.
Following function parameter changes was done:
- All string functions in mysys/strings was changed to use size_t
instead of uint for string lengths.
- All read()/write() functions changed to use size_t (including vio).
- All protocoll functions changed to use size_t instead of uint
- Functions that used a pointer to a string length was changed to use size_t*
- Changed malloc(), free() and related functions from using gptr to use void *
as this requires fewer casts in the code and is more in line with how the
standard functions work.
- Added extra length argument to dirname_part() to return the length of the
created string.
- Changed (at least) following functions to take uchar* as argument:
- db_dump()
- my_net_write()
- net_write_command()
- net_store_data()
- DBUG_DUMP()
- decimal2bin() & bin2decimal()
- Changed my_compress() and my_uncompress() to use size_t. Changed one
argument to my_uncompress() from a pointer to a value as we only return
one value (makes function easier to use).
- Changed type of 'pack_data' argument to packfrm() to avoid casts.
- Changed in readfrm() and writefrom(), ha_discover and handler::discover()
the type for argument 'frmdata' to uchar** to avoid casts.
- Changed most Field functions to use uchar* instead of char* (reduced a lot of
casts).
- Changed field->val_xxx(xxx, new_ptr) to take const pointers.
Other changes:
- Removed a lot of not needed casts
- Added a few new cast required by other changes
- Added some cast to my_multi_malloc() arguments for safety (as string lengths
needs to be uint, not size_t).
- Fixed all calls to hash-get-key functions to use size_t*. (Needed to be done
explicitely as this conflict was often hided by casting the function to
hash_get_key).
- Changed some buffers to memory regions to uchar* to avoid casts.
- Changed some string lengths from uint to size_t.
- Changed field->ptr to be uchar* instead of char*. This allowed us to
get rid of a lot of casts.
- Some changes from true -> TRUE, false -> FALSE, unsigned char -> uchar
- Include zlib.h in some files as we needed declaration of crc32()
- Changed MY_FILE_ERROR to be (size_t) -1.
- Changed many variables to hold the result of my_read() / my_write() to be
size_t. This was needed to properly detect errors (which are
returned as (size_t) -1).
- Removed some very old VMS code
- Changed packfrm()/unpackfrm() to not be depending on uint size
(portability fix)
- Removed windows specific code to restore cursor position as this
causes slowdown on windows and we should not mix read() and pread()
calls anyway as this is not thread safe. Updated function comment to
reflect this. Changed function that depended on original behavior of
my_pwrite() to itself restore the cursor position (one such case).
- Added some missing checking of return value of malloc().
- Changed definition of MOD_PAD_CHAR_TO_FULL_LENGTH to avoid 'long' overflow.
- Changed type of table_def::m_size from my_size_t to ulong to reflect that
m_size is the number of elements in the array, not a string/memory
length.
- Moved THD::max_row_length() to table.cc (as it's not depending on THD).
Inlined max_row_length_blob() into this function.
- More function comments
- Fixed some compiler warnings when compiled without partitions.
- Removed setting of LEX_STRING() arguments in declaration (portability fix).
- Some trivial indentation/variable name changes.
- Some trivial code simplifications:
- Replaced some calls to alloc_root + memcpy to use
strmake_root()/strdup_root().
- Changed some calls from memdup() to strmake() (Safety fix)
- Simpler loops in client-simple.c
2007-05-10 11:59:39 +02:00
|
|
|
(As an alternative you can take the sql_yacc.yy and sql_yacc.h files from a
|
2007-02-23 21:48:15 +01:00
|
|
|
matching mysql tar distribution and drop them into the sql directory just
|
|
|
|
|
before you start the build)
|
|
|
|
|
|
|
|
|
|
Step 4
|
2006-03-15 12:20:27 +01:00
|
|
|
------
|
|
|
|
|
Clone your bk tree to any location you like.
|
|
|
|
|
|
2007-02-23 21:48:15 +01:00
|
|
|
Step 5
|
2006-03-15 12:20:27 +01:00
|
|
|
------
|
WL#3817: Simplify string / memory area types and make things more consistent (first part)
The following type conversions was done:
- Changed byte to uchar
- Changed gptr to uchar*
- Change my_string to char *
- Change my_size_t to size_t
- Change size_s to size_t
Removed declaration of byte, gptr, my_string, my_size_t and size_s.
Following function parameter changes was done:
- All string functions in mysys/strings was changed to use size_t
instead of uint for string lengths.
- All read()/write() functions changed to use size_t (including vio).
- All protocoll functions changed to use size_t instead of uint
- Functions that used a pointer to a string length was changed to use size_t*
- Changed malloc(), free() and related functions from using gptr to use void *
as this requires fewer casts in the code and is more in line with how the
standard functions work.
- Added extra length argument to dirname_part() to return the length of the
created string.
- Changed (at least) following functions to take uchar* as argument:
- db_dump()
- my_net_write()
- net_write_command()
- net_store_data()
- DBUG_DUMP()
- decimal2bin() & bin2decimal()
- Changed my_compress() and my_uncompress() to use size_t. Changed one
argument to my_uncompress() from a pointer to a value as we only return
one value (makes function easier to use).
- Changed type of 'pack_data' argument to packfrm() to avoid casts.
- Changed in readfrm() and writefrom(), ha_discover and handler::discover()
the type for argument 'frmdata' to uchar** to avoid casts.
- Changed most Field functions to use uchar* instead of char* (reduced a lot of
casts).
- Changed field->val_xxx(xxx, new_ptr) to take const pointers.
Other changes:
- Removed a lot of not needed casts
- Added a few new cast required by other changes
- Added some cast to my_multi_malloc() arguments for safety (as string lengths
needs to be uint, not size_t).
- Fixed all calls to hash-get-key functions to use size_t*. (Needed to be done
explicitely as this conflict was often hided by casting the function to
hash_get_key).
- Changed some buffers to memory regions to uchar* to avoid casts.
- Changed some string lengths from uint to size_t.
- Changed field->ptr to be uchar* instead of char*. This allowed us to
get rid of a lot of casts.
- Some changes from true -> TRUE, false -> FALSE, unsigned char -> uchar
- Include zlib.h in some files as we needed declaration of crc32()
- Changed MY_FILE_ERROR to be (size_t) -1.
- Changed many variables to hold the result of my_read() / my_write() to be
size_t. This was needed to properly detect errors (which are
returned as (size_t) -1).
- Removed some very old VMS code
- Changed packfrm()/unpackfrm() to not be depending on uint size
(portability fix)
- Removed windows specific code to restore cursor position as this
causes slowdown on windows and we should not mix read() and pread()
calls anyway as this is not thread safe. Updated function comment to
reflect this. Changed function that depended on original behavior of
my_pwrite() to itself restore the cursor position (one such case).
- Added some missing checking of return value of malloc().
- Changed definition of MOD_PAD_CHAR_TO_FULL_LENGTH to avoid 'long' overflow.
- Changed type of table_def::m_size from my_size_t to ulong to reflect that
m_size is the number of elements in the array, not a string/memory
length.
- Moved THD::max_row_length() to table.cc (as it's not depending on THD).
Inlined max_row_length_blob() into this function.
- More function comments
- Fixed some compiler warnings when compiled without partitions.
- Removed setting of LEX_STRING() arguments in declaration (portability fix).
- Some trivial indentation/variable name changes.
- Some trivial code simplifications:
- Replaced some calls to alloc_root + memcpy to use
strmake_root()/strdup_root().
- Changed some calls from memdup() to strmake() (Safety fix)
- Simpler loops in client-simple.c
2007-05-10 11:59:39 +02:00
|
|
|
From the root of your installation directory, execute the command:
|
|
|
|
|
|
|
|
|
|
win\configure <options>
|
|
|
|
|
|
|
|
|
|
The options right now are:
|
2006-03-23 16:34:52 +01:00
|
|
|
|
|
|
|
|
WITH_INNOBASE_STORAGE_ENGINE Enable particular storage engines
|
|
|
|
|
WITH_PARTITION_STORAGE_ENGINE
|
|
|
|
|
WITH_ARCHIVE_STORAGE_ENGINE
|
|
|
|
|
WITH_BLACKHOLE_STORAGE_ENGINE
|
|
|
|
|
WITH_EXAMPLE_STORAGE_ENGINE
|
|
|
|
|
WITH_FEDERATED_STORAGE_ENGINE
|
|
|
|
|
__NT__ Enable named pipe support
|
2009-03-06 19:25:38 +01:00
|
|
|
WITHOUT_ATOMICS Do not use atomic instructions
|
2006-03-23 16:34:52 +01:00
|
|
|
MYSQL_SERVER_SUFFIX=<suffix> Server suffix, default none
|
|
|
|
|
COMPILATION_COMMENT=<comment> Server comment, default "Source distribution"
|
|
|
|
|
MYSQL_TCP_PORT=<port> Server port, default 3306
|
2007-04-23 22:23:32 +02:00
|
|
|
CYBOZU Default character set is UTF8
|
|
|
|
|
EMBED_MANIFESTS Embed custom manifests into final exes, otherwise VS
|
2007-07-25 19:33:39 +02:00
|
|
|
default will be used. (Note - This option should only be
|
|
|
|
|
used by MySQL AB.)
|
CMakeLists.txt (many), win/README, mysql_manifest.cmake, configure.js:
Additional changes for bug#29903
- Changed to do embedded build part as normal build, when
WITH_EMBEDDED_SERVER is set.
- Allow both normal and debug build with embedded.
- Build static embedded library by pointing out all source and compile
it all, i.e. not building libraries from libraries, not portable.
- Let embedded use generated files from the "sql" directory, added
dependencies to make sure built before embedded.
- Mark library "dbug" in TARGET_LINK_LIBRARIES() with "debug", so only
linked in when debug target is used.
- Removed change of target name with "mysqld${MYSQLD_EXE_SUFFIX}", as
others can't depend on it, not defined at configure time. Instead
set the output file name.
- Created work around for bug in CMake 2.4.6 and output names, to
set the "mysqld<suffix>.pdb" name to the same base name.
- Set the correct manifest "name" (patch by iggy)
2007-08-06 23:16:01 +02:00
|
|
|
WITH_EMBEDDED_SERVER Configure solution to produce libmysqld.dll
|
|
|
|
|
and the static mysqlserver.lib
|
2007-07-25 19:33:39 +02:00
|
|
|
|
2006-03-23 16:34:52 +01:00
|
|
|
So the command line could look like:
|
|
|
|
|
|
|
|
|
|
win\configure WITH_INNOBASE_STORAGE_ENGINE WITH_PARTITION_STORAGE_ENGINE MYSQL_SERVER_SUFFIX=-pro
|
2006-03-15 12:20:27 +01:00
|
|
|
|
2007-02-23 21:48:15 +01:00
|
|
|
Step 6
|
2006-03-15 12:20:27 +01:00
|
|
|
------
|
WL#3817: Simplify string / memory area types and make things more consistent (first part)
The following type conversions was done:
- Changed byte to uchar
- Changed gptr to uchar*
- Change my_string to char *
- Change my_size_t to size_t
- Change size_s to size_t
Removed declaration of byte, gptr, my_string, my_size_t and size_s.
Following function parameter changes was done:
- All string functions in mysys/strings was changed to use size_t
instead of uint for string lengths.
- All read()/write() functions changed to use size_t (including vio).
- All protocoll functions changed to use size_t instead of uint
- Functions that used a pointer to a string length was changed to use size_t*
- Changed malloc(), free() and related functions from using gptr to use void *
as this requires fewer casts in the code and is more in line with how the
standard functions work.
- Added extra length argument to dirname_part() to return the length of the
created string.
- Changed (at least) following functions to take uchar* as argument:
- db_dump()
- my_net_write()
- net_write_command()
- net_store_data()
- DBUG_DUMP()
- decimal2bin() & bin2decimal()
- Changed my_compress() and my_uncompress() to use size_t. Changed one
argument to my_uncompress() from a pointer to a value as we only return
one value (makes function easier to use).
- Changed type of 'pack_data' argument to packfrm() to avoid casts.
- Changed in readfrm() and writefrom(), ha_discover and handler::discover()
the type for argument 'frmdata' to uchar** to avoid casts.
- Changed most Field functions to use uchar* instead of char* (reduced a lot of
casts).
- Changed field->val_xxx(xxx, new_ptr) to take const pointers.
Other changes:
- Removed a lot of not needed casts
- Added a few new cast required by other changes
- Added some cast to my_multi_malloc() arguments for safety (as string lengths
needs to be uint, not size_t).
- Fixed all calls to hash-get-key functions to use size_t*. (Needed to be done
explicitely as this conflict was often hided by casting the function to
hash_get_key).
- Changed some buffers to memory regions to uchar* to avoid casts.
- Changed some string lengths from uint to size_t.
- Changed field->ptr to be uchar* instead of char*. This allowed us to
get rid of a lot of casts.
- Some changes from true -> TRUE, false -> FALSE, unsigned char -> uchar
- Include zlib.h in some files as we needed declaration of crc32()
- Changed MY_FILE_ERROR to be (size_t) -1.
- Changed many variables to hold the result of my_read() / my_write() to be
size_t. This was needed to properly detect errors (which are
returned as (size_t) -1).
- Removed some very old VMS code
- Changed packfrm()/unpackfrm() to not be depending on uint size
(portability fix)
- Removed windows specific code to restore cursor position as this
causes slowdown on windows and we should not mix read() and pread()
calls anyway as this is not thread safe. Updated function comment to
reflect this. Changed function that depended on original behavior of
my_pwrite() to itself restore the cursor position (one such case).
- Added some missing checking of return value of malloc().
- Changed definition of MOD_PAD_CHAR_TO_FULL_LENGTH to avoid 'long' overflow.
- Changed type of table_def::m_size from my_size_t to ulong to reflect that
m_size is the number of elements in the array, not a string/memory
length.
- Moved THD::max_row_length() to table.cc (as it's not depending on THD).
Inlined max_row_length_blob() into this function.
- More function comments
- Fixed some compiler warnings when compiled without partitions.
- Removed setting of LEX_STRING() arguments in declaration (portability fix).
- Some trivial indentation/variable name changes.
- Some trivial code simplifications:
- Replaced some calls to alloc_root + memcpy to use
strmake_root()/strdup_root().
- Changed some calls from memdup() to strmake() (Safety fix)
- Simpler loops in client-simple.c
2007-05-10 11:59:39 +02:00
|
|
|
|
|
|
|
|
From the root of your installation directory/bk clone, execute one of
|
|
|
|
|
the batch files to generate the type of project files you desire.
|
2006-03-15 12:20:27 +01:00
|
|
|
|
2007-02-23 21:48:15 +01:00
|
|
|
For Visual Studio 8 (or Visual C++ 2005 express edition), do win\build-vs8.
|
2006-03-15 12:20:27 +01:00
|
|
|
For Visual Studio 7.1, do win\build-vs71.
|
|
|
|
|
|
|
|
|
|
We will support building with nmake in the near future.
|
|
|
|
|
|
2007-02-23 21:48:15 +01:00
|
|
|
Step 7
|
2006-03-15 12:20:27 +01:00
|
|
|
------
|
|
|
|
|
From the root of your bk clone, start your build.
|
|
|
|
|
|
WL#3817: Simplify string / memory area types and make things more consistent (first part)
The following type conversions was done:
- Changed byte to uchar
- Changed gptr to uchar*
- Change my_string to char *
- Change my_size_t to size_t
- Change size_s to size_t
Removed declaration of byte, gptr, my_string, my_size_t and size_s.
Following function parameter changes was done:
- All string functions in mysys/strings was changed to use size_t
instead of uint for string lengths.
- All read()/write() functions changed to use size_t (including vio).
- All protocoll functions changed to use size_t instead of uint
- Functions that used a pointer to a string length was changed to use size_t*
- Changed malloc(), free() and related functions from using gptr to use void *
as this requires fewer casts in the code and is more in line with how the
standard functions work.
- Added extra length argument to dirname_part() to return the length of the
created string.
- Changed (at least) following functions to take uchar* as argument:
- db_dump()
- my_net_write()
- net_write_command()
- net_store_data()
- DBUG_DUMP()
- decimal2bin() & bin2decimal()
- Changed my_compress() and my_uncompress() to use size_t. Changed one
argument to my_uncompress() from a pointer to a value as we only return
one value (makes function easier to use).
- Changed type of 'pack_data' argument to packfrm() to avoid casts.
- Changed in readfrm() and writefrom(), ha_discover and handler::discover()
the type for argument 'frmdata' to uchar** to avoid casts.
- Changed most Field functions to use uchar* instead of char* (reduced a lot of
casts).
- Changed field->val_xxx(xxx, new_ptr) to take const pointers.
Other changes:
- Removed a lot of not needed casts
- Added a few new cast required by other changes
- Added some cast to my_multi_malloc() arguments for safety (as string lengths
needs to be uint, not size_t).
- Fixed all calls to hash-get-key functions to use size_t*. (Needed to be done
explicitely as this conflict was often hided by casting the function to
hash_get_key).
- Changed some buffers to memory regions to uchar* to avoid casts.
- Changed some string lengths from uint to size_t.
- Changed field->ptr to be uchar* instead of char*. This allowed us to
get rid of a lot of casts.
- Some changes from true -> TRUE, false -> FALSE, unsigned char -> uchar
- Include zlib.h in some files as we needed declaration of crc32()
- Changed MY_FILE_ERROR to be (size_t) -1.
- Changed many variables to hold the result of my_read() / my_write() to be
size_t. This was needed to properly detect errors (which are
returned as (size_t) -1).
- Removed some very old VMS code
- Changed packfrm()/unpackfrm() to not be depending on uint size
(portability fix)
- Removed windows specific code to restore cursor position as this
causes slowdown on windows and we should not mix read() and pread()
calls anyway as this is not thread safe. Updated function comment to
reflect this. Changed function that depended on original behavior of
my_pwrite() to itself restore the cursor position (one such case).
- Added some missing checking of return value of malloc().
- Changed definition of MOD_PAD_CHAR_TO_FULL_LENGTH to avoid 'long' overflow.
- Changed type of table_def::m_size from my_size_t to ulong to reflect that
m_size is the number of elements in the array, not a string/memory
length.
- Moved THD::max_row_length() to table.cc (as it's not depending on THD).
Inlined max_row_length_blob() into this function.
- More function comments
- Fixed some compiler warnings when compiled without partitions.
- Removed setting of LEX_STRING() arguments in declaration (portability fix).
- Some trivial indentation/variable name changes.
- Some trivial code simplifications:
- Replaced some calls to alloc_root + memcpy to use
strmake_root()/strdup_root().
- Changed some calls from memdup() to strmake() (Safety fix)
- Simpler loops in client-simple.c
2007-05-10 11:59:39 +02:00
|
|
|
For Visual Studio, execute mysql.sln. This will start the IDE
|
|
|
|
|
and you can click the build solution menu option.
|
2006-03-15 12:20:27 +01:00
|
|
|
|
|
|
|
|
Current issues
|
|
|
|
|
--------------
|
2006-03-23 16:34:52 +01:00
|
|
|
1. After changing configuration (eg. adding or removing a storage engine), it
|
|
|
|
|
may be necessary to clean the build tree to remove any stale objects.
|
2006-04-10 18:44:55 +02:00
|
|
|
|
|
|
|
|
2. To use Visual C++ Express Edition you also need to install the Platform SDK.
|
|
|
|
|
Please see this link: http://msdn.microsoft.com/vstudio/express/visualc/usingpsdk/
|
2007-02-27 18:31:49 +01:00
|
|
|
At step 5 you only need to add the libraries advapi32.lib and user32.lib to
|
2006-04-10 18:44:55 +02:00
|
|
|
the file "corewin_express.vsprops" in order to avoid link errors.
|