the yum repository is left. This is useful if you want to run further
yum commands inside the filesystem by hand.
+=item B<-p "proxyurl">
+
+=item B<--proxy="proxyurl">
+
+URL to the proxy server that yum should use.
+
+=item B<-u source>
+
+=item B<--updates=source>
+
+Pull in updates from an additional updates repository. The possible
+sources are:
+
+=over 4
+
+=item -u C<http://...> (a URL)
+
+Get updates from the specific URL.
+
+=item -u C<updates-released-fN> (an updates repository name)
+
+Get updates from the public mirrors of the named repository
+(eg. C<updates-released-f10>). See REPOSITORIES below.
+
+=item -u C<none> (default)
+
+Don't add an updates repository. This is the default.
+
+=back
+
=back
=head1 REPOSITORIES
directory as C<I<TARGET>/fakeroot.log>.
This logfile is indexed by inode number, which makes certain
-operations safe and other operations unsafe. For example, deleting
-files is usually safe. Files should be replaced only by doing:
+operations safe and other operations unsafe.
+Files should be replaced only by doing:
echo updated-content > old-file
-(since that preserves the original inode). In most cases it's usually
-safest to use C<febootstrap-run>.
+(since that preserves the original inode).
+
+Deleting files and then creating new ones (even with a different name)
+is usually unsafe, because the new files might reuse inodes claimed by
+the old files, and so appear with peculiar permissions
+(eg. unreadable, or as a symbolic link).
+
+Deleting files is also usually unsafe, although the reasons are more
+subtle. If you just use C<rm> then the inode number is not deleted
+from C<fakeroot.log> which means it can be reused by another file
+later on.
+
+In most cases it's usually safest to use C<febootstrap-run>.
You can use the fakeroot logfile in a number of ways:
=item *
+Use L<febootstrap-install(8)> to install a file with permissions
+in the root filesystem.
+
+=item *
+
Generate an initramfs (compressed cpio) file containing the correct
permissions using the tool C<febootstrap-to-initramfs>.
=item *
+Generate a supermin appliance using the tool
+C<febootstrap-to-supermin>.
+
+=item *
+
Apply the permissions to the target directory using the forthcoming
tool C<febootstrap-fix-root> (requires root).
=head1 OTHER RESTRICTIONS AND BUGS
-C</sbin/ldconfig> and C</usr/sbin/glibc_post_upgrade> are not run
-during C<%post> scriptlets (because they are statically linked, and
-fakechroot cannot run statically linked programs). If you wish, you
-can run them the first time you boot into the new machine.
+The following programs are not run during C<%post> scriptlets (because
+they are all statically linked, and fakechroot cannot run statically
+linked programs).
+
+=over 4
+
+=item C</sbin/ldconfig> (from many packages)
+
+=item C</usr/sbin/glibc_post_upgrade> (from C<glibc>)
+
+=item C</usr/sbin/build-locale-archive> (from C<glibc-common>)
+
+=item C</usr/sbin/libgcc_post_upgrade> (from C<libgcc>)
+
+=back
+
+If you wish, you can run them the first time you boot into the new
+machine.
febootstrap recreates the repository anew each time, and this causes
yum to download all the RPMs every time. This is very wasteful, and
=head1 HOME PAGE
-L<http://et.redhat.com/~rjones/febootstrap>
+L<http://people.redhat.com/~rjones/febootstrap>
=head1 SEE ALSO
L<febootstrap-to-initramfs(8)>,
L<febootstrap-minimize(8)>,
L<febootstrap-run(8)>,
+L<febootstrap-install(8)>,
+L<febootstrap-to-supermin(8)>,
L<fakeroot(1)>,
L<fakechroot(1)>,
L<yum(8)>,
=head1 COPYRIGHT
(C) Copyright 2009 Red Hat Inc.,
-L<http://et.redhat.com/~rjones/febootstrap>.
+L<http://people.redhat.com/~rjones/febootstrap>.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by