2009-09-16 14:03:18 +02:00
'\" t
2009-05-25 11:59:47 +02:00
. \"
2015-09-09 14:32:52 +02:00
.TH "\FBMAKE_WIN_BIN_DIST" "1" "04/08/2015" "MariaDB 10\&.0" "MariaDB Database System"
2009-09-16 14:03:18 +02:00
. \" -----------------------------------------------------------------
. \" * set default formatting
. \" -----------------------------------------------------------------
2009-05-25 11:59:47 +02:00
. \" disable hyphenation
.nh
. \" disable justification (adjust text to left margin only)
.ad l
2009-09-16 14:03:18 +02:00
. \" -----------------------------------------------------------------
. \" * MAIN CONTENT STARTS HERE *
. \" -----------------------------------------------------------------
. \" make_win_bin_dist
2009-05-25 11:59:47 +02:00
.SH "NAME"
make_win_bin_dist \- package MySQL distribution as ZIP archive
.SH "SYNOPSIS"
2009-09-16 14:03:18 +02:00
.HP \w '\fBmake_win_bin_dist\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR \fB \fI package_basename\fR\fR\fB\ [\fR\fB\fIcopy_def\fR\fR\fB\ \& .\&.\&.]\fR\ 'u
\fB make_win_bin_dist [\fR \fB \fI options\fR \fR \fB ] \fR \fB \fI package_basename\fR \fR \fB [\fR \fB \fI copy_def\fR \fR \fB \& .\& .\& .]\fR
2009-05-25 11:59:47 +02:00
.SH "DESCRIPTION"
.PP
2009-09-16 14:03:18 +02:00
This script is used on Windows after building a MySQL distribution from source to create executable programs\& . It packages the binaries and support files into a ZIP archive that can be unpacked at the location where you want to install MySQL\& .
2009-05-25 11:59:47 +02:00
.PP
\fB make_win_bin_dist\fR
2009-09-16 14:03:18 +02:00
is a shell script, so you must have Cygwin installed to use it\& .
2009-05-25 11:59:47 +02:00
.PP
2009-09-16 14:03:18 +02:00
This program\' s use is subject to change\& . Currently, you invoke it as follows from the root directory of your source distribution:
2009-05-25 11:59:47 +02:00
.sp
2009-09-16 14:03:18 +02:00
.if n \{ \
.RS 4
. \}
2009-05-25 11:59:47 +02:00
.nf
2009-09-16 14:03:18 +02:00
shell> \fB make_win_bin_dist [\fR \fB \fI options\fR \fR \fB ] \fR \fB \fI package_basename\fR \fR \fB [\fR \fB \fI copy_def\fR \fR \fB \& .\& .\& .]\fR
2009-05-25 11:59:47 +02:00
.fi
2009-09-16 14:03:18 +02:00
.if n \{ \
2009-05-25 11:59:47 +02:00
.RE
2009-09-16 14:03:18 +02:00
. \}
2009-05-25 11:59:47 +02:00
.PP
The
\fI package_basename\fR
2009-09-16 14:03:18 +02:00
argument provides the basename for the resulting ZIP archive\& . This name will be the name of the directory that results from unpacking the archive\& .
2009-05-25 11:59:47 +02:00
.PP
Because you might want to include files of directories from other builds, you can instruct this script do copy them in for you, via
\fI copy_def\fR
arguments, which of which is of the form
2009-09-16 14:03:18 +02:00
\fI relative_dest_name\fR =\fI source_name\fR \& .
2009-05-25 11:59:47 +02:00
.PP
Example:
.sp
2009-09-16 14:03:18 +02:00
.if n \{ \
.RS 4
. \}
2009-05-25 11:59:47 +02:00
.nf
2009-09-16 14:03:18 +02:00
bin/mysqld\- max\& .exe=\& .\& ./my\- max\- build/sql/release/mysqld\& .exe
2009-05-25 11:59:47 +02:00
.fi
2009-09-16 14:03:18 +02:00
.if n \{ \
2009-05-25 11:59:47 +02:00
.RE
2009-09-16 14:03:18 +02:00
. \}
2009-05-25 11:59:47 +02:00
.PP
2009-09-16 14:03:18 +02:00
If you specify a directory, the entire directory will be copied\& .
2009-05-25 11:59:47 +02:00
.PP
\fB make_win_bin_dist\fR
2010-04-28 15:06:11 +02:00
supports the following options\& .
2009-09-16 14:03:18 +02:00
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" make_win_bin_dist: debug option
. \" debug option: make_win_bin_dist
2009-05-25 11:59:47 +02:00
\fB \- \- debug\fR
.sp
2009-09-16 14:03:18 +02:00
Pack the debug binaries and produce an error if they were not built\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" make_win_bin_dist: embedded option
. \" embedded option: make_win_bin_dist
2009-05-25 11:59:47 +02:00
\fB \- \- embedded\fR
.sp
2009-09-16 14:03:18 +02:00
Pack the embedded server and produce an error if it was not built\& . The default is to pack it if it was built\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" make_win_bin_dist: exe-suffix option
. \" exe-suffix option: make_win_bin_dist
2009-05-25 11:59:47 +02:00
\fB \- \- exe\- suffix=\fR \fB \fI suffix\fR \fR
.sp
Add a suffix to the basename of the
\fB mysql\fR
2009-09-16 14:03:18 +02:00
binary\& . For example, a suffix of
2009-05-25 11:59:47 +02:00
\- abc
produces a binary named
2009-09-16 14:03:18 +02:00
\fB mysqld\- abc\& .exe\fR \& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" make_win_bin_dist: no-debug option
. \" no-debug option: make_win_bin_dist
2009-05-25 11:59:47 +02:00
\fB \- \- no\- debug\fR
.sp
2009-09-16 14:03:18 +02:00
Do not pack the debug binaries even if they were built\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" make_win_bin_dist: no-embedded option
. \" no-embedded option: make_win_bin_dist
2009-05-25 11:59:47 +02:00
\fB \- \- no\- embedded\fR
.sp
2009-09-16 14:03:18 +02:00
Do not pack the embedded server even if it was built\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" make_win_bin_dist: only-debug option
. \" only-debug option: make_win_bin_dist
2009-05-25 11:59:47 +02:00
\fB \- \- only\- debug\fR
.sp
Use this option when the target for this build was
Debug, and you just want to replace the normal binaries with debug versions (that is, do not use separate
2009-09-16 14:03:18 +02:00
debug
directories)\& .
.RE
2009-05-25 11:59:47 +02:00
.SH "COPYRIGHT"
2009-09-16 14:03:18 +02:00
.br
2009-05-25 11:59:47 +02:00
.PP
2015-09-09 14:32:52 +02:00
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2015 MariaDB Foundation
2009-05-25 11:59:47 +02:00
.PP
This documentation is free software; you can redistribute it and/or modify it only under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License.
.PP
This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
.PP
2009-09-16 14:03:18 +02:00
You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or see http://www.gnu.org/licenses/.
.sp
2009-05-25 11:59:47 +02:00
.SH "SEE ALSO"
2015-09-09 14:32:52 +02:00
For more information, please refer to the MariaDB Knowledge Base, available online at https://mariadb.com/kb/
2009-05-25 11:59:47 +02:00
.SH AUTHOR
2015-09-09 14:32:52 +02:00
MariaDB Foundation (http://www.mariadb.org/).