Man Linux: Main Page and Category List

NAME

       debdelta-upgrade  -  Downloads  all deltas that may be used to ’apt-get
       upgrade’, and apply them.

SYNOPSIS

       debdelta-upgrade [OPTION]... [PACKAGE] ...

DESCRIPTION

       This program is designed to download changes (deltas) that may be  used
       to  apt-get upgrade all listed packages, and apply them.  If no package
       is listed in the command line, then it will  apply  to  all  upgradable
       packages. See debdelta(1) for more details on the delta files.

OPTIONS

       --dir DIR
              directory      where     to     save     results.      (default:
              /var/cache/apt/archives  for  root,  /tmp/archive  for  non-root
              users)

       --deb-policy POLICY
              policy to decide which debs to download, it is a comma separated
              list of (abbreviations of)
                  source =  there is no /etc/debdelta/sources.conf line
                  big =  the delta is too big
                  error =  the delta fails to apply
                  unavailable = all other cases
                  after = continue downloading debs after patching has ended
                default is s,b,e

       -v     verbose (can be added multiple times).

       -d     print full traceback on  Python  errors;  save  useful  info  in
              temporary files in case that a delta fails.

       -k     keep temporary files (use for debugging).

       -A --accept-unsigned
              accept unsigned deltas.

       --gpg-home
              specify  a  different  home  for  GnuPG,  default  for  root  is
              /etc/debdelta/gnupg  while  for  other  users  is   unset.   See
              --homedir in gpg(1) for details.

EXAMPLES

       When  invoked  as  root,  apt-get update && debdelta-upgrade && apt-get
       upgrade will download delta files, recreate the needed Debian packages,
       and  then  upgrade your Debian host. When only slow Internet connection
       is available, the above procedure  may  be  significantly  faster  than
       "apt-get  update && apt-get upgrade".  (Use -v to see how much faster.)

       The package manager cupt uses deltas as well when upgrading.

SECURITY

       A Debian package that is recreated using debdelta-upgrade  is  byte-by-
       byte  identical  to  the  original  one;  when   "apt-get  upgrade"  is
       subsequently invoked, the cryptographic archive authentication  support
       (see  apt-secure  (8)  )  will  guarantee  that it can be trusted to be
       installed.  Moreover, the delta files themselves  are  cryptograhically
       protected  using  GnuPG,  MD5  and SHA1 (using the same method as dpkg-
       sig(1) ), and  debdelta-upgrade  will  refuse  to  apply  corrupted  or
       unsigned deltas (but, see option -A ).

DOWNLOAD AND PROXIES

       debdelta-upgrade  downloads deltas in two passes: in the first pass, it
       downloads the first kB of each delta, to extract the  delta  parameters
       and  to  examine  them.  If  the delta does not exist, it checks if the
       debdelta-too-big timestamp  file  exists,  and  then  it  examines  the
       --deb-policy  to  decide if to download the deb instead.  In the second
       pass, it downloads (the rest of)  the  deltas  and  queues  them  in  a
       patching queue.

       For  plain  direct  http  downloads,  debdelta-upgrade  uses the Python
       library ’httplib’ directly; in particular, it uses keep-alive features,
       and this speeds up a lot the first pass.

       If   variables  such  as  http_proxy  are set in the environment,  then
       instead debdelta-upgrade will use the  ’urllib2’  module:  this  though
       slows  down  sensibly  the  first  pass  above (since ’urllib2’ opens a
       different connection for each download); moreover ’urllib2’ seems to be
       buggy  in  some  places (for example, it transforms http response "401"
       into "404" , and "302" into "200") so the output explanation printed by
       debdelta-upgrade  in  case  of  download  error  may  be wrong; and the
       --deb-policy big is currently disabled (until  the  author  understands
       ’urllib2’ better).

EXIT STATUS

       See debdelta(1)

REPORTING BUGS

       Report bugs to <mennucc1@debian.org>.

AUTHORS

       Debdelta was written and is copyright © 2006-09 Andrea Mennucci.
       This     man     page     was     written    by    Jegou    Pierre-yves
       <pierreyves.jeg@voila.fr>.

COPYING

       This is free software.  You may redistribute copies  of  it  under  the
       terms     of     the     GNU    Library    General    Public    License
       <http://www.gnu.org/licenses/lgpl-2.0.html>.  There is NO WARRANTY,  to
       the extent permitted by law.

SEE ALSO

       debdelta(1),     apt-get(8),    /usr/share/doc/debdelta/README.upgrade,
       /usr/share/doc/debdelta/README.