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