README FILE FOR uCRUX Linux release 2.0.1 Sep 20 2004 INTRODUCTION uCRUX is a port of CRUX Linux by Per Lidén (http://www.crux.nu) using the uClibc C library (http://www.uclibc.org). It is mainly intended as a standalone development environment for uClibc related projects. DOCUMENTATION For installation, usage and other information please refer to the CRUX handbook, available at CRUX Home Page or in the /crux directory of the uCRUX Linux cdrom. Differences from the original CRUX Linux are discussed in the next section. DIFFERENCES WITH CRUX Here a small list of differences between CRUX and uCRUX: - All packages compiled with -march=i486 - uCRUX uses the uclibc library instead of GNU libc. After all it's what this distribution is about. - The Pico editor has been replaced by nano on the uCRUX cdrom. - The /contrib collection included in the uCRUX cdrom is a small set of ports I personally find useful to have available at installation time, or are an alternative to missing packages (see section 'missing packages') - The port system uses httpup by Johannes Winkelmann by default (though cvsup is included as well). If you install the "ports" port from the opt collection, please be sure also to install curl and httpup from the contrib collection. The httpup repositories are currently located in a temporary site, this is very likely going to change in the future. - The kernel and ports are the latest available resp. from kernel.org and the CRUX ports tree. There could be some rare exception (i.e. latest tar version has problems with uClibc) MISSING PACKAGES Here's a detailed list of missing packages from CRUX: Missing Package Reason Alternative --------------------------------------------------------------------- base/glibc need to ask? base/uclibc base/sendmail could not compile contrib/qmail opt/emacs could not compile contrib/zile opt/firefox segfaults contrib/elinks opt/libstdc++-compat not needed? n.a. opt/nfs-utils could not compile n.a. opt/xfsprogs could not compile n.a. --------------------------------------------------------------------- I'm working on packages marked as "could not compile" in order to make uCRUX as similar as possible to the standard CRUX distribution. Your help patching the offending packages is welcome. KNOWN PROBLEMS - psmisc binaries (pstree, killall) does not seem to work correctly, you'll have to stick with good old ps & kill for the moment. - The kernel loudly complains about /dev/md/dxxx files, at boot time; I didn't have the time to have a look at the issue yet. - I did not make extensive tests on the packages (and uclibc related patches). Some patch is really a quick hack to make a port compile or work, without thinking too much about side-effects (see findutils-uclibc.patch). CHANGELOG Version 2.0 was a 'nice try', since a lot of ports from the opt collection were absent. Version 2.0.1 is to be considered the first 'official' release. A proper changelog will be included in future releases. AUTHORS AND AKNOWLEDGEMENTS Simone Rota Created uCRUX, wrote this document. Sven Dahl Many ports and patches are from Sven's ucrux repository. (most notably the gcc port) The folks at uclibc.org, uclibc-lfs, Rob McMullen (uClibc gentoo) Documentation, patches and ideas as been taken from this resources. Per Lidén Created CRUX Linux (http://www.crux.nu) End of Document.