Manual Reference Pages - WANTED-PORTS (1)
wanted-ports -- depend on the ports that you want installed
wanted-ports [-n] [-f config] [-a|-d portname]]
wanted-ports is a small port that simply has a user modifiable list
of run-time dependencies. The idea is that by marking a port as
wanted, it adds a double check helping to prevent accidental deletion
of the ports you really want to have installed. pkg_delete(1) will
refuse to delete a port when that port is a dependency required by
some other installed port, unless you give the -f option to force
wanted-ports can also be used as a means to automate installing the
required software load on a server.
The first time you run the wanted-ports script, it will generate a
skeleton configuration file. Run wanted-ports to modify the list
of ports that you want to have marked. This will automatically
increment the PORTREVISION of wanted-ports, marking the
ports-mgmt/wanted-ports port to be updated, eg. the next time that
portmaster(8) or portupgrade(1) is run.
Updating or reinstalling the port will cause the ports system to force
all of the marked ports to be installed, using the standard dependency
resolution mechanisms of the ports.
The add -a and delete -d options are processed in the order
given on the command line, so a later option can override an earlier
one. The portname argument will match any substring of the port or
package name: care should be taken that you dont accidentally match
unintended items. You can anchor searches to start or end of item
using ^ or $.
Dry-run. Causes wanted-ports not to update the configuration file,
but instead to display what the final result would have been.
Read and modify an alternate configuration file. config should be
the full path to the alternate file. Note: when updating the
ports-management/wanted-ports port, set CFGFILE or
WANTEDPORTSCFG in the make(1) environment to achieve the same
Add dependencies. Find all matching package names or port paths from
the INDEX file, and prompt the user whether to add any that are not
already listed as dependencies in the configuration file.
Delete dependencies. Find all matching package names or port paths
from the INDEX file, and prompt the user whether to delete any that
are currently listed as dependencies in the configuration file.
The default configuration file used by wanted-ports. This is a
makefile snippet, that will be included by
ports-mgmt/wanted-ports/Makefile. A skeleton version will be
created by wanted-ports if it doesnt exist. The wanted-ports
script exists to add or remove RUN_DEPENDS entries and update the
The following environment variables affect the operation of
wanted-ports. PORTSDIR, INDEXFILE and WANTEDPORTSCFG
override the system default settings: normally they will not need to
be set. USER and LOGNAME are standard settings, from
As in ports(7), the location where the ports tree is installed.
As in ports(7), overrides the automatic logic to determine the name
of the index file. Default INDEX-N where N is the OS major
The name of the user running the script. If neither are set, uses
an unknown user.
Override the default location of the configuration file. Using the
-f config command line option superceeds this setting. Default
ports(7), pkg_delete(1), pkg_cutleaves(1), portmaster(8),
|perl v5.10.1 ||WANTED-PORTS (1) ||2010-06-12 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.