freebsd-ports/ports-mgmt/pkg_jail/files

#
# /usr/ports/local/update/
#
#	Scripts reside here.
#	install then here with:
#	cd /usr/ports/ports-mgmt/pkg_jail && make install-ports
#	/usr/ports should be shared with buildjail and hosts.
#
#
#	Intended to run within a jailed System:
#	---------------------------------------
#
#
#	pkg_update cvsup
#		Installs a copy of cvsup-without-gui package and start
#		"make update" for the ports tree.
#
#
#	pkg_update make-packages
#		Builds a port and its dependencies in a clean /usr/local.
#		You should not run this on a server with configuration.
#		Existing packages are used.
#		Extra files in "${PREFIX}" are detected and reported.
#		The default list of ports is "data/make-packages.${hostname}"
#
#
#	pkg_update clean-distfiles
#		Checks all distinfo files and moves the disfiles not found
#		to "/usr/ports/distfiles/Old/".
#
#
#	pkg_update merge-distfiles
#		Copy all disfiles found that do not yet exist on the master
#		directory "/media/ports/distfiles/".
#
#
#	pkg_update clean-packages
#		Synopsis:
#		Find obsolete packages and move them out of the way
#
#		Problem:
#		Installation of a package with multiple dependencys.
#		pkg_add installs the depended package, and its requirements.
#		When the depended package has been updated,
#		The packages that require this are no longer up to date.
#
#		Solution:
#		Use pkg_info on each package and compare the versions
#		with the new versions in the ports tree, if they don't
#		match report it, and move it out of the "All" directory
#		"/usr/ports/packages/All/" into a seperate directory
#		"/usr/ports/packages/Old/" for later cleanup.
#		Then remove all stale links to the moved packages.
#
#	pkg_update clean-openssl-packages
#		Find packages that use openssl and move them out of the way
#
#	pkg_update full-update-jail
#		do full update cycle
#		1) "cvsup" to update the ports tree
#		2) "clean-distfiles" to keep only current distfiles
#		3) "clean-packages" to keep only good packages
#		4) remove all old error logs
#		5) "make-packages" to rebuild missing packages
#
#	pkg_update full-update-jail retry
#		Skip "cvsup" and procced as above.
#
#
#	clean-usr-lib.sh:
#		Cleans the base system after installworld.
#		move old libs to comapt, so old applications keep running,
#		but new applications can only link to up-to-date libs.
#
#
#
#	Intended to everywhere:
#	-----------------------
#
#	pkg_update fetch-distfiles
#		Fetch distfiles for list of ports.
#
#	pkg_update fetch-recursive-distfiles
#		Fetch distfiles for list of ports and their dependecies.
#
#	pkg_update show-extra-files
#		list files in portsdir that are not updated by cvsup
#
#
#
#	Intended to run on a host:
#	--------------------------
#
#	pkg_update dependency-update
#		Try to fix as much dependecy problens in installed ports.
#
#	pkg_update fix-moved-ports
#		Check installed packages for moved ports. Then register
#		the new dir in the old installed package.
#
#	pkg_update add-packages
#		Build a missing port and its missing dpendencies
#		/usr/local is not deleted, on success the port is installed.
#		Existing packages will be used.
#
#	pkg_update list-installed-ports
#		List all installed ports.
#
#	pkg_update show-version-list
#		List installed packages that are not in correct version
#
#	pkg_update show-packages
#		List build packages or report missing for each port
#		recorded in "data/install-packages.${hostname}".
#
#	pkg_update show-missing-installed
#		List build packages or report missing for each port
#		installed on this host.
#
#	pkg_update check-installed-ports
#		Compare the list of installed ports with the list
#		recorded in data/install-packages.${hostname}".
#
#	pkg_update check-update
#		pkg_update check-installed-ports
#		pkg_update show-missing-packages
#		pkg_update show-missing-installed
#
#
#
#	Intended to update a host:
#	--------------------------
#
#	pkg_update show-missing-packages
#		Warn if no package is found for each port
#		recorded in "data/install-packages.${hostname}"
#
#	pkg_update clean
#		Clean all cached information.
#
#	pkg_update make-version-list
#		Make new list of packages that are not in correct version
#
#	pkg_update make-deinstall-list
#		Make new list of ports that are not in correct version
#		and create a script "deinstall.${hostname}" to deinstall
#		all the old ports and the dependend ports in order.
#
#	pkg_update check-reinstall
#		For each package deleted by "make-deinstall-list" warn
#		if no new package is found.
#
#	pkg_update reinstall
#		For each package deleted by "make-deinstall-list" try
#		to install the new package if it exists.
#
#	pkg_update install-packages
#		For each port recorded in "data/install-packages.${hostname}"
#		try to to install the new package if it exists.
#
#	pkg_update show-missing-reinstall
#		For each port recorded from "make-deinstall-list" warn
#		if no new package is found.
#
#	pkg_update make-easy-update
#		Try to generate the ordered sequence of pkg_deinstall
#		and pkg_add commands to update your old packages.
#
#	pkg_update replace-package
#		Overwrite the installed package with a new one and
#		register dependencies and dependant packages.
#		Warning: Don't do this when the ABI of the this
#		package or the ABI of its dependencies has changed.
#
#	pkg_update clean-reinstall
#		For each port recorded from "make-deinstall-list",
#		keep only the ports that have no package installed.
#
#	pkg_update deinstall-packages
#		For each port recorded in "data/install-packages.${hostname}"
#		try to to deinstall the installed port.
#
#
#
#	Files:
#	------
#
#
# /usr/ports/local/update/data/
#
#	Configuration files reside here.
#	create your initial configuration for a build jail:
#	pkg_update list-installed-ports \
#		> /usr/ports/local/update/data/make-packages.jailname
#
# /usr/ports/local/update/log-${host}
#
#	Buildlogs and errorlogs reside here.
#