GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PORTDEPENDS (1)

.ds Aq ’

NAME

portdepends -- list the dependency tree for a port

CONTENTS

SYNOPSIS

<B>portdependsB> [<B>-hB>] [<B>-sB> style] [<B>-cB> dir] [<B>-CB> file] [<B>-oB> file] dir...

DESCRIPTION

<B>portdependsB> displays the dependency tree for each port origin listed on the command line. Dependency relationships are read from the <B>portindexB> cache file. By default dependencies are displayed textually, in a recursive fashion without flattening any of the lists as is done in generating an INDEX file: this leads to a great deal of repetition and much longer output than might be expected for some ports. To suppress the repetition of dependency subtrees, use the <B>--style=shortB> or <B>-s sB> command line option. This visits each node in the dependency tree at most once. For graphical output use the <B>--style=graphB> or <B>-s gB> option. This generates canonical GraphViz format, which can be read into <B>dotB> to render the graph as an image.

Output is tagged with a label showing which of the six possible dependency types exist between each port and its immediate superior. In addition edges in the graphical output are colour coded:
E EXTRACT_DEPENDS (yellow)
P PATCH_DEPENDS (Cyan)
F FETCH_DEPENDS (Magenta)
B BUILD_DEPENDS (Red)
R RUN_DEPENDS (Green)
L LIB_DEPENDS (Blue)
For example: <B>GraphVizB> format output can be rendered as a PNG image like this:

portdepends -s g ports-mgmt/p5-FreeBSD-Portindex | dot -Tpng -o FP.png

Dependency levels in textual output are indicated by indenting the dependent port name inseting a string - for each level.

    Configuration Files

<B>portdependsB> shares configuration files with <B>portindexB>, <B>cache-initB>, <B>cache-updateB> and <B>find-updatedB>. Any configuration settings are taken from the following locations, where the later items on this list override the earlier:
o Built-in settings from the <B>FreeBSD::Portindex::ConfigB> perl module.
o The system wide configuration file /usr/local/etc/portindex.cfg
o The per-user configuration file ${HOME}/.portindexrc (ignored if the program is being run by the superuser)
o The local configuration file, found in the current working directory of the <B>portdependsB> process ./.portindexrc (ignored if the program is being run by the superuser)
o The program command line.
All of the configuration files are optional. A summary of the resultant configuration options including the effect of any command line settings is printed as part of the help text when <B>portindexB> is invoked with the -h option.

OPTIONS

<B>-hB>
<B>--helpB> Print a brief usage message and a summary of the configuration settings after command line processing and then exit.
<B>-sB> { short | s | graph | g | default }
<B>--styleB> { short | ... } Choose the output style.
<B>shortB> or <B>sB> Visit each dependency node only once. Avoids repetetive printing of various dependency sub-trees, and can reduce the amount of output a great deal for complicated dependency trees.
<B>graphB> or <B>gB> Generate canonical GraphViz format suitable for rendering into an image by <B>dotB>
<B>defaultB> or any other text Print out the full dependency tree, recursing into each sub-branch as many times as there are dependency links to that branch. This is the default.
<B>-cB> dir
<B>--cache-dirB>=dir The location of the <B>portindexB> data cache, by default /var/db/portindex.
<B>-CB> file
<B>--cache-fileB>=file Berkeley DB Btree file containing the cached and post-processed values of a number of make variables for all of the ports in the tree. This file name will be relative to the cache directory (<B>-cB> option above) unless an absolute path is given. Defaults to portindex-cache.db.
<B>-oB> file
<B>--outputB>=file Filename to write the generated dependency information to. Setting this to - means output to STDOUT, which is the default.

FILES

/usr/ports The default ports directory.
/var/db/portindex The location of the data cache.
portindex-cache.db Btree file containing cached make describe output.
__db.001, __db.002, __db.003 Files used as part of the internal workings of BerkeleyDB, for memory pool management and DB locking. Will be recreated automatically if deleted.
portindex-timestamp This file contains the last time and date that the cache was updated or modified.
/usr/local/etc/portindex.cfg System-wide configuration file.
${HOME}/.portindexrc Per-user configuration file
./.portindexrc Local configuration file

SEE ALSO

poertindex(7), cache-init(1), cache-update(1), find-updated(1), cvsup(1), ports(7), graphviz(7), dot(1)

BUGS

There are bound to be some somewhere.
Search for    or go to Top of page |  Section 1 |  Main Index


perl v5.20.3 PORTDEPENDS (1) 2015-10-18

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.