debian-legal and DPL added to distribution.
This bug concerns appropriate copyright notice in the Debian Installer
Guide which adapts substantial material originally written by me.
My license allows use under DFSG compliant guidelines, but requests
attribution. I initially requested attribution in May, 2003, a DIG
author admitted to using my work in writing this section of the DIG, but
requested I submit a patch (I'm not familiar with Debian's document
system and patches -- I'm not a DD).
Joey Hess is now proposing a rewrite to excise any citation of my
materials which is unacceptable as:
- The woody DIG already cites my work and is now obsolete stable.
- I would prefer attribution to excision.
- Denying contributors proper credit reflects poorly on the Debian
Project and discourages future contributions to Debian documentation
by third parties, a contribution by which the Project would benefit
greatly.
on Fri, Jul 01, 2005 at 11:56:32AM -0400, Joey Hess (joeyh@debian.org) wrote:
> Karsten M. Self wrote:
> > Section C.4 of the Debian GNU/Linux Installation Guide is based on notes
> > I wrote for performing a chroot installation of Debian under an existing
> > GNU/Linux system.
> >
> > The current version of the manual has modified this work, but is still
> > clearly based on the documents I wrote originally in 1999, and further
> > ammended in 2002 and continue to maintain, with most recent
> > modifications in May, 2004:
> >
> > http://linuxmafia.com/faq/Debian/install-under-chroot.html
> > http://kmself.home.netcom.com/Linux/FAQs/DebianChrootInstall.html
> > http://twiki.iwethey.org/twiki/bin/view/Main/DebianChrootInstall
> >
> > The terms for distribution of my work is clearly stated:
> >
> > ? 2002-2004 Karsten M. Self (kmself@ix.netcom.com) This document may
> > be freely distributed, copied, or modified, with attribution, this
> > notice, and the following disclaimer:
> >
> > THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.
> >
> > IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
> > ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
> > CONSEQUENTIAL DAMAGES.
>
> I don't feel it would be healthy for the readability (or usability) of
> the manual if the copyright notice included a list of every minor
> contributor or web page read by a contributor, or if it had a copyright
> statement more complex than the current one:
An entire section of the Debian Installer Guide (DIG) substantially
running to approximately four printed pages adapted and consolidated
from my longer work of approximately ten printed pages is not what I'd
consider a minor contribution. I'm more than dismayed that the Debian
project which places such an emphasis on scrupulously adhering to
software licensing requirements has been dragging its feet for over two
years and repeated requests to rectify this situation, and it's now
suggested that a rewrite to excise any of my content would be preferable
to simply giving credit where due, as repeatedly requested.
I've written and adapted my documents for over five years. I've made
the work freely available, with copyright notice and attribution. My
own notes are the first Google result for "debian chroot install" (the
second, ironically, is my original request to be credited in the DIG).
For my own part, I'm both proud of my contribution and glad it's been
adopted as part of official Debian Project documentation. I perform
professional duties as as systems and network administrator, tech
writer, and trainer. What I'd like is to be able to point to this as
an example of my work. The current situation does not allow me to do
this. I'm more than happy for the Debian Project to use the work. I
expect credit as detailed in my copyright notice.
The DIG has been adapted somewhat from the woody edition, which appeared
in section 3.7, which was closer to my original, but is still clearly a
derived work.
I'll include a summary of major similar sections below, but note:
- The major difference is that the DIG and my original method is
substitution of debootstrap for the use of the potato 2.2 base tgz
image.
- Specific examples, including the partition table example and others,
are adapted straight out of my work, with minimal changes.
- The general process mirrors the procedures I spelled out. There are
some changes (mostly improvements ;-)
> Copyright ? 2004, 2005 the Debian Installer team
>
> This manual is free software; you may redistribute it and/or modify it
> under the terms of the GNU General Public License. Please refer to the
> license in Appendix E, GNU General Public License.
The GPL v2 section one states that a work my be copied and distributed
if:
you conspicuously and appropriately publish on each copy an
appropriate copyright notice.
...of which the notice I've written is compatible with the GPL. The
GPL's disclaimer of warranty suits my needs.
> FWIW, I think you're blowing this all out of porportion,
It's easy enough for you to say this of someone else's work.
The fact remains that I authored the original work, credited several
individuals (including yourself) for assistance in same, and this work
was adopted and adapted by the Debian project. I also point users at
the official Debian installation instructions, noting that my own notes
are indepent but related.
> but if you would like to produce a list of specific phrases in the
> manual that you feel are derived from those on your web page, I'd be
> happy to rewrite them.
Joey, that's just plain petty. It also does very little to promote
future contributions to Debian documentation projects. I'd like notice.
Plain and simple. Credit for what I've done. I find it exceptionally
curious that a rewrite of the work is seen as a more acceptable solution
than adding a copyright notice crediting me.
Further, I don't believe it's plausible for Debian to do a "clean hands"
rewrite at this time.
I'm copying DPL and debian-legal on this as I feel that you are not
handling this in an appropriate, equitable, or legal manner.
The following are substantially similar sections from my work and the
DIG. Where appropriate, potato and woody releases are noted separately.
Similarities include direct quotations, sample configuration files, and
section titles.
DIGs == DIG sarge, section C4.
http://www.debian.org/releases/stable/i386/apcs04.html.en
DIGw == DIG woody, section 3.7.
http://www.nl.debian.org/releases/woody/i386/ch-preparing.en.html#s-linux-upgrade
KMS == KMSelf version
http://twiki.iwethey.org/twiki/bin/view/Main/DebianChrootInstall
Comparisons of substantially similar sections. Order of occurance is
a bit arbitrary:
Overall sections:
-----------------
KMS:
# A Few General Notes and Caveats
# Getting Started
# Transferring The Base Image
# Configuring The Base System
* Partitioning and Filesystems
* Networking
* Keyboard, Language, & Timezone: base-config
* User Account
* Configure apt sources
* Delete "unconfigured.sh"
* Rebooting
* Continuing a partial installation
DIGs:
C.4.1. Getting Started
C.4.2. Install debootstrap
C.4.3. Run debootstrap
C.4.4. Configure The Base System
C.4.5. Install a Kernel
C.4.6. Set up the Boot Loader
DIGw:
3.7.1 Getting Started
3.7.2 Install debootstrap
3.7.3 Run debootstrap (Network-connected)
3.7.4 Run debootstrap (Using basedebs.tar)
3.7.5 Configure The Base System
3.7.5.1 Mount Partitions
3.7.5.2 Configure Keyboard
3.7.5.3 Configure Networking
3.7.5.4 Configure Timezone, Users, and APT
3.7.5.5 Configure Locales
3.7.6 Install a Kernel
3.7.7 Set up the Boot Loader
Content:
--------
KMS:
Once you've got the new Debian system configured to your preference,
you can migrate your existing user data (if any) to it, and keep on
rolling. Thus this is also a "zero downtime" GNU/GNU/Linux install.
It's also a damned good way for dealing with hardware that otherwise
doesn't play friendly with various boot or installation media.
DIGs:
Once you've got the new Debian system configured to your preference,
you can migrate your existing user data (if any) to it, and keep on
rolling. This is therefore a "zero downtime" Debian GNU/Linux
install. It's also a clever way for dealing with hardware that
otherwise doesn't play friendly with various boot or installation
media.
DIGw:
Once you've got the new Debian system configured to your preference,
you can migrate your existing user data (if any) to it, and keep on
rolling. This is therefore a "zero downtime" Debian GNU/Linux
install. It's also a clever way for dealing with hardware that
otherwise doesn't play friendly with various boot or installation
media.
----
KMS:
Getting Started
Whatever your bootable system choice, boot one that works and
you're comfortable with. If you're going to repartition the hard
drive, do it now. My suggestions on partitioning may be found in
the NixPartitioning topic.
DIGs:
C.4.1. Getting Started
With your current *nix partitioning tools, repartition the hard
drive as needed, creating at least one filesystem plus swap. You
need at least 150MB of space available for a console only install,
or at least 300MB if you plan to install X.
DIGw:
3.7.1 Getting Started
With your current *nix partitioning tools, repartition the hard
drive as needed, creating at least one filesystem plus swap. You
need at least 150MB of space available for a console only install,
or at least 300MB if you plan to install X.
----
KMS:
You can mount the proc filesystem multiple times and to arbitrary
locations, though /proc is customary. It will make certain other
tasks easier, so do this now:
mount -t proc proc /proc
DIGs:
You can mount the proc file system multiple times and to arbitrary
locations, though /proc is customary. If you didn't use mount -a,
be sure to mount proc before continuing:
# mount -t proc proc /proc
DIGw:
You can mount the proc file system multiple times and to arbitrary
locations, though /proc is customary. If you didn't use mount -a,
be sure to mount proc before continuing:
# mount -t proc proc /proc
----
KMS:
Configuring The Base System
Note: deboostrap folks can largely follow the remaining instructions
in this article.
You've now got a real Debian system, though rather lean, on disk.
Chroot into it:
chroot . bin/bash
DIGs:
C.4.4. Configure The Base System
Now you've got a real Debian system, though rather lean, on disk.
Chroot into it:
# chroot /mnt/debinst /bin/bash
DIGw:
3.7.5 Configure The Base System
Now you've got a real Debian system, though rather lean, on disk.
Chroot into it:
$ chroot /mnt/debinst /bin/bash
----
----
KMS:
A sample /etc/fstab -- modify to suit:
# /etc/fstab: static file system information.
#
# <file system> <mount point> <type> <options> <dump> <pass>
/dev/XXX / ext2 defaults 0 0
/dev/XXX /boot ext2 ro,nosuid,nodev 0 2
/dev/XXX none swap sw 0 0
proc /proc proc defaults 0 0
/dev/fd0 /mnt/floppy auto noauto,rw,sync,user,exec 0 0
/dev/cdrom /mnt/cdrom iso9660 noauto,ro,user,exec 0 0
/dev/XXX /tmp ext2 rw,nosuid,nodev 0 2
/dev/XXX /var ext2 rw,nosuid,nodev 0 2
/dev/XXX /usr ext2 rw,nodev 0 2
/dev/XXX /home ext2 rw,nosuid,nodev 0 2
DIGs:
You need to create /etc/fstab.
# editor /etc/fstab
Here is a sample you can modify to suit:
# /etc/fstab: static file system information.
#
# file system mount point type options dump pass
/dev/XXX / ext2 defaults 0 0
/dev/XXX /boot ext2 ro,nosuid,nodev 0 2
/dev/XXX none swap sw 0 0
proc /proc proc defaults 0 0
/dev/fd0 /mnt/floppy auto noauto,rw,sync,user,exec 0 0
/dev/cdrom /mnt/cdrom iso9660 noauto,ro,user,exec 0 0
/dev/XXX /tmp ext2 rw,nosuid,nodev 0 2
/dev/XXX /var ext2 rw,nosuid,nodev 0 2
/dev/XXX /usr ext2 rw,nodev 0 2
/dev/XXX /home ext2 rw,nosuid,nodev 0 2
DIGw:
3.7.5.1 Mount Partitions
You need to create /etc/fstab.
# editor /etc/fstab
Here is a sample you can modify to suit:
# /etc/fstab: static file system information.
#
# file system mount point type options dump pass
/dev/XXX / ext2 defaults 0 0
/dev/XXX /boot ext2 ro,nosuid,nodev 0 2
/dev/XXX none swap sw 0 0
proc /proc proc defaults 0 0
/dev/fd0 /mnt/floppy auto noauto,rw,sync,user,exec 0 0
/dev/cdrom /mnt/cdrom iso9660 noauto,ro,user,exec 0 0
/dev/XXX /tmp ext2 rw,nosuid,nodev 0 2
/dev/XXX /var ext2 rw,nosuid,nodev 0 2
/dev/XXX /usr ext2 rw,nodev 0 2
/dev/XXX /home ext2 rw,nosuid,nodev 0 2
----
KMS:
You probably want a GNU/Linux kernel and a bootloader1. I've become
partial to GRUB these days, though LILO's an old standard. apt-get
install your preference.
DIGs:
If you intend to boot this system, you probably want a GNU/Linux
kernel and a boot loader. Identify available pre-packaged kernels
with
----
Note: the DIG references neglect to configure /etc/hosts, which should
probably be added.
KMS:
Networking
I'll assume you've got networking handled through your boot system,
for the duration of your chroot installation process. This section
mostly covers configuring networking for use after installation,
when you actually boot your newly installed system.
It's possible that name resolution won't work until /etc/resolv.conf
is properly configured. Under Knoppix, this may be symlinked outside
the chroot. You'll have to break (delete) the link and create a
regular file with your nameserver(s), and (optionally) domain and
search directives.
You still likely don't have networking configured to come up on the
installed system. This requires hand edits of:
* /etc/resolv.conf -- your nameserver(s) and search directives go here.
* /etc/network/interfaces -- see /usr/share/doc/ifupdown/examples
for examples. This configures your interfaces. In general, you
need to know your IP, network, netmask, network, broadcast, and
gateway.
* /etc/hostname -- your system's host name -- 2 - 63 characters.
* /etc/hosts -- 127.0.0.1 your_system's_host_name (required for some
services)
DIGs:
C.4.4.3. Configure Networking
To configure networking, edit /etc/network/interfaces,
/etc/resolv.conf, and /etc/hostname.
# editor /etc/network/interfaces
DIGw:
3.7.5.3 Configure Networking
To configure networking, edit /etc/network/interfaces,
/etc/resolv.conf, and etc/hostname.
# editor /etc/network/interfaces
----
KMS:
OK. You've got a few things to configure that would ordinarily be
handled by the installed (dbootstrap):
* partitioning
* networking
* keyboard
* language
* time zone
* user account
* apt sources
<...>
Keyboard, Language, & Timezone: base-config
Note: Applying these settings will affect both the chroot and host
environment, though the configuration files themselves are
persistant only in the chroot install.
Basics of system setup are handled by base-config
dpkg-reconfigure base-config
base-config
# (You may have to run 'dpkg --install --reinstall base-config'
# instead to force this).
DIGs:
C.4.4.4. Configure Timezone, Users, and APT
Set your timezone, add a normal user, and choose your apt sources by
running
# /usr/sbin/base-config new
DIGw:
3.7.5.4 Configure Timezone, Users, and APT
Set your timezone, add a normal user, and choose your apt sources by
running
# /usr/sbin/base-config
> Aside from that, we can add a link to one of your pages in our
> existing list of influential howtos and faqs, something like:
> Extremely helpful text and information was found in Jim Mintha's HOWTO
> for network booting (no URL available), the <ulink
> + url="&url-debianchrootinstall;">DebianChrootInstall document</a>, the <ulink
> url="&url-debian-faq;">Debian FAQ</ulink>, the <ulink
> url="&url-m68k-faq;">Linux/m68k FAQ</ulink>, the <ulink
> url="&url-sparc-linux-faq;">Linux for SPARC Processors
> FAQ</ulink>, the <ulink
> url="&url-alpha-faq;">Linux/Alpha
> FAQ</ulink>, amongst others. The maintainers of these freely
> available and rich sources of information must be recognized.
>
> > The Debian Project has been distributing this work in violation of my
> > copyrights. I've previously requested this be remedied in 2003, the
> > situation remains uncorrected:
> >
> > http://lists.debian.org/debian-boot/2003/05/msg00489.html
> >
> > The use of my works has been confirmed by one of the
> > debian-installer-manual developers:
> >
> > http://lists.debian.org/debian-boot/2003/05/msg00491.html
>
> I'm sorry that this has gone uncorrected for so long.
>
> --
> see shy jo
--
Karsten M. Self <kmself@ix.netcom.com> http://kmself.home.netcom.com/
What Part of "Gestalt" don't you understand?
Beware of German-speaking Greeks bearing...
- Paul Wallich
Attachment:
signature.asc
Description: Digital signature