From owner-svn-src-user@FreeBSD.ORG Sat Aug 7 22:08:59 2010 Return-Path: Delivered-To: svn-src-user@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 03CB01065678; Sat, 7 Aug 2010 22:08:59 +0000 (UTC) (envelope-from dougb@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id CD54C8FC1E; Sat, 7 Aug 2010 22:08:58 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id o77M8wgJ069744; Sat, 7 Aug 2010 22:08:58 GMT (envelope-from dougb@svn.freebsd.org) Received: (from dougb@localhost) by svn.freebsd.org (8.14.3/8.14.3/Submit) id o77M8wSE069741; Sat, 7 Aug 2010 22:08:58 GMT (envelope-from dougb@svn.freebsd.org) Message-Id: <201008072208.o77M8wSE069741@svn.freebsd.org> From: Doug Barton Date: Sat, 7 Aug 2010 22:08:58 +0000 (UTC) To: src-committers@freebsd.org, svn-src-user@freebsd.org X-SVN-Group: user MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r211042 - user/dougb/portmaster/files X-BeenThere: svn-src-user@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the experimental " user" src tree" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 07 Aug 2010 22:08:59 -0000 Author: dougb Date: Sat Aug 7 22:08:58 2010 New Revision: 211042 URL: http://svn.freebsd.org/changeset/base/211042 Log: Document the PM_LOG and PM_IGNORE_FAILED_BACKUP_PACKAGE options Modified: user/dougb/portmaster/files/portmaster.8 user/dougb/portmaster/files/portmaster.rc.sample.in Modified: user/dougb/portmaster/files/portmaster.8 ============================================================================== --- user/dougb/portmaster/files/portmaster.8 Sat Aug 7 21:49:05 2010 (r211041) +++ user/dougb/portmaster/files/portmaster.8 Sat Aug 7 22:08:58 2010 (r211042) @@ -592,6 +592,34 @@ file so that the dependencies match. If you wish to customize your build environment on a per-port basis you might want to take a look at .Pa ports/ports-mgmt/portconf +.Pp +To log actions taken by +.Nm +along with a date/time stamp you can define +.Ev PM_LOG +in your rc file with the full path of the file you would +like to log to. +If running +.Nm +with +.Xr sudo 8 +(see below) then you should make sure that the file is +writable by the unprivileged user. +.Pp +By default +.Nm +creates backup packages of installed ports before it runs +.Xr pkg_delete 1 +during an update. +If that package creation fails it is treated as a serious +error and the user is prompted. +However for scripted use of +.Nm +this can be a problem. +In situations where the user is ABSOLUTELY SURE +that lack of a backup package should not be a fatal error +.Ev PM_IGNORE_FAILED_BACKUP_PACKAGE +can be defined to any value in the rc file. .Sh FILES .Bl -tag -width "1234" -compact .It Pa /usr/local/etc/portmaster.rc Modified: user/dougb/portmaster/files/portmaster.rc.sample.in ============================================================================== --- user/dougb/portmaster/files/portmaster.rc.sample.in Sat Aug 7 21:49:05 2010 (r211041) +++ user/dougb/portmaster/files/portmaster.rc.sample.in Sat Aug 7 22:08:58 2010 (r211042) @@ -98,3 +98,12 @@ # Use the INDEX file instead of /usr/ports (--index-only) # PM_INDEX=pm_index # PM_INDEX_ONLY=pm_index_only +# +# +# The following options are available for the rc file only: +# +# Log actions taken by portmaster with a date/time stamp +# PM_LOG=/full/path/to/file +# +# Do not prompt the user for failed backup package creation +# PM_IGNORE_FAILED_BACKUP_PACKAGE=pm_ignore_failed_backup_package