Annotation of pkgsrc/pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8, revision 1.8
1.8 ! wiz 1: .\" $NetBSD: pkg_rolling-replace.8,v 1.7 2007/08/08 11:28:04 tnn Exp $
1.7 tnn 2: .Dd August 8, 2007
1.1 gdt 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.7 tnn 10: .Op Fl hnrsuv
1.1 gdt 11: .Op Fl x Ar pkgs
12: .Sh DESCRIPTION
13: .Nm
1.2 wiz 14: runs
15: .Dq make replace
1.7 tnn 16: on packages that have been marked to have unsafe dependencies or have
17: been marked to be rebuilt.
18: Optionally it can replace any outdated packages (as reported by
1.1 gdt 19: .Xr pkg_chk 8 )
20: as well.
21: .Pp
1.2 wiz 22: Whenever
23: .Dq make replace
24: is run on a package, all installed packages
25: that depend on it are marked with the
1.7 tnn 26: .Dq unsafe_depends_strict=YES
1.8 ! wiz 27: flag.
! 28: If the version of the replaced package has changed, this indicates
1.7 tnn 29: that it may no longer be ABI-compatible so
1.2 wiz 30: .Dq unsafe_depends=YES
1.7 tnn 31: is also set for all packages that depend on it.
1.2 wiz 32: Running
1.1 gdt 33: .Nm
34: with no arguments will restore such packages to a safe state by
35: building a dependency graph, running
36: .Xr tsort 1
1.2 wiz 37: on it, and running
38: .Dq make replace
39: in the resulting topological order.
1.1 gdt 40: The dependency graph and topological sort are re-calculated after each
1.2 wiz 41: .Dq make replace ,
42: in case it causes additional packages to be marked unsafe.
1.1 gdt 43: .Pp
44: The user can mark additional packages to be rebuilt by setting the
1.2 wiz 45: .Dq rebuild=YES
46: flag on them using the command
47: .Dl % pkg_admin set rebuild=YES Aq pkg
1.1 gdt 48: .Pp
49: If the
50: .Fl u
51: option is given,
52: .Nm
53: will use
54: .Xl pkg_chk 8
55: to check for packages for which the version in pkgsrc is different
1.2 wiz 56: than the installed version, and run
57: .Dq make replace
58: on those packages as well (tsorting them along with the unsafe/rebuild
59: packages).
1.1 gdt 60: (Usually this results in packages being upgraded to newer versions,
61: assuming the pkgsrc tree is more recent than the currently installed
62: packages.)
63: .Ss Options
64: .Bl -tag -width xxxxxxxx
65: .It Fl h
66: Brief help.
67: .It Fl n
1.2 wiz 68: Display actions that would be taken, but don't actually run
69: .Dq make replace
70: or change any flags on installed packages.
71: This option attempts to calculate the new packages that would be
72: marked unsafe after each
73: .Dq make replace .
1.7 tnn 74: .It Fl r
75: Just replace packages, do not build binary packages.
76: .It Fl s
1.8 ! wiz 77: Enable strict mode.
! 78: This makes
1.7 tnn 79: .Nm
1.8 ! wiz 80: look at
1.7 tnn 81: .Dq unsafe_depends_strict
82: tags instead of
83: .Dq unsafe_depends
1.8 ! wiz 84: tags.
! 85: This will replace packages more aggressively and can be used to solve
1.7 tnn 86: shared library problems.
1.1 gdt 87: .It Fl u
88: Use
89: .Xl pkg_chk 8
90: to check for outdated packages, and replace those too.
91: .It Fl v
92: Verbose output.
93: .It Fl x Ar pkgs
94: Exclude the comma-separated list of packages from the update check
95: when
96: .Fl u
97: is given (does not exclude unsafe or rebuild-requested packages).
98: .El
99: .Sh ENVIRONMENT
100: .Nm
101: uses the following environment variables.
102: .Bl -tag -width xxxx
1.3 tnn 103: .It Ev MAKECONF
104: Path to
105: .Pa mk.conf .
106: Defaults to
107: .Pa /etc/mk.conf
1.5 tnn 108: or
1.6 wiz 109: .Pa ${PREFIX}/etc/mk.conf
1.5 tnn 110: (if using bmake).
1.1 gdt 111: .It Ev PKGSRCDIR
1.2 wiz 112: Base of pkgsrc tree.
1.3 tnn 113: Defaults to value configured in MAKECONF or
114: .Pa /usr/pkgsrc
115: if unset.
1.1 gdt 116: .It Ev PKG_DBDIR
117: pkgsrc database directory.
118: If not set in environment then defaults to
1.2 wiz 119: .Pa /var/db/pkg .
1.1 gdt 120: .El
121: .Sh AUTHORS
1.2 wiz 122: .An -nosplit
1.1 gdt 123: .An Nick Goffee
124: .Aq ngoffee@bbn.com ,
125: with initial idea and many suggestions from
126: .An Greg Troxel
127: .Aq gdt@ir.bbn.com .
1.8 ! wiz 128: The options
! 129: .Fl s
! 130: and
! 131: .Fl r
! 132: were added by
1.7 tnn 133: .An Tobias Nygren
134: .Aq tnn@NetBSD.org .
1.1 gdt 135: .Sh BUGS
136: .Nm
137: does not run fully automatically when any significant number of
138: packages need to be replaced.
CVSweb <webmaster@jp.NetBSD.org>