summaryrefslogtreecommitdiffhomepage
path: root/etc/README
diff options
context:
space:
mode:
authorLucio Andrés Illanes Albornoz (arab, vxp) <l.illanes@gmx.de>2016-11-14 23:02:47 +0100
committerLucio Andrés Illanes Albornoz (arab, vxp) <l.illanes@gmx.de>2016-11-15 20:40:50 +0100
commit59765f508225998d8a73b1da8380ff06b4a6b79c (patch)
tree9397850a4ab5bac51ec373558722c45be4fe7258 /etc/README
parent8739dbe67d82f90d1c3b63a8d07af291c4ace600 (diff)
downloadmidipix_build-59765f508225998d8a73b1da8380ff06b4a6b79c.tar.bz2
midipix_build-59765f508225998d8a73b1da8380ff06b4a6b79c.tar.xz
1) Replaces the SysV-style build script link mechanism w/ build {,meta-}targets,
2) splits build.{subr,sh}} into subr/{build,pkg,rtl}.subr and build.sh, 3) replaces {997.strip,998.midipix_sh,999.tarballs}.build with subr/{strip,tarball}.subr, 4) moves patches to patches/, vars files to vars/, and everything else to etc/, 5) renames `Create `Midipix mintty shell' shortcut.vbs' to midipix_shortcut.vbs, 6) fixes a Weechat configure issue, and 7) updates etc/{build.usage,README}.
Diffstat (limited to 'etc/README')
-rw-r--r--etc/README230
1 files changed, 230 insertions, 0 deletions
diff --git a/etc/README b/etc/README
new file mode 100644
index 00000000..5cab545e
--- /dev/null
+++ b/etc/README
@@ -0,0 +1,230 @@
+
+ Obtaining and installing a Midipix distribution
+ Last update: Sun, 24 Apr 2016 09:42:40 +0000
+
+A Midipix distribution consists of the following:
+a) the native Midipix toolchain, consisting of perk, gcc, its dependencies,
+ and binutils,
+b) musl, a lightweight, fast, simple, and free libc[1] used by Midipix,
+c) the Midipix runtime components that bridge the gap between the libc and the
+ executive subsystems of all Windows NT-derived Windows OS starting with and
+ including Windows XP, and
+d) a steadily increasing number of 3rd party open source packages, as expected in
+ any modern POSIX-compliant *nix environment, including GNU coreutils, shells,
+ libraries such as ncurses, libressl, as well as Perl and Python.
+
+Compressed Midipix distribution tarballs and, separately, source tarballs are,
+at present, produced every four (4) hours UTC after each successful build and
+subsequently signed. This process is fully automated by a portable Bourne shell
+script; all of the above mentioned components are cross-compiled.
+
+Thus, the most hassle-free way to get started with Midipix is to simply download
+the most recent distribution tarball and follow the instructions below. It is,
+however, recommended to anyone intending to use Midipix as a development platform
+to familiarise themselves with the build process. Other reasons to prefer building
+a Midipix distribution yourself include integrating new 3rd party software or local
+runtime component patches. At present, a full build from scratch takes about 30
+(thirty) minutes to finish on an 8-core host with eight simultaneous make jobs,
+minus the generation of the tarballs. The build script can be obtained from the
+following GitHub repository: <https://github.com/lalbornoz/midipix_build>.
+
+If you obtained a Midipix distribution tarball, extract it into a directory and
+drive of your choice, henceforth referred to as target directory; the drive can
+be a network drive. Do _not_ use anything but a true UNIX environment tar(1), as
+e.g. WinRAR or WinZip handle extracting hard links incorrectly.
+If you built Midipix yourself, the target directory is equivalent to the ${PREFIX}
+configured in build.vars, which defaults to ${HOME}/midipix.
+
+At present, providing an interactive Midipix environment still requires the Cygwin
+terminal emulator Mintty and a shell; this does not include pseudoterminals, which
+are entirely handled by Midipix. Both can be installed via the 64-bit Cygwin setup
+program at <https://www.cygwin.com/setup-x86_64.exe>.
+
+Once installed, launching a Midipix shell is accomplished by the `midipix.sh' shell
+script provided in the target directory from within a Cygwin shell prompt in Mintty
+and the target directory. This may either simply be done manually each time, or
+automated by a shortcut. As shortcuts cannot be distributed, it can be created by
+either:
+a) Opening (executing) the VBScript script in the target directory from within the
+ latter cscript.exe, providing the fully qualified pathname to Mintty, if it differs
+ from the default value of C:\cygwin64\bin\mintty.exe or
+b) manually creating a shortcut to Mintty with `Start in:' set to the target directory
+ and the following command line:
+ [ ... ]\mintty.exe -i /Cygwin-Terminal.ico -e sh midipix.sh, or
+
+References:
+Sun, 24 Apr 2016 09:04:08 +0000 [1] musl FAQ <http://www.musl-libc.org/faq.html>
+
+ Linux distribution-related errata
+
+Busybox based distributions need the gawk, gsed, and coreutils packages to build perl.
+
+ Midipix status report
+ Last update: Tue, 26 Apr 2016 10:16:16 +0000
+
+The following build status codes are defined:
+C -- Complete build w/ at least the default configuration,
+B -- Broken, e.g. doesn't work at all or only minimally,
+I -- Integrated (e.g. linked against) with other packages,
+E -- Extensively tested and confirmed to work by multiple sources, possibly via a testsuite,
+P -- Patches needed to build that haven't been committed upstream yet, and
+U -- Update to latest stable version or HEAD pending.
+
+Component type Name Version Status Comments
+Host toolchain binutils 2.24.51 C--EPU
+Host toolchain file 5.28 C-----
+Host toolchain gcc 4.6.4 ---EPU Excludes libstdc++
+Host toolchain musl 1.1.12 C-IEPU
+Host toolchain perk HEAD C-IE--
+Host toolchain pkgconf 0.28 C--E--
+Host toolchain slibtool 0.5.7 C--E--
+Native toolchain binutils 2.24.51 C--EPU
+Native toolchain gcc 4.6.4 ---EPU Excludes libstdc++
+Native toolchain gmp 5.1.3 C-IEPU
+Native toolchain libelf 0.8.13 C-IEP-
+Native toolchain mpc 1.0.1 C-IE-U
+Native toolchain mpfr 3.1.2 C-IE-U
+Native toolchain musl 1.1.12 C-IEPU
+Native toolchain perk HEAD C-IE--
+Native toolchain pkgconf 0.28 C-IE--
+Runtime components dalist HEAD C-IE--
+Runtime components ntapi HEAD C-IE--
+Runtime components ntcon HEAD C-IE--
+Runtime components ntctty HEAD C-IE--
+Runtime components pemagine HEAD C-IE--
+Runtime components psxscl HEAD C-IE-- Excludes clone(2) and dlopen(3)
+Runtime components psxtypes HEAD C-IE--
+Runtime components ptycon HEAD C-IE--
+3rd party libraries bzip2 1.0.6 C-IE--
+3rd party libraries curl 7.47.1 C---P-
+3rd party libraries expat 2.2.0 C-----
+3rd party libraries gdbm 1.12 C-I---
+3rd party libraries glib 2.46.2 C-I-P- Shared object not built
+3rd party libraries gzip 1.2.4 C-IE--
+3rd party libraries inputproto 2.3.2 C-----
+3rd party libraries kbproto 1.0.7 C-----
+3rd party libraries libarchive 3.1.2 C-I-P-
+3rd party libraries libassuan 2.4.3 C-I---
+3rd party libraries libevent 2.0.22-stable C-I---
+3rd party libraries libfetch 2.33 C-I-P-
+3rd party libraries libffi 3.2.1 C-I-P-
+3rd party libraries libfirm HEAD C-I-P-
+3rd party libraries libgcrypt 1.7.3 C-I---
+3rd party libraries libgpg_error 1.24 C-I-P-
+3rd party libraries libICE 1.0.9 C-----
+3rd party libraries libksba 1.3.5 C-I-P-
+3rd party libraries libpipeline 1.4.1 C-I---
+3rd party libraries libpthread-stubs 0.3 C-----
+3rd party libraries libressl 2.2.6 C-I-P-
+3rd party libraries libSM 1.2.2 C-----
+3rd party libraries libX11 1.6.3 C-----
+3rd party libraries libXau 1.0.8 C-----
+3rd party libraries libXaw 1.0.13 C-----
+3rd party libraries libXext 1.3.3 C-----
+3rd party libraries libxkbfile 1.0.9 C-----
+3rd party libraries libXmu 1.1.2 C-----
+3rd party libraries libXpm 3.5.11 C-----
+3rd party libraries libXt 1.1.5 C-----
+3rd party libraries libz 1.2.8.2015.05.20 C-I---
+3rd party libraries lua 5.3.3 C---P-
+3rd party libraries ncurses 6.0 C-IEP- ncurses, ncursestw, and ncursesw built
+3rd party libraries npth 1.2 C-I---
+3rd party libraries pcre 8.39 C-I---
+3rd party libraries renderproto 0.11.1 C-----
+3rd party libraries xcb 1.12 C----- Needs pthreads / clone(2)
+3rd party libraries xcb-proto 1.12 C-----
+3rd party libraries xextproto 7.3.0 C-----
+3rd party libraries xproto 7.0.29 C-----
+3rd party libraries Xrender 0.9.9 C-----
+3rd party libraries xtrans 1.1 C-----
+3rd party libraries xz 5.2.2 C-IE--
+3rd party packages apk_tools 2.6.6 C---P-
+3rd party packages bash 4.3 C-I-P- Linked against ncursesw
+3rd party packages coreutils 8.23 C---P- Needs extensive testing
+3rd party packages cparser HEAD C-I-P-
+3rd party packages cron HEAD C---P-
+3rd party packages dash 0.5.8 C----- Provides /bin/sh
+3rd party packages diffutils 3.3 C-----
+3rd party packages dos2unix 7.3.4 C-----
+3rd party packages ed 1.13 C-----
+3rd party packages file 5.28 C-----
+3rd party packages findutils 4.5.14 C---P-
+3rd party packages gawk 4.1.3 C-----
+3rd party packages git 2.7.1 C----- Needs clone(2)
+3rd party packages gnupg 2.1.15 C----- Needs /dev/[u]random, extensive testing
+3rd party packages grep 2.22 C-----
+3rd party packages hexcurse 1.60.0 C-I-P- Linked against ncursesw
+3rd party packages htop 2.0.1 C-I-P- Linked against ncursesw
+3rd party packages inetutils 1.9.4 C-----
+3rd party packages infounzip 6.0 C-----
+3rd party packages infozip 3.0 C-----
+3rd party packages irssi 0.8.18 CB--P- DNS and /EXEC require clone(2) due to pthreads (see psxscl;) no Perl support
+3rd party packages john 1.8.0 C---P-
+3rd party packages less 481 C-I--- Linked against ncursesw
+3rd party packages lynx 2.8.8rel2 C-----
+3rd party packages make 3.81 C-----
+3rd party packages man_db 2.7.5 C-----
+3rd party packages mc 4.8.17 C-----
+3rd party packages mksh R52c C-----
+3rd party packages nano 2.5.3 C-I--- Linked against ncursesw
+3rd party packages netcat 110 C---P-
+3rd party packages openssh 7.1p2 C-I--- Linked against libressl
+3rd party packages p7zip HEAD C-----
+3rd party packages pacman 5.0.1 C---P-
+3rd party packages patch 2.7 C-----
+3rd party packages perl 5.22.1 ------ No dlopen(3) (see psxscl,) modules missing
+3rd party packages procps-ng 3.3.12 C-----
+3rd party packages python 3.5.1 -B--P- No dlopen(3) (see psxscl,) modules missing
+3rd party packages rsync 3.1.2 C-----
+3rd party packages rxvt-unicode 9.22 C-I--- No Perl support
+3rd party packages sed 4.2.2 C-----
+3rd party packages tar 1.28 C-----
+3rd party packages tcsh 6.19.00 C-I-P-
+3rd party packages the silver searcher 0.32.0 C-----
+3rd party packages tmux 2.2 C---P-
+3rd party packages util_linux 2.27.1 C----- Needs extensive testing
+3rd party packages vim 7.4.1952 C----- Provides /bin/vi
+3rd party packages weechat 1.6 C-----
+3rd party packages which 2.21 C-----
+3rd party packages whois 5.2.12 C-----
+3rd party packages xeyes 1.1.1 C-I---
+3rd party packages xwd 1.0.6 C-I---
+3rd party packages zsh 5.2 C-I--- Linked against ncursesw
+
+ Midipix roadmap/TODO list
+ Last update: Fri, 03 Jun 2016 12:47:13 +0000
+
+midipix alpha release: the final stretch
+========================================
+
+my.own.tasks@midipix.org
+------------------------
+
+* ofd tables: additional bucket allocation as needed.
+* `ls -R //c`: check for the cause of individual failures.
+ (might be related to the above ofd bucket allocation).
+* integrate clone and the initial ldso implementation.
+* integrate the signal queue, check signal implementation for
+ semantic completion, especially in the context of multi-threaded
+ applications.
+* implement /dev/random and /dev/urandom, as well as other virtual
+ folders needed by core applications.
+* implement the scheduler functions.
+* implement (possibly as stubs) missing system calls, fix existing
+ system calls as needed by the core applications.
+* toolchain: provided the few interfaces missing for C++ support.
+* porting of mintty.
+
+
+porting and other release-related tasks
+---------------------------------------
+
+* testing of ncurses.
+* testing of bash and dash when built with ncurses.
+* testing of all of the coreutils, seeing which ones fail due to
+ a missing virtual file or folder, which ones fail due to a missing
+ system call (crash), and which ones fail due to an incomplete or
+ incorrect system call.
+* porting of gdb.
+
+vim:expandtab sw=8 ts=8 tw=0 nowrap