dec-multia: make netboot possible, add aboot bootloader

28 files changed, 3849 insertions, 0 deletions

diff --git a/package/aboot/src/doc/man/Makefile b/package/aboot/src/doc/man/Makefile
new file mode 100644
index 000000000..4ccdd4c0d
--- /dev/null
+++ b/package/aboot/src/doc/man/Makefile
@@ -0,0 +1,51 @@
+# eventually this should have rules for recreating the man pages from the 
+# sgml source, but since this doesn't work on my machine right now i'm
+# leaving it out.
+
+# if this is a recursive make, and mandir was set in the top-level Makefile,
+# use that value. Otherwise default to /usr/man.
+
+ifeq ($(mandir),)
+MANDIR=/usr/man
+else
+MANDIR=$(mandir)
+endif
+MAN1=$(MANDIR)/man1
+MAN5=$(MANDIR)/man5
+MAN8=$(MANDIR)/man8
+
+all: aboot.8 aboot.conf.5 abootconf.8 isomarkboot.1 sdisklabel.8 netabootwrap.1
+
+install: 
+	install -d $(MAN1) $(MAN5) $(MAN8)
+	install -c isomarkboot.1 netabootwrap.1 $(MAN1)
+	install -c aboot.conf.5 $(MAN5)
+	install -c aboot.8 abootconf.8 e2writeboot.8 swriteboot.8 sdisklabel.8 $(MAN8)	
+install-gz: install
+	gzip -f9 $(MAN1)/isomarkboot.1 $(MAN1)/netabootwrap.1
+	gzip -f9 $(MAN5)/aboot.conf.5
+	gzip -f9 $(MAN8)/aboot.8 $(MAN8)/abootconf.8 $(MAN8)/e2writeboot.8 \
+		 $(MAN8)/swriteboot.8 $(MAN8)/sdisklabel.8
+install-gzip: install-gz
+
+clean:
+	rm -f aboot.8 aboot.conf.5 abootconf.8 isomarkboot.1 sdisklabel.8 netabootwrap.1 manpage.log manpage.links manpage.refs
+
+aboot.8: aboot.sgml
+	nsgmls aboot.sgml | sgmlspl sgmlspl-specs/docbook2man-spec.pl
+
+aboot.conf.5: aboot.conf.sgml
+	nsgmls aboot.conf.sgml | sgmlspl sgmlspl-specs/docbook2man-spec.pl
+
+abootconf.8: abootconf.sgml
+	nsgmls abootconf.sgml | sgmlspl sgmlspl-specs/docbook2man-spec.pl
+
+isomarkboot.1: isomarkboot.sgml
+	nsgmls isomarkboot.sgml | sgmlspl sgmlspl-specs/docbook2man-spec.pl
+
+netabootwrap.1: netabootwrap.sgml
+	nsgmls netabootwrap.sgml | sgmlspl sgmlspl-specs/docbook2man-spec.pl
+
+sdisklabel.8: sdisklabel.sgml
+	nsgmls sdisklabel.sgml | sgmlspl sgmlspl-specs/docbook2man-spec.pl
+
diff --git a/package/aboot/src/doc/man/README b/package/aboot/src/doc/man/README
new file mode 100644
index 000000000..f2af31271
--- /dev/null
+++ b/package/aboot/src/doc/man/README
@@ -0,0 +1,32 @@
+This compilation contains man pages for various boot aspects on the Linux/Alpha
+platform. They are licensed under the GPL. Comments, suggestions and patches
+should be forwarded either to me or to the current aboot maintainer.
+
+The following files are included:
+
+README             this document
+aboot.8            man pages for aboot
+aboot.sgml         sgml-source for man page for aboot
+aboot.conf.5       man page for configuration file etc/aboot.conf
+aboot.conf.sgml    sgml-source for above man page
+abootconf.8        man page for abootconf
+abootconf.sgml     sgml-source for man page for abootconf
+e2writeboot.8      man page for e2writeboot (from aboot 7a tarball, modified)
+swriteboot.8       man page for swriteboot (from debian distribution, modified)
+isomarkboot.sgml   sgml-source for man page for isomarkboot
+isomarkboot.8      man page for isomarkboot
+sdisklabel.sgml    sgml-source for man page for sdisklabel
+sdisklabel.8       man page for sdisklabel
+
+Since I have no experience regarding e2writeboot and swriteboot I made only
+small modifications in these man pages.
+
+The list of authors was verified as best as possible (by contacting all
+person still reachable via email), if you feel this is not complete/accureate
+please contact me.
+
+Technical note:
+To create the nroff version from the SGML sources, nsgml was used like
+        nsgmls abootconf.sgml | sgmlspl sgmlspl-specs/docbook2man-spec.pl
+
+Hannover, Germany, January 17th 2003
diff --git a/package/aboot/src/doc/man/aboot.8 b/package/aboot/src/doc/man/aboot.8
new file mode 100644
index 000000000..5aa86a568
--- /dev/null
+++ b/package/aboot/src/doc/man/aboot.8
@@ -0,0 +1,57 @@
+.\" This manpage has been automatically generated by docbook2man-spec
+.\" from a DocBook document.  docbook2man-spec can be found at:
+.\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> 
+.\" Please send any bug reports, improvements, comments, patches, 
+.\" etc. to Steve Cheng <steve@ggi-project.org>.
+.TH "ABOOT" "8" "11 Juli 2002" "aboot" ""
+.SH NAME
+aboot \- The secondary boot loader for Linux/Alpha
+.SH "COPYRIGHT"
+.PP
+\fBaboot\fR is Copyright (C) 1996 Linus Torvalds, David Mosberger-Tang and Michael Schwingen
+.SH "DESCRIPTION"
+.PP
+
+\fBaboot\fR is the secondary boot loader needed if
+the Linux/Alpha system is booted via SRM. It is usually installed during
+system installation by \fBswriteboot\fR(8). 
+.PP
+To automate the booting process predefined boot configurations can be stored
+in \fIetc/aboot.conf\fR(5). 
+.PP
+\fBaboot\fR can also be used interactively by issuing
+.PP
+\fBboot \fIdka0 -fl "i"\fB\fR
+.PP
+at the SRM-Prompt where dka0 has to be replaced by the device used. 
+.PP
+In the interactive mode you can use the command h to show your current
+\fIetc/aboot.conf\fR and then the appropriate number
+(or a complete boot command as in SRM) to boot Linux.
+.PP
+If you do not want to use the \fIetc/aboot.conf\fR as set
+up by \fBabootconf\fR you can explicitly tell 
+\fBaboot\fR where to look for \fIetc/aboot.conf\fR by prepending the number of the configuration with the proper
+partition, i.e. if your \fIetc/aboot.conf\fR is on your
+second partition and you want to boot the entry labeled three you would
+issue
+.PP
+\fBboot \fIdqa -fl "2:3"\fB\fR
+.PP
+Note that this applies to Linux booting via SRM only as
+VMS, Tru64, *BSD and
+Windows NT each have their own secondary boot loader.
+Furthermore \fBaboot\fR is also not needed if the system is booted via
+\fBmilo\fR.
+.SH "AUTHOR"
+.PP
+This man page was written by Helge Kreutzmann
+<kreutzm@itp.uni-hannover.de> for the Debian GNU/Linux project
+but may be used by others.
+.SH "FILES"
+.PP
+\fIetc/aboot.conf\fR
+.SH "SEE ALSO"
+.PP
+\fBabootconf\fR(8), \fIaboot.conf\fR(5),
+\fBswriteboot\fR(8), HP SRM Manual
diff --git a/package/aboot/src/doc/man/aboot.conf.5 b/package/aboot/src/doc/man/aboot.conf.5
new file mode 100644
index 000000000..b3cb49393
--- /dev/null
+++ b/package/aboot/src/doc/man/aboot.conf.5
@@ -0,0 +1,81 @@
+.\" This manpage has been automatically generated by docbook2man-spec
+.\" from a DocBook document.  docbook2man-spec can be found at:
+.\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> 
+.\" Please send any bug reports, improvements, comments, patches, 
+.\" etc. to Steve Cheng <steve@ggi-project.org>.
+.TH "ABOOT.CONF" "5" "16 Juli 2003" "aboot.conf" ""
+.SH NAME
+aboot.conf \- The configuration file for aboot(8)
+.SH "DESCRIPTION"
+.PP
+
+\fIaboot.conf\fR contains a list of boot settings
+for \fBaboot\fR(8). Each boot setting
+has a unique number which can be supplied at the SRM-Prompt.
+.
+.PP
+\fIaboot.conf\fR must be in a directory called
+\fIetc\fR on the \fBsame partition\fR
+as your kernels reside on unless you explicitly list the partitions
+for your kernels (see below for details). So if you create a separate
+boot partition (called \fI/boot\fR) then
+\fIaboot.conf\fR should reside in \fI/boot/etc/\fR.
+.PP
+In the following example the kernels reside on a different partition (hda4)
+then \fI/\fR belongs to (hda5) while in the fourth
+line \fI/boot\fR is on the same partition (hda6) as
+\fI/\fR.
+Therefore \fIaboot.conf\fR can be located on any of the
+three partitions but \fBalways\fR in a directory
+\fIetc\fR at the top level of the file system on that
+partition. You can change the partition to use with
+\fBabootconf\fR(8).
+.PP
+.SS "EXAMPLE ABOOT.CONF"
+.sp
+.RS
+.sp
+.nf
+0:4/vmlinuz root=/dev/hda5
+1:4/vmlinuz root=/dev/hda5 single
+2:4/vmlinuz.old ro root=/dev/hda5
+3:4/vmlinuz-2.4.9-32 root=/dev/sdc3 initrd=/initrd-2.4.9-32.img console=tty0
+8:6/boot/vmlinuz ro root=/dev/hda6
+.sp
+.fi
+.RE
+.sp
+.PP
+The first number is a unique identifier for each boot configuration.
+To boot a certain configuration at the SRM-Prompt you would issue
+.PP
+\fBboot \fIdka0 -fl "0"\fB\fR
+.PP
+where dka0 has to be replaced by your boot device and the boot configuration
+(0 in this case) can be replaced by any defined in 
+\fIetc/aboot.conf\fR.
+.PP
+After the colon the number of the partition the kernel resides on is given. 1
+corresponds to the BSD partition labeled A:, 2 to B: and so on. 
+.PP
+After the slash the name of the kernel to boot is given, including a possible
+path. If your kernel does not reside on a file system but is located directly
+after \fBaboot\fR at the beginning of the hard disk
+you would omit the number, the slash and the kernel name.
+.PP
+Next the name of the partition to mount as \fI/\fR is given.
+Other kernel parameters follow as required. As shown also an initrd can be
+specified.
+.PP
+The contents of this file can be shown before booting if necessary by
+using the interactive
+mode of \fBaboot\fR(8) (booting with the flag "i")
+and then issuing "h" at the \fBaboot\fR-prompt.
+.SH "AUTHOR"
+.PP
+This man page was written by Helge Kreutzmann
+<kreutzm@itp.uni-hannover.de> for the Debian GNU/Linux project but
+may be used by others.
+.SH "SEE ALSO"
+.PP
+\fBaboot\fR(8), \fBabootconf\fR(8), \fBswriteboot\fR(8), HP SRM Manual
diff --git a/package/aboot/src/doc/man/aboot.conf.sgml b/package/aboot/src/doc/man/aboot.conf.sgml
new file mode 100644
index 000000000..f29813e7f
--- /dev/null
+++ b/package/aboot/src/doc/man/aboot.conf.sgml
@@ -0,0 +1,106 @@
+<!DOCTYPE RefEntry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
+<refentry id="aboot.conf">
+
+<refmeta>
+<refentrytitle>aboot.conf</refentrytitle>
+<manvolnum>5</manvolnum>
+<refmiscinfo>aboot.conf</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+<refname>aboot.conf</refname>
+<refpurpose>The configuration file for <application>aboot</application>(8)
+</refpurpose>
+</refnamediv>
+
+<refsect1><title>DESCRIPTION</title>
+<para>
+<indexterm><primary>aboot.conf</primary></indexterm>
+<filename>aboot.conf</filename> contains a list of boot settings
+for <application>aboot</application>(8). Each boot setting
+has a unique number which can be supplied at the SRM-Prompt.
+<indexterm><primary>SRM</primary></indexterm>.
+</para>
+<para>
+<filename>aboot.conf</filename> must be in a directory called
+<filename>etc</filename> on the <emphasis>same partition</emphasis>
+as your kernels reside on unless you explicitly list the partitions
+for your kernels (see below for details). So if you create a separate
+boot partition (called <filename>/boot</filename>) then
+<filename>aboot.conf</filename> should reside in <filename>/boot/etc/</filename>.
+</para>
+<para>
+In the following example the kernels reside on a different partition (hda4)
+then <filename>/</filename> belongs to (hda5), while in the fifth
+line <filename>/boot</filename> is on the same partition (hda6) as
+<filename>/</filename>.
+Therefore <filename>aboot.conf</filename> can be located on any of the
+three partitions but <emphasis>always</emphasis> in a directory
+<filename>etc</filename> at the top level of the file system on that
+partition. You can change the partition to use with
+<application>abootconf</application>(8).
+</para>
+<para><example>
+<title>Example <filename>aboot.conf</filename></title>
+<blockquote>
+<literallayout>
+0:4/vmlinuz root=/dev/hda5
+1:4/vmlinuz root=/dev/hda5 single
+2:4/vmlinuz.old ro root=/dev/hda5
+3:4/vmlinuz-2.4.9-32 root=/dev/sdc3 initrd=/initrd-2.4.9-32.img console=tty0
+8:6/boot/vmlinuz ro root=/dev/hda6
+</literallayout>
+</blockquote>
+</example></para>
+<para>
+The first number is a unique identifier for each boot configuration.
+To boot a certain configuration at the SRM-Prompt you would issue
+</para>
+<para>
+<command>
+boot <parameter>dka0 -fl "0"</parameter>
+</command>
+</para>
+<para>
+where dka0 has to be replaced by your boot device and the boot configuration
+(0 in this case) can be replaced by any defined in 
+<filename>etc/aboot.conf</filename>.
+</para>
+
+<para>
+After the colon the number of the partition the kernel resides on is given. 1
+corresponds to the BSD partition labeled A:, 2 to B: and so on. 
+</para>
+
+<para>
+After the slash the name of the kernel to boot is given, including a possible
+path. If your kernel does not reside on a file system but is located directly
+after <application>aboot</application>(8) at the beginning of the hard disk
+you would omit the number, the slash and the kernel name.
+</para>
+
+<para>
+Next the name of the partition to mount as <filename>/</filename> is given.
+Other kernel parameters follow as required. As shown also an initrd can be
+specified.
+</para>
+
+<para>
+The contents of this file can be shown before booting if necessary by
+using the interactive
+mode of <application>aboot</application>(8) (booting with the flag "i")
+and then issuing "h" at the <application>aboot</application>-prompt.
+</para>
+
+</refsect1>
+<refsect1><title>AUTHOR</title>
+<para>
+This man page was written by Helge Kreutzmann
+<email>debian@helgefjell.de</email> for the Debian GNU/Linux project but
+may be used by others.
+</para>
+</refsect1>
+<refsect1><title>SEE ALSO</title>
+<para><application>aboot</application>(8), <application>abootconf</application>(8), <application>swriteboot</application>(8), HP SRM Manual (<ULink URL="http://h18002.www1.hp.com/alphaserver/download/srm_reference.pdf"></ULink>)
+</refsect1>
+</refentry>
diff --git a/package/aboot/src/doc/man/aboot.sgml b/package/aboot/src/doc/man/aboot.sgml
new file mode 100644
index 000000000..d54d3ad8c
--- /dev/null
+++ b/package/aboot/src/doc/man/aboot.sgml
@@ -0,0 +1,83 @@
+<!DOCTYPE RefEntry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
+<refentry id="aboot">
+
+<refmeta>
+<refentrytitle>aboot</refentrytitle>
+<manvolnum>8</manvolnum>
+<refmiscinfo>aboot</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+<refname>aboot</refname>
+<refpurpose>The secondary boot loader for Linux/Alpha</refpurpose>
+</refnamediv>
+
+<refsect1><title>COPYRIGHT</title>
+<para>
+<application>aboot</application> is Copyright (C) 1996 Linus Torvalds, David Mosberger-Tang and Michael Schwingen
+</para>
+</refsect1>
+
+<refsect1><title>DESCRIPTION</title>
+<para>
+<indexterm><primary>aboot</primary></indexterm>
+<application>aboot</application> is the secondary boot loader needed if
+the Linux/Alpha system is booted via SRM. It is usually installed during
+system installation by <application>swriteboot</application>(8). 
+</para>
+<para>
+To automate the booting process predefined boot configurations can be stored
+in <filename>etc/aboot.conf</filename>(5). 
+</para>
+<para>
+<application>aboot</application> can also be used interactively by issuing
+</para>
+<para>
+<command>boot <parameter>dka0 -fl "i"</parameter></command>
+</para>
+<para>
+at the SRM-Prompt where dka0 has to be replaced by the device used. 
+</para>
+<para>
+In the interactive mode you can use the command l to show your current
+<filename>etc/aboot.conf</filename> and then the appropriate number
+(or a complete boot command as in SRM) to boot Linux.
+</para>
+<para>
+If you do not want to use the <filename>etc/aboot.conf</filename> as set
+up by <application>abootconf</application>(8) you can explicitly tell 
+<application>aboot</application> where to look for <filename>etc/aboot.conf</filename> by prepending the number of the configuration with the proper
+partition, i.e. if your <filename>etc/aboot.conf</filename> is on your
+second partition and you want to boot the entry labeled three you would
+issue
+</para>
+<para>
+<command>boot <parameter>dqa -fl "2:3"</parameter></command>
+</para>
+<para>
+Note that this applies to Linux booting via SRM only as
+<ProductName>VMS</ProductName>, <ProductName>Tru64</ProductName>, *BSD and
+<ProductName>Windows NT</ProductName> each have their own secondary boot loader.
+Furthermore <application>aboot</application> is also not needed if the system is booted via
+<application>milo</application>.
+</para>
+</refsect1>
+
+
+<refsect1><title>AUTHOR</title>
+<para>
+This man page was written by Helge Kreutzmann
+<email>debian@helgefjell.de</email> for the Debian GNU/Linux project
+but may be used by others.
+</para>
+</refsect1>
+
+<refsect1><title>FILES</title>
+<para><filename>etc/aboot.conf</filename></para>
+</refsect1>
+
+<refsect1><title>SEE ALSO</title>
+<para><application>abootconf</application>(8), <filename>aboot.conf</filename>(5),
+<application>swriteboot</application>(8), HP SRM Manual (<ULink URL="http://h18002.www1.hp.com/alphaserver/download/srm_reference.pdf"></ULink>)</para>
+</refsect1>
+</refentry>
diff --git a/package/aboot/src/doc/man/abootconf.8 b/package/aboot/src/doc/man/abootconf.8
new file mode 100644
index 000000000..cb0f00624
--- /dev/null
+++ b/package/aboot/src/doc/man/abootconf.8
@@ -0,0 +1,96 @@
+.\" This manpage has been automatically generated by docbook2man-spec
+.\" from a DocBook document.  docbook2man-spec can be found at:
+.\" <http://shell.ipoline.com/~elmert/hacks/docbook2X/> 
+.\" Please send any bug reports, improvements, comments, patches, 
+.\" etc. to Steve Cheng <steve@ggi-project.org>.
+.TH "ABOOTCONF" "8" "26 Oktober 2003" "abootconf" ""
+.SH NAME
+abootconf \- Configure the location of the configuration file for the secondary bootloader aboot(8) for Linux/Alpha.
+.SH SYNOPSIS
+.sp
+\fBabootconf\fR \fB/dev/xxx num\fR
+.SH "COPYRIGHT"
+.PP
+\fBabootconf\fR is Copyright (C) 1996 Linus Torvalds, David Mosberger-Tang and Michael Schwingen
+.SH "DESCRIPTIONS"
+.PP
+
+
+\fBabootconf\fR is used to change the partition
+the alpha Linux boot loader \fBaboot\fR(8)
+looks for its configuration file in. The configuration file is stored
+in \fIetc/aboot.conf\fR(5)
+relative to the root of the file system in this partition.
+.PP
+\fBabootconf\fR requires the boot device
+(e.g. \fI/dev/hdb\fR, \fI/dev/sda\fR) and the
+partition
+to be used (e.g. 3). Thus if you want to boot from partition E: on your second
+SCSI disk you would enter
+.PP
+\fBabootconf \fI/dev/sdb 5\fB\fR
+.SH "NOTES"
+.PP
+\fBabootconf\fR is not needed if you are booting
+your alpha system via \fBmilo\fR. 
+.PP
+For each disk one partition can be activated to contain the configuration
+for \fBaboot\fR(8) which is located in
+\fIetc/aboot.conf\fR(5).
+The disk chosen to boot from is selected at
+the SRM prompt as the second argument, e.g.
+.PP
+\fBboot \fIdqa\fB\fR
+.PP
+to boot from your first IDE hard disk. See the HP SRM-Manual and
+\fBaboot\fR(8)
+for details.
+.PP
+\fBaboot\fR(8) can load a kernel from an
+arbitrary partition and can even use a different
+root partition than the one \fIetc/aboot.conf\fR
+belongs to. Hence you would usually
+set up one \fIetc/aboot.conf\fR with all combinations and
+would not require \fBabootconf\fR except for initial
+set up. You can then
+boot the requested
+Linux kernel by giving the appropriate flags at the SRM prompt, e.g. to boot
+the entry labeled 2 you would use
+.PP
+\fBboot \fIdqa -fl "2"\fB\fR
+.PP
+See the HP SRM manual and \fIaboot.conf\fR(5)
+for details.
+.PP
+To show the current setting simply omit the last argument (i.e. the partition
+number).
+.PP
+Note that you have to rerun \fBabootconf\fR if you updated
+\fBaboot\fR.
+.PP
+Strictly speaking \fBabootconf\fR is not necessary as
+you can specify the partition which \fIetc/aboot.conf\fR
+resides on at the SRM-Prompt by prepending the partition number and a colon
+in the flags-parameter, i.e. if \fIetc/aboot.conf\fR
+resided on the fourth partition and you want to boot the entry labeled 2
+you could also issue
+.PP
+\fBboot \fIdqa -fl "4:2"\fB\fR
+.PP
+at the SRM prompt.
+.PP
+Note that this applies to Linux only as VMS, Tru64, *BSD and
+Windows NT each have their own secondary boot loader.
+.PP
+Also note that for initial hard disk setup \fBabootconf\fR
+is no longer needed as \fBswriteboot\fR(8) contains the
+entire functionality of \fBabootconf\fR.
+.SH "AUTHOR"
+.PP
+This man page was written by Helge Kreutzmann <kreutzm@itp.uni-hannover.de> for the Debian GNU/Linux project but may be used by others.
+.SH "FILES"
+.PP
+\fIetc/aboot.conf\fR
+.SH "SEE ALSO"
+.PP
+\fBaboot\fR(8), \fBswriteboot\fR(8), \fIaboot.conf\fR(5), HP SRM Manual
diff --git a/package/aboot/src/doc/man/abootconf.sgml b/package/aboot/src/doc/man/abootconf.sgml
new file mode 100644
index 000000000..5281cd323
--- /dev/null
+++ b/package/aboot/src/doc/man/abootconf.sgml
@@ -0,0 +1,141 @@
+<!DOCTYPE RefEntry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
+<refentry id="abootconf">
+
+<refmeta>
+<refentrytitle>abootconf</refentrytitle>
+<manvolnum>8</manvolnum>
+<refmiscinfo>abootconf</refmiscinfo>
+</refmeta>
+
+<refnamediv>
+<refname>abootconf</refname>
+<refpurpose>
+Configure the location of the configuration file for the secondary boot
+loader <application>aboot</application>(8) for Linux/Alpha.
+</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+ <cmdsynopsis>
+   <command>abootconf</command> <arg choice="plain">/dev/xxx num</arg>
+ </cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>COPYRIGHT</title>
+<para>
+<application>abootconf</application> is Copyright (C) 1996 Linus Torvalds, David Mosberger-Tang and Michael Schwingen
+</para>
+</refsect1>
+
+<refsect1><title>DESCRIPTIONS</title>
+<para>
+<indexterm><primary>abootconf</primary></indexterm>
+<indexterm><primary>aboot</primary></indexterm>
+<application>abootconf</application> is used to change the partition<indexterm><primary>partition
+</primary></indexterm>
+the alpha Linux boot loader <application>aboot</application>(8)
+looks for its configuration file in. The configuration file is stored
+in <filename>etc/aboot.conf</filename>(5)
+relative to the root of the file system in this partition.
+</para>
+<para> 
+<application>abootconf</application> requires the boot device
+(e.g. <filename>/dev/hdb</filename>, <filename>/dev/sda</filename>) and the
+partition
+to be used (e.g. 3). Thus if you want to boot from partition E: on your second
+SCSI disk you would enter</para>
+<para>
+<command>
+abootconf <parameter>/dev/sdb 5</parameter>
+</command>
+</para>
+</refsect1>
+<refsect1><title>NOTES</title>
+<para>
+<application>abootconf</application> is not needed if you are booting
+your alpha system via <application>milo</application>. 
+</para>
+<para>
+For each disk one partition can be activated to contain the configuration
+for <application>aboot</application>(8) which is located in
+<filename>etc/aboot.conf</filename>(5).
+The disk chosen to boot from is selected at
+the SRM prompt as the second argument, e.g.
+</para>
+<para>
+<command>
+boot <parameter>dqa</parameter>
+</command>
+</para>
+<para>
+to boot from your first IDE hard disk. See the HP SRM-Manual and
+<application>aboot</application>(8)
+for details.
+</para>
+<para>
+<application>aboot</application>(8) can load a kernel from an
+arbitrary partition and can even use a different
+root partition than the one <filename>etc/aboot.conf</filename>
+belongs to. Hence you would usually
+set up one <filename>etc/aboot.conf</filename> with all combinations and
+would not require <application>abootconf</application> except for initial
+set up. You can then
+boot the requested
+Linux kernel by giving the appropriate flags at the SRM prompt, e.g. to boot
+the entry labeled 2 you would use
+</para>
+<para>
+<command>
+boot <parameter>dqa -fl "2"</parameter>
+</command>
+</para>
+<para>
+See the HP SRM manual and <filename>aboot.conf</filename>(5)
+for details.
+</para>
+<para>
+To show the current setting simply omit the last argument (i.e. the partition
+number).
+</para>
+<para>
+Note that you have to rerun <application>abootconf</application> if you updated
+<application>aboot</application>(8).
+</para>
+<para>
+Strictly speaking <application>abootconf</application> is not necessary as
+you can specify the partition which <filename>etc/aboot.conf</filename>
+resides on at the SRM-Prompt by prepending the partition number and a colon
+in the flags-parameter, i.e. if <filename>etc/aboot.conf</filename>
+resided on the fourth partition and you want to boot the entry labeled 2
+you could also issue
+</para>
+<para>
+<command>
+boot <parameter>dqa -fl "4:2"</parameter>
+</command>
+</para>
+<para>
+at the SRM prompt.
+</para>
+<para>
+Note that this applies to Linux only as <ProductName>VMS</ProductName>, <ProductName>Tru64</ProductName>, *BSD and
+<ProductName>Windows NT</ProductName> each have their own secondary boot loader.
+</para>
+<para>
+Also note that for initial hard disk setup <application>abootconf</application>
+is no longer needed as <application>swriteboot</application>(8) contains the
+entire functionality of <application>abootconf</application>.
+</para>
+</refsect1>
+<refsect1><title>AUTHOR</title>
+<para>
+This man page was written by Helge Kreutzmann <email>debian@helgefjell.de</email> for the Debian GNU/Linux project but may be used by others.
+</para>
+</refsect1>
+<refsect1><title>FILES</title>
+<para><filename>etc/aboot.conf</filename></para>
+</refsect1>
+<refsect1><title>SEE ALSO</title>
+<para><application>aboot</application>(8), <application>swriteboot</application>(8), <filename>aboot.conf</filename>(5), HP SRM Manual (<ULink URL="http://h18002.www1.hp.com/alphaserver/download/srm_reference.pdf"></ULink>)</para>
+</refsect1>
+</refentry>
diff --git a/package/aboot/src/doc/man/de/Makefile b/package/aboot/src/doc/man/de/Makefile
new file mode 100644
index 000000000..22ef583a1
--- /dev/null
+++ b/package/aboot/src/doc/man/de/Makefile
@@ -0,0 +1,46 @@
+all:  srmbootraw.de.8 aboot.de.8 aboot.conf.de.5 abootconf.de.8 isomarkboot.de.1 sdisklabel.de.8 srmbootfat.de.1 e2writeboot.de.8 swriteboot.de.8 netabootwrap.de.1
+
+aboot.de.8: aboot.sgml
+	nsgmls aboot.sgml | sgmlspl docbook2man-de-spec.pl
+	mv aboot.8 aboot.de.8
+
+aboot.conf.de.5: aboot.conf.sgml
+	nsgmls aboot.conf.sgml | sgmlspl docbook2man-de-spec.pl
+	mv aboot.conf.5 aboot.conf.de.5
+
+abootconf.de.8: abootconf.sgml
+	nsgmls abootconf.sgml | sgmlspl docbook2man-de-spec.pl
+	mv abootconf.8 abootconf.de.8
+
+netabootwrap.de.1: netabootwrap.sgml
+	nsgmls netabootwrap.sgml | sgmlspl docbook2man-de-spec.pl
+	mv netabootwrap.1 netabootwrap.de.1
+
+isomarkboot.de.1: isomarkboot.sgml
+	nsgmls isomarkboot.sgml | sgmlspl docbook2man-de-spec.pl
+	mv isomarkboot.1 isomarkboot.de.1
+
+sdisklabel.de.8: sdisklabel.sgml
+	nsgmls sdisklabel.sgml | sgmlspl docbook2man-de-spec.pl
+	mv sdisklabel.8 sdisklabel.de.8
+
+srmbootfat.de.1: srmbootfat.sgml
+	nsgmls srmbootfat.sgml | sgmlspl docbook2man-de-spec.pl
+	mv srmbootfat.1 srmbootfat.de.1
+
+srmbootraw.de.8: srmbootraw.sgml
+	nsgmls srmbootraw.sgml | sgmlspl docbook2man-de-spec.pl
+	mv srmbootraw.8 srmbootraw.de.8
+
+e2writeboot.de.8: e2writeboot.8
+	ln -s e2writeboot.8 e2writeboot.de.8
+
+swriteboot.de.8: swriteboot.8
+	ln -s  swriteboot.8 swriteboot.de.8
+
+clean :
+	rm -f *.html *.de.? srmbootraw.8 srmbootfat.1 sdisklabel.8 isomarkboot.8 abootconf.8 aboot.conf.5 aboot.8 netabootwrap.1 manpage.links manpage.log manpage.refs