febootstrap-supermin-helper -f ext2 input [...] host_cpu kernel initrd appliance
+ febootstrap-supermin-helper -f checksum input [...] host_cpu
+
=head1 DESCRIPTION
I<febootstrap-supermin-helper> reconstructs a bootable kernel and
that this script produces. These output files are meant to be used
just for booting the appliance, and should be deleted straight
afterwards. The extra C<appliance> parameter is only required when
-the format is C<ext2>.
+the format is C<ext2>. None of these parameters are needed for
+the checksum output C<-f checksum>.
=head1 OPTIONS
An ext2 filesystem.
-In this case you have to supply names for the C<kernel>,
-a small C<initrd> which is used just to locate the appliance,
-and the C<appliance> (the ext2 filesystem).
+In this case you have to supply names for the C<kernel>, a small
+C<initrd> which is used just to locate the appliance, and the
+C<appliance> (the ext2 filesystem).
+
+=item checksum
+
+Output a checksum.
+
+This prints a checksum which only changes when one of the input files
+changes.
+
+You can use this in order to cache the output of a previous run of
+this program: computing the checksum is much quicker than building an
+appliance, and you only need to invalidate the cache (and consequently
+rebuild the appliance) when the checksum changes. Note that the
+host_cpu and the UID of the current user are included in the checksum.
=back
host will be included. This is safer, but can produce rather large
appliances which need a lot more memory to boot.
+=item B<-u user> | B<--user user> | B<-g group> | B<--group group>
+
+Run febootstrap-supermin-helper as an alternate user and/or group.
+C<user> and C<group> can be specified as either a name, which will
+be resolved using the system name service, or a uid/gid. Use of these
+options requires root privileges.
+
+Use of these options is required if running febootstrap-supermin-helper
+as root with the effective uid/gid set to non-root. Bash will reset
+the effective uid/gid to the real uid/gid when invoked. As
+febootstrap-supermin-helper uses bash in parts, this will result in the
+creation of an appliance with a mixture of ownerships.
+
=back
=head1 SPEED