Annotation of pkgsrc/pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8, revision 1.1
1.1 ! gdt 1: .\" $NetBSD: pkg_rolling-replace.8,v 1.2 2006/12/05 18:20:50 gdt Exp $
! 2: .Dd August 7, 2006
! 3: .Dt PKG_ROLLING-REPLACE 8
! 4: .Sh NAME
! 5: .Nm pkg_rolling-replace
! 6: .Nd rebuild or update packages using 'make replace' in tsorted order
! 7: .Sh SYNOPSIS
! 8: .Nm
! 9: .Op Fl hnuvx
! 10: .Op Fl x Ar pkgs
! 11: .Sh DESCRIPTION
! 12: .Nm
! 13: runs 'make replace' on packages that have been marked with the
! 14: 'unsafe_depends=YES' flag or the 'rebuild=YES' flag, optionally
! 15: replacing any outdated packages (as reported by
! 16: .Xr pkg_chk 8 )
! 17: as well.
! 18: .Pp
! 19: Whenever 'make replace' is run on a package, all installed packages
! 20: that depend on it are marked with the 'unsafe_depends=YES' flag, which
! 21: indicates that they may no longer be ABI-compatible with the replaced
! 22: package. Running
! 23: .Nm
! 24: with no arguments will restore such packages to a safe state by
! 25: building a dependency graph, running
! 26: .Xr tsort 1
! 27: on it, and running 'make replace' in the resulting topological order.
! 28: The dependency graph and topological sort are re-calculated after each
! 29: 'make replace', in case it causes additional
! 30: packages to be marked unsafe.
! 31: .Pp
! 32: The user can mark additional packages to be rebuilt by setting the
! 33: 'rebuild=YES' flag on them using the command
! 34: .Dl % pkg_admin set rebuild=YES <pkg>
! 35: .Pp
! 36: If the
! 37: .Fl u
! 38: option is given,
! 39: .Nm
! 40: will use
! 41: .Xl pkg_chk 8
! 42: to check for packages for which the version in pkgsrc is different
! 43: than the installed version, and run 'make replace' on those packages
! 44: as well (tsorting them along with the unsafe/rebuild packages).
! 45: (Usually this results in packages being upgraded to newer versions,
! 46: assuming the pkgsrc tree is more recent than the currently installed
! 47: packages.)
! 48: .Pp
! 49: .Ss Options
! 50: .Bl -tag -width xxxxxxxx
! 51: .It Fl h
! 52: Brief help.
! 53: .It Fl n
! 54: Display actions that would be taken, but don't actually run 'make
! 55: replace' or change any flags on installed packages. This option
! 56: attempts to calculate the new packages that would be marked unsafe
! 57: after each 'make replace'.
! 58: .It Fl u
! 59: Use
! 60: .Xl pkg_chk 8
! 61: to check for outdated packages, and replace those too.
! 62: .It Fl v
! 63: Verbose output.
! 64: .It Fl x Ar pkgs
! 65: Exclude the comma-separated list of packages from the update check
! 66: when
! 67: .Fl u
! 68: is given (does not exclude unsafe or rebuild-requested packages).
! 69: .El
! 70: .Sh ENVIRONMENT
! 71: .Nm
! 72: uses the following environment variables.
! 73: .Bl -tag -width xxxx
! 74: .It Ev PKGSRCDIR
! 75: Base of pkgsrc tree. Defaults to
! 76: .Pa /usr/pkgsrc
! 77: .It Ev PKG_DBDIR
! 78: pkgsrc database directory.
! 79: If not set in environment then defaults to
! 80: .Pa /var/db/pkg
! 81: .El
! 82: .Sh AUTHORS
! 83: .An Nick Goffee
! 84: .Aq ngoffee@bbn.com ,
! 85: with initial idea and many suggestions from
! 86: .An Greg Troxel
! 87: .Aq gdt@ir.bbn.com .
! 88: .Sh BUGS
! 89: .Nm
! 90: does not run fully automatically when any significant number of
! 91: packages need to be replaced.
CVSweb <webmaster@jp.NetBSD.org>