Quick Navigator

Search Site

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

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  WANTED-PORTS (1)

.ds Aq ’


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 the action.

wanted-ports can also be used as a means to automate installing the required software load on a server.

Using wanted-ports

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.


-n Dry-run. Causes wanted-ports not to update the configuration file, but instead to display what the final result would have been.
-f config 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 effect.
-a portname 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.
-d portname 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 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 don’t accidentally match unintended items. You can anchor searches to start or end of item using ^ or $.


/var/db/wanted-ports.conf 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 doesn’t exist. The wanted-ports script exists to add or remove RUN_DEPENDS entries and update the PORTREVISION setting.


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 login(1).
PORTSDIR As in ports(7), the location where the ports tree is installed. Default /usr/ports
INDEXFILE 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 version number.
LOGNAME The name of the user running the script. If neither are set, uses an unknown user.
WANTEDPORTSCFG Override the default location of the configuration file. Using the -f config command line option superceeds this setting. Default /var/db/wanted-ports.conf


ports(7), pkg_delete(1), pkg_cutleaves(1), portmaster(8), portupgrade(1)
Search for    or go to Top of page |  Section 1 |  Main Index

perl v5.10.1 WANTED-PORTS (1) 2010-06-12

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