Some parts of this FAQ can be highly out of date or even wrong. Please either ask in IRC channel if unsure or refer to the [http://users.alioth.debian.org/~intero-guest/debian-amd64-howto.html The Debian GNU/Linux AMD64 HOW-TO] for a more up-to-date manual.


Debian on amd64 FAQ

   This page holds the frequently asked questions regarding 
   the Debian port to ["AMD64"].

   If there are unanswered questions the best thing you can do is 
   to add the Q's at the bottom of this page.


Q: Is this port only for AMD 64-bit ["CPUs"]?

A: No. "amd64" is the name chosen by AMD for their 64-bit architecture. Before release, it was called "x86_64", and some distributions continue to use this name. Intel refers to its x86_64 instruction set ["CPUs"] as "["EM64T"]". The architecture is still the same, and Debian amd64 will run on AMD and Intel x86 processors with 64-bit support. In honor of the inventing company, AMD, Debian uses the name amd64.


Q: Ok, so how do I run OpenOffice?

A: Works fine in Etch.


Q: How do I install Acrobat Reader?

A: Same situation: it works fine in a chroot environment, but you can also get it to work without. It is highly recommended to use a chroot as described in the [http://haydn.debian.org/~intero-guest/debian-amd64-howto.html HOWTO]. However, if you absolutely want to avoid using a chroot, here is an alternate way:

1. In Etch and later, install ia32-libs and ia32-libs-gtk. Do

   apt-get install ia32-libs ia32-libs-gtk

2. Get the acroread (e.g. acroread_7.0.8-0.0_i386.deb) debian package from http://www.debian-multimedia.org/pool/main/a/acroread/ and install it with

   dpkg -i --force-architecture acroread_7.0.8-0.0_i386.deb

It won't go without force, because it is the wrong architecture. While you are at it, you may also get the extra plugins.

3. Edit /usr/bin/acroread. Towards the end, there is a line

   exec "$ACRO_EXEC_CMD" ${1+"$@"}

Add

   GCONV_PATH=/usr/lib32/gconv LD_PRELOAD=/usr/lib32/libpangohack.so.0.0 GDK_PIXBUF_MODULE_FILE=/etc/gtk-2.0/gdk-pixbuf.loaders32

at the beginning of this line, before exec.

Not sure if it is required -- AlexanderVlasov

4. Copy /etc/gtk-2.0/gdk-pixbuf.loaders to /etc/gtk-2.0/gdk-pixbuf.loaders32, and replace all references to /usr/lib/ with /usr/lib32/:

   sed 's:/usr/lib/:/usr/lib32/:' < /etc/gtk-2.0/gdk-pixbuf.loaders > /etc/gtk-2.0/gdk-pixbuf.loaders32

Not sure if it is required -- AlexanderVlasov

acroread should work now.

5. To prevent the warning during the loading of the PPK module, remove it:

   rm /usr/lib/Adobe/Acrobat7.0/Reader/intellinux/plug_ins/["PPKLite"].api

You cannot start any other program from Acrobat Reader (such as a web browser), because the special settings do not work for other applications. Hopefully someday this will all be easier.


Q: Does Wine work?

A: No, it is 32-bit software. However it runs fine in a chroot, as described in the [http://haydn.debian.org/~intero-guest/debian-amd64-howto.html HOWTO], expecially the version provided on http://www.winehq.org/site/download-deb. You can safely avoid using a chroot by following [http://wiki.winehq.org/WineOn64bit this] guide.


Q: What about Flash?

A: Same story: It's a 32-bit binary, so you need a 32-bit system and a 32-bit browser. You can install Flash and a browser in your 32-bit chroot and use that.

For people using [http://www.debian.org/releases/unstable/ Debian Sid], the package [http://packages.debian.org/nspluginwrapper nspluginwrapper] allow you to run 32-bit Flash with a 64-bit browser. May works with others 32-bit plugins.


Q: Where is memtest for ["AMD64"]?

A: Here is it.


Q: How do I build i386 debs on amd64?

A: use the linux32 command to fake uname and limit memory size inside your i386 chroot. Package is linux32.

The following solution is based on the [https://alioth.debian.org/docman/view.php/30192/21/debian-amd64-howto.html#id274383 Debian-AMD64 Howto 'Running applications inside the chroot' Section]:

 Simplest way to build i386 packages out of the box on amd64 is to use dchroot and a simple wrapper script 
 such as the following example for dpkg-buildpackage:

   #!/bin/sh
   rpath=`pwd`
   dchroot -c i386 "cd $rpath && linux32 dpkg-buildpackage -ai386 $@"

 Save it under /usr/local/bin/ia32-dpkg-buildpackage, make it executable and change the chroot name
 according to your environment.

 You will need to have your home directory available under the chroot.

 Now you can build i386 packages using ia32-dpkg-buildpackage like dpkg-buildpackage. for example:

   $ ia32-dpkg-buildpackage -rfakeroot

 Remember to install the build-depends for the package inside the chroot.

Better approach: use -vserver kernel and create 32-bit vserver; build anything you want instide it.


Q: Is there a quick rundown on the changes you've made to apt/dpkg command-line syntax anywhere?

A: There are two new scripts that were added to dpkg.

dpkg-libinfo was added by Gerhard Tonn. It was originally written for the s390x and sparc64 ports. It allows debian/rules files to figure out if /lib or /lib64 should be used. See --help, or the usage of dpkg-libinfo in the zlib source.

dpkg-subarchitecture was added by Bart Trojanowski. The main goal of dpkg-subarchitecture is to allow for the concurrent installation of packages that were compiled for different CPU types, but can still be executed on the local host. As you may already know, on amd64 hardware you can install and run software compiled for k8, k7, i686, i586, i486, and i386. That relationship is captured in /usr/share/dpkg/subarchtable; or see http://www.jukie.net/~bart/debian/amd64/files/dpkg/subarchtable. Note that this feature can also be used to build i686 optimized modules.

Along with the scripts, the dpkg architecture name was changed to 'amd64'. Thus the names of 64-bit packages are named *_amd64.deb.

Apt's /etc/apt/sources.list has a new feature, too: You can specify what architecture apt should pull from a given distribution mirror. Below is an example that instructs apt to use the binary-i386 part of the testing distribution. If the "(i386)" is omitted, the default binary-amd64 would be used.

  deb http://ftp.debian.org/debian/ testing(i386) main non-free contrib

In addition, apt now uses the dpkg-subarchitecture script to determine whether certain packages are subarchitectures of amd64. The -s flag requests a list of compatible architectures that can be installed. The actual call that apt makes is

  $ dpkg-subarchitecture -s -aamd64
  i686 i586 i486 i386 all

There are a few other features that still need to be added to apt and dpkg. The next one that has been requested is a test for library ["ABIs"]. Basically, binaries of any architecture can depend on applications of any other architecture, but for binaries that depend on libraries, apt would have to make sure that the ABI of both packages is compatible. For example, an i386 and i686 package have compatible ABI, but amd64 and ia64 do not. Again, this information is captured in the subarchtable file previously mentioned.


Q: How do I port a debian package to amd64?

A: There should be no porting necessary, so just use the standard commands:

  apt-get source package
  cd package-version
  dpkg-buildpackage -us -uc -rfakeroot

If everything works (i.e., there are no problems in the code that affect building it on a 64-bit system), you should have a package-version_amd64.deb.


Q: Ok, so what do I have to do to port a library package to amd64?

A: With biarch, that used to be a pain, but with pure64 building a library should be no different from building an ordinary package.


Q: How do I build my first amd64 binaries?

A: With pure64, it is a simple as

 gcc hello.c. 

gcc will automatically target a 64-bit system. You can add -m32 to get a 32-bit executable.


Q: Lots of us don't care about 32-bit compatibility -- we don't run anything proprietary. We just want a native 64-bit port. Shouldn't that be simple to put together?

A: Yes, and that is what pure64 gives you.


Q: How do I bootstrap a 64-bit system?

A: There are many ways.

You can just download the installer and create a new 64-bit installation. You can also use debootstrap from a running system. Remember that you will need a 64-bit kernel for a 64-bit system. Using the 64-bit kernel for a 32-bit system may work, but there will probably be problems with loadable modules.

You can also recompile the system from source yourself:

 following the debian-amd64-howto, I have found the following differences:

  when compiling the kernel I had to 

  1) remove the ARCH:=  line from the makefile and 

  2) use the command

    ARCH="x86_64" make HOSTCC="gcc -m32" CC="gcc -m64" LD="ld -m elf_x86_64" bzImage

Note: When using an MSI SCSI board, compile the kernel with SCSI and SCSI_DEV and MPT FUSION.