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>