Annotation of pkgsrc/pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8, revision 1.7
1.6 wiz 1: .\" $NetBSD: pkg_rolling-replace.8,v 1.5 2007/05/11 16:48:55 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
! 27: flag. If the version of the replaced package has changed, this indicates
! 28: that it may no longer be ABI-compatible so
1.2 wiz 29: .Dq unsafe_depends=YES
1.7 ! tnn 30: is also set for all packages that depend on it.
1.2 wiz 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.7 ! tnn 73: .It Fl r
! 74: Just replace packages, do not build binary packages.
! 75: .It Fl s
! 76: Enable strict mode. This makes
! 77: .Nm
! 78: Look at
! 79: .Dq unsafe_depends_strict
! 80: tags instead of
! 81: .Dq unsafe_depends
! 82: tags. This will replace packages more aggressively and can be used to solve
! 83: shared library problems.
1.1 gdt 84: .It Fl u
85: Use
86: .Xl pkg_chk 8
87: to check for outdated packages, and replace those too.
88: .It Fl v
89: Verbose output.
90: .It Fl x Ar pkgs
91: Exclude the comma-separated list of packages from the update check
92: when
93: .Fl u
94: is given (does not exclude unsafe or rebuild-requested packages).
95: .El
96: .Sh ENVIRONMENT
97: .Nm
98: uses the following environment variables.
99: .Bl -tag -width xxxx
1.3 tnn 100: .It Ev MAKECONF
101: Path to
102: .Pa mk.conf .
103: Defaults to
104: .Pa /etc/mk.conf
1.5 tnn 105: or
1.6 wiz 106: .Pa ${PREFIX}/etc/mk.conf
1.5 tnn 107: (if using bmake).
1.1 gdt 108: .It Ev PKGSRCDIR
1.2 wiz 109: Base of pkgsrc tree.
1.3 tnn 110: Defaults to value configured in MAKECONF or
111: .Pa /usr/pkgsrc
112: if unset.
1.1 gdt 113: .It Ev PKG_DBDIR
114: pkgsrc database directory.
115: If not set in environment then defaults to
1.2 wiz 116: .Pa /var/db/pkg .
1.1 gdt 117: .El
118: .Sh AUTHORS
1.2 wiz 119: .An -nosplit
1.1 gdt 120: .An Nick Goffee
121: .Aq ngoffee@bbn.com ,
122: with initial idea and many suggestions from
123: .An Greg Troxel
124: .Aq gdt@ir.bbn.com .
1.7 ! tnn 125: The options -s and -r were added by
! 126: .An Tobias Nygren
! 127: .Aq tnn@NetBSD.org .
1.1 gdt 128: .Sh BUGS
129: .Nm
130: does not run fully automatically when any significant number of
131: packages need to be replaced.
CVSweb <webmaster@jp.NetBSD.org>