Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
WANTED-PORTS(1)	      User Contributed Perl Documentation      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 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

       -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

       -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

		       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"

       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".

		       Override	the default location of	the configuration
		       file.  Using the	-f config command line option
		       superceeds this setting.	 Default /var/db/wanted-

       ports(7), pkg_delete(1),	pkg_cutleaves(1), portmaster(8),

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


Want to link to this manual page? Use this URL:

home | help