Emdebian Quick Start

This is intended to be a quick start guide to Emdebian and emdebian-tools.


You will need to install a package called emdebian-tools, either from Debian repositories or the Emdebian repository. emdebian-tools also brings in apt-cross and dpkg-cross.

$ sudo apt-get install emdebian-tools

This will ask you where you want to build packages, your username for emdebian svn access if you have one and if you want to use apt-get or aptitude for package downloading. dpkg-cross will offer you the chance to set a default cross-building architecture which saves a lot of typing later on. If you choose None, you will need to add '--arch ARCH' to all the emdebian-tools commands.

After you have the tools, you have to setup an emdebian environment. This sets up the ~/.dpkg-cross dir which contains apt caches and configuration files.

New users are recommended to use at least one -v|--verbose option to all emdebian-tools commands.

$ emsetup --verbose --simulate
# check that the output is acceptable, nothing changed yet.
$ emsetup

If ~/.dpkg_cross/cross_compile isn't fully configured yet, (hint in the manpage), or you chosen to have no default cross-building architecture, then emsetup requests the use of --arch to determine the target architecture:

$ emsetup -v -s --arch m68k
# check that the output is acceptable, nothing changed yet.
$ emsetup -a m68k

Now you can run emsource <package> to get a debian package, unpack it and apply / generate any emdebian patches. This is directly equivalent to apt-get source in mainstream debian and then applying some patches. emsource tells you where the package has been unpacked.

Now you can cd into the package dir and do emdebuild to actually build the package. You will need to install any build dependencies as needed with apt-get or aptitude.

You could check some documentation at [http://linux.codehelp.co.uk/emdebian/man/ Emdebian Manual]