[39083] branches/gsoc08-privileges/base/README.txt

[pmagrath at macports.org]

Revision: 39083
          http://trac.macosforge.org/projects/macports/changeset/39083
Author:   pmagrath at macports.org
Date:     2008-08-07 12:52:00 -0700 (Thu, 07 Aug 2008)
Log Message:
-----------
Add README for beta testers.

Added Paths:
-----------
    branches/gsoc08-privileges/base/README.txt

Added: branches/gsoc08-privileges/base/README.txt
===================================================================
--- branches/gsoc08-privileges/base/README.txt	                        (rev 0)
+++ branches/gsoc08-privileges/base/README.txt	2008-08-07 19:52:00 UTC (rev 39083)
@@ -0,0 +1,51 @@
+-------------
+MacPorts v1.7
+-------------
+
+Name:		MacPorts
+Version:	1.7 (aka trunk)
+Branch:		gsoc08-privileges
+Culprit:	pmagrath at macports.org
+Stage:		Beta Release
+Release Date:	11th August 2008
+
+
+Welcome
+-------
+
+Welcome to the beta of my gsoc08-privileges branch of MacPorts!
+
+
+Introduction
+------------
+
+The purpose of the gsoc08-privileges branch is to implement facilities to reduce the need to execute MacPorts as root. 
+
+To this end, a number of modifications were made to the MacPorts trunk. The changes have the following effect:
+
+1) MacPorts now performs fetch, extract, patch, configure and build in a user rather than system owned location. By default, this is ~/.macports/opt. This allows MacPorts to do all but the install of the port without root privileges.
+
+2) MacPorts now automatically drops privileges whenever possible so as to avoid running as root whenever possible.
+
+3) MacPorts will prompt for the root password if you attempt to install a port into the /opt hierarchy and did not start MacPorts with sudo. It will not do so however until the install stage. The fetch, extract, patch, configure and build will proceed first under the privileges MacPorts is started with.
+
+4) The Portfile format has a number of new boolean attributes to indicate when an action should or should not be run with root privileges: 'patch.asroot', 'build.asroot', 'configure.asroot', 'destroot.asroot', and 'install.asroot'. The default for all is "no" except for 'install.asroot', which defaults to "yes".
+
+5) MacPorts now supports two new, additional, installation options. Each of these is a distinct alternative to the current standard installation option. 
+	(a)	A "make group" command has been added to the Makefile and a "--with-shared-directory" switch to the configure script. Running "make group" will create a macports group. "--with-shared-directory" will let let the group specified by "--with-install-group" have full read write access to the /opt/local hierarchy. This will allow users who are members of the new macports group to have full write permissions to /opt and its subfolders, and hence to install ports which only affect that hierarchy to install those ports without requiring root privileges. 
+	(b)	 A switch called "--with-no-root-privileges" has been added for use by user installing MacPorts for their own use only. An example configure command would be "./configure --prefix=/Users/{your-user-name-here}/.macports --with-no-root-privileges"
+
+
+Why a Beta Release?
+-------------------
+
+Why not? It allows an opportunity to shake out bugs in my code before it is merged in with the trunk.
+
+
+Where should feedback be directed?
+----------------------------------
+
+Please drop me a line with your feedback, either positive or negative, to pmagrath at macports.org.
+
+If you encounter an unexpected error, please include a full debug output and instructions on how to reproduce. 
+
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20080807/1aaec151/attachment.html