[MacPorts] FAQ modified

MacPorts noreply at macports.org
Thu Mar 26 18:49:00 PDT 2009


Changed page "FAQ" by blb at macports.org from 75.163.231.4*
Page URL: <http://trac.macports.org/wiki/FAQ>
Diff URL: <http://trac.macports.org/wiki/FAQ?action=diff&version=63>
Revision 63
Comment: Add info on using force option

-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: FAQ
=========================================================================
--- FAQ (version: 62)
+++ FAQ (version: 63)
@@ -187,6 +187,24 @@
 
 Using separate ports for these modules (like py25-readline) avoids the need to completely rebuild the base port, and can be used as a dependency, but ends up having other issues.  One is that these modules are installed using the standard distutils method for python, which causes them to be installed in a different location than where they would be when installed normally (see ticket #12369).  The other is that many python developers have expectations when they install python, and installing python24 or python25 simply does not match that.
 
+=== When should I use the force option (-f) === #whentoforce
+
+Use of the force option (-f) is rarely necessary, but some suggestions in the past have recommended its use quite frequently.  One of the few useful applications of it is in forcing a reinstall of an already-installed port to add a new variant, for example
+{{{
+sudo port -fn upgrade mysql5 +server
+}}}
+will install a new version of the mysql5 port with the current variants plus +server.  Note the use of the -n (don't follow dependencies) option, which is important in this case (otherwise ports depended on by mysql5 will be upgraded as well even when it isn't needed).
+
+One of the other times -f is needed is when you run into a stray file in your MacPorts prefix, not owned by a port, but blocks the install of one.  This is seen with an error message from port similar to
+{{{
+Error: Activating some-port @1.0_0 failed: Image error: /opt/local/path/to/stray/file already exists and does not belong to a registered port.  Unable to activate port some-port.
+}}}
+Unless you know the source of that file and that you need to keep it, this is a good use of force.  However, don't use it with '''install''' but with activate:
+{{{
+sudo port -f activate some-port
+}}}
+Outside of `-fn upgrade` and `-f activate` force can be extremely dangerous, and should be avoided unless you know precisely how port is going to act.
+
 == Portfile Development and Maintenance Questions ==
 
 === Is it possible to have a dependency on a specific variant of another port? E.g. "postgresql8 +server"? ===

-------8<------8<------8<------8<------8<------8<------8<------8<--------

* The IP shown here might not mean anything if the user or the server is
behind a proxy.

--
MacPorts <http://www.macports.org/>
Ports system for Mac OS

This is an automated message. Someone at http://www.macports.org/ added your email
address to be notified of changes on FAQ. If it was not you, please
report to .


More information about the macports-changes mailing list