revdep/revdep.1



    1 .\"Text automatically generated by txt2man
    2 .TH untitled  "23 February 2016" "" ""
    3 .SH NAME
    4 \fBrevdep \fP- checks for missing libraries of installed packages
    5 .SH SYNOPSIS
    6 .nf
    7 .fam C
    8 \fBrevdep\fP [\fB-h\fP] [\fB-v\fP|\fB-vv\fP|\fB-vvv\fP|\fB-vvvv\fP] [package\.\.\.]
    9 .fam T
   10 .fi
   11 .fam T
   12 .fi
   13 .SH DESCRIPTION
   14 \fBrevdep\fP checks for missing libraries of installed packages using elfutils'
   15 libelf and the same algorithm that \fBld.so\fP(8) uses.
   16 .SH OPTIONS
   17 .TP
   18 .B
   19 \fB-h\fP
   20 The option \fB-h\fP displays help
   21 .TP
   22 .B
   23 \fB-d\fP
   24 Specify an alternate location for the package database
   25 .TP
   26 .B
   27 \fB-c\fP
   28 Specify an alternate location for ld.so.conf
   29 .TP
   30 .B
   31 \fB-r\fP
   32 Specify an alternate directory for \fBrevdep\fP package config
   33 .TP
   34 .B
   35 \fB-i\fP
   36 Comma-separated list of ports to ignore
   37 .TP
   38 .B
   39 \fB-v\fP
   40 Formatted listing
   41 .TP
   42 .B
   43 \fB-vv\fP
   44 Include errorous files
   45 .TP
   46 .B
   47 \fB-vvv\fP
   48 Include precise file errors
   49 \fB-vvvv\fP Show debug/trace
   50 .SH EXAMPLE
   51 Try this command to list broken packages:
   52 .PP
   53 $ \fBrevdep\fP
   54 .PP
   55 Use this command to rebuild packages on your system:
   56 .PP
   57 # prt-get update \fB-fr\fP $(\fBrevdep\fP)
   58 .SH ADDITIONAL LIBRARY DIRECTORIES
   59 Upon startup, \fBrevdep\fP searches the /etc/revdep.d directory for files named
   60 after ports. If any are found, any directories (assumed to be absolute
   61 pathes and delimited by newlines) within the file are added to a list of
   62 port specific directories to search if a library dependency is not found
   63 in one of the many standard locations (as specified by \fBld.so\fP(8)).
   64 .PP
   65 If a port is discovered to have library dependencies that are in a
   66 non-standard location, then a file, as specified above, should be created.
   67 .PP
   68 For example, if the port "firefox" has a "libxul.so" dependency in a
   69 the non-standard directory "/usr/lib/firefox" then a file named "firefox"
   70 should be created under "/etc/revdep.d" with a single line containing
   71 "/usr/lib/firefox". This will tell \fBrevdep\fP where to find firefox's "libxul.so"
   72 when looking for its library dependencies, reducing one source of false
   73 positives. Ideally, this file would be included with the port's own packaging
   74 as well.
   75 .SH NOTES
   76 C++ rewrite inspired by Johannes Winkelmann's <jw@tks6.net> shell \fBrevdep\fP.
   77 Contributed to design Danny Rawlins <contact@romster.me>.
   78 .SH SEE ALSO
   79 \fBld.so\fP(8), \fBprt-get\fP(8), \fBpkginfo\fP(1)
   80 .SH AUTHOR
   81 James Buren, ryuo @ freenode