oot/docs/BUILDING_CYGWIN.md

Building with Cygwin

If you want to use Cygwin, you will need to:

1. Install Cygwin (and required packages)

• Download and install Cygwin.

Run the installer and follow the steps to install a cygwin terminal.

After the "choose a download site" step, a window will pop up which will allow you to select packages. Unlike a normal linux distribution, you must install packages from this interface within the setup program. To install a package you can change View from "Pending" to "Full". Then you can enter a package name to search. After finding the package you want, change the "Skip" drop down to the version you want to install.

Use this interface to select the latest version for all of the following packages:

• make
• gcc-g++
• bison
• flex
• texinfo
• git
• libiconv
• dos2unix
• python3
• libpng-devel
• binutils (Make sure to check the "Src?" checkbox since we're interested in the source code)

2. Build mips-linux-binutils on Windows using Cygwin

For the following instructions, wherever you see binutils-[...], the [...] represents the version number. You can use tab auto-complete to fill this in.

Create destination dir for binutils

mkdir -p /opt/cross

Extract binutils source

cd /usr/src/binutils-[...].src/
tar -xf binutils-[...].tar.xz

Create and enter build dir

mkdir build-binutils
cd build-binutils

Configure the build

../binutils-[...]/configure --target=mips-linux-gnu --prefix=/opt/cross --disable-gprof --disable-nls --disable-werror --disable-gdb --disable-libdecnumber --disable-readline --disable-sim

Make and install binutils

make -j
make install -j

Add the new binutils binaries to your system PATH:

• Go to your home directory cd
• Open windows explorer in your current location explorer.exe .
• Open the .bashrc file in a text editor
• Scroll to the bottom and add PATH=$PATH:/opt/cross/bin to a new line and save the file
• Run source .bashrc or close and reopen cygwin

3. Continue with Linux instructions

You should be able to continue from step step 2 of the Linux instructions.

N.B. Before building anything, you will need to run the following commands to fix line endings:

dos2unix fixle.sh
./fixle.sh