Poster of Linux kernelThe best gift for a Linux geek
FEBOOTSTRAP-MINIMIZE

FEBOOTSTRAP-MINIMIZE

Section: Virtualization Support (8) Updated: 2010-05-14
Local index Up
 

NAME

febootstrap-minimize - Minimize an febootstrap image  

SYNOPSIS

 febootstrap-minimize [--options] DIR

 

DESCRIPTION

febootstrap-minimize minimizes an febootstrap(8)-created filesystem. This means that unneeded files and cruft are removed from the image.

If no options are given, the default is to minimize the image as much as possible. This means, for example, that locales are removed so the image will only be usable in US-English, there will be no documentation or manual pages, and the image will only work in a UTC timezone.

Note that image minimization involves deleting files that have been installed by RPM. Thus after minimization, it is no longer guaranteed that RPM will function correctly on the image. You should only do this as a final step for ``throwaway'' appliances that do not need to be modified or upgraded in future.  

OPTIONS

--all
Perform all minimization operations, to produce the smallest possible image. Note in particular that locales are discarded.

You can perform all minimization operations except X, Y and Z by doing:

 febootstrap-minimize --all --keep-X --keep-Y --keep-Z ...

("--all" can be omitted since it is the default).

--none
Start with no minimization operations. You can specify only minimization operations X, Y and Z like this:

 febootstrap-minimize --none --drop-X --drop-Y --drop-Z ...

--keep-locales
--drop-locales
Keep or drop locale support.
--keep-docs
--drop-docs
Keep or drop documentation, man pages and info files.
--keep-cracklib
--drop-cracklib
Keep or drop cracklib libraries.
--keep-i18n
--drop-i18n
Keep or drop "/usr/share/i18n".
--keep-zoneinfo
--drop-zoneinfo
Keep or drop all timezones (except UTC which is never deleted).
--keep-rpmdb
--drop-rpmdb
Keep or drop the RPM and YUM package databases. Obviously RPM and YUM will be completely non-functional if you drop these.
--keep-yum-cache
--drop-yum-cache
Keep or drop the yum cache. Note that febootstrap(8) has already deleted this directory unless you ran it with the "--no-clean" option.
--keep-services
--drop-services
Keep or drop the "/etc/services" file. If dropped, this file is replaced with a very minimal one which just lists the most common services. For less common services you will have to refer to them by port number instead of name.
--keep-sln
--drop-sln
Keep or drop "/sbin/sln" (statically linked "ln"). This is not really required in minimal appliances.
--keep-ldconfig
--drop-ldconfig
Keep or drop "/sbin/ldconfig", "/etc/ld.so.cache" and "/var/cache/ldconfig" (the dynamic linking cache). This is not needed. Dynamic linking during program execution will be marginally slower.
--pack-executables
This option has been removed in febootstrap 2.5. In previous versions it was used to pack executables using the external "upx" program. However it was not enabled by default and never worked very effectively.
 

TODO

Deduplicate files with the same content (by hardlinking them). See the program hardlink(1).
Remove unused binaries.
Remove unused libraries.
 

SEE ALSO

febootstrap(8).  

AUTHORS

Richard W.M. Jones <rjones @ redhat . com>  

COPYRIGHT

(C) Copyright 2009 Red Hat Inc., <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 the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
TODO
SEE ALSO
AUTHORS
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 22:01:37 GMT, April 16, 2011