Welcome to Eric Hameleers (Alien BOB)'s Wiki pages.
This is an old revision of the document!
This article contains instructions on how to create a true multilib Slackware64. A multilib 64bit Linux system is capable of running 64bit as well as 32bit software. The Filesystem Hierarchy Standard dictates the best way to achieve a clean separation between 64bit and 32bit software on a single system. With Slackware64 we chose to adopt this standard, so it has been prepared to look for 64bit libraries in
/usr/lib64 directories. This is why I call Slackware64 “multilib-ready” - even though 32bit libraries will be looked for in
/usr/lib, Slackware64 does not ship with any 32bit software. There is one more step to take before Slackware64 can be called “multilib-enabled”.
This is accomplished as follows:
- First we need to switch to multilib versions of
- glibc (i.e. a glibc that supports running both 32bit and 64bit binaries), and
- gcc (i.e. able to compile 32bit binaries as well as 64bit binaries).
- Then, system libraries are taken from 32bit Slackware and installed in the 64bit Slackware system which completes the process of creating a 32bit software layer.
Slackware64 has an advantage over the 64bit “forks” that exist out there. These forks add the 32bit compatibility layer by recompiling a lot of their packages as 32bit binaries. Slackware on the other hand, is a distribution that consists of a 32bit and 64bit version which are being developed in parallel. This means, that you do not have to compile 32-bit packages from scratch in order to add multilib capability to the 64bit system. You simply take them from the 32-bit Slackware package tree. This was one of the reasons for not adding full multilib to Slackware64 - we create the right preconditions but require the user to act if she needs multilib.
In a section further down, I will explain how you can take a 32-bit Slackware package (say, the “mesa” package) and re-package its content into a “mesa-compat32” package that you can install straight away on Slackware64.
I will give some examples of programs that require multilib support on a 64bit Slackware because they will not start or compile on Slackware64 without the 32bit compatibility layer:
Most Windows programs are still 32bit, and in order to run those on Linux with Wine, you need a 32bit version of Wine.
The popular virtual machine software. Although this is (partly) open source it still needs 32-bit compatibility libraries on 64-bit Slackware.
Luckily, 64bit support is becoming more and more common. In the past year, Adobe released their Flash browser plugin in a 64bit version and Sun revealed a 64bit version of their Java browser plugin. This was one of the triggers to start working on Slackware64.
You can download a set of multilib-enabled packages and scripts from my web site: http://slackware.com/~alien/multilib/ .
Apart from several README files (this Wiki article is based on one of these READMEs), you will find one subdirectory for every 64-bit Slackware release below the toplevel directory ”multilib”. There is another directory called “source”. The ”source” directory contains package sources and SlackBuild scripts.
The stuff that you are really interested in - the binary packages - is available in the <slackware_release_number> directory below the toplevel directory. Every such directory also contains a ”slackware64-compat32” subdirectory where you will find an essential set of converted 32-bit Slackware packages, ready for installing on your 64-bit Slackware.
This section contains the essential instructions to add full multilib capability to your Slackware64 system. If you want to understand the process in more detail, or need information on how to compile 32bit software in Slackware64, read the next sections as well.
- After downloading the packages from my web site (I gave you the URL in the previous section), you upgrade your 64bit Slackware ”gcc” and ”glibc” packages to my multilib versions.
Run the command
upgradepkg --reinstall --install-new *.t?z
in the directory where you downloaded them.
This command will also install an additional package called ”compat32-tools”.
- If you also downloaded a directory called slackware64-compat32 then you are lucky, because I did the 32bit package conversion for you already! All you do is run the command:
upgradepkg --install-new slackware64-compat32/*-compat32/*.t?z
which will install all the converted 32-bit Slackware packages (or upgrade them if you already had installed older multilib packages, for instance when you are upgrading to a newer Slackware). That's all!
- If you can't find that subdirectory called slackware64-compat32 then you have to do the conversion yourself. Not difficult at all, it takes a few minutes:
- The fastest is if you have a local directory with original 32-bit Slackware packages available (also called a local mirror). Those who bought an official Slackware DVD can simply use that DVD: it is dual-sided and 32bit Slackware is on one of the sides. For the sake of this example I will assume that you have a local 32bit Slackware directory tree available at ”
There should be sub-directories called 'a', 'ap', 'd', 'l', 'n', 'x' immediately below this directory. (If you have mounted a Slackware DVD, your directory will probably be ”
/media/SlackDVD/slackware/” but I will not use that in the example commands below).
- Create a new empty directory (let us call it 'slackware64-compat32') and change into it:
mkdir slackware64-compat32 ; cd slackware64-compat32
- Run the following command to create a set of 32bit compatibility packages, using the directory to the official 32bit Slackware packages as input:
massconvert32.sh -i /home/ftp/pub/slackware/slackware-13.37/slackware/
- The previous step takes a while. When it ends, proceed to install the 90 MB of freshly converted 32-bit Slackware packages which were created in subdirectories below your current directory:
upgradepkg --install-new *-compat32/*.t?z
- Done! You can now start downloading, installing and running 32bit programs. This was not so hard, was it?
gccpackage names to its package blacklist. If you do not take this precaution, you run the risk of your package manager accidentally replacing your multilib versions with Slackware's original pure 64-bit versions!
massconvert32.sh -u http://someserver.org/path/to/slackware-13.37/slackware
The following glibc/gcc packages are replacements for - not additions to - standard Slackware packages. You use the “upgradepkg” program to upgrade to my multilib versions of gcc and glibc. You will need these in order to run (glibc), and build (gcc), 32-bit software on your 64-bit Slackware computer:
- The gcc compiler suite:
- The GNU libc libraries:
- The gcc compiler suite:
- The GNU libc libraries:
- The gcc compiler suite:
- The GNU libc libraries:
- As long as you don't see a separate directory named ”current” you can just use the files in the directory for the most recent stable release.
- The gcc compiler suite:
- The GNU libc libraries:
There is one additional package that you install using the “installpkg” program:
- The “32-bit toolkit” (scripts that facilitate the creation of 32bit packages)
However, I believe that it is cleaner to keep these essential multilib packages undivided. I followed the concept already used in Slackware64's own binutils package, which has 64-bit and 32-bit multilib capability bundled into one package.
The upgrade of glibc and gcc which I described in the previous section changes your system from ”multilib-ready” to ”multilib-enabled”.
Now, all you need to do is to install 32bit versions of Slackware's system software so that future 32bit programs that you are going to install and/or compile will find all the 32bit libraries they need in order to work.
This is not as simple as grabbing 32bit Slackware packages and installing them in Slackware64:
- In the first place, you will end up with multiple packages carrying the same name (two 'mesa' packages, two 'zlib' packages, etc…) which will be confusing to you as well as to the slackpkg package manager.
- And furthermore, if the 32bit package contains binaries (something like
/usr/bin/foo), they will overwrite their 64bit counterparts when you install the 32bit package on top. It will seriously mess up your system if that happens.
A little bit of extra care is required so that unnecessary/unwanted files are stripped from the 32bit packages before you install them. What you need, is a 32bit package that does not conflict with whatever is already present in 64bit Slackware. Hence the name “32bit compatibility package”.
I decided that it would be a waste of download bandwidth if I created 32bit compatibility versions of Slackware packages myself. After all, you have probably bought the Slackware 13.37 DVD so you already possess both 64bit and 32bit versions of Slackware… or else the 32bit Slackware tree is available for free download of course
Instead, I wrote a few scripts (parts of the script code were written by Fred Emmott of Slamd64 fame) and wrapped these into a ”compat32-tools” package. Their purpose is to let you extract the content from any 32bit Slackware package and use that to create a new package which you can safely install on your 64bit Slackware.
This ”compat32-tools” package needs some explanation.
Please read the detailed 'README' file in the
/usr/doc/compat32-tools-*/ directory, it will help you on your way. These are the three useful scripts which the package installs:
This is the same script that comes with Slamd64. It reconfigures your shell environment so that it will be easier for you to compile 32-bit software (by preferring the 32-bit compilers and libraries over their 64-bit versions)
This script takes a 32-bit Slackware package and converts it to a '-compat32' package that you can safely install (using “installpkg”) on Slackware64, alongside the 64-bit version of the same software package. For instance: suppose you need 32bit libraries that are in the mesa package. You take the mesa package from 32-bit Slackware (
x/mesa-7.5-i486-1.txz) and then run
convertpkg-compat32 -i /path/to/mesa-7.5-i486-1.txz
which will create a new package called
mesa-compat32-7.5-x86_64-1.txz. This new package (which is created in your
/tmpdirectory unless you specified another destination) is basically the old 32bit package, but stripped from non-essential stuff. The changed basename (mesa becomes mesa-compat32) allows you to install this new package in Slackware64 where it will co-exist with the 64bit mesa package, not overwriting any files.
The script leaves temporary files in the directory ”
/tmp/package-<prgnam>-compat32” which you can safely delete.
This script contains an internal list of what I consider the essential subset of 32-bit Slackware packages. It uses the above ”convertpkg-compat32” script to grab every package that is on this internal list, and convert these into '-compat32' packages.
You need to run this script only once, for example like this (the example assumes that you mounted your 32bit Slackware DVD on
massconvert32.sh -i /mnt/dvd/slackware -d ~/compat32
This action will result in about 60 MB of new packages which you will find inside the newly created directory
~/compat32(the directory's name is arbitrary of course, I chose it for the sake of this example). These packages comprise the 32bit component of your multilib Slackware64 system.
They should be installed using ”
installpkg”, and they give you a pretty complete 32-bit compatibility layer on top of Slackware64:
If you are upgrading from an earlier version of these packages (because for instance you upgraded your 64-bit Slackware to a newer release) then you do not use ”
installpkg” of course, but ”
upgradepkg –install-new” instead:
upgradepkg --install-new ~/compat32/*/*.t?z
The ”–install-new” parameter is needed to install the new
compat32packages which were added between releases.
compat32packages you will notice that some will show errors about missing files in
/etc. This is “by design”, and these errors can be ignored. These messages are caused by the fact that files in
/etcare removed from a ”-compat32” package during conversion (except for pango and gtk+2). I assume that files in
/etcwill already have been installed by the original 64bit packages.
An example of these “errors” for the
Executing install script for cups-compat32-1.3.11-x86_64-1.txz. install/doinst.sh: line 5: [: too many arguments cat: etc/cups/interfaces: Is a directory cat: etc/cups/ppd: Is a directory cat: etc/cups/ssl: Is a directory cat: etc/cups/*.new: No such file or directory cat: etc/dbus-1/system.d/cups.conf.new: No such file or directory chmod: cannot access `etc/rc.d/rc.cups.new': No such file or directory cat: etc/rc.d/rc.cups.new: No such file or directory Package cups-compat32-1.3.11-x86_64-1.txz installed.
convertpkg-compat32script to convert a non-Slackware package to a -compat32 package, I must strongly advise against this. The script is written with a single purpose and that is to make 32bit versions of the official Slackware64 binaries/libraries available in a multilib setup. As such, the script will remove a lot of stuff that is present in the original 32bit package - stuff which is expected to have been installed as part of the 64bit version of the package.
In almost all cases where you have downloaded a non-Slackware 32bit package and want to make it work on Slackware64, the best way is to find the sources and build a 64bit version of the package. Alternatively, just install the original 32bit package instead of trying to “convert it” and then run it from the commandline to find out any missing 32bit libraries you may still have to extract from an official Slackware package.
Running a pre-compiled 32-bit program is easy after you've done the above system preparation. Just download, install and run it!
At times, you may run into a program that requires a certain 32-bit Slackware library that you do not yet have available. In that case, find out which 32bit Slackware package contains this missing library. Use the ”convertpkg-compat32” script to convert that original 32bit Slackware package and install the resulting 32bit ”compatibility” package on Slackware64.
In case you need to compile a 32-bit program (wine and grub are two examples of open source programs that are 32-bit only) you first configure your shell environment by running the command:
Note the 'dot' in front of the filename - that is actually part of the commandline! Running this command changes or creates several environment variables. The effect of this is, that 32-bit versions of binaries are preferred over 64bit binaries when you compile source code - you will be running a 32bit compilation. The effect will last until you logout from your shell.
In this changed environment, you will be able to use standard SlackBuilds to build 32-bit packages for Slackware64. There are two things to keep in mind:
- You will have to define the ARCH variable as 'x86_64' even though you are compiling a 32-bit program!
This is related to the triplet of “$ARCH-slackware-linux” which is normally used in the “configure” command. Also, try setting the ARCH to for instance “i486” and you will see that the CFLAGS definition for that architecture will result in gcc errors like ”compiler can not create executables”. This is related to the design of a SlackBuild script. Rather than editing the script and change/remove CFLAGS definitions, you can set the ARCH to “x86_64” and save yourself some time. The real work is being done by the 32dev.sh script.
- You will have to edit the SlackBuild if it wants to use 'lib64/' directories for “$ARCH = x86_64”. You have to force it to use 'lib/' directories instead. Usually, this is accomplished by finding a definition like:
and changing this line to
- After installing the ”
-compat32” packages, you may have to re-install your binary Nvidia or Ati video X.Org drivers. These driver packages contain both 64bit and 32bit libraries to be maximally useful on a 64bit multilib OS. If you installed the driver files for both architectures, the ”
mesa-compat32” package will overwrite some of the 32bit library files.
On the other hand, if you originally only installed the 64bit driver libraries for your Nvidia/Ati card, it is recommended after installation of the multilib packages, to re-install the binary driver package. This time, choose to install the 32bit driver files as well.
The graphical 32bit applications that you are going to run on your multilib installation will require these 32bit driver libraries. Crashes are likely to occur if you fail to install the correct files.
- If you want to compile your 64bit kernel yourself, be sure to compile 32bit emulation capability into it or else multilib will mysteriously fail. You will need this piece of kernel configuration: CONFIG_IA32_EMULATION
This is the list of packages that is converted into ”-compat32” versions by the
massconvert32.sh script. Note that some of these packages are not part of Slackware 13.0 or 13.1, they were added in a later Slackware version so they will produce a ”* FAIL: package 'package_name' was not found!” message when you run the script on an older release. The other way round is true as well - some packages have been removed in later versions of Slackware and they will also trigger the ”* FAIL: package 'package_name' was not found!” message. Don't worry about that.
# The A/ series: aaa_elflibs bzip2 cups cxxlibs dbus e2fsprogs openssl-solibs util-linux # The AP/ series: mpg123 mysql # The D/ series: libtool # The L/ series: alsa-lib alsa-oss atk audiofile cairo dbus-glib esound expat freetype gamin gdk-pixbuf2 glib2 gtk+2 gst-plugins-base gst-plugins-good gstreamer hal jasper lcms libart_lgpl libelf libexif libglade libgphoto2 libidn libieee1284 libjpeg libmng libmpc libpcap libpng libsndfile libtermcap libtiff libusb libxml2 libxslt ncurses pango popt qt readline sdl seamonkey-solibs svgalib v4l-utils zlib # The N/ series: curl cyrus-sasl gnutls libgcrypt libgpg-error openldap-client openssl # The X/ series: fontconfig glew libFS libICE libSM libX11 libXScrnSaver libXTrap libXau libXaw libXcomposite libXcursor libXdamage libXdmcp libXevie libXext libXfixes libXfont libXfontcache libXft libXi libXinerama libXmu libXp libXpm libXprintUtil libXrandr libXrender libXres libXt libXtst libXv libXvMC libXxf86dga libXxf86misc libXxf86vm libdmx libdrm libfontenc libxcb mesa pixman
- Sėbastien Ballet has written a tool called compat32pkg. On his web site he has compat32pkg available for download as well as extensive documentation about how to use it on Slackware64.
I will quote the site:
“Compat32pkg is an automated tool that provides all the necessary for managing (converting, installing, upgrading, removing) the 32-bit part of AlienBob's multilib for slackware-64, and all 32-bit packages from Slackware-32 for which users could find a needs into a 64-bit environment, like firefox, seamonkey, jre,…”
- Bruno Russo translated this article to portuguese (brazil): http://www.brunorusso.eti.br/slackware/doku.php?id=multilib_para_o_slackware_x86_64
- Mehdi Esmaeelpour translated this article to persian: http://www.slack-world.com/index.php/articles/43-general-system/85-multilib-slackware64
- A lot of thanks should go to Fred Emmott, who created Slamd64, the original unofficial 64-bit fork of Slackware. Although Slackware64 was not based on Fred's work, I still learnt most of what I know about setting up the 32-bit part of a multilib Linux from his writings that are found in Slamd64.
- Cross Linux From Scratch.
The CLFS Wiki (http://trac.cross-lfs.org/wiki/read#ReadtheCrossLinuxFromScratchBookOnline) is a 'must-read' if you want to understand how to port Linux to a new architecture. I took several ideas, concepts and patches from them when creating Slackware64 from scratch, and again when I created my multilib gcc/glibc packages from scratch (my README on this multilib-from-scratch is available in the ./source directory).