summaryrefslogtreecommitdiffstats
path: root/man
diff options
context:
space:
mode:
authorMike Frysinger <vapier@gentoo.org>2012-01-13 14:34:58 -0500
committerMike Frysinger <vapier@gentoo.org>2012-01-14 16:37:24 -0500
commit3ae079dc5650e5af73516198b429d56d9131d637 (patch)
tree86cec4fe177af39d1860ce126d79b3de3edf08a9 /man
parentac263977391643f1c147d7e767b5b804ac095d55 (diff)
downloadportage-3ae079dc5650e5af73516198b429d56d9131d637.tar.gz
portage-3ae079dc5650e5af73516198b429d56d9131d637.tar.bz2
portage-3ae079dc5650e5af73516198b429d56d9131d637.zip
add support for compressing debug sections to save space
Since binutils/gdb can compress the .debug* sections with zlib into .zdebug*, we should be able to save quite a bit of space -- on my system, I saw /usr/lib/debug/ go from ~20GB to ~7.5GB. This requires binutils/gdb to be built with USE=zlib which is why this defaults to off. Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Diffstat (limited to 'man')
-rw-r--r--man/make.conf.510
1 files changed, 9 insertions, 1 deletions
diff --git a/man/make.conf.5 b/man/make.conf.5
index f7491a949..e5a9ae1ed 100644
--- a/man/make.conf.5
+++ b/man/make.conf.5
@@ -260,6 +260,12 @@ Log file names have an extension that is appropriate for the compression
type. Currently, only \fBgzip\fR(1) compression is supported, so build
logs will have a '.gz' extension when this feature is enabled.
.TP
+.B compressdebug
+Compress the debug sections in the split debug files with zlib to save
+space. Make sure you have built both binutils and gdb with USE=zlib
+support for this to work. See \fBsplitdebug\fR for general split debug
+information (upon which this feature depends).
+.TP
.B config\-protect\-if\-modified
This causes the \fBCONFIG_PROTECT\fR behavior to be skipped for files
that have not been modified since they were installed.
@@ -476,7 +482,9 @@ instead of using \fBPORT_LOGDIR\fR directly.
.B splitdebug
Prior to stripping ELF etdyn and etexec files, the debugging info is
stored for later use by various debuggers. This feature is disabled by
-\fBnostrip\fR. For installation of source code, see \fBinstallsources\fR.
+\fBnostrip\fR. You should also consider setting \fBcompressdebug\fR so
+the files don't suck up a lot of space. For installation of source code,
+see \fBinstallsources\fR.
.TP
.B strict
Have portage react strongly to conditions that have the potential to be