~ubuntu-branches/ubuntu/vivid/apt-cacher/vivid-proposed

« back to all changes in this revision

Viewing changes to debian/apt-cacher.8

  • Committer: Package Import Robot
  • Author(s): Mark Hindley
  • Date: 2011-11-27 08:39:23 UTC
  • mfrom: (4.2.8 sid)
  • Revision ID: package-import@ubuntu.com-20111127083923-bgg2i3seunmxdeqx
Tags: 1.7.2
* Clear SysV semaphore block on install.
* Brazilian Portuguese debconf translation. Thanks to Marco Juliano e
  Silva (closes: #649499).
* When refreshing Release files internally, use Cache-Control: no-cache
* Add support for "status" action to init.d script. Patch from Peter
  Eisentraut (closes: #647984).
* Allow source files to be xv compressed. Patch from Ansgar Burghardt
  (closes: #648470).
* Support setting IO priority to reduce load in apt-cacher-cleanup.pl.
* Move library files to lib/ subdir.
* Document support for incoming request Cache-Control headers.
* Remove deprecated/* from source tarball.
* Workaround features missing in perl versions less than 5.10. 
* Improve child process management using process groups.
* Fix reading checksums from patched index files when using pdiff option
  to apt-cacher-cleanup.pl.
* New option concurrent_import_limit to control simultaneous reading of
  checksums from new index files. Default is the number of virtual CPU
  cores as parsed from /proc/cpuinfo (where possible).  
* Replace cron.daily script with more flexible cron.d fragment.
* Precompile regexps where possible.
* Don't try to checksum installer files.
* Fix libcurl low speed timeout.

Show diffs side-by-side

added added

removed removed

Lines of Context:
50
50
.B config_option=value
51
51
Override values in configuration file. Can be given multiple times.
52
52
.TP
 
53
.B \-v, --version
 
54
Show version and exit.
 
55
.TP
53
56
.B \-h, --help
54
57
Print brief usage.
55
58
.SH USAGE
262
265
filename of all package-type files (files that are uniquely identified, within
263
266
their Distribution, by their filename).
264
267
.TP
 
268
.BI "pdiff_files_regexp [" "see default /etc/apt-cacher/apt-cacher.conf" "]"
 
269
Perl regular expression (perlre(1)) which matches APT pdiff files. These are
 
270
ed(1) scripts which APT use to patch index files rather than redownloading the
 
271
whole file afresh.
 
272
.TP
265
273
.BI "index_files_regexp [" "see default /etc/apt-cacher/apt-cacher.conf" "]"
266
274
Perl regular expression (perlre(1)) which matches the URL filename of all
267
275
index-type files (files that are uniquely identified by their full path and need
388
396
apt\-cacher response as requested files have to be downloaded completely before
389
397
validation can occur. Requires package libberkeleydb-perl to be installed.
390
398
.TP
391
 
.B concurrent_import_limit []
 
399
.BI "concurrent_import_limit [" "Number of CPU cores from /proc/cpuinfo or 0" "]"
392
400
Importing new checksums can cause high CPU usage on slower systems. This option
393
401
sets a limit to the number of index files that are imported simultaneously,
394
 
thereby limiting CPU load, but taking longer. Leave unset or set to 0 for no
395
 
limit.
 
402
thereby limiting CPU load average, but, possibly, taking longer. Leave unset or
 
403
set to 0 for no limit.
396
404
.TP
397
405
.B debug [0]
398
406
Whether debug mode is enabled. Off by default. When turned on (non-nil), lots of
515
523
potential clients that would download these packages and the clients did run
516
524
"apt\-get update" using apt\-cacher once, there is no reason to worry.
517
525
.PP
 
526
.B Q: I have an invalid/corrupt file in the cache, how can I remove it?
 
527
.PP
 
528
A: There are several possibilities for this:
 
529
.IP 1) 4
 
530
In either daemon mode, apt-cacher tries to be a well-behaved cache and respects
 
531
Cache-Control and Pragma headers. Refreshing a file can be forced by adding
 
532
Cache-Control: no-cache to the request. The easiest way of doing this is with
 
533
the --no-cache option of wget(1), for example:
 
534
.IP "" 6
 
535
wget -O/dev/null --no-cache http://localhost:3142/debian/dists/stable/Release
 
536
.IP 2) 4
 
537
Enable checksumming which will validate cached files as they are fetched.
 
538
.IP 3)
 
539
Wait until after apt-cacher-cleanup.pl has run (which should remove invalid
 
540
files).
 
541
.IP 4)
 
542
Manually delete the file from /var/cache/apt-cacher/packages.
 
543
.PP
518
544
.B Q: Does the daily generation of reports or cleaning the cache depend
519
545
.B on whether apt\-cacher is running continuously as a daemon?
520
546
.PP