CRUX : Home

Home :: Documentation :: Download :: Development :: Community :: Wiki :: Ports :: Bugs :: Links :: About

(redirected from Main.Faq)

Frequently Asked Questions (FAQ)

Table of contents

- General
- Why the name “CRUX”?
- When will the next version be released?
- Is it called CRUX Linux or CRUX GNU/Linux?
- I heard CRUX was based on Slackware, is that true?
- Why isn't there an active forum?
- I can't figure something out! Where do I get more help?
- How can I help the CRUX project?
- How can I join the CRUX project?
- Installation
- Will CRUX work with AMD K6/K6-II/K6-III?
- When booting from the CRUX CD-ROM I get a kernel panic saying “VFS: Unable to mount root fs”. What's wrong?
- When booting CRUX for the first time I get the error “Unable to open initial console”. What's wrong?
- When logging in to my newly installed CRUX for the first time it asks for a password, but the installation guide says “Login as root (no password required)”. What's wrong?
- The ports system
- How do I publish my own ports?
- How do I add someone else's repository to my ports system?
- How do I install packages using dependencies?
- How do I build either KDE or GNOME?
- How can I have more control over my packages?
- I'm behind a restrictive firewall. Is there any way for me to update ports?
- I just realized a port is out of date.
- I'm having trouble getting the port off of Sourceforge.net
- It says “ports: no driver(s) installed” when I try to update my ports, what's wrong?
- pkgutils
- How can I store sources and packages in dedicated directories?
- I got a footprint mismatch, what's wrong?
- I got an md5sum mismatch, what's wrong?
- Configuration
- How do I get sshd running?
- Miscellaneous
- I have the installation CD, but not on me. All I need is a package. Where can I get one?
- X [ xorg ] dies when I open openoffice.
- My system clock is way off.

Original author: The CRUX Team
Maintained by: Jonathan Asghar


General

Why the name “CRUX”?

Sorry, there's no interesting story behind the name. Per chose it simply because he thought it sounded cool, it was short, it was fairly easy to remember and it had the mandatory X in the end to make it UNIX/Linux-ish ;)

When will the next version be released?

Well, the standard answer to this question is “when it's done”. New versions are however usually released every 3 or 4 months. Between releases, updated packages are made available through the ports system.

Is it called CRUX Linux or CRUX GNU/Linux?

None of the above. It's called CRUX, no more no less.

I heard CRUX was based on Slackware, is that true?

No, that's incorrect. CRUX was built from scratch and has never been based on any other Linux distribution.

Why isn't there an active forum?

Most of the developers and users prefer mailing lists over forums. It's much simpler to follow discussion when using a mailing list--forums require constant polling if you are trying to stay up to date about what's happening.

I can't figure something out! Where do I get more help?

First off try searching the mailing lists. Browsing the archives (marc.theaimsgroup.com provides a nice, searchable archive) is always a good way to start. If that doesn't work, try asking in one of the IRC channels.

How can I help the CRUX project?

Create ports and maintain a repository of your own, help people on the mailing list and in the IRC channels and write documentation.

How can I join the CRUX project?

Maintain a personal port repository for a while, make sure that your ports adhere to the port guidelines and contact the CRUX team.


Installation

Will CRUX work with AMD K6/K6-II/K6-III?

Yes and No. AMD K6, K6-II and K6-III have an i586 (Pentium) compatible instruction set. Packages on the official CRUX ISO are compiled with -march=i686, which means that CRUX requires a processor which has an i686 compatible instruction set (i.e. Intel PPro/Celeron/PII/PIII/P4 or AMD K7/Athlon). However, Jürgen Daubert maintains an i586 version of the CRUX ISO image which can be found here. The i586 version of the CRUX ISO works on AMD K6/K6-II/K6-III.

When booting from the CRUX CD-ROM I get a kernel panic saying “VFS: Unable to mount root fs”. What's wrong?

This can happen if you have more than one CD-ROM drive. Make sure you boot from then "first" CD-ROM drive, i.e. /dev/cdroms/cdrom0. If you must boot from a different drive (i.e. not the first one) you can still do that but you have to type CRUX root=/dev/cdroms/cdrom1 at the boot prompt (cdrom1 indicates that it is the second drive, cdrom2 that it is the third, and so on).

When booting CRUX for the first time I get the error “Unable to open initial console”. What's wrong?

You most likely forgot to enable devfs or didn't tell the kernel to mount devfs at boot. The installation instructions (Handbook Section 2.2, “Installing From CD-ROM”) tell you how to enable it.

When logging in to my newly installed CRUX for the first time it asks for a password, but the installation guide says “Login as root (no password required)”. What's wrong?

You most likely forgot to edit /mnt/etc/fstab before you rebooted or you entered the wrong name of your new root partition at the boot prompt.


The ports system

How do I publish my own ports?

Create a httpup repository and register it with the ports database. Basically you just make a directory which contains your ports, run httpup-repgen <directory> to generate an index file and upload the directory in your personal web space. It's as simple as that. More detailed infos here.

How do I add someone else's repository to my ports system?

Install httpup and put the corresponding .httpup file in your /etc/ports directory. Running ports -u should now make the ports available in /usr/ports/<repository>. If you are using prt-get, you might want to add the port directory to /etc/prt-get.conf e.g. prtdir /path/to/repository.

How do I install packages using dependencies?

Use prt-get (depends or deptree to check the dependencies and depinst to actually install them) from the opt tree (opt/prt-get).

How do I build either KDE or GNOME?

Follow the instructions for either GNOME? or KDE.

How can I have more control over my packages?

prt-utils is a good place to start and have a look at our ToolsAndScripts page.

I'm behind a restrictive firewall. Is there any way for me to update ports?

Have a look at our httpup page.

I just realized a port is out of date.

If the port is from the core, base or opt collections, this is considered a bug. Feel free to report it using the ticket system. Please make sure there isn't already a bug report for this version difference. Also note that all CRUX team members only work on CRUX in their free time, so the respective person might already know about the new version (submitting a bug report an hour after the release doesn't make any sense).

A good "new version out" bug report also contains a note whether it is enough to just update the version in the Pkgfile. Important: If the update is security related, please contact the port maintainer directly (and immediately).

I'm having trouble getting the port off of Sourceforge.net

It seems to be a problem with the round-robin DNS that SourceForge uses. The best way to fix it is by editing /etc/hosts and making an alias to a mirror that is closest to you.

For example, to use the heanet mirror:

 193.1.193.66 download.sourceforge.net download.sf.net dl.sourceforge.net dl.sf.net

It says “ports: no driver(s) installed” when I try to update my ports, what's wrong?

You forgot to install the opt/cvsup package. You will find it on the CRUX ISO (under /crux/opt/).


pkgutils

How can I store sources and packages in dedicated directories?

Edit /etc/pkgmk.conf. Change this part:

 # PKGMK_SOURCE_DIR="$PWD" 
 # PKGMK_PACKAGE_DIR="$PWD"
 # PKGMK_WORK_DIR="$PWD/work"

To this:

 PKGMK_SOURCE_DIR="/usr/ports/distfiles"
 PKGMK_PACKAGE_DIR="/usr/ports/packages"
 PKGMK_WORK_DIR="/usr/ports/work/${PWD##*/}"

Finally create the directories:

 # mkdir /usr/ports/{distfiles,packages,work}

I got a footprint mismatch, what's wrong?

Have a close look at the mismatch. If there are lots of new files, it's probably just because you have some software installed the packager didn't, which is no problem at all. In this case, just ignore or update the footprint (see the pkgmk manpage) and install it. If you're missing a lot of files, make sure you have all dependencies installed. Also make sure you built the package as root.

I got an md5sum mismatch, what's wrong?

The md5sum is a security feature, so you shouldn't just ignore this one. The package you downloaded could be manipulated. But there are other reasons why this can happen, without a malicious action: the download might have failed (try to decompress the tarball to see whether is is corrupt), or the requested file might have been changed on the server without its name being changed; this usually happens for things like theme-packs which change constantly without getting another name.


Configuration

How do I get sshd running?

You have to edit /etc/hosts.deny and/or /ets/hosts.allow to specify which hosts are allowed/denied access. To allow anyone to connect to your machine you can add sshd: ALL to /etc/hosts.allow. See the hosts_access(5) man-page for further information about the file format. When this is done you can start sshd by entering the command /etc/rc.d/sshd start and/or edit /etc/rc.conf and add sshd to the SERVICES array, i.e. SERVICES=(... sshd ...), which means that sshd will be started when the system boots.


Miscellaneous

I have the installation CD, but not on me. All I need is a package. Where can I get one?

If you need something off of the CD, you can grab the base install packages from core and opt (provided by Matt Housh) or core and opt (provided by Tilman Sauerbeck). Either should work

X [ xorg ] dies when I open openoffice.

If you are using the binary NVidia driver (opt/nvidia) for xorg, keep in mind to run the gl-select tool after installation to set up your OpenGL environment, as pointed out in the README file. X dying like this happens not only with openoffice but most of the glx stuff such as childsplay, showfont etc.

My system clock is way off.