PKG_PATCH(1)		FreeBSD General Commands Manual 	  PKG_PATCH(1)

NNAAMMEE
     ppkkgg__ppaattcchh -- a utility for managing binary package patches.

SSYYNNOOPPSSIISS
     ppkkgg__ppaattcchh [--ff] [--vv] --aa _p_a_t_c_h_f_i_l_e
     ppkkgg__ppaattcchh [--bb] [--vv] --cc _s_o_u_r_c_e___p_a_c_k_a_g_e _t_a_r_g_e_t___p_a_c_k_a_g_e _p_a_t_c_h___f_i_l_e
     ppkkgg__ppaattcchh [--bb] [--vv] [--pp _p_k_g___r_e_p_o___u_r_l] --mm _s_o_u_r_c_e___d_i_r _t_a_r_g_e_t___d_i_r _p_a_t_c_h___d_i_r
     ppkkgg__ppaattcchh [--vv] --uu _p_a_t_c_h___u_r_l
     ppkkgg__ppaattcchh --hh

DDEESSCCRRIIPPTTIIOONN
     The ppkkgg__ppaattcchh command is used to work with patches to binary packages -
     creating them from existing binary packages and applying them to live
     systems.  It implements infrastructure for mass package creation and dis-
     tribution over the web.  The --aa and --uu command flags are intended to be
     used by end-user to apply individual packages or mass update their pack-
     ages.  The other command flags are used by package patch repo maintain-
     ers.

OOPPTTIIOONNSS
     The following command line arguments are supported:

     --vv      Turn on verbose output.

     --ff      Force continuing operation even if non-critical errors are
	     encountered, such as error in installed package state or unsatis-
	     fied dependancies.

     --aa      Apply the specified package patch to the current live system.
	     The currently installed package must match the source package
	     from which the patch was generated.

     --cc      Create a package patch from two specified binary package files.

     --mm      Mass-create package patches from two directories of packages.
	     The ppkkgg__ppaattcchh will attempt to match each package from the source
	     directory to exactly one package in the target directory and pro-
	     duce both patches and the index file in the specified patch
	     directory.  The resulting directory will be called the "package
	     patch repository."

     --pp      URL of the package repository containing full packages (i.e. not
	     patches) compatible with packages in target_dir.  This URL is
	     used by clients to fetch the

     --uu      Compare the current system state with the package patch reposi-
	     tory and update any packages found to need updating.

     --hh      Show usage help message.

TTEECCHHNNIICCAALL DDEETTAAIILLSS
     The ppkkgg__ppaattcchh utility operates on binary package files and on the live
     system, including the package database in _/_v_a_r_/_d_b_/_p_k_g.  All documented
     modes of operation require ppkkgg__ppaattcchh to be run as the superuser.  Cur-
     rently, ppkkgg__ppaattcchh does not invoke any scripts or commands specified in
     the package files.

SSEEEE AALLSSOO
     pkg_add(1), pkg_create(1), pkg_delete(1), pkg_info(1), pkg_version(1),
     bsdiff(1)

AAUUTTHHOORRSS
     Ivan Voras <ivoras@freebsd.org>

BBUUGGSS
     Many low-level details of ppkkgg__ppaattcchh (such as hard link handling, etc)
     depend on the behaviour of the tar(1) utility.  This is also the reason
     why ppkkgg__ppaattcchh needs superuser privileges while running in all modes of
     operation.


FreeBSD 8.1			August 9, 2010			   FreeBSD 8.1