From Gentoo Wiki
< Prefix
Jump to: navigation, search

This article provides instructions for any poor soul attempting to bootstrap Gentoo Prefix on Cygwin.

Preface: Prefix on Cygwin

How to bootstrap Gentoo Prefix on Cygwin?


At the beginning some general advice is given on how to setup Cygwin. There are a few restrictions for the Cygwin setup that users need to bear in mind to have success with Gentoo Prefix on Cygwin.

What is this?

There was also a project "Gentoo on Cygwin" which is unmaintained as of 2008. Note the difference to "Gentoo Prefix on Cygwin". "Gentoo Prefix on Cygwin" is not a project itself but simply a try to run the well maintained "Gentoo Prefix" sources on Cygwin.

Why do this?

Running Prefix on Cygwin provides the same runtime environment on Windows as possible on Linux or Mac. It brings much more options than a Java runtime environment and it requires less resources than a virtual machine. Additionally, any program can be compiled by using Gentoo's package manager. Finally, all this happens in the userspace which provides independence from the administrator account. Nothing compares to this.


Unix/Linux based package managers usually do require the fork() system call, which is not available in Windows in general. Nevertheless, Cygwin implements the fork() system call using the CreateProcess() and LoadLibrary() Windows calls, combined with sophisticated duplication of process memory, loaded libraries and open handles into the child process.

But this requires CreateProcess() and LoadLibrary() to locate the very same binaries (executable and DLLs) as loaded in the parent process.

Imagine what happens when the package manager has replaced these binaries, while existing processes (including the package manager itself) still want to fork.

Fortunately, Cygwin 3.0 (not released yet - April 2017) or newer provides an improved implementation of the fork() system call, which is able to deal with removed or updated binaries. But this implementation imposes some additional requirements to the Cygwin setup to actually work.

  • An NTFS file system for the Cygwin installation to install into.
  • Use this very same NTFS file system for Gentoo Prefix to install into.

The reason here is that the original executables are hardlinked into the /var/run/cygfork/ directory.

Note that Cygwin has discontinued support for Windows XP and Server 2003.

Installing Cygwin

Cygwin comes with a full featured installer that explains itself:

Space and paths

Before installing Cygwin consider the pathname. Use a windows user account without whitespace in the username. Not all scripts can handle whitespace in pathes. Have enough free space, minimum 4 GB, take 10 GB if available.

Let's assume "prefix" has been chosen as the username and Cygwin is installed at P:\cygwin (mnemo for Prefix Cygwin).

Windows perspective: P:\cygwin\home\prefix Cygwin perspective: /home/prefix

Remember to choose an NTFS partition as the Cygwin installation directory.

User and permissions

Install Cygwin from the same windows account that will be using it. This way some trouble can be avoided with user permissions and administration.

Additional packages

The Gentoo Prefix bootstrap aims to require as less as possible packages installed on the underlying operating system. However, a minimal set of compilation environment plus some download tool is required. In addition to the default selection done by the Cygwin setup please install these additional packages:

  • gcc-core
  • gcc-g++
  • wget

Additional setup

The fork feature mentioned above is disabled by default, it will need to be enabled manually:

  • Don't forget to set the executable permission for when you downloaded a precompiled cygwin1.dll!
  • Create the /var/run/cygfork/ Cygwin directory; the Cygwin setup does not create it. To do so start the mintty console and run:
user $mkdir --mode=a=rwxt /var/run/cygfork
  • Finally, reboot Windows, to make sure the initial Cygwin process started already finds the /var/run/cygfork/ directory in place, to actually activate the fork handler for removed or replaced binaries for this Cygwin instance.

Install Gentoo Prefix

Simply follow the general bootstrap process.

External resources

  • Interix - A now deprecated, optional, POSIX-conformant Unix subsystem for Windows NT operating systems.