Editing MXE

Jump to navigation Jump to search

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
[https://hg.octave.org/mxe-octave MXE-Octave] was forked 2012 from the [https://mxe.cc/ MXE project] and is useful for building Octave in the following scenarios<ref>[https://hg.octave.org/mxe-octave/file/6836b2f08479/README MXE-Octave README] text by [[User:jwe|jwe]].</ref>:
Based on the [https://mxe.cc/ MXE project] there is an [https://hg.octave.org/mxe-octave MXE-Octave] fork available to allow cross compiling Octave to various target systems.
# Cross-compilation for MS Windows (see also [[Windows Installer]]) and other platforms.
=== Examples of compiling Octave for different platforms ===
# Building Octave on outdated Linux systems (e.g. only an old GCC version is available).
# Building Octave without root permission.
{{Warning|MXE-Octave is '''not''' the best choice for building Octave, if your system already provides recent versions of GCC and other required build dependencies. See [[:Category:Installation]] for other install options.}}
* '''Compiling for Windows'''
# There is some further information for using mxe-octave to build an Windows installer here: [[Windows_Installer]].
=== Example of compiling MXE-Octave ===
MXE-Octave is really intended to be used to cross compile Octave along with all dependencies for Windows systems.  It may also be used to do native builds on Windows if you have a minimal set of MinGW tools installed, or to do native builds on Linux systems.  However, it was really only intended as a way to build Octave on systems that lack sufficiently recent versions of tools and libraries to build Octave.
==== Preparation ====
'''For systems that provide packages of recent versions of GCC and required build dependencies, MXE-Octave is NOT the best choice for building Octave.'''
# [[Windows_Installer#Installing_requirements_of_MXE_Octave|Install all requirements of MXE Octave]].
* '''Compiling for your Linux system'''
# Decide for an installation directory (e.g. {{path|~/mxe-octave}}).
# Download [http://hg.octave.org/mxe-octave MXE-Octave] as a compressed file.
# <code>cd ~</code>
# Unpack it in ~ or somewhere suitable.
# <code>hg clone https://hg.octave.org/mxe-octave mxe-octave</code>
# Check you have all the [http://mxe.cc/#requirements requirements], gfortran and libgl2ps-dev.
# <code>cd mxe-octave</code>
# cd into the directory (called ~/mxe-octave-123456789 or similiar).
# <code>./bootstrap</code>
# Type: ./bootstrap
# Type: ./configure --enable-64 --enable-native-build --enable-pic-flag host_alias=gnu-linux --enable-openblas --enable-jit
# Type: make
# Type: make openblas
# cd usr/lib
# mv libblas.so libblas.so.reference
# ln -s libopenblas.so libblas.so
# Octave will exist in ~/mxe-octave-123456789/usr/bin
# Add to your .bashrc file: alias octave=~/mxe-octave-123456789/usr/bin/octave
==== Configuration ====
It's that easy...
For a comprehensive list of configuration options with a short explanation, type <code>./configure --help</code>. See also the [[#Known issues|known issues]] below.
* '''Compiling for your Ubuntu Desktop x64 Linux (tested for 14.xx)'''
# In Ubuntu Desktop Linux 14.10 the above recipe fails during building BLAS library ...
# I have found a working solution how to build Octave 3.8.2 with ---enable-64 in Ubuntu Desktop Linux - see:
# BLOG: http://calaba.tumblr.com/post/107087607479/octave-64
# GitHub: https://github.com/calaba/octave-3.8.2-enable-64-ubuntu-14.04
<syntaxhighlight lang="text">
./configure \
    --prefix=$HOME/mxe-octave \
    --enable-native-build \
    --enable-octave=release \
    --enable-64 \
    --enable-binary-packages \
    --enable-devel-tools \
    --enable-fortran-int64 \
    --enable-lib64-directory \
    --enable-openblas \
    --enable-pic-flag \
    --disable-system-fontconfig \
    --disable-system-gcc \
    --disable-system-opengl \
    --disable-system-x11-libs \
    --with-ccache \
==== Build ====
=== Note for gnuplot ===
<code>make -j3 JOBS=2 all openblas</code> Adapt the values of the variables <code>-j</code> (parallel package builds) and <code>JOBS</code> (parallel build jobs) to your needs.
The gnuplot built by mxe-octave does not support cairo based terminals and lua/tikz terminals.
If you want uses those feature, prepare gnuplot with those features and points its location setting to
==== Replace reference BLAS by OpenBLAS ====
"gnuplot_binary" like
In general using the [https://www.openblas.net/ OpenBLAS] library results in faster matrix-vector operations compared to the reference BLAS library.
# <code>cd ~/mxe-octave/usr/lib</code>
# <code>mv libblas.so libblas.so.reference</code>
# <code>ln -s libopenblas.so libblas.so</code>
==== Run ====
# MXE-Octave will exist in {{path|~/mxe-octave/usr/bin}}
# Add the command <code>octave</code> as alias to your {{path|.bashrc}} file: <code>alias octave=~/mxe-octave/usr/bin/octave</code>
# Start MXE-Octave by typing <code>octave</code>.
=== Known issues ===
==== gnuplot ====
The gnuplot built by MXE-Octave does not support cairo based terminals and lua/tikz terminals.
If you want uses those features, prepare gnuplot with those features and type in the Octave command prompt
   >> gnuplot_binary /usr/bin/gnuplot
   >> gnuplot_binary /usr/bin/gnuplot
==== Build errors on older systems ====
On some older systems, it might be useful to consider adding the configuration options
* <code>--disable-docs</code>
* <code>--disable-java</code>
in case of building errors.
=== References ===

Please note that all contributions to Octave may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see Octave:Copyrights for details). Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel Editing help (opens in new window)

Templates used on this page: