(HTML version in README.html)
Debian GNU/Hurd K8 "Sid" - Unofficial GNU hurd-i386 Binary-1 CD
CONTENTS:
* Intro
* About This CD
* Installing
* Last-Minute Notes
* Using CDs with Dselect and Apt
* Non-free/Non-US
* CD Manufacturers
* More Information
Welcome to the exciting world of
Debian GNU/Linux!
Intro
=====
This is one of the CD-ROMs of the Debian GNU/Linux distribution.
Debian is a very extensive collection of software. But it is more. It
is a complete Operating System (OS) for your computer. And it is free
(as in "freedom").
An operating system is the set of basic programs and utilities that
make your computer run. At the core of an operating system is the
kernel. The kernel is the most fundamental program on the computer,
which does all the basic housekeeping and lets you start other
programs. Debian is kernel independent. It currently uses the Linux
kernel but work is in progress to provide Debian for other kernels,
using the Hurd. Most of the basic operating system tools come from the
GNU project; hence the name GNU/Linux.
Debian is available for various kinds of computers ("architectures"),
like "IBM-compatible" PCs (i386), Compaq's Alpha, Motorola's 680x0
(m68k), Sun's Sparc, Motorola/IBM's PowerPC, and (Strong)ARM
processors. Check the ports page (
http://www.debian.org/ports) for
more information.
Read more at
http://www.debian.org/intro/about
About This CD
=============
This CD-ROM is labeled
Debian GNU/Hurd K8 "Sid" - Unofficial GNU hurd-i386 Binary-1
which means that this CD is number 1 of totally 8 CDs containing
programs ("binaries") for `hurd-i386' computers.
The programs on the Binary CDs are ordered by popularity. The Binary-1
CD contains the most popular programs and the installation tools; it
is possible to install and run Debian with only the Binary-1 CD. The
other CDs, up to Binary-8, contain mostly special-interest programs.
Installing
==========
Because Debian is a complete Operating System, the installation
procedure may seem a bit unusual. You can install Debian GNU/Linux
either next to your current OS, or as only OS on your computer.
Read the Installation Manual, on this CD at
/install/doc/install.en.html (English version).
Translations of the Installation Manual, and plain-text and PDF
versions, are also available in the
/install/doc
directory, along with various other documents.
Programs and other files that are needed for the installation can be
found on this CD under
/dists/woody/main/disks-hurd-i386
Last-Minute Notes
=================
* You should keep in mind that this is an unofficial CD of the
current development version of the Debian system. This means that
all sorts of bugs may be present anywhere in the system.
Using CDs with Dselect and Apt
==============================
After installing or upgrading, Debian's packaging system can use
CD-ROMs, local collections, or networked servers (FTP, HTTP) to
automatically install software from (.deb packages). This is done
preferably with the `apt' and `dselect' programs. If you do not
already know how to setup these, here is a brief explanation.
First of all, comment out every line of /etc/apt/sources.list by
placing a hash sign (`#') in front of it (if it isn't already there).
Then you need to add new "deb" lines describing the location(s) where
apt will get the new packages from. You can add "deb" lines for a
packages mirror on a local harddisk, and/or FTP/HTTP mirrors, and/or
(a set of) CD-ROMs. `Apt' will consider all packages that can be found
via any "deb" line, and use the one with the highest version number,
giving priority to the first mentioned lines. (So, in case of multiple
mirror locations, you'd typically first name a local harddisk, then
CD-ROMs, and finally FTP/HTTP mirrors.)
* For a local archive (or a single mounted CD-ROM), that for example
has these directories,
/var/ftp/debian/dists/potato/main/binary-hurd-i386/...
/var/ftp/debian/dists/potato/contrib/binary-hurd-i386/...
--------------- ------ |\
\________ \_ | \___
add: \ \ | \
--------------- ------ | \
deb file:/var/ftp/debian potato main contrib
As shown, the `dists' is added implicitly, and the 3rd,...
arguments are used to expand the path into multiple directories.
If you have a complete mirror that also has non-free and non-US,
you typically have to add lines like these:
deb file:/var/ftp/debian potato main contrib non-free
deb file:/var/ftp/debian-non-US potato/non-US main contrib
non-free
If you don't have such a structure, other description lines are
possible, see the sources.list manpage.
* FTP or HTTP packages mirror addresses can be found on this CD in
README.mirrors.txt, or on
http://www.debian.org/distrib/ftplist,
look at the "Full list of mirrors".
If the mirror has these directories:
ftp://some-server/debian/dists/potato/main/binary-hurd-i386/...
ftp://some-server/debian/dists/potato/contrib/binary-hurd-i386/...
------------------------ ------ | |
\___ / | |
add: \ / | |
------------------------ ------ | |
deb
ftp://some-server/debian potato main contrib
As shown, the `dists' is added implicitly, and the 3rd,...
arguments are used to expand the path into multiple directories.
If you use a complete mirror that also has non-free and non-US,
you typically have to add lines like these:
deb
ftp://some-server/debian potato main contrib non-free
deb
ftp://some-server/debian-non-US potato/non-US main contrib
non-free
If the mirror doesn't have such a structure, other description
lines are possible, see the sources.list manpage.
* In case of upgrading from a set of CD-ROMs (also possible for a
single, unmounted CD-ROM), do _not_ add any lines to sources.list
manually.
Instead, first make sure there is a line in /etc/fstab that
connects the /cdrom mount point with your CD-ROM drive (the exact
`/cdrom' mount point is "required" for apt). For example, if
/dev/scd0 is your CD-ROM drive, /etc/fstab should contain a line
/dev/scd0 /cdrom auto defaults,noauto,ro 0 0
To test this, insert a CD-ROM and give commands
mount /cdrom
ls -alF /cdrom (this should show the CD-ROM's root
directory)
umount /cdrom
Then, use the command
apt-cdrom add
to add the data of each individual CD-ROM to apt's internal
database. This command will ask for one CD-ROM per run, and
mount/unmount the CD-ROM automatically. You should repeat this
command for all 2.2 `Binary' CD-ROMs you have.
The final step of the preparation is to update apt's internal database
with the command
apt-get update
Once this is done, you can install packages from the commandline using
apt-get. For example, if you want to install the packages `commprog'
and `maxgame', you can give the command
apt-get install commprog maxgame
Note that you don't have to enter the complete path, or the `.deb'
extension. `Apt' will figure this out itself.
`Dselect' is also able to use `apt' to fetch the packages. To set up
`dselect', choose [A]ccess in the main menu, and then select `apt'.
The sources.list file should be okay already, so don't let the program
make a new one. Then, after an [U]pdate, the configuration is ready.
You can just keep using [S]elect and [I]nstall to install packages.
See dselect's online help screens for more information (use the `?'
key).
Non-free and Non-US
===================
The package sections `non-free' and `non-US' contain packages that
either have a restrictive license, or can't be exported from the US
(like `pgp' or `ssh'). It may well be that this CD does not contain
(all of) these packages. You can get them from our FTP/HTTP mirror
sites.
`Non-free' packages are on our "regular" mirrors, listed in
README.mirrors.html on this CD, or on
http://www.debian.org/distrib/ftplist ("Full list of mirrors").
`Non-US' packages are on special mirrors outside the US, listed in
README.non-US on this CD, or on
http://www.debian.org/misc/README.non-US.
Note that you are allowed to import non-US packages into the US.
CD Manufacturers
================
You are completely free to manufacture and (re-)distribute CD-ROMs of
the Debian GNU/Linux Operating System, like this one. There is no
charge from us (but of course donations are always welcome).
For all needed information, and contact addresses, please refer to
http://cdimage.debian.org
More Information
================
There is much more information present on this CD. Besides the already
mentioned installation and upgrading procedures, this is the most
interesting:
* /doc/FAQ Debian FAQ
* /doc/constitution.txt The Debian Constitution
* /doc/debian-manifesto The Debian Manifesto
* /doc/social-contract.txt Debian's Social Contract
* /doc/bug-reporting.txt Bug reporting instructions
Also on the Internet are many resources. To name a few:
*
http://www.debian.org The Debian homepage
*
http://www.debian.org/doc Debian Documentation
*
http://www.debian.org/support Debian User Support
*
http://www.linuxdoc.org The Linux Documentation Project
*
http://www.linux.org General Linux homepage
See the Debian contact page (
http://www.debian.org/contact) for
information on contacting us.
Last Modified: Wed Apr 18 19:09:34 CEST 2001