Prefix/Cygwin

From Gentoo Wiki
< Prefix
Jump to: navigation, search
Resources

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?

Overview

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.

Restrictions

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.

Since Cygwin 3.0.0-0.8, the fork() system call is able to deal with removed or updated binaries. However, the implementation still 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. Please find more details in section Additional setup.

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:\cygwin64 (mnemo for Prefix Cygwin).

  • Windows perspective: P:\cygwin64\home\prefix
  • Cygwin perspective: /home/prefix

Remember to choose the very same NTFS partition for both the Cygwin installation directory and the Gentoo Prefix 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 and their automatically added dependencies:

  • gcc-g++
  • wget

Additional setup

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

  • Don't forget to set the executable permission when you download a precompiled cygwin1.dll using some Cygwin program. Windows programs may already set the executable permission for a downloaded dll.
  • Use your Windows utilities to replace your current cygwin1.dll with the new one, probably in C:\cygwin64\bin.
  • 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.