[ previous ] [ Abstract ] [ Copyright Notice ] [ Contents ] [ next ]

The Debian GNU/Linux FAQ
Chapter 5 The Debian FTP archives


5.1 What are all those directories at the Debian FTP archives?

The software that has been packaged for Debian GNU/Linux is available in one of several directory trees on each Debian mirror site.

The directory dists contains the "distributions", and it is the canonical way to access the currently available Debian releases (and pre-releases).


5.2 How many Debian distributions are there in the dists directory?

Normally there are two distributions, the "stable" distribution and the "unstable" distribution. Sometimes there is also a "frozen" distribution (see What about "frozen"?, Section 5.4).


5.3 What are all those names like slink, potato, etc.?

They are just "codenames". When a Debian distribution is in the development stage, it has no version number but a codename. The purpose of these codenames is to make easier the mirroring of the Debian distributions (if a real directory like unstable suddenly changed its name to stable, a lot of stuff would have to be needlessly downloaded again).

Currently, stable is a symlink to potato (i.e. Debian GNU/Linux 2.2) and unstable is a symlink to woody, which means that potato is the current stable distribution and woody is the current unstable distribution.


5.4 What about "frozen"?

When the unstable distribution is mature enough, it becomes frozen, meaning no new code is accepted anymore, just bugfixes, if necessary. Also, a new unstable tree is created in the dists directory, having a new codename. The frozen distribution passes through a few months of testing, with intermittent updates and deep freezes called `test cycles'. We keep a record of bugs in the frozen distribution that can hold off a package from being released or bugs that can hold back the whole release. Once that bug count lowers to maximum acceptable values, the frozen distribution becomes stable, it is released, and the previous stable distribution becomes obsolete (and moves to the archive).


5.5 Which other codenames have been used in the past?

Other codenames that have been already used are: buzz for release 1.1, rex for release 1.2, bo for releases 1.3.x, hamm for release 2.0, and slink for release 2.1.


5.6 Where do these codenames come from?

So far they have been characters taken from the movie "Toy Story" by Pixar.


5.7 What about "sid"?

It is a special distribution for architectures which haven't yet been released for the first time.

When sid did not exist, the FTP site organization had one major flaw: there was an assumption that when an architecture is created in the current unstable, it will be released when that distribution becomes the new stable. For many architectures that isn't the case, with the result that those directories had to be moved at release time, chewing up lots of bandwidth.

For those architectures not yet released, the first time they are released there will be a link from the current stable to sid, and from then on they will be created inside the unstable tree as normal. sid will never be released nor even accessed directly - only through symlinks in the current stable, frozen, or unstable trees. It is a mix of released and unreleased architectures.

The name "sid" also comes from the "Toy Story" animated motion picture: Sid was the boy next door who destroyed toys :-)


5.8 What does the stable directory contain?


5.9 What does the unstable directory contain?

The `unstable' directory contains a snapshot of the current development system. Users are welcome to use and test these packages, but are warned about their state of readiness. The advantage of using the unstable distribution is that you are always up-to-date with the latest in GNU/Linux software industry, but if it breaks: you get to keep both parts :-)

There are also main, contrib and non-free subdirectories in `unstable', separated on the same criteria as in `stable'.


5.10 What are all those directories inside dists/stable/main?

Within each of the major directory trees (dists/stable/main, dists/stable/contrib, dists/stable/non-free, and dists/unstable/main/, etc. but not project/experimental/, which is too small to subdivide), the binary packages reside in sub-directories whose names indicate the chip architecture for which they were compiled:

See On what hardware architectures/systems does Debian GNU/Linux run?, Section 3.1 for more information.


5.11 Where is the source code?

Source code is included for everything in the Debian system. Moreover, the license terms of most programs in the system require that source code be distributed along with the programs, or that an offer to provide the source code accompany the programs.

Normally the source code is distributed in the "source" directories, which are parallel to all the architecture-specific binary directories.

Source code may or may not be available for packages in the "contrib" and "non-free" directories, which are not formally part of the Debian system.


5.12 Ok, what about the other directories, not inside dists?

There are the following supplementary directories:

/tools/:
DOS utilities for creating boot disks, partitioning your disk drive, compressing/decompressing files, and booting Linux.

/doc/:
Debian documentation, Debian FAQ, instructions on how to submit bug reports.

/indices/:
Various indices, maintainers, Packages-master files, override files.

/project/:
mostly developer-only materials, such as:

project/experimental/:
This directory contains packages and tools which are still being developed, and are still in the alpha testing stage. Users shouldn't be using packages from here, because they can be dangerous and harmful even for most experienced people.

project/orphaned/:
Packages that have been orphaned by their old maintainers, and withdrawn from the distribution.


[ previous ] [ Abstract ] [ Copyright Notice ] [ Contents ] [ next ]
The Debian GNU/Linux FAQ
version 2.2.2, 24 September 2000
Authors, Section 15.1