Annotation of pkgsrc/pkgtools/pkg_rolling-replace/files/pkg_rolling-replace.8, revision 1.1

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

CVSweb <webmaster@jp.NetBSD.org>