4 # This file understands the following apt configuration variables:
5 # Values here are the default.
6 # Create /etc/apt/apt.conf.d/10periodic file to set your preference.
9 # - RootDir for all configuration files
11 # Dir::Cache "var/cache/apt/";
12 # - Set apt package cache directory
14 # Dir::Cache::Archives "archives/";
15 # - Set package archive directory
17 # APT::Periodic::Enable "1";
18 # - Enable the update/upgrade script (0=disable)
20 # APT::Periodic::BackupArchiveInterval "0";
21 # - Backup after n-days if archive contents changed.(0=disable)
23 # APT::Periodic::BackupLevel "3";
24 # - Backup level.(0=disable), 1 is invalid.
26 # Dir::Cache::Backup "backup/";
27 # - Set periodic package backup directory
29 # APT::Archives::MaxAge "0"; (old, deprecated)
30 # APT::Periodic::MaxAge "0"; (new)
31 # - Set maximum allowed age of a cache package file. If a cache
32 # package file is older it is deleted (0=disable)
34 # APT::Archives::MinAge "2"; (old, deprecated)
35 # APT::Periodic::MinAge "2"; (new)
36 # - Set minimum age of a package file. If a file is younger it
37 # will not be deleted (0=disable). Useful to prevent races
38 # and to keep backups of the packages for emergency.
40 # APT::Archives::MaxSize "0"; (old, deprecated)
41 # APT::Periodic::MaxSize "0"; (new)
42 # - Set maximum size of the cache in MB (0=disable). If the cache
43 # is bigger, cached package files are deleted until the size
44 # requirement is met (the oldest packages will be deleted
47 # APT::Periodic::Update-Package-Lists "0";
48 # - Do "apt-get update" automatically every n-days (0=disable)
50 # APT::Periodic::Download-Upgradeable-Packages "0";
51 # - Do "apt-get upgrade --download-only" every n-days (0=disable)
53 # APT::Periodic::Download-Upgradeable-Packages-Debdelta "1";
54 # - Use debdelta-upgrade to download updates if available (0=disable)
56 # APT::Periodic::Unattended-Upgrade "0";
57 # - Run the "unattended-upgrade" security upgrade script
58 # every n-days (0=disabled)
59 # Requires the package "unattended-upgrades" and will write
60 # a log in /var/log/unattended-upgrades
62 # APT::Periodic::AutocleanInterval "0";
63 # - Do "apt-get autoclean" every n-days (0=disable)
65 # APT::Periodic::CleanInterval "0";
66 # - Do "apt-get clean" every n-days (0=disable)
68 # APT::Periodic::Verbose "0";
69 # - Send report mail to root
70 # 0: no report (or null string)
71 # 1: progress report (actually any string)
72 # 2: + command outputs (remove -qq, remove 2>/dev/null, add -d)
75 # APT::Periodic::RandomSleep "1800";
76 # - The apt cron job will delay its execution by a random
77 # time span between zero and 'APT::Periodic::RandomSleep'
79 # This is done because otherwise everyone would access the
80 # mirror servers at the same time and put them collectively
81 # under very high strain.
82 # You can set this to '0' if you are using a local mirror and
83 # do not care about the load spikes.
84 # Note that sleeping in the apt job will be delaying the
85 # execution of all subsequent cron.daily jobs.
93 if [ $interval -eq 0 ]; then
94 debug_echo
"check_stamp: interval=0"
95 # treat as no time has passed
99 if [ ! -f $stamp ]; then
100 debug_echo
"check_stamp: missing time stamp file: $stamp."
101 # treat as enough time has passed
105 # compare midnight today to midnight the day the stamp was updated
107 stamp
=$(date --date=$(date -r $stamp_file --iso-8601) +%s
2>/dev
/null
)
108 if [ "$?" != "0" ]; then
109 # Due to some timezones returning 'invalid date' for midnight on
110 # certain dates (e.g. America/Sao_Paulo), if date returns with error
111 # remove the stamp file and return 0. See coreutils bug:
112 # http://lists.gnu.org/archive/html/bug-coreutils/2007-09/msg00176.html
117 now
=$(date --date=$(date --iso-8601) +%s
2>/dev
/null
)
118 if [ "$?" != "0" ]; then
119 # As above, due to some timezones returning 'invalid date' for midnight
120 # on certain dates (e.g. America/Sao_Paulo), if date returns with error
125 delta
=$(($now-$stamp))
127 # interval is in days, convert to sec.
128 interval
=$(($interval*60*60*24))
129 debug_echo
"check_stamp: interval=$interval, now=$now, stamp=$stamp, delta=$delta (sec)"
131 # remove timestamps a day (or more) in the future and force re-check
132 if [ $stamp -gt $(($now+86400)) ]; then
133 echo "WARNING: file $stamp_file has a timestamp in the future: $stamp"
138 if [ $delta -ge $interval ]; then
151 # we check here if autoclean was enough sizewise
152 check_size_constraints
()
155 eval $(apt-config shell MaxAge APT::Archives::MaxAge)
156 eval $(apt-config shell MaxAge APT::Periodic::MaxAge)
159 eval $(apt-config shell MinAge APT::Archives::MinAge)
160 eval $(apt-config shell MinAge APT::Periodic::MinAge)
163 eval $(apt-config shell MaxSize APT::Archives::MaxSize)
164 eval $(apt-config shell MaxSize APT::Periodic::MaxSize)
166 Cache
="/var/cache/apt/archives/"
167 eval $(apt-config shell Cache Dir::Cache::archives/d)
170 if [ -z "$Cache" ]; then
171 echo "empty Dir::Cache::archives, exiting"
176 if [ ! $MaxAge -eq 0 ] && [ ! $MinAge -eq 0 ]; then
177 debug_echo
"aged: ctime <$MaxAge and mtime <$MaxAge and ctime>$MinAge and mtime>$MinAge"
178 find $Cache -name "*.deb" \
( -mtime +$MaxAge -and -ctime +$MaxAge \
) -and -not \
( -mtime -$MinAge -or -ctime -$MinAge \
) -print0 | xargs -r -0 rm -f
179 elif [ ! $MaxAge -eq 0 ]; then
180 debug_echo
"aged: ctime <$MaxAge and mtime <$MaxAge only"
181 find $Cache -name "*.deb" -ctime +$MaxAge -and -mtime +$MaxAge -print0 | xargs -r -0 rm -f
183 debug_echo
"skip aging since MaxAge is 0"
187 if [ ! $MaxSize -eq 0 ]; then
189 MaxSize
=$(($MaxSize*1024))
192 now
=$(date --date=$(date --iso-8601) +%s
)
193 MinAge
=$(($MinAge*24*60*60))
195 # reverse-sort by mtime
196 for file in $(ls -rt $Cache/*.deb 2>/dev/null); do
199 # check if the cache is small enough
200 if [ $size -lt $MaxSize ]; then
201 debug_echo
"end remove by archive size: size=$size < $MaxSize"
205 # check for MinAge of the file
206 if [ $MinAge -ne 0 ]; then
207 # check both ctime and mtime
208 mtime
=$(stat -c %Y $file)
209 ctime
=$(stat -c %Z $file)
210 if [ $mtime -gt $ctime ]; then
211 delta
=$(($now-$mtime))
213 delta
=$(($now-$ctime))
215 if [ $delta -le $MinAge ]; then
216 debug_echo
"skip remove by archive size: $file, delta=$delta < $MinAge"
220 debug_echo
"remove by archive size: $file, delta=$delta >= $MinAge (sec), size=$size >= $MaxSize"
228 # deal with the Apt::Periodic::BackupArchiveInterval
231 BackupArchiveInterval
="$1"
232 if [ $BackupArchiveInterval -eq 0 ]; then
236 # Set default values and normalize
237 CacheDir
="/var/cache/apt"
238 eval $(apt-config shell CacheDir Dir::Cache/d)
239 CacheDir
=${CacheDir%/}
240 if [ -z "$CacheDir" ]; then
241 debug_echo
"practically empty Dir::Cache, exiting"
245 Cache
="${CacheDir}/archives/"
246 eval $(apt-config shell Cache Dir::Cache::Archives/d)
247 if [ -z "$Cache" ]; then
248 debug_echo
"practically empty Dir::Cache::archives, exiting"
253 eval $(apt-config shell BackupLevel APT::Periodic::BackupLevel)
254 if [ $BackupLevel -le 1 ]; then
258 Back
="${CacheDir}/backup/"
259 eval $(apt-config shell Back Dir::Cache::Backup/d)
260 if [ -z "$Back" ]; then
261 echo "practically empty Dir::Cache::Backup, exiting" 1>&2
265 CacheArchive
="$(basename "${Cache}")"
266 test -n "${CacheArchive}" || CacheArchive
="archives"
267 BackX
="${Back}${CacheArchive}/"
268 for x
in $(seq 0 1 $((${BackupLevel}-1))); do
269 eval "Back${x}=${Back}${x}/"
272 # backup after n-days if archive contents changed.
273 # (This uses hardlink to save disk space)
274 BACKUP_ARCHIVE_STAMP
=/var
/lib
/apt
/periodic
/backup
-archive-stamp
275 if check_stamp
$BACKUP_ARCHIVE_STAMP $BackupArchiveInterval; then
276 if [ $({(cd $Cache 2>/dev/null; find . -name "*.deb"); (cd $Back0 2>/dev
/null
;find .
-name "*.deb") ;}| sort|uniq -u|wc -l) -ne 0 ]; then
278 rm -rf $Back$((${BackupLevel}-1))
279 for y
in $(seq $((${BackupLevel}-1)) -1 1); do
281 eval BackZ
=${Back}$(($y-1))
282 if [ -e $BackZ ]; then
283 mv -f $BackZ $BackY ;
286 cp -la $Cache $Back ; mv -f $BackX $Back0
287 update_stamp
$BACKUP_ARCHIVE_STAMP
288 debug_echo
"backup with hardlinks. (success)"
290 debug_echo
"skip backup since same content."
293 debug_echo
"skip backup since too new."
297 # sleep for a random interval of time (default 30min)
298 # (some code taken from cron-apt, thanks)
302 eval $(apt-config shell RandomSleep APT::Periodic::RandomSleep)
303 if [ $RandomSleep -eq 0 ]; then
306 if [ -z "$RANDOM" ] ; then
307 # A fix for shells that do not have this bash feature.
308 RANDOM
=$(( $(dd if=/dev/urandom bs=2 count=1 2> /dev/null | cksum | cut -d' ' -f1) % 32767 ))
310 TIME
=$(($RANDOM % $RandomSleep))
311 debug_echo
"sleeping for $TIME seconds"
318 # Display message if $VERBOSE >= 1
319 if [ "$VERBOSE" -ge 1 ]; then
325 # laptop check, on_ac_power returns:
326 # 0 (true) System is on main power
327 # 1 (false) System is not on main power
328 # 255 (false) Power status could not be determined
329 # Desktop systems always return 255 it seems
330 if which on_ac_power
>/dev
/null
2>&1; then
333 if [ $POWER -eq 1 ]; then
334 debug_echo
"exit: system NOT on main power"
336 elif [ $POWER -ne 0 ]; then
337 debug_echo
"power status ($POWER) undetermined, continuing"
339 debug_echo
"system is on main power."
344 # ------------------------ main ----------------------------
346 if test -r /var
/lib
/apt
/extended_states
; then
347 # Backup the 7 last versions of APT's extended_states file
348 # shameless copy from dpkg cron
349 if cd /var
/backups
; then
350 if ! cmp -s apt.extended_states
.0 /var
/lib
/apt
/extended_states
; then
351 cp -p /var
/lib
/apt
/extended_states apt.extended_states
352 savelog
-c 7 apt.extended_states
>/dev
/null
357 # check apt-config existence
358 if ! which apt
-config >/dev
/null
2>&1; then
362 # check if the user really wants to do something
363 AutoAptEnable
=1 # default is yes
364 eval $(apt-config shell AutoAptEnable APT::Periodic::Enable)
366 if [ $AutoAptEnable -eq 0 ]; then
370 # Set VERBOSE mode from apt-config (or inherit from environment)
372 eval $(apt-config shell VERBOSE APT::Periodic::Verbose)
373 debug_echo
"verbose level $VERBOSE"
374 if [ "$VERBOSE" -le 2 ]; then
377 XSTDERR
="2>/dev/null"
386 if [ "$VERBOSE" -ge 3 ]; then
391 check_power
|| exit 0
393 # check if we can lock the cache and if the cache is clean
394 if which apt
-get >/dev
/null
2>&1 && ! eval apt
-get check
$XAPTOPT $XSTDERR ; then
395 debug_echo
"error encountered in cron job with \"apt-get check\"."
399 # Global current time in seconds since 1970-01-01 00:00:00 UTC
402 # Support old Archive for compatibility.
403 # Document only Periodic for all controlling parameters of this script.
406 eval $(apt-config shell UpdateInterval APT::Periodic::Update-Package-Lists)
408 DownloadUpgradeableInterval
=0
409 eval $(apt-config shell DownloadUpgradeableInterval APT::Periodic::Download-Upgradeable-Packages)
411 UnattendedUpgradeInterval
=0
412 eval $(apt-config shell UnattendedUpgradeInterval APT::Periodic::Unattended-Upgrade)
415 eval $(apt-config shell AutocleanInterval APT::Periodic::AutocleanInterval)
418 eval $(apt-config shell CleanInterval APT::Periodic::CleanInterval)
420 BackupArchiveInterval
=0
421 eval $(apt-config shell BackupArchiveInterval APT::Periodic::BackupArchiveInterval)
424 eval $(apt-config shell Debdelta APT::Periodic::Download-Upgradeable-Packages-Debdelta)
426 # check if we actually have to do anything that requires locking the cache
427 if [ $UpdateInterval -eq 0 ] &&
428 [ $DownloadUpgradeableInterval -eq 0 ] &&
429 [ $UnattendedUpgradeInterval -eq 0 ] &&
430 [ $BackupArchiveInterval -eq 0 ] &&
431 [ $AutocleanInterval -eq 0 ] &&
432 [ $CleanInterval -eq 0 ]; then
435 check_size_constraints
440 # deal with BackupArchiveInterval
441 do_cache_backup
$BackupArchiveInterval
443 # sleep random amount of time to avoid hitting the
444 # mirrors at the same time
446 check_power
|| exit 0
448 # include default system language so that "apt-get update" will
449 # fetch the right translated package descriptions
450 if [ -r /etc
/default
/locale
]; then
451 .
/etc
/default
/locale
452 export LANG LANGUAGE LC_MESSAGES LC_ALL
455 # update package lists
457 UPDATE_STAMP
=/var
/lib
/apt
/periodic
/update
-stamp
458 if check_stamp
$UPDATE_STAMP $UpdateInterval; then
459 if eval apt
-get $XAPTOPT -y update
$XSTDERR; then
460 debug_echo
"download updated metadata (success)."
461 if which dbus
-send >/dev
/null
2>&1 && pidof dbus
-daemon >/dev
/null
2>&1; then
462 if dbus
-send --system / app.apt.dbus.updated boolean
:true
; then
463 debug_echo
"send dbus signal (success)"
465 debug_echo
"send dbus signal (error)"
468 debug_echo
"dbus signal not send (command not available)"
470 update_stamp
$UPDATE_STAMP
473 debug_echo
"download updated metadata (error)"
476 debug_echo
"download updated metadata (not run)."
479 # download all upgradeable packages (if it is requested)
480 DOWNLOAD_UPGRADEABLE_STAMP
=/var
/lib
/apt
/periodic
/download
-upgradeable-stamp
481 if [ $UPDATED -eq 1 ] && check_stamp
$DOWNLOAD_UPGRADEABLE_STAMP $DownloadUpgradeableInterval; then
482 if [ $Debdelta -eq 1 ]; then
483 debdelta
-upgrade >/dev
/null
2>&1 || true
485 if eval apt
-get $XAPTOPT -y -d dist
-upgrade $XSTDERR; then
486 update_stamp
$DOWNLOAD_UPGRADEABLE_STAMP
487 debug_echo
"download upgradable (success)"
489 debug_echo
"download upgradable (error)"
492 debug_echo
"download upgradable (not run)"
495 # auto upgrade all upgradeable packages
496 UPGRADE_STAMP
=/var
/lib
/apt
/periodic
/upgrade
-stamp
497 if which unattended
-upgrade >/dev
/null
2>&1 && check_stamp
$UPGRADE_STAMP $UnattendedUpgradeInterval; then
498 if unattended
-upgrade $XUUPOPT; then
499 update_stamp
$UPGRADE_STAMP
500 debug_echo
"unattended-upgrade (success)"
502 debug_echo
"unattended-upgrade (error)"
505 debug_echo
"unattended-upgrade (not run)"
508 # clean package archive
509 CLEAN_STAMP
=/var
/lib
/apt
/periodic
/clean
-stamp
510 if check_stamp
$CLEAN_STAMP $CleanInterval; then
511 if eval apt
-get $XAPTOPT -y clean
$XSTDERR; then
512 debug_echo
"clean (success)."
513 update_stamp
$CLEAN_STAMP
515 debug_echo
"clean (error)"
518 debug_echo
"clean (not run)"
521 # autoclean package archive
522 AUTOCLEAN_STAMP
=/var
/lib
/apt
/periodic
/autoclean
-stamp
523 if check_stamp
$AUTOCLEAN_STAMP $AutocleanInterval; then
524 if eval apt
-get $XAPTOPT -y autoclean
$XSTDERR; then
525 debug_echo
"autoclean (success)."
526 update_stamp
$AUTOCLEAN_STAMP
528 debug_echo
"autoclean (error)"
531 debug_echo
"autoclean (not run)"
535 check_size_constraints
538 # vim: set sts=4 ai :