diff options
Diffstat (limited to 'hurd/running/debian')
40 files changed, 1542 insertions, 0 deletions
diff --git a/hurd/running/debian/CDNotesHome.mdwn b/hurd/running/debian/CDNotesHome.mdwn new file mode 100644 index 00000000..a154415b --- /dev/null +++ b/hurd/running/debian/CDNotesHome.mdwn @@ -0,0 +1,7 @@ +Charles, here's a place for you! As usual, you can find [more information here](http://www.debian.org/ports/hurd/hurd-cd). Past notes may be of help as well. + +---- + +It seems the building of the CDs is being passed to the University of Calicut. [Re: latest ISO images](http://lists.debian.org/debian-hurd/2007/07/msg00095.html) K 14 is the latest stable, L1 is the development version. + +-- [[Main/GrantBow]] - 24 Jul 2007 diff --git a/hurd/running/debian/CrossInstall.mdwn b/hurd/running/debian/CrossInstall.mdwn new file mode 100644 index 00000000..1cde150c --- /dev/null +++ b/hurd/running/debian/CrossInstall.mdwn @@ -0,0 +1,76 @@ +## <a name="Easy_install_with_CrossHurd"> Easy install with CrossHurd </a> + +Qurious about the Hurd? Have a 1-5 GiB partition free? Let's install GNU/Hurd on it! + +### <a name="Preparing_the_partition"> Preparing the partition </a> + +We'll assume you have a partition ready, for the sake of argument we use an example here: /dev/hda3 is the Hurd partition (type: Linux) and /dev/hda4 is the Linux swap that we'll reuse. + +First we create the Ext2 filesystem, notice the `hurd` option. + + # mke2fs -o hurd /dev/DEVICE + +Next we create a useful mountpoint and mount the partition. + + # mkdir /gnu + # mount /dev/hda3 /gnu + +### <a name="Retrieving_CrossHurd"> Retrieving CrossHurd </a> + +Unless you don't run Debian GNU/Linux download it from <http://packages.debian.org/crosshurd>, or simply apt-get the package from Testing or Unstable. + + # apt-get install crosshurd + +### <a name="Cross_installing"> Cross installing </a> + +The crosshurd package only operates in the given target directory, which is the first question asked when running the program. + + # cd /gnu + # crosshurd + +Answer the questions you get: $ What is the target directory?: `/gnu` $ Target Debian system?: gnu $ Target CPU?: i386 + +Now the program starts retrieving all the necessary base packages. + +### <a name="Preparing_to_reboot"> Preparing to reboot </a> + +When all packages have been extracted we must prepare [[GRUB]] for the Hurd when we reboot. Add the below entry to your `/boot/grub/menu.lst` file to boot the Hurd in single user mode (-s). Single user mode is needed only for the two reboots when running the Native Install. + + title GNU (kernel GNUmach 1.3) + root (hd0,2) + kernel /boot/gnumach.gz root=device:hd0s3 -s + module /hurd/ext2fs.static \ + --multiboot-command-line=${kernel-command-line} \ + --host-priv-port=${host-port} \ + --device-master-port=${device-port} \ + --exec-server-task=${exec-task} \ + -T typed ${root} $(task-create) $(task-resume) + module /lib/ld.so.1 /hurd/exec $(exec-task=task-create) + +**_Nota Bene:_** In your menu file there should be no extra white space after the back slashes. + +### <a name="Native_install"> Native install </a> + +Ah, reboot and select "GNU (kernel GNUmach 1.3)" from the Grub menu. At the prompt, setup TERM and run the native-install script. + + # export TERM=mach + # ./native-install + +When done the native install requests that you reboot once again and rerun native-install. This time you will be asked a lot of questions, see the [[Hurd/InstallNotes]] for details. + + # reboot + ... + # export TERM=mach + # ./native-install + +Done, continue setting up your system, see the [[Hurd/InstallNotes]] for more help. + +-- [[Main/JoachimNilsson]] - 22 Mar 2005 + +---- + +Jeff Bailey has set up a system where you can install a Hurd system without having to use CDs. It's another type of cross-installation method which uses Debian package management tools to get the packages required as opposed to the one single big tarball. + +As of 2005-03-22, the latest version of crosshurd is 1.7.11. It can be found at <http://packages.debian.org/crosshurd>. + +-- [[Main/PeterMelville]] - 12 Jun 2004 diff --git a/hurd/running/debian/DebianAptOffline.mdwn b/hurd/running/debian/DebianAptOffline.mdwn new file mode 100644 index 00000000..9596040d --- /dev/null +++ b/hurd/running/debian/DebianAptOffline.mdwn @@ -0,0 +1,62 @@ +[[!meta copyright="Copyright © 2005, 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +# How to Installing Packages without a Network Connection from your Hurd Installation + +This procedure is based on that found in +`/usr/share/doc/apt-doc/offline.text.gz` (Debian package `apt-doc`). + +This requires having apt installed on the Host operating system. + +Put a copy of [apt.conf.offline](DebianAptOffline/apt.conf.offline) +into your Debian GNU/Hurd installations /etc/apt/ directory. + +## If you _can_ mount your Debian GNU/Hurd partition from another OS, which can connect to the Internet + +As root on the internet connected OS: + + # mount /dev/DEBIAN_GNU_HURD_PARTITON /mnt + # cd /mnt + # apt-get -c etc/apt/apt.conf.offline {update, upgrade, install foo, etc.} + +Then, reboot into your Debian GNU/Hurd installation and as root, run: + + # apt-get {update, upgrade, install foo, etc.} + +## If you _cannot_ mount your Debian GNU/Hurd partition under another OS. + +From your Debian GNU/Hurd installation run, as the root user: + + # tar cf myhurdsconf.tar /etc/apt/{apt.conf.offline,sources.list} /var/lib/dpkg/status + +Copy _myhurdsconf.tar_ to the remote system. + +This copies your apt configuration and the status of your system +(what packages are installed, which versions, etc.) + +From the remote sytem, as any user, run: + + $ mkdir myhurd + $ cd myhurd + $ tar -xf myhurdsconf.tar + $ mkdir -p var/lib/apt/lists/partial var/cache/apt/archives/partial tmp + $ apt-get -c etc/apt/apt.conf.offline {update, upgrade, install foo, etc.} + $ tar cf myhurdsconf.tar etc/apt/{apt.conf.offline,sources.list} var/ + +Copy _myhurdsconf.tar_ back to your Debian GNU/Hurd system. + +Finally, from your Debian GNU/Hurd installation as the root user: + + # mkdir tmp + # cd tmp + # tar -xf myhurdsconf.tar + # mv var/cache/apt/archives/*.deb /var/cache/apt/archives/ + # mv var/lib/apt/lists/*_* /var/lib/apt/lists/ + # apt-get {update, upgrade, install foo, etc.} diff --git a/hurd/running/debian/DebianAptOffline/apt.conf.offline b/hurd/running/debian/DebianAptOffline/apt.conf.offline new file mode 100644 index 00000000..59aed564 --- /dev/null +++ b/hurd/running/debian/DebianAptOffline/apt.conf.offline @@ -0,0 +1,23 @@ + APT + { + /* This is not necessary if the two machines are the same arch, it tells + the remote APT what architecture the Debian machine is */ + Architecture "hurd-i386"; + + Get::Download-Only "true"; + }; + + Dir + { + /* Use the disc for state information and redirect the status file from + the /var/lib/dpkg default */ + State "./var/lib/apt"; + State::status "./var/lib/dpkg/status"; + + // Binary caches will be stored locally + Cache::archives "./var/cache/apt/archives/"; + Cache "./tmp/"; + + // Location of the source list. + Etc "./etc/apt/"; + }; diff --git a/hurd/running/debian/DebianDpkgArchitecture.mdwn b/hurd/running/debian/DebianDpkgArchitecture.mdwn new file mode 100644 index 00000000..c768ff4e --- /dev/null +++ b/hurd/running/debian/DebianDpkgArchitecture.mdwn @@ -0,0 +1,27 @@ +The output of dpkg-archicture on Debian's hurd-i386 port: + +DEB\_BUILD\_ARCH=hurd-i386 + +DEB\_BUILD\_ARCH\_OS=hurd + +DEB\_BUILD\_ARCH\_CPU=i386 + +DEB\_BUILD\_GNU\_CPU=i486 + +DEB\_BUILD\_GNU\_SYSTEM=gnu + +DEB\_BUILD\_GNU\_TYPE=i486-gnu + +DEB\_HOST\_ARCH=hurd-i386 + +DEB\_HOST\_ARCH\_OS=hurd + +DEB\_HOST\_ARCH\_CPU=i386 + +DEB\_HOST\_GNU\_CPU=i486 + +DEB\_HOST\_GNU\_SYSTEM=gnu + +DEB\_HOST\_GNU\_TYPE=i486-gnu + +-- [[Main/MichaelBanck]] - 14 Jan 2006 diff --git a/hurd/running/debian/DebianIntegrationDeveloper.mdwn b/hurd/running/debian/DebianIntegrationDeveloper.mdwn new file mode 100644 index 00000000..8b34cb7b --- /dev/null +++ b/hurd/running/debian/DebianIntegrationDeveloper.mdwn @@ -0,0 +1,15 @@ +Currently, the [Debian](http://www.debian.org) Project consists of two distinct classes of people - Users and Developers. There is a [Quality Assurance](http://qa.debian.org) group that exists to try to help bridge this gap, however it is not as strong as some people would like it to be. In many ways, a DID is another name for what Debian currently classifies as QA. + +A Debian Integration Developer (DID) is a middle-person, someone to assist users and developers. From a [user](http://www.debian.org/support) perspective they answer, categorize and enhance bug reports with patches or Policy suggestions and generally help with user-level integration of multiple Debian software packages as installed. From a [developer](http://www.debian.org/devel/) perspective they update Debian specific package defaults and configuration systems. Upon reflection, this is also a group of folks that can be described as containing both Developer status (maintaining one package) and those who do not feel comfortable classifying themselves as developers. These groups share common goals. + +Besides these two perspectives, there is also a range of tasks that fall into the domain of "[Quality Assurance](http://qa.debian.org)." Tasks necessary to perform on a range of individual packages such as Policy compliance checking, debconf use, /etc/alternatives and similar debian configuration mechanisms that integrate. The Work Needed and Prospective Packages system is an important function. Questions are sometimes raised regarding the diligence or MIA status of developers, in a way, ensuring the overall quality of the debian operational infrastructure. Gathering feedback from users and developers regarding enhancements and changes to these systems. Helping to Integrate the various infrastructure groups when responding to the environment in which Debian resides in is raising the quality of the organization. Many of the tasks that exist in this grey area can be accomplished by non-packaging maintaining users if they understand how Debian and package maintenance works. + +The more I write and think about this area, the more clearly the concept of idealistic leadership is brought to mind. Yet keys to the success of Debian can be directly attributed to the lack of a centralized organizational structure and a strong set of negotiated policies. + +Software dependencies can be very complex. There is often a need for a semi-knowledgable developer (DID or QA) to understand how things work best in a coordinated manner, how best to Integrate. This is also a natural path from which to recruit new package maintainers if assistance is provided along the way. Another separate group that subscribe to a [mail list](http://lists.debian.org) and perform this extremely valuable service is [Debian-Mentors](http://lists.debian.org/debian-mentors/). + +Recognition for the significance of contribution is one reason to give this group of helpful people more courage and identity in helping the Debian project in a clearly defined and less daunting a way. The [devel](http://www.debian.org/devel) page has relevant links. There is a page describing [how you can help](http://www.debian.org/devel/join/), but (indicating the mentality) it's simply a link to the same page as the first step in the [new maintainer process](http://www.debian.org/devel/join/). Behind this first page is the real [new maintainer page](http://www.debian.org/devel/join/newmaint). There's also a [TODO list](http://www.debian.org/devel/todo/) but it's very very broad. + +Perhaps a little bit of this resides in all members of the Debian community and is an important ingredient to the project's overall success. This may be because the developers are in fact, also the users. This can be extremely demanding for new users of Debian. It does take time to come up to speed with what Debian is about, [who participates](http://www.debian.org/intro/organization) to keep it running as it does and what processes exist. The Bug Tracking System's [pseudo-package list](http://www.debian.org/Bugs/pseudo-packages) may give great insight into some processes. + +-- [[Main/GrantBow]] - 25 Feb 2004 diff --git a/hurd/running/debian/DebianPackages.mdwn b/hurd/running/debian/DebianPackages.mdwn new file mode 100644 index 00000000..7e09dce0 --- /dev/null +++ b/hurd/running/debian/DebianPackages.mdwn @@ -0,0 +1,43 @@ +There are many different systems related to Debian that are related to the efforts. Some of these target information to/from upstream developers, some to end users. Here are some useful links. + +<dl> + <dt><a href="http://qa.debian.org/developer.php" target="_top">Developer Packages Overview</a></dt> + <dd> new system! </dd> +</dl> + +<dl> + <dt><a href="http://bugs.debian.org" target="_top">Bug Tracking System</a></dt> + <dd> also see [[Distrib/BtsFiling]], use a URL like <nop>http://bugs.debian.org/<em>bug-number</em> or <nop>DebianBug:<em>number</em> in a topic using the [[TWiki/InterWikis]] format. </nop></nop></dd> +</dl> + +<dl> + <dt><a href="http://packages.debian.org" target="_top">Package lookup</a></dt> + <dd> also use a URL like <nop>http://packages.debian.org/<em>package-name</em> or <nop>DebianPackage:<em>name</em> in a topic. </nop></nop></dd> +</dl> + +<dl> + <dt><a href="http://packages.qa.debian.org" target="_top">Package Tracking System</a></dt> + <dd><nop>PTS:<em>name</em> in a topic. Email based tracking system to get notices of all package activity - used for packages that highly interest you. This is a new system for Debian and was recently <a href="http://lists.debian.org/debian-devel-announce/2002/debian-devel-announce-200201/msg00011.html" target="_top">announced</a>. </nop></dd> +</dl> + +<dl> + <dt><a href="http://www.debian.gr.jp/~kitame/maint.cgi" target="_top">Package &amp; Maintainer lookup</a></dt> + <dd> from Takuo Kitame </dd> +</dl> + +<dl> + <dt><a href="http://buildd.debian.org/" target="_top">Buildd System</a></dt> + <dd> system to compile and upload binary packages from source automatically. </dd> +</dl> + +<dl> + <dt><a href="http://db.debian.org/" target="_top">Maintainer LDAP</a></dt> + <dd> LDAP directory with the information of Debian developers. </dd> +</dl> + +<dl> + <dt><a href="http://ftp-master.debian.org/testing/update_excuses.html" target="_top">testing "update excuses"</a></dt> + <dd> not needed for Hurd yet. </dd> +</dl> + +-- [[Main/GrantBow]] - 15 Jan 2003 diff --git a/hurd/running/debian/DebianTranslatorPolicy.mdwn b/hurd/running/debian/DebianTranslatorPolicy.mdwn new file mode 100644 index 00000000..7092a761 --- /dev/null +++ b/hurd/running/debian/DebianTranslatorPolicy.mdwn @@ -0,0 +1,40 @@ +**_This page describes the Debian packaging policy for translators._** + +## <a name="Package_Naming_Scheme"> Package Naming Scheme </a> + +Candidates for package naming schemes (_foofs_ is a filesystem based translator, e.g. _tarfs_, _bar_ is a node based translator, e.g. _random_): + +* _foofs-translator_, _bar-translator_ [current favourite] + +* _foofs_, _bar_ [this will make searching somewhat more of a hassle and may easily conflict with already used package names] + +* _foofs-trans_, _bar-trans_ + +* _hurd-translator-foofs_, _hurd-translator-bar_ + +Do we need to destinguish between file system and node based translators? + +Source packages should be called whatever the tarball/cvs module says. + +## <a name="Where_to_Put_Files"> Where to Put Files </a> + +The translators should go into _/hurd_. + +## <a name="What_about_setting_passive_trans"> What about setting passive translators in _/servers_ or _/dev_? </a> + +The idea is that the package should set passive translators in its _postinst_ instructions. + +There may, however, be difficulties with that: it's perfectly valid to have two different _random_ translator packages installed (they won't conflict with each other as long as their file names don't clash), but which one should sit on _/dev/random_ and _/dev/urandom_? Debian's _alternatives system_ doesn't help here, because the translators may need different command line arguments. + +One idea is to have the _postinst_ instructions set the passive translator if there isn't already one set on the relevant node(s). + +## <a name="Short_Long_Description_Guideline"> Short/Long Description Guidelines </a> + + [packagename]: Foo translator for [doing bar]. + Foo is a GNU/Hurd translator which does [bar]. + +## <a name="Miscellaneous"> Miscellaneous </a> + +There could / should be a meta package (or even more than one) that just depends e.g. on all installable translators, so that they'll conveniently find their way into the system by just installing that meta package. + +-- [[Main/MichaelBanck]] - 10 Mar 2006 diff --git a/hurd/running/debian/GNUDebianBuildProcess.mdwn b/hurd/running/debian/GNUDebianBuildProcess.mdwn new file mode 100644 index 00000000..55a9c6aa --- /dev/null +++ b/hurd/running/debian/GNUDebianBuildProcess.mdwn @@ -0,0 +1,133 @@ +components, required and somewhat related - BEFORE you have .debs + +### <a name="Software_States"> Software States </a> + +see [Debian Policy Manual](http://www.debian.org/doc/debian-policy/). + +* Upstream source +* Debian Source Package + * Build-depends +* Debian Binary Package + * Essential - boolean, default is no/unset, see Policy [ref](http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Essential) + * Architecture - policy [ref](http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Architecture) + * Section (main, contrib, non-free, non-US/main, non-US/contrib, non-US/non-free) + * updates, security + * Subsection (admin, base, comm, contrib, devel, doc, editors, electronics, embedded, games, gnome graphics, hamradio, interpreters, kde, libs, libdevel, mail, math, misc, net, news, non-US, non-free, oldlibs, otherosfs, perl, python science, shells, sound, tex, text, utils, web, x11) + * Priority (required, important, standard, optional, extra) policy [ref](http://www.debian.org/doc/debian-policy/ch-archive.html#s-priorities) + * a particular set of packages is called the [Base System](http://www.debian.org/doc/debian-policy/ch-binary.html#s3.7) +* Source and binary package upload example from [new maintainers guide](http://www.debian.org/doc/maint-guide/ch-build.en.html) + * gentoo\_0.9.12.orig.tar.gz + * gentoo\_0.9.12-1.dsc + * gentoo\_0.9.12-1.diff.gz + * gentoo\_0.9.12-1\_i386.deb + * gentoo\_0.9.12-1\_i386.changes + +### <a name="Groups"> Groups </a> + +* software author(s) +* Debian Package Maintainers, Co-Maintainers & uploaders +* ftp-masters +* buildd admins - It seems the two primary buildd admins are Ryan Murray and James Troup. +* QA +* bug-filers +* porters for supported platforms (i386, m69k, sparc, alpha, powerpc, arm, mips, mipsel, hppa, ia64, s390) +* porters for unreleased platforms (amd64, sh) +* porters of non-linux platforms (hurd-i386, netbsd-i386, netbsd-alpha, freebsd-i386) +* International translation providers +* system administrators +* users + +### <a name="Build_Debian_Archive_amp_Debian_"> Build, Debian Archive & Debian Systems Software </a> + +* wanna-build available in the buildd [CVS](http://m68k.debian.org/buildd/getting.html) +* buildd [CVS](http://m68k.debian.org/buildd/getting.html), [statistics](http://buildd.debian.org/stats/) +* [quinn-diff](http://buildd.debian.org/quinn-diff/) with anon-CVS + * July 2002 (samosa.sh ?) hurd output [http://buildd.debian.org/quinn-diff/output/unstable/by\_priority-hurd-i386.txt](http://buildd.debian.org/quinn-diff/output/unstable/by_priority-hurd-i386.txt) + * email [reference](http://lists.debian.org/debian-hurd/2000/debian-hurd-200012/msg00168.html) +* [katie](http://ftp-master.debian.org) (was dinstall), ftp-master + * update-excuses [output](http://ftp-master.debian.org/testing/update_excuses.html) +* andrea, see wanna-build for source (no longer at <http://buildd.debian.org/andrea/> ) +* [madison](http://www.debian.org/doc/developers-reference/ch-resources.en.html#s-madison) from developer's reference +* [fakeroot](http://packages.qa.debian.org/fakeroot) +* [sbuild](http://packages.qa.debian.org/sbuild) +* [pbuilder](http://packages.qa.debian.org/pbuilder) +* turtle [reference](http://lists.debian.org/debian-hurd/2001/debian-hurd-200103/msg00328.html) +* [Package Tracking System](http://lists.debian.org/debian-devel-announce/2002/debian-devel-announce-200201/msg00011.html) (PTS) +* [Bug Tracking System](http://bugs.debian.org) (BTS) + * Release Critical mailing to <debian-devel-announce@lists.debianNOSPAM.org> +* [Work Needed and Prospective Packages](http://www.debian.org/devel/wnpp/) (WNPP) +* [Lintian](http://lintian.debian.org/) +* [apt-proxy](http://packages.qa.debian.org/apt-proxy) or [apt-cacher](http://packages.qa.debian.org/apt-cacher) +* [reportbug](http://packages.qa.debian.org/reportbug) +* [dpkg](http://packages.qa.debian.org/dpkg) +* [apt](http://packages.qa.debian.org/apt) +* grep-dctrl +* dpkg-awk + +also see appendix A [Overview of Debian Maintainer Tools](http://www.debian.org/doc/developers-reference/ap-tools.en.html) in the Developer's Reference. + +### <a name="Input_amp_Output_Files_Formats"> Input & Output Files/Formats </a> + +* sources file from an archive +* packages file from an archive +* log from build process +* lintian report +* debcheck report +* upstream related files (tar.gz, dsc [[SampleDscFile]]) +* source deb +* binary deb +* /etc/apt/sources.list file +* bug reports +* web pages +* location to upload files for incoming: ftp-master.debian.org:/org/ftp.debian.org/incoming/ or via ftp to /pub/UploadQueue/ + +<table border="1" cellpadding="1" cellspacing="0"> + <tr> + <th bgcolor="#99CCCC"><strong>Inputs</strong></th> + <th bgcolor="#99CCCC"><strong>1</strong></th> + <th bgcolor="#99CCCC"><strong>2</strong></th> + <th bgcolor="#99CCCC"><strong>3</strong></th> + <th bgcolor="#99CCCC"><strong>4</strong></th> + </tr> + <tr> + <td> </td> + <td> X </td> + <td> </td> + <td> </td> + <td> </td> + <th bgcolor="#99CCCC"><strong>1</strong></th> + </tr> + <tr> + <td> </td> + <td> </td> + <td> X </td> + <td> </td> + <td> </td> + <th bgcolor="#99CCCC"><strong>2</strong></th> + </tr> + <tr> + <td> </td> + <td> </td> + <td> </td> + <td> X </td> + <td> </td> + <th bgcolor="#99CCCC"><strong>3</strong></th> + </tr> + <tr> + <td> </td> + <td> </td> + <td> </td> + <td> </td> + <td> X </td> + <th bgcolor="#99CCCC"><strong>4</strong></th> + </tr> + <tr> + <td> </td> + <td colspan="4"> </td> + <th align="right" bgcolor="#99CCCC"><strong>Outputs</strong></th> + </tr> +</table> + +also see [[GNUDebianPackages]] for information on what you can do AFTER you have .debs. + +-- [[Main/GrantBow]] - 03 March 2004 diff --git a/hurd/running/debian/GNUDebianPackages.mdwn b/hurd/running/debian/GNUDebianPackages.mdwn new file mode 100644 index 00000000..de1798ad --- /dev/null +++ b/hurd/running/debian/GNUDebianPackages.mdwn @@ -0,0 +1,103 @@ +tools for AFTER you have .debs + +### <a name="Software_States"> Software States </a> + +* Debian Source Package +* Debian Binary Package + * Component (main, contrib, non-free, non-US, updates, security) + * Priority + * Section + * installed state - installed, half-installed, not-installed, unpacked, half-configured, config-files + +### <a name="Groups"> Groups </a> + +* bug-filers +* users + +* Debian Package Maintainers, Co-Maintainers & uploaders +* ftp-masters +* QA +* porters for supported platforms (i386, m69k, sparc, alpha, powerpc, arm, mips, mipsel, hppa, ia64, s390) +* porters for unreleased platforms (amd64, sh) +* porters of non-linux platforms (hurd-i386, netbsd-i386, netbsd-alpha, freebsd-i386) +* International translation providers +* system administrators + +### <a name="Software_amp_Systems"> Software & Systems </a> + +* dselect +* wajig +* grep-dctrl +* dpkg-awk +* [reportbug](http://packages.qa.debian.org/reportbug) +* [dpkg](http://packages.qa.debian.org/dpkg) +* [apt](http://packages.qa.debian.org/apt) + +* [apt-proxy](http://packages.qa.debian.org/apt-proxy) or [apt-cacher](http://packages.qa.debian.org/apt-cacher) +* [Package Tracking System](http://lists.debian.org/debian-devel-announce/2002/debian-devel-announce-200201/msg00011.html) (PTS) +* [Bug Tracking System](http://bugs.debian.org) (BTS) + * Release Critical mailing to <debian-devel-announce@lists.debianNOSPAM.org> +* [Work Needed and Prospective Packages](http://www.debian.org/devel/wnpp/) (WNPP) +* [katie](http://ftp-master.debian.org) (was dinstall), ftp-master + * update-excuses [output](http://ftp-master.debian.org/testing/update_excuses.html) + +### <a name="Input_amp_Output_Files_Formats"> Input & Output Files/Formats </a> + +* sources file from an archive +* packages file from an archive +* source deb +* binary deb +* /etc/apt/sources.list file +* bug reports +* web pages + +<table border="1" cellpadding="1" cellspacing="0"> + <tr> + <th bgcolor="#99CCCC"><strong>Inputs</strong></th> + <th bgcolor="#99CCCC"><strong>1</strong></th> + <th bgcolor="#99CCCC"><strong>2</strong></th> + <th bgcolor="#99CCCC"><strong>3</strong></th> + <th bgcolor="#99CCCC"><strong>4</strong></th> + </tr> + <tr> + <td> </td> + <td> X </td> + <td> </td> + <td> </td> + <td> </td> + <th bgcolor="#99CCCC"><strong>1</strong></th> + </tr> + <tr> + <td> </td> + <td> </td> + <td> X </td> + <td> </td> + <td> </td> + <th bgcolor="#99CCCC"><strong>2</strong></th> + </tr> + <tr> + <td> </td> + <td> </td> + <td> </td> + <td> X </td> + <td> </td> + <th bgcolor="#99CCCC"><strong>3</strong></th> + </tr> + <tr> + <td> </td> + <td> </td> + <td> </td> + <td> </td> + <td> X </td> + <th bgcolor="#99CCCC"><strong>4</strong></th> + </tr> + <tr> + <td> </td> + <td colspan="4"> </td> + <th align="right" bgcolor="#99CCCC"><strong>Outputs</strong></th> + </tr> +</table> + +also see [[GNUDebianBuildProcess]] for tools BEFORE you have .debs + +-- [[Main/GrantBow]] - 03 March 2004 diff --git a/hurd/running/debian/GnuDebianRelationship.mdwn b/hurd/running/debian/GnuDebianRelationship.mdwn new file mode 100644 index 00000000..94fd6265 --- /dev/null +++ b/hurd/running/debian/GnuDebianRelationship.mdwn @@ -0,0 +1,32 @@ +I have hesitated in starting this page due to the sensitive nature of this relationship and the (May 2002) flame war on debian-devel and other mail lists. I believe that rather than guessing about relevant points of the discussion, the facts should be presented in a clear manner. I hope the facts presented here are accurate and precise enough to be helpful in the ongoing discussion. I have not read all messages in all relevant threads. + +This is a work in progress. Please email me directly if you have comments or suggestions. + +* Debian Advantages of Hurd [[porting/guidelines]] Efforts + * One of the first ports to non-Linux system along with \*BSD and win32. + * Official GNU system distribution. + +* Debian Disadvantages of Hurd [porting/guidelines]] Efforts + * Perceived zealous GNU and FSF promotion. + +* Hurd Port Advantages of Debian + * Glibc use. + * Gcc use. + * Debian reputation + * Debian mirror infrastructure - ftp, both official and private. Includes bandwidth, hardware, maintenance efforts. + * Debian www infrastructure - many languages supported, mirrors. + * [Debian developer machine](http://db.debian.org/machines.cgi) infrastructure, many architectures, compile farm, buildd software. + * Many Debian Developers maintaining software packages, bug reports, porting efforts. + * Bug tracking system - BTS infrastructure + * Package infrastructure architecture capabilities are improving. dpkg update in progress. + +* Hurd Port Disadvantages of Debian + * Possible DFSG vs. Free Software compatibility issues. + * BTS Severity practices/use for unreleased ports issues. + * Debian non-parallel development issues. + * [Architecture handling](http://master.debian.org/~brinkmd/arch-handling.txt) issues. + * Linux base history with assumed Linux assumptions. + * Possible incompatibility of third party standards compliance issues. i.e. LSB, FHS, GNU Coding Standards + * Perceived zealous Debian promotion. + +-- [[Main/GrantBow]] - 22 May 2002 diff --git a/hurd/running/debian/MediaPressKitDiscuss.mdwn b/hurd/running/debian/MediaPressKitDiscuss.mdwn new file mode 100644 index 00000000..2bd97290 --- /dev/null +++ b/hurd/running/debian/MediaPressKitDiscuss.mdwn @@ -0,0 +1,76 @@ +# <a name="Media_Press_Kit"> Media / Press Kit </a> + +## <a name="Problem"> Problem </a> + +Debian awareness not as high as other Linux distributions. Some people don't take Debian seriously because of it's organizational structure. Target audience lacks education. Most current Debian users are rather skilled and sometimes PERCIEVED as arrogant. "Non-technical" participation is not fully recognized. + +## <a name="Target_Audience"> Target Audience </a> + +* non-users without any experience of Debian. + * Technically-minded people will often be convinced already of why they should use Debian +* casual users who might be interested in Debian +* ammunition for those who are campaigning to have Debian used + * With our backgrounds, we could emphasize that we can provide material in the langauge that decision-makers can understand. + +## <a name="Debian_Resources"> Debian Resources </a> + +It's important to identify and work with the existing infrastructures for this type of thing. More research about who is out there that is interested in press relations needs to be done before showing the work completed to others. + +* [Contacts](http://www.debian.org/contact) page includes <press@debianNOSPAM.org> but I don't know who's behind that alias. I'll send an email right now to find out. +* [Events team](http://www.debian.org/events/) + * Mail list [debian-events-na](http://lists.debian.org/debian-events-na) + * Mail list [debian-events-eu](http://lists.debian.org/debian-events-eu) +* Debian Weekly News [DWN](http://www.debian.org/News/weekly/) and their mail list [debian-news](http://lists.debian.org/debian-news) +* [debian-announce](http://lists.debian.org/debian-announce) and their [News page](http://www.debian.org/News/) +* [DebianPlanet.org](http://www.debianplanet.org) +* Others? + +## <a name="Solution_Goal"> Solution / Goal </a> + +* persuade people to use Debian +* give target audience realistic expectations of running GNU/Linux + * skills expected + * differences from what they already know +* educate target audience about benefits and advantages of Debian. +* give target audience realistic expectations of running Debian + * skills expected + * differences from what they already know +* background materials, "marketing collateral" + +You have proposed two documents that sound on target to me. + +<dl> + <dt>[[WhyDebian]]</dt> + <dd> A bullet list meant to give a quick answer. </dd> + <dt>[[DebianProductSheet]]</dt> + <dd> includes interesting facts </dd> +</dl> + +The third is a collection of success stories which is more of a process than a clearly defined deliverable in itself. That sounds wonderful. + +I think another active process for tracking recent news (if it doesn't already exist) should also be useful for similar purposes. + +## <a name="Result"> Result </a> + +* two documents: Why Debian? & Debian Product Sheet + * these will be documents of a Debian media/press kit + * processes to keep these documents updated over time. For example, every release. + * beginning of a central repository for info about Debian +* a web repsitory for success stories + * some kind of link or integration with current website. +* increased appreciation by official Debian organization for non-technical participation. +* increased non-technical Debian user involvement +* increased adoption of Debian GNU/Linux by users. +* consideration for using SPI funds for hiring part-time PR resources + +-- [[Main/GrantBow]] - 13 Jan 2003 + +[This article](http://www.theage.com.au/articles/2003/01/08/1041989994382.html) was in the [most recent](http://www.debian.org/News/weekly/2003/02/) version of the [Debian Weekly News](http://www.debian.org/News/weekly/). + +-- [[Main/GrantBow]] - 15 Jan 2003 + +Here are some interesting urls from [this issue](http://www.debian.org/News/weekly/2003/03/) of the Debian Weekly news: + +**Debian Presentations.** Wolfgang Borgert was [looking](http://lists.debian.org/debian-devel-0301/msg00991.html) for a set of slides on dpkg, apt-get and debconf. Javier Fern�ndez-Sanguino Pe�a [intends](http://lists.debian.org/debian-devel-0301/msg01022.html) to provide a 'presentations' section in the [Debian Documentation Project](http://cvs.debian.org/ddp/?cvsroot=debian-doc) (DDP) and has already created an [archive](http://dat.etsit.upm.es/~jfs/debian/www/ddp/slides/) of slides. Whilst the Debian web site does link to [talks](http://www.debian.org/events/talks) given by developers and some [sample slides](http://www.debian.org/events/materials/slides/), it is difficult to gather this information and publish it in a homogeneous way. Talks should be reported to <events@debianNOSPAM.org> and forwarded to him. + +-- [[Main/GrantBow]] - 22 Jan 2003 diff --git a/hurd/running/debian/SampleDscFile.mdwn b/hurd/running/debian/SampleDscFile.mdwn new file mode 100644 index 00000000..d3b7b9f8 --- /dev/null +++ b/hurd/running/debian/SampleDscFile.mdwn @@ -0,0 +1,24 @@ + -----BEGIN PGP SIGNED MESSAGE----- + Hash: SHA1 + + Format: 1.0 + Source: glibc + Version: 2.3.2.ds1-11 + Binary: libc6, libc6-s390x, locales, libc0.3-prof, libc6.1-dev, libc6-i686, libc1-pic, libc6.1-dbg, glibc-doc, libc6-dev-sparc64, libc0.3-dbg, libc6.1-pic, libc6-dbg, libc0.3, libc0.3-pic, libc6.1-prof, libc6.1, libc6-dev-s390x, libc1, libc0.3-dev, libc6-sparcv9, nscd, libc1-dev, libc6-pic, libc6-prof, libc1-prof, libc-udeb, libc6-sparc64, libc6-dev, libc1-dbg + Maintainer: GNU Libc Maintainers + Architecture: any + Standards-Version: 3.6.1.0 + Build-Depends: gettext (>= 0.10.37-1), make (>= 3.80-1), dpkg-dev (>= 1.4.1.5), debianutils (>= 1.13.1), tar (>= 1.13.11), bzip2, texinfo (>= 4.0), linux-kernel-headers (>= 2.5.999-test7-bk-9) [!hurd-i386], mig (>= 1.3-2) [hurd-i386], hurd-dev (>= 20020608-1) [hurd-i386], gnumach-dev [hurd-i386], texi2html, file, gcc-3.3, autoconf, binutils (>= 2.14.90.0.5) [!s390], binutils (>= 2.13.90.0.4-1) [s390], sed (>= 4.0.5-4), gawk, debhelper (>= 4.0.0) + Build-Depends-Indep: perl, po-debconf + Uploaders: Ben Collins , GOTO Masanori , Philip Blundell , Jeff Bailey , Daniel Jacobowitz + Files: + b982bf6ad7ebc8622d3b81d51c44b78a 13246448 glibc_2.3.2.ds1.orig.tar.gz + 2951fde13e9ba21d70d8c7e580849730 1997696 glibc_2.3.2.ds1-11.diff.gz + + -----BEGIN PGP SIGNATURE----- + Version: GnuPG v1.2.3 (GNU/Linux) + + iD8DBQFADZsWbgOPXuCjg3cRAg9LAJ9r3ioJNdzloaM4qQu3FJj2R3y7pQCeNPD+ + i03WJeMdyAhKjHGM2sRqWVk= + =37je + -----END PGP SIGNATURE----- diff --git a/hurd/running/debian/SoftwareLicensing.mdwn b/hurd/running/debian/SoftwareLicensing.mdwn new file mode 100644 index 00000000..e236fea1 --- /dev/null +++ b/hurd/running/debian/SoftwareLicensing.mdwn @@ -0,0 +1,116 @@ +There are differences betwen the [Debian Free Software Guidelines](http://www.debian.org/social_contract#guidelines) (DFSG) and [Free Software](http://www.fsf.org/philosophy/free-sw.html) as defined by the Free Software Foundation. The FSF's GNU project is the sponsor of the GNU/Hurd project. Debian GNU/Hurd is a "port" or distribution of this software. I have not yet performed a comparison between the list of acceptable DFSG licenses (if a list exists) and the acceptable Free Software [license list](http://www.gnu.org/licenses/license-list.html). (Perhaps not directly related but for reference, here's the Open Source [license list](http://www.opensource.org/licenses/index.html)) + +What will this consist of? In the end the result will need to be simply a list of packages with their license marked next to them. This will be relatively simple for those packages that use a standard license. Software that has it's own custom license will need to be categorized. + +I am thinking of ways to automatically check the licenses and to get lists of the various "Priority:" packages. I thought this list of package names would be easy to obtain. The first step is getting the list of packages. This is possible by parsing /var/lib/dpkg/available, using dpkg or using apt-cache. + +The next step is checking the licenses of the packages. There is no dpkg package field available for license. A script that checks licenses will involve using "apt-get source" to check the COPYING and/or similar files in each package. + +-- [[Main/GrantBow]] - 5 Oct 2002 + +I used the following command on an old Hurd machine to get the 22 packages with Essential in their description. I've listed them and put them in a table at the end of this topic. + + sed -e '/./{H;$!d;}' -e 'x;/Essential\:\ yes/!d' /var/lib/dpkg/status | egrep ^Package | sort + +base-files base-passwd bash bsdutils debianutils diff dpkg e2fsprogs fileutils findutils grep gzip hostname hurd ncurses-base ncurses-bin perl-base sed shellutils tar textutils util-linux + +Using `base` instead of `Essential\:\ yes` above I find 64 additional packages. + +adduser alsa-base apt autoconf2.13 bug cpp-3.0 cvs debconf debconf-utils debhelper debiandoc-sgml debian-policy developers-reference exim fetchmail-common g++-3.0 gcc-3.0 gcc-3.0-base gettext gettext-base gnumach groff groff-base inetutils libc0.3 libc0.3-dev libdb2 libdb2++ libdb2-dev libdb2++-dev libdb2-util libdb3 libgdbmg1 libncurses5 libnet-perl libpam0g libpam-runtime libperl5.6 libpopt0 libpopt-dev libreadline4 libstdc++3 libstdc++3-dev libwrap0 libxaw7 man-db mawk mutt netbase passwd perl python python2.1 screen sgmltools-lite slang1 ssh tcpd texinfo xfree86-common xlibs xserver-common xterm xutils + +-- [[Main/GrantBow]] - 11 Jan 2003 + +<table border="1" cellpadding="1" cellspacing="0"> + <tr> + <td> Name </td> + <td> Compatible License? </td> + </tr> + <tr> + <td> base-files </td> + <td> </td> + </tr> + <tr> + <td> base-passwd </td> + <td> </td> + </tr> + <tr> + <td> bash </td> + <td> </td> + </tr> + <tr> + <td> bsdutils </td> + <td> </td> + </tr> + <tr> + <td> debianutils </td> + <td> </td> + </tr> + <tr> + <td> diff </td> + <td> </td> + </tr> + <tr> + <td> dpkg </td> + <td> </td> + </tr> + <tr> + <td> e2fsprogs </td> + <td> </td> + </tr> + <tr> + <td> fileutils </td> + <td> </td> + </tr> + <tr> + <td> findutils </td> + <td> </td> + </tr> + <tr> + <td> grep </td> + <td> </td> + </tr> + <tr> + <td> gzip </td> + <td> </td> + </tr> + <tr> + <td> hostname </td> + <td> </td> + </tr> + <tr> + <td> hurd </td> + <td> </td> + </tr> + <tr> + <td> ncurses-base </td> + <td> </td> + </tr> + <tr> + <td> ncurses-bin </td> + <td> </td> + </tr> + <tr> + <td> perl-base </td> + <td> </td> + </tr> + <tr> + <td> sed </td> + <td> </td> + </tr> + <tr> + <td> shellutils </td> + <td> </td> + </tr> + <tr> + <td> tar </td> + <td> </td> + </tr> + <tr> + <td> textutils </td> + <td> </td> + </tr> + <tr> + <td> util-linux </td> + <td> </td> + </tr> +</table> diff --git a/hurd/running/debian/after_install.mdwn b/hurd/running/debian/after_install.mdwn new file mode 100644 index 00000000..15ca9c83 --- /dev/null +++ b/hurd/running/debian/after_install.mdwn @@ -0,0 +1,111 @@ +First steps after installation. + +So you have managed to get past the first `native-install` runs in single-user +mode? + +Time to get to work. + +[[!toc]] + + +### Get Networking Running + +[[Network]]. + +Check if your NIC was detected by GNU Mach: + + # devprobe eth0 + +`devprobe` (run as user *root*) will print `eth0` on successful detection. If +it doesn't, your NIC was not detected correctly. You can then try to do the +following (also as user *root*) for getting details: + + # cat /dev/klog > ~/klog + [Wait a second, then press `Ctrl-C'.] + +Now examine the `~/klog` file. + +If the NIC was detected: + + # settrans -fgap /servers/socket/2 /hurd/pfinet -i eth0 -a 192.168.1.3 -g 192.168.1.1 -m 255.255.255.0 + +In order to use DHCP, you need to install the `dhcp-client` package and run `dhclient eth0` etc. + +# Setup GRUB + +You surely want grub to have a nice menu entry able to boot GNU, instead of +typing a boring arcane. There are Debian-specific scripts that may help +you. See [[GRUB]]'s page for this. + + +# Setup `apt-get` + +Sometimes getting `apt-get` to work is not straightforward. Good mirrors to +put in `/etc/apt/sources.list` are (as of Jan 2007): + + deb http://mirrors.kernel.org/debian unstable main contrib + deb-src http://mirrors.kernel.org/debian unstable main contrib + deb http://ftp.debian-ports.org/debian unreleased main + deb-src http://ftp.debian-ports.org/debian unreleased main + +`apt-get` update a couple of times if some file fails to download. + +If when doing your first `apt-get`, `dpkg` complains of missing programs, get root in a login shell (`su -`). + +Installing packages without having a network connection is described +[[Distrib/DebianAptOffline]]. + +# [[translator/Random]] + +You often need `scp` and `ssh`. There is now a `random-egd` package available which uses +a random translator by Ryan Hunter and the entropy gathering daemon as entropy source. + +See [[Translator/random]] for more information. + +# [[Console]] + +The latest Hurd package in Debian, plus the `native-install` script, creates +all necessary device nodes and other magic. You just need to edit +`/etc/default/hurd-console` to tune the parameters and tell it to start at +bootup. + +You can also call the Hurd console manually with the proper arguments: + + console -d vga -d pc_kbd --repeat=kbd -d pc_mouse --repeat=mouse \ + -d generic_speaker -c /dev/vcs + + cd /dev + ln -s cons/kbd . + ln -s cons/mouse . + + +# [[Hurd/DebianXorg]] + +You first must have setup the virtual console. See above. + +Assuming you've installed WindowMaker and have tried running `startx` already: + + [/etc/xorg.conf] + + Section "Module" + # Load "dri" + # Load "speedo" + . + . + . + EndSection + + Section "InputDevice" + Identifier "Configured Mouse" + Driver "mouse" + Option "CorePointer" + Option "Device" "/dev/mouse" + Option "Protocol" "osmouse" + EndSection + +Make sure not to have the `Emulate3Buttons` and `ZAxisMapping` settings set, as +they lead to problems with e.g. dragging windows around. + +# What about package XYZ? + +See if you can find a useful tip in [[package_troubleshooting]]. diff --git a/hurd/running/debian/creating_image_tarball.mdwn b/hurd/running/debian/creating_image_tarball.mdwn new file mode 100644 index 00000000..ac91dab4 --- /dev/null +++ b/hurd/running/debian/creating_image_tarball.mdwn @@ -0,0 +1,21 @@ +[[!meta copyright="Copyright © 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +The following [[anonftpsync-ports]] is used to create a local Debian GNU/Hurd +repo. You will need atleast 12G of disk space. Change the +"TO=/home/foo/rsync-debian-ports" to your desired target directory. + +Run it using: + + sudo sh anonftpsync-ports + +In /home/foo/rsync-debian-ports, you will find the following directories: + + base dists indices pool pool-hurd-i386 project diff --git a/hurd/running/debian/creating_image_tarball/anonftpsync-ports b/hurd/running/debian/creating_image_tarball/anonftpsync-ports new file mode 100644 index 00000000..0988dbde --- /dev/null +++ b/hurd/running/debian/creating_image_tarball/anonftpsync-ports @@ -0,0 +1,180 @@ +#! /bin/sh +set -e + +# This script originates from http://www.debian.org/mirror/anonftpsync +# modified by Martin Zobel-Helas <zobel@debian.org>, 2005-01-16 +# these modifications are published under the terms of the GNU GPL +# Modifications: +# + some more documentation about variables +# + added ARCH_EXCLUDE +# + mirror in a safe way, first /pool, then /dists and the rest +# modified by Aurelien Jarno <aurel32@debian.org>, 2007-12-02 +# these modifications are published under the terms of the GNU GPL +# + modifications to mirror debia,-ports.org +# Version: $Id: anonftpsync,v 1.18 2005/10/28 15:25:54 aba Exp $ + + +# Note: You MUST have rsync 2.0.16-1 or newer, which is available in slink +# and all newer Debian releases, or at http://rsync.samba.org/ + +# Set the variables below to fit your site. You can then use cron to have +# this script run daily to automatically update your copy of the archive. + +# Don't forget: +# chmod 744 anonftpsync + +# TO is the destination for the base of the Debian mirror directory +# (the dir that holds dists/ and ls-lR). +# (mandatory) + +TO=/home/foo/rsync-debian-ports + +# RSYNC_HOST is the site you have chosen from the mirrors file. +# (http://www.debian-ports.org/mirrors) +# (mandatory) + +RSYNC_HOST=rsync.debian-ports.org + +# RSYNC_DIR is the directory given in the "Packages over rsync:" line of +# the mirrors file for the site you have chosen to mirror. +# (mandatory) + +RSYNC_DIR=debian/ + +# LOGDIR is the directory where the logs will be written to +# (mandatory) + +LOGDIR=/var/log/rsync-debian-ports + +# ARCH_EXCLUDE can be used to exclude a complete architecture from +# mirrorring. Please use as space seperated list. +# Possible values are: +# armel hurd-i386 kfreebsd-amd64 kfreebsd-i386 +# +# There is one special value: source +# This is not an architecture but will exclude all source code in /pool +# +# eg. +# ARCH_EXCLUDE="hurd-i386" +# +# With a blank ARCH_EXCLUDE you will mirror all availible architectures +# (optional) + +ARCH_EXCLUDE="armel kfreebsd-amd64 kfreebsd-i386 m68k" + +# EXCLUDE is a list of parameters listing patterns that rsync will exclude. +# The following example would exclude mostly everything: +#EXCLUDE="\ +# --exclude binary-hurd-i386/ --exclude binary-kfreebsd-i386/ +# --exclude *_hurd-i386.deb --exclude *_knetbsd-i386.deb \ +# --exclude stable/ --exclude testing/ --exclude unstable/ \ +# --exclude source/ \ +# --exclude *.orig.tar.gz --exclude *.diff.gz --exclude *.dsc \ +# --exclude /base/ --exclude /bochs/ --exclude /obsolete/ \ +# " + +# With a blank EXCLUDE you will mirror the entire archive. +# (optional) + +EXCLUDE="--exclude binary-kfreebsd-i386/ --exclude *_knetbsd-i386.deb \ + --exclude source/ --exclude *.orig.tar.gz --exclude *.diff.gz \ + --exclude /bochs/ --exclude /obsolete/ \ + --exclude *kfreebsd* --exclude *m68* --exclude *sh* \ + " + +# MAILTO is the address to send logfiles to; +# if it is not defined, no mail will be sent +# (optional) + +MAILTO= + +# There should be no need to edit anything below this point, unless there +# are problems. + +#-----------------------------------------------------------------------------# + +# Check for some environment variables +if [ -z $TO ] || [ -z $RSYNC_HOST ] || [ -z $RSYNC_DIR ] || [ -z $LOGDIR ]; then + echo "One of the following variables seems to be empty:" + echo "TO, RSYNC_HOST, RSYNC_DIR or LOGDIR" + exit 2 +fi + +if ! [ -d ${TO}/project/trace/ ]; then + # we are running mirror script for the first time + mkdir -p ${TO}/project/trace +fi + +# Note: on some non-Debian systems, hostname doesn't accept -f option. +# If that's the case on your system, make sure hostname prints the full +# hostname, and remove the -f option. If there's no hostname command, +# explicitly replace `hostname -f` with the hostname. +HOSTNAME=`hostname -f` + +LOCK="${TO}/Archive-Update-in-Progress-${HOSTNAME}" + +# Exclude architectures defined in $ARCH_EXCLUDE +for ARCH in $ARCH_EXCLUDE; do + EXCLUDE=$EXCLUDE"\ + --exclude binary-$ARCH/ \ + --exclude disks-$ARCH/ \ + --exclude installer-$ARCH/ \ + --exclude Contents-$ARCH \ + --exclude Contents-$ARCH.gz \ + --exclude *_$ARCH.deb \ + --exclude *_$ARCH.udeb \ + --exclude pool-$ARCH/" + if [ "$ARCH" == "source" ]; then + SOURCE_EXCLUDE="\ + --exclude *.tar.gz \ + --exclude *.diff.gz \ + --exclude *.dsc " + fi +done + +# Logfile +LOGFILE=$LOGDIR/debian-mirror-ports.log + +# Get in the right directory and set the umask to be group writable +# +cd $HOME +umask 002 + +# Check to see if another sync is in progress +if lockfile -! -l 10800 -r 0 "$LOCK"; then + echo ${HOSTNAME} is unable to start rsync, lock file exists + exit 1 +fi +# Note: on some non-Debian systems, trap doesn't accept "exit" as signal +# specification. If that's the case on your system, try using "0". +trap "rm -f $LOCK > /dev/null 2>&1" exit + +set +e + +# First sync /pool-* +rsync --recursive --links --hard-links --times --verbose \ + $EXCLUDE $SOURCE_EXCLUDE \ + $RSYNC_HOST::$RSYNC_DIR/pool-* $TO >> $LOGFILE 2>&1 +result=$? + +if [ 0 = $result ]; then + # Now sync the remaining stuff + rsync --recursive --links --hard-links --times --verbose --delete-after \ + --exclude "Archive-Update-in-Progress-${HOSTNAME}" \ + --exclude "project/trace/" \ + --exclude "/pool-*/" \ + $EXCLUDE \ + $RSYNC_HOST::$RSYNC_DIR $TO >> $LOGFILE 2>&1 + + date -u > "${TO}/project/trace/${HOSTNAME}" +else + echo "ERROR: Help, something weird happened" | tee -a $LOGFILE + echo "mirroring /pool-* exited with exitcode" $result | tee -a $LOGFILE +fi + + +if ! [ -z $MAILTO ]; then + mail -s "debian ports archive synced" $MAILTO < $LOGFILE +fi + +savelog $LOGFILE diff --git a/hurd/running/debian/faq.mdwn b/hurd/running/debian/faq.mdwn new file mode 100644 index 00000000..8aaadf9c --- /dev/null +++ b/hurd/running/debian/faq.mdwn @@ -0,0 +1,21 @@ +[[!meta copyright="Copyright © 2007, 2009, 2010 Free Software Foundation, +Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +[[!meta title="Debian GNU/Hurd FAQ"]] + +See also [[after_install]] instructions, and other [[/FAQ]]. + +[[!inline +pages="hurd/running/debian/faq/* and !*/discussion" +show=0 +feeds=no +actions=yes +rootpage="hurd/running/debian/faq" postformtext="Add a new item titled:"]] diff --git a/hurd/running/debian/faq/2_gib_partition_limit.mdwn b/hurd/running/debian/faq/2_gib_partition_limit.mdwn new file mode 100644 index 00000000..195191cb --- /dev/null +++ b/hurd/running/debian/faq/2_gib_partition_limit.mdwn @@ -0,0 +1,13 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +[[!meta title="2 GiB Partition Limit"]] + +The 2 GiB limit has been removed in Debian GNU/Hurd. diff --git a/hurd/running/debian/faq/512_mib_ram_limit.mdwn b/hurd/running/debian/faq/512_mib_ram_limit.mdwn new file mode 100644 index 00000000..f89a5c01 --- /dev/null +++ b/hurd/running/debian/faq/512_mib_ram_limit.mdwn @@ -0,0 +1,21 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +[[!meta title="512 MiB RAM Limit"]] + +Just like any 32bit OS without bad tricks, GNU Mach does not cope well with lots +of memory. Newer versions of the Debian `gnumach` package will limit themselves +to around 1 GiB of memory. If you want more, you can twiddle the VM_MAX_ADDRESS +limit between kernelland and userland in i386/include/mach/i386/vm_param.h. + +If you have an older version, or still experience problems with `vmstat` (see +above) reported much less memory than you have, the best is to limit the memory +it can see via GRUB's `upppermem` feature. Add `uppermem 786432` to GRUB's Hurd +entry in `menu.lst`. diff --git a/hurd/running/debian/faq/apt_umount.mdwn b/hurd/running/debian/faq/apt_umount.mdwn new file mode 100644 index 00000000..db0dbfd1 --- /dev/null +++ b/hurd/running/debian/faq/apt_umount.mdwn @@ -0,0 +1,25 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +[[!meta title="apt: unmount cdroms"]] + +You can add a shell script umount so that apt can automatically unmount cdroms. + + #!/bin/sh + # Filename: /usr/bin/umount + + settrans -fg "$@" + +Give executable permission to the script. + + # chmod +x /usr/bin/umount + +In `/etc/fstab` add a trailing `/` after cdrom like `/cdrom/` since apt uses a +trailing `/`. diff --git a/hurd/running/debian/faq/bad_hypermeta_data.mdwn b/hurd/running/debian/faq/bad_hypermeta_data.mdwn new file mode 100644 index 00000000..bc960e30 --- /dev/null +++ b/hurd/running/debian/faq/bad_hypermeta_data.mdwn @@ -0,0 +1,15 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +If you get the error `bad hypermeta data` when trying to mount an ext3 +partition from GNU/Linux, that is usually because the file system has not been +unmounted cleanly (maybe GNU/Linux got suspended to disk) and the Hurd cannot +mount it as ext2 without checking. Either boot back into GNU/Linux and unmount +it or you can try to run `fsck.ext3` from GNU/Hurd directly. diff --git a/hurd/running/debian/faq/debugging_inside_glibc.mdwn b/hurd/running/debian/faq/debugging_inside_glibc.mdwn new file mode 100644 index 00000000..91b71d64 --- /dev/null +++ b/hurd/running/debian/faq/debugging_inside_glibc.mdwn @@ -0,0 +1,19 @@ +[[!meta copyright="Copyright © 2007, 2008, 2009 Free Software Foundation, +Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +To get [[debugging]] information for glibc, you need to install the +`libc0.3-dbg` package. At the place [[debugging/GDB]] looks for debugging +symbols by default (`/usr/lib/debug/lib/`), Debian's `libc0.3-dbg` stores only +the frame unwind information used for backtracing. If you want to step into +glibc while debugging, you need to add `LD_LIBRARY_PATH=/usr/lib/debug` to +debugged program's environment (`set env VAR value` from the GDB command line). +If that still does not work, try `LD_PRELOAD=/usr/lib/debug/libc.so.0.3` +instead. diff --git a/hurd/running/debian/faq/debugging_translators.mdwn b/hurd/running/debian/faq/debugging_translators.mdwn new file mode 100644 index 00000000..b55484e1 --- /dev/null +++ b/hurd/running/debian/faq/debugging_translators.mdwn @@ -0,0 +1,15 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +In order to [[debug|debugging]] translators and being able to step into glibc +during it, you need the `hurd-dbg` and `libc0.3-dbg` packages installed. If you need to debug the initialization of the translator, +start the translator like `settrans -P /foo /usr/bin/env +LD\_LIBRARY\_PATH=/usr/lib/debug /hurd/foofs`. The `-P` option will make it +pause and you will be able to attach [[debugging/GDB]] to the process. diff --git a/hurd/running/debian/faq/dev_random.mdwn b/hurd/running/debian/faq/dev_random.mdwn new file mode 100644 index 00000000..3b5fdffe --- /dev/null +++ b/hurd/running/debian/faq/dev_random.mdwn @@ -0,0 +1,17 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +[[!meta title="/dev/random"]] + +There is no random device by default as no secure implementation has been +finished yet. An easy (but very insecure) work-around is to copy a binary file +like `/bin/bash` to `/dev/random` and `/dev/urandom`. A slightly more secure +alternative is installing the `random-egd` from the `debian-ports` repository. + diff --git a/hurd/running/debian/faq/df.mdwn b/hurd/running/debian/faq/df.mdwn new file mode 100644 index 00000000..4de232da --- /dev/null +++ b/hurd/running/debian/faq/df.mdwn @@ -0,0 +1,13 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +There is no `/etc/mtab`, so just running `df` will yield an error. Pass `df` a +path like `df /` or `df ./` to see the disk usage of that particular file +system. diff --git a/hurd/running/debian/faq/eata.mdwn b/hurd/running/debian/faq/eata.mdwn new file mode 100644 index 00000000..fa7dbdec --- /dev/null +++ b/hurd/running/debian/faq/eata.mdwn @@ -0,0 +1,13 @@ +[[!meta copyright="Copyright © 2010 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +In some virtual machines (e.g. VirtualBox), "probing eata on XXX" may be +quite long. This is apparently due to poor efficiency of the virtualizer, not +Mach. There is no such issue on real hardware or using qemu/kvm. diff --git a/hurd/running/debian/faq/free_memory.mdwn b/hurd/running/debian/faq/free_memory.mdwn new file mode 100644 index 00000000..c1c0a83c --- /dev/null +++ b/hurd/running/debian/faq/free_memory.mdwn @@ -0,0 +1,11 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +Run `vmstat` to see memory and swap usage. diff --git a/hurd/running/debian/faq/hurd_console.mdwn b/hurd/running/debian/faq/hurd_console.mdwn new file mode 100644 index 00000000..c4a619a1 --- /dev/null +++ b/hurd/running/debian/faq/hurd_console.mdwn @@ -0,0 +1,12 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +Edit `/etc/default/hurd-console` to configure the Hurd console and enable it on +bootup. See [[console]] for further information about the Hurd console. diff --git a/hurd/running/debian/faq/kernel_logs.mdwn b/hurd/running/debian/faq/kernel_logs.mdwn new file mode 100644 index 00000000..ff14ce5f --- /dev/null +++ b/hurd/running/debian/faq/kernel_logs.mdwn @@ -0,0 +1,13 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +The kernel logs are written to `/dev/klog`. Run `cat /dev/klog > foo` as root +and hit `ctrl+c` after a few seconds to catch the logs. You can do this only +once and do not do this in single-user mode (where `ctrl+c` does not work). diff --git a/hurd/running/debian/faq/other_repositories.mdwn b/hurd/running/debian/faq/other_repositories.mdwn new file mode 100644 index 00000000..88781d46 --- /dev/null +++ b/hurd/running/debian/faq/other_repositories.mdwn @@ -0,0 +1,16 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +If you want to use the `apt-get source` facility, make sure that +`/etc/apt/sources.list` contains a line like + + deb-src http://ftp.de.debian.org/debian unstable main + +... replacing _de_ with your homeland's code. diff --git a/hurd/running/debian/faq/ps_hangs.mdwn b/hurd/running/debian/faq/ps_hangs.mdwn new file mode 100644 index 00000000..febfeb59 --- /dev/null +++ b/hurd/running/debian/faq/ps_hangs.mdwn @@ -0,0 +1,12 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +If `ps` hangs, try `ps -M` which might still work by not getting detailed +information from processes. diff --git a/hurd/running/debian/faq/reporting_bugs.mdwn b/hurd/running/debian/faq/reporting_bugs.mdwn new file mode 100644 index 00000000..40781ab0 --- /dev/null +++ b/hurd/running/debian/faq/reporting_bugs.mdwn @@ -0,0 +1,19 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +Please try to reproduce bugs which are not obviously Hurd-specific on Debian +GNU/Linux and then file them there. + +If you find a genuine issue in Debian GNU/Hurd, please file it in our Alioth +bug tracker at +<http://alioth.debian.org/tracker/?atid=411594&group_id=30628&func=browse> +If you find a bug in the Hurd or GNU Mach themselves, either file a bug against +the respective Debian packages, or directly at +<http://savannah.gnu.org/bugs/?group=hurd> diff --git a/hurd/running/debian/faq/sata_disk_drives.mdwn b/hurd/running/debian/faq/sata_disk_drives.mdwn new file mode 100644 index 00000000..dad10cb9 --- /dev/null +++ b/hurd/running/debian/faq/sata_disk_drives.mdwn @@ -0,0 +1,11 @@ +[[!meta copyright="Copyright © 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +GNU Mach does not support SATA disk drives (/dev/sda etc. in GNU/Linux) natively, so using device:sd0s1 will not work, sd* devices are for SCSI drives only. The only way to get those drives to work is to put them into compatibility mode in the BIOS, if such an option exists. GNU Mach will then recognize them as hda etc. diff --git a/hurd/running/debian/faq/sshd_only_works_for_root_logins.mdwn b/hurd/running/debian/faq/sshd_only_works_for_root_logins.mdwn new file mode 100644 index 00000000..517d59dc --- /dev/null +++ b/hurd/running/debian/faq/sshd_only_works_for_root_logins.mdwn @@ -0,0 +1,14 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +Privilege seperation does not work with Hurd currently. You need to explicitely +set `PrivilegeSeparation` to `no` in `/etc/ssh/sshd_options`, just commenting out +the entry will not work as it is on by default. Also make sure you have +`/dev/random`, see below. diff --git a/hurd/running/debian/faq/xserver-common.mdwn b/hurd/running/debian/faq/xserver-common.mdwn new file mode 100644 index 00000000..09fbc902 --- /dev/null +++ b/hurd/running/debian/faq/xserver-common.mdwn @@ -0,0 +1,12 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +You need to run `dpkg-reconfigure xserver-common` and select `Anybody` for +starting X as there is no way to detect console users currently. diff --git a/hurd/running/debian/package_troubleshooting.mdwn b/hurd/running/debian/package_troubleshooting.mdwn new file mode 100644 index 00000000..43ecbc77 --- /dev/null +++ b/hurd/running/debian/package_troubleshooting.mdwn @@ -0,0 +1,48 @@ +This page reports known Hurd-specific bugs, quirks and corresponding solutions and workarounds with Debian GNU/Hurd package installation and working. + +## <a name="Dpkg_wants_external_programs_"> Dpkg wants external programs? </a> + +It may be that dpkg wants external GNU/Linux-specific programs that it can't found or that just don't exist on the Hurd. You can trick dpkg by copying and running this script as root: + + #!/bin/bash + ln -s /sbin/ldconfig /bin/ldconfig + ln -s /bin/true /bin/update-rc.d + ln -s /bin/true /bin/start-stop-daemon + ln -s /bin/true /bin/install-info + ln -s /bin/true /bin/update-alternatives + +## <a name="SSH_not_working"> </a> SSH not working + +You must set up the [[translator/random]] device first. + +## <a name="An_X_package_hangs_at_startup_wi"> An X package hangs at startup without error messages </a> + +Observed with GTK programs like xchat, synaptic, inkscape. It is an issue with libpthread that (as of 04 Feb 2007) is still unresolved. Sorry. + +## <a name="Borked_fonts_on_GTK_app"> </a> Borked fonts on GTK app + +This is related to issues in Pango. + +* Install pango-dev package +* Run as root: + + pango-querymodules > /etc/pango/pango.modules + +## <a name="Installing_a_package_seems_to_ha"> Installing a package seems to hang forever </a> + +There are various reasons for this. + +* If interrupting the process with ctrl-c gives a line like that: + + File "/usr/lib/python2.4/os.py", line 723, in urandom + bytes += read(_urandomfd, n - len(bytes)) + KeyboardInterrupt + +it is the random device fault. Follow the [[translator/random]] guide. If you already did, try _anyway_ to detach and reattach the translators. + +## <a name="Cannot_compile_even_trivial_C_pr"> Cannot compile even trivial C programs </a> + +Check to have installed the following: + + apt-get install build-essential + apt-get install libc-dev diff --git a/hurd/running/debian/patch_submission.mdwn b/hurd/running/debian/patch_submission.mdwn new file mode 100644 index 00000000..66348dd9 --- /dev/null +++ b/hurd/running/debian/patch_submission.mdwn @@ -0,0 +1,55 @@ +[[!meta copyright="Copyright © 2007, 2008 Free Software Foundation, Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +If you fixed a Debian package which *FTBFS* (fails to build from source), you +should submit the patch so that all users can profit from your work. + +If it is not a Debian-specific patch, you should strongly consider submitting +the patch upstream for inclusion. This applies even more so if it is a GNU +package, or otherwise frequently used package, or you know upstream anyway. + +If you had to change the code considerably and are not 100% sure you did not +introduce a regression, or are not very experienced with these kinds of code +changes, you should first submit your patch for review to the [Debian alioth +patch +tracker](http://alioth.debian.org/tracker/?atid=410472&group_id=30628&func=browse). + +If the patch is trivial, or one of the Debian porters approved your patch for +submission, submit the patch to the Debian BTS (bug tracking system). You can +either use the reportbug tool, or just simple mail. In any case, you should +follow these guidelines: + + * The submission address is <submit@bugs.debian.org>. + * The mail's subject (which will become the bug's title) should be + `SOURCE-PACKAGE: FTBFS on hurd-i386: REASON`. + * The first lines of the mail's body (the so-called *pseudo-header*): + * `Severity: important` -- not *serious*. + * `Version: VERSION` -- the version of the source package in unstable. + * `Tags: patch` -- as/if you include a ready-to-be-applied patch. + * `User: debian-hurd@lists.debian.org` + * `Usertags: hurd` + +In the bug description, mention that the package fails to build on hurd-i386 +and (if possible) quote the failure. If possible, point to the failing build +log from <http://buildd.debian-ports.org/build.php> or elsewhere. + +Then, explain the failure (Debian maintainers usually do not know much about +Hurd-specific failures), and attach the patch. + +The patch should be in unidiff form. + +If the package uses a patch system, it is preferable to submit the patch in a +ready-to-use form (e.g. as a *dpatch*), but this is not required. Also, try to +keep the patch small, e.g., do not submit a 100 KiB autotools diff for a +one-line change in `configure.in` or a `Makefile.am`, but in this case mention +that autotools need to be rerun and let the maintainer choose (you can suggest +you would file a complete diff if the maintainer prefers). + +Last but not least, try to be courteous. diff --git a/hurd/running/debian/porting.mdwn b/hurd/running/debian/porting.mdwn new file mode 100644 index 00000000..0eb15465 --- /dev/null +++ b/hurd/running/debian/porting.mdwn @@ -0,0 +1,54 @@ +[[!meta copyright="Copyright © 2007, 2008, 2009, 2010 Free Software Foundation, +Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled +[[GNU Free Documentation License|/fdl]]."]]"""]] + +[[!meta title="Debian packages that need porting"]] + +More than half of the Debian archive has been compiled successfully on the +Hurd, however, many programs fail to build for various reasons. + +A [list of build failures including error +messages](http://unstable.buildd.net/buildd/hurd-i386_Failed.html) can be +found, as well as a [preliminary +analysis](http://lists.debian.org/debian-hurd/2007/07/msg00000.html) of them and [solutions](http://lists.debian.org/debian-hurd/2007/07/msg00001.html), and some more details in [[hurd/porting/guidelines]]. [Graphs and statistics](http://people.debian.org/~sthibault/) about the consequence in terms of build dependencies are available. + +There is a mailing list, +[debian-hurd-build-logs](http://lists.alioth.debian.org/mailman/listinfo/debian-hurd-build-logs), +where *builds logs from the Debian GNU/Hurd autobuilders* are posted. It is a +high-traffic and high-volume list, and for that reason *not* archived, so you +have to subscribe to see the messages. + +It might be a good idea to record your intention to port something either in +the list below or in the [Alioth task +tracker](http://alioth.debian.org/pm/task.php?group_project_id=34&group_id=30628&func=browse) +so other people do not do duplicated work. + +Also, the [[community/HurdFr]] guys maintain their own [liste des travaux de +packaging](http://wiki.hurdfr.org/index.php/Liste_des_travaux_de_packaging). + +Aside from the Alioth task tracker, here is a list of some packages (the +important ones, as they're, e.g., blocking other packages from being built) +that need someone to work on them. + +When you have a patch to submit, please adhere to the [[patch_submission]] +guidelines. + +There is also further information available about [[hurd/porting]]. + +[[!map +pages="tagged(open_issue_porting) and !tagged(fixed_in_debian) and !*/discussion" +show=title]] + +[[!inline +pages="tagged(open_issue_porting) and !tagged(fixed_in_debian) and !*/discussion" +show=0 +feeds=no +actions=yes +rootpage="open_issues" postformtext="Add a new item titled:"]] diff --git a/hurd/running/debian/status.mdwn b/hurd/running/debian/status.mdwn new file mode 100644 index 00000000..95e48edc --- /dev/null +++ b/hurd/running/debian/status.mdwn @@ -0,0 +1,4 @@ +Debian GNU/Hurd is currently an official, non-releasing Debian port. I.e., there is no testing or stable distribution. + + - [Build daemon/archive status](http://unstable.buildd.net/buildd/hurd-i386_stats) + - [Number of registered users](http://buildd.net/cgi/archvote.phtml) |