Attachment #129009: revdep-rebuild.1.patch for bug #187967

revdep\-rebuild scans libraries and binaries for missing shared library dependencies and fixes them by re\-emerging those broken binaries and shared libraries.  It is useful when an upgraded package breaks other software packages that are dependent upon the upgraded package.

revdep\-rebuild scans libraries and binaries for missing shared library dependencies and attempts to fix them by re\-emerging those broken binaries and shared libraries.  It is useful when an upgraded package breaks other software packages that are dependent upon the upgraded package.

.B \-X | \-\-package\-names

.B \-C | \-\-nocolor

emerge the best packages available, not neccessarily the exact version of the installed package

Turn off colored output. (This option is also passed to portage.)

.B \-\-library=NAME

.B \-e | \-\-exact

emerge packages that use the named library. Name can be a full path to a library or basic regular expression. (See man grep for the definition of basic regular expressions)

Emerge the most recent version of found packages, without regard to SLOT.

.B \-np | \-\-no\-ld\-path

.B \-h | \-\-help

Print usage.

.TP

.B \-i | \-\-ignore

Delete temporary files from previous runs.

.TP

.B \-k | \-\-keep\-temp

Force revdep\-rebuild not to delete temporary files after it successfully rebuilds packages. This option will NOT prevent revdep\-rebuild from deleting inconsistent or out\-of\-date temporary files.

.TP

.B \-\-library NAME | -L NAME

Search for reverse dependencies for a particular library or group of libraries, rather than every library on the system. Emerge packages that use the named library. NAME can be a full path to a library or basic regular expression.  (See regex(7).)

.TP 

.B \-l | \-\-no\-ld\-path

.B \-nc | \-\-no\-color

.B \-o | \-\-no-order

turn off colored output (This option is also passed to the emerge command)

Do not check the build order against the deep dependency list.  This will make revdep-rebuild faster, but it can cause emerge failures.  Please try revdep\-rebuild without \-o before reporting any bugs.

.B \-i | \-\-ignore

.B \-p | \-\-pretend

ignore temporary files from previous runs

Do a dry-run.  Do not delete temporary files.  (\-k \-p is redundant, but harmless.)  \-\-pretend is assumed when not running revdep\-rebuild as root.

be less verbose (This option is also passed to the emerge command)

Print less output and disable the progress meter.  (This option is also passed to portage.)

.B \-vv | \-\-extra\-verbose

.B \-u UTIL | \-\-no-util UTIL

be extra verbose (currently prints the revdep\-rebuild search environment)

Do not use features provided by UTIL.

UTIL can be one of portage-utils or pkgcore, or it can be a \fBquoted\fR space-delimited list.

.B All other options are passed to the emerge command

.B \-v | \-\-verbose

More output.  (Prints the revdep\-rebuild search environment.)

.TP

.B All other options (including unrecognized ones) are passed to the emerge command.  Single\-letter options may not be combined, so for example, \-pv is not valid.  Please use \-p \-v.

These variables can be prepended to either by setting the variable in your environment prior to execution, by placing an entry in /etc/make.conf, or by placing a file in /etc/revdep\-rebuild containing the appropriate variables.

You can prepend to these variables by setting the variable in your environment prior to execution, by placing an entry in /etc/make.conf, or by placing a file in /etc/revdep\-rebuild containing the appropriate variables.

/etc/make.conf \- persistant changes by user

/etc/make.conf \- persistent changes by user

/etc/revdep\-rebuild/* \- persistant changes by ebuild authors

/etc/revdep\-rebuild/* \- persistent changes by ebuild authors

revdep\-rebuild returns a zero exit status if it succeeds.

revdep\-rebuild returns a zero exit status if it \fBand emerge\fR succeeds, and a nonzero exit status otherwise.

Non zero is returned in case of failure.

In exact ebuild mode revdep\-rebuild can fail to properly order packages, which are not up to date.

Report bugs to <http://bugs.gentoo.org>. Please do not report emerge failures caused by \-o or \-e. Please include your .revdep\-rebuild* files, your emerge \-\-info, and patches. ;)

.br 

http://bugs.gentoo.org/show_bug.cgi?id=23018

.LP 

Rebuilding using \-\-package\-names mode should be default, but emerge has no feature to update to latest version of a defined SLOT.

.br 

http://bugs.gentoo.org/show_bug.cgi?id=4698

\fBNote:\fR The ability to update to the latest version of a slotted package has been added to revdep\-rebuild.  However, it is possible for this feature to still not work 100% correctly

emerge(1), portage(5), grep(1)

emerge(1), portage(5), regex(7)