-*- mode:text; eval:(footnote-balloons) -*-
Time-stamp: <Wednesday Dec  1, 2010 01:19:17 steve>

Introduction:
============

Here are the tools I use for package management on bastard.  It is
based _very_ heavily on the LFS hint:

  "More control and package management using package users (v1.2)"

Which I have included in this repo (see LFS-pkgusr-hint.txt) and is
considered essential reading.

The main differences (enhancements?) these tools have over the
original LFS hint are:

	 o A set of convenience shell functions for pkg users, and a
	   pseudo "master installer"[1]

	 o Make it easy to give individual settings to each pkg user.
	   For example, some pkg users may need ssh/gnupg or $DISPLAY
	   set. 

	 o Better build script and .project templates

	 o Better uninstall script.

	 o Includes a `which' script.

	 o Includes a `/bin/mail' script.

	 o Includes a `lesspipe.sh' script (unashamedly stolen from
	   Pat Volkerding and Slackware.  Thanks, Pat!)

	 o A more complete list of "install" directories.

	 o Includes an elisp library that implements much of the
	   convenience shell functions.[2]

You should understand that not everything here can be used straight
away.  The /bin/mail script, for example, needs Zsh, and Sendmail
installed (could probably be rewritten to use bash with very little
effort); if you want to set yourself up as a "master installer",
OpenSSL and OpenSSH are needed; and pkgusr.el needs SXEmacs (or
XEmacs/Emacs) obviously.

Pre-Installation:
================
The current version of the LFS book (Version SVN-20100919) is a little
screwed up in one or two places, so BEFORE you move onto the chroot
part of the deal you need to do a couple extra things:

  1.  Install bison, flex, nano, and less (in that order) into your
      /tools dir.  Bison, and flex are needed to build binutils in the
      chroot.  And nano and less make life for the package user so
      much easier.

  2.  At the point in the book where it has you mount the devpts
      filesystem, it neglects to mention that you have to specify a
      mode and gid:
	   mount -vt devpts devpts ${LFS}/dev/pts -o gid=5,mode=620

  3.  When creating the initial /etc/group file, I don't use the LFS
      book suggestions.  I have my own set groups that I've been using
      since 1995, and old habits are so hard to break. :-)

      IMPORTANT:  Please note that my tty group has GID 5 and that
      group in the LFS book has GID 4... make sure you use the right
      gid= option when mounting your devpts.

      Anyhoo, here's my initial group file...

cat>/etc/group<<EOF
root:x:0:
bin:x:1:
daemon:x:2:
sys:x:3:
adm:x:4:
tty:x:5:
disk:x:6:
lp:x:7:
mem:x:8:
kmem:x:9:
wheel:x:10:
floppy:x:11:
mail:x:12:
news:x:13:
uucp:x:14:
man:x:15:
dialout:x:16:
audio:x:17:
video:x:18:
cdrom:x:19:
games:x:20:
utmp:x:22:
usb:x:23:
tape:x:26:
nobody:x:98:
nogroup:x:99:
users:x:1000:
EOF

Installation:
============

Step 1... Go read that LFS hint.  You'll probably want to read it
through a couple of times.

Step 2... Don't follow the instructions in the LFS hint for how to set
things up and where to dump the scripts etc.  Instead see the next
section, "Pkgusr Specific Installation".

Pkgusr Specific Installation
============================

In the hint it tells you how where and when to put the helper scripts
and stuff, which is great, but I have not included the
"more-control-scripts" tarball in this repo.  I've split them out into
their respective directories so that I can easily modify and track
them.  Because of that you may get a little lost in aligning what the
hint says to the files you have in this repo.

When
----
Right _BEFORE_ installing linux libc headers at start of Chap 6 in the
LFS book.

Where
-----
From _OUTSIDE_ the chroot environment

Who
---
Do this as root

How
---
Copy'n'Paste Fun!

PKGUSR=/path/to/your/pkgusr/working/dir
cp -v ${PKGUSR}/installdir.lst ${LFS}/root &&
cp -v ${PKGUSR}/bin/{which,mail} ${LFS}/bin &&
cp -va ${PKGUSR}/etc/pkgusr ${LFS}/etc &&
cp -v ${PKGUSR}/usr/bin/* ${LFS}/bin &&
cp -va ${PKGUSR}/usr/lib/pkgusr ${LFS}/usr/lib &&
cp -v ${PKGUSR}/usr/sbin/{add_package_user,install_package} \
  ${LFS}/usr/sbin &&
cp -v ${PKGUSR}/usr/sbin/{group,user}add ${LFS}/tools/bin &&
chown -vR 0:0 ${LFS}/etc/pkgusr &&
chown -vR 0:0 ${LFS}/usr/lib/pkgusr
unset PKGUSR

From this point on you need to re-enter the chroot environment.  So
these next (and final) steps are done _INSIDE_ the chroot (as root).

Create the install group:
------------------------

groupadd -g 9999 install


Set up the install directories:
------------------------------

while read dir; do
    if [ ! -d ${dir} ]; then
        mkdir -vp ${dir}
    fi
    chown -v 0:9999 ${dir}
    chmod -v 1775 ${dir}
done < /root/installdir.lst

One last symlink:
----------------

  ln -sv /tools/lib/libncurses.so.5 /usr/lib/libncursesw.so.5

(don't forget you'll have to remove that before you install ncurses
later)

Alright, where are we up to now?  Well, in the LFS hint you are up to:

  7.2 Walkthrough: Installing linux-libc-headers

And in the LFS book, you are up to:

  6.7. Linux-2.6.35.4 API Headers

So have fun building the rest of your LFS system!


Footnotes: 
[1]  The "master installer" is just someone who can change their
     identity to a pkg user.  It _could_ be root, though I don't
     recommend it.  I use a ssh->root->su->pkgusr from my personal A/C
     which is a single "step" (I'm not stopping in a root shell).

[2]  pkgusr.el is probably fairly SXEmacs-centric, but should work
     with perhaps minor changes on XEmacs or even GNU/Emacs.