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>