[osmrrze.git] / scripts / osmtilecleanup.pl

#!/usr/bin/perl -w

# OSM tile cleanup / maintenance script. Big parts are a copied from
# hochwasserloeschung.pl.

use Fcntl ':mode';
use POSIX 'strftime';

$zoommin = 0;
$zoommax = 20;
$filelimit = -1;
$rmemptydirs = 0;
$action = 0;
$rrs = '/bin/echo';
$minage = 0;  # In hours!
$setbackinterval = 7305 * 86400; # 20 years (including leap years)

# Sort function for candidate list
sub sortbydateasc {
  #print("$a->[1] $b->[1]\n");
  return ($a->[1] <=> $b->[1]);
}

# Remembers a candidate for deletion, if required sorting and purging out the
# list.
# Parameters: 0   filename
#             1   atime
#             2   mtime
#             3   type field from stat (containing DIR, LINK etc.)
#             4   uid
#             5   gid
#             6   size in bytes
sub remembercandidate($$$$$$$) {
  if (($_[4] == 0) || ($_[5] == 0)) {
    # we do not touch roots files or directories.
    return;
  }
  if ($_[2] > (time() - ($minage * 3600))) {
    #print("not adding $_[0], too new\n");
    return;
  }
  $totalfilesseen++;
  push(@allentries, [ $_[0], $_[2], $_[3], $_[4], $_[5], $_[6] ]);
}

# Par. 0: Path were we start
# Par. 1: Recursion counter
# Returns: Number of files/dirs found (non-recursively!)
sub runrecursive($$);
sub runrecursive($$) {
  my $DIR;
  my $pth = $_[0];
  my $curdirentry;
  my @statres;
  my $recctr = $_[1];
  my $direntries = 0;
  unless (opendir($DIR, $pth)) {
    print("ERROR: Failed to open dir $pth\n");
    exit(1);
  }
  while ($curdirentrys = readdir($DIR)) {
    if (($curdirentrys eq '.') || ($curdirentrys eq '..')) {
      next;
    }
    $direntries++;
    $curdirentryf = $pth.'/'.$curdirentrys;
    @statres = lstat($curdirentryf);
    unless (@statres > 12) {
      # This usually happens if we have a symlink to a file for which we have
      # no permission to read.
      #print("stat failed for $curdirentry\n");
      next;
    }
    if (S_ISLNK($statres[2])) { next; } # A symlink? We no like.
    if ($recctr <= 4) { # There should be no files on these levels
      unless (S_ISDIR($statres[2])) { next; }
      unless ($curdirentrys =~ m/^\d+$/) { next; }
    } else { # whereas there should be only files called .meta on level 5.
      unless (S_ISREG($statres[2])) { next; }
      unless ($curdirentrys =~ m/^\d+\.meta$/) { next; }
    }
    if ($recctr == 0) {
      my $z = int($curdirentrys);
      unless (($z >= $zoommin) && ($z <= $zoommax)) { next; }
      runrecursive($curdirentryf, $recctr+1);
    } elsif ($recctr <= 4) {
      if (runrecursive($curdirentryf, $recctr+1) == 0) { # Empty dir!
        if ($rmemptydirs) {
          print("RMDIR: $curdirentryf\n");
          rmdir($curdirentryf);
        }
      }
    } else {
      remembercandidate($curdirentryf, $statres[8], $statres[9], $statres[2], $statres[4], $statres[5], $statres[12]);
    }
  }
  closedir($DIR);
  return $direntries;
}

# Par. 0: Full path of file
sub rerenderfile($) {
  my $fpth = $_[0];
  # We first need to figure out the relevant numbers from the full file path
  unless ($fpth =~ m!/(\d+)/(\d+)/(\d+)/(\d+)/(\d+)/(\d+)\.meta$!) {
    print("WARNING: rerenderfile: Failed to extract path components for rerendering out of '$fpth' - skipping\n");
    return;
  }
  my $zl = $1; my @p = ( $2, $3, $4, $5, $6 );
  my $calcx = 0; my $calcy = 0;
  my $i;
  for ($i = 0; $i < 5; $i++) {
    $calcx = ($calcx << 4) | (($p[$i] & 0xf0) >> 4);
    $calcy = ($calcy << 4) | (($p[$i] & 0x0f) >> 0);
  }
  #  struct meta_layout {
  #    char magic[4];        // 'M' 'E' 'T' 'A'
  #    int count;            // METATILE ^ 2
  #    int x, y, z;          // lowest x,y of this metatile, plus z
  my $fi;
  unless (open($fi, '<', $fpth)) {
    print("WARNING: rerenderfile: Failed to open file '$fpth' - skipping\n");
    return;
  }
  binmode($fi);
  my $dbuf;
  unless (read($fi, $dbuf, 20)) {
    print("WARNING: rerenderfile: Failed to read info from metatile '$fpth' - skipping\n");
    return;
  }
  close($fi); undef($fi);
  unless (substr($dbuf, 0, 4) eq 'META') {
    print("WARNING: rerenderfile: file '$fpth' is not a metatile - skipping\n");
    return;
  }
  unless (ord(substr($dbuf, 4, 1)) == 64) {
    print("WARNING: rerenderfile: file '$fpth' is not a 8x8 metatile - skipping\n");
    return;
  }
  my $fx = (ord(substr($dbuf,  8, 1)) <<  0) | (ord(substr($dbuf,  9, 1)) <<  8)
         | (ord(substr($dbuf, 10, 1)) << 16) | (ord(substr($dbuf, 11, 1)) << 24);
  unless ($fx == $calcx) {
    print("WARNING: rerenderfile: file '$fpth' is invalid - xsize $fx != $calcx - skipping\n");
    return;
  }
  my $fy = (ord(substr($dbuf, 12, 1)) <<  0) | (ord(substr($dbuf, 13, 1)) <<  8)
         | (ord(substr($dbuf, 14, 1)) << 16) | (ord(substr($dbuf, 15, 1)) << 24);
  unless ($fy == $calcy) {
    print("WARNING: rerenderfile: file '$fpth' is invalid - xsize $fy != $calcy - skipping\n");
    return;
  }
  my $fz = (ord(substr($dbuf, 16, 1)) <<  0) | (ord(substr($dbuf, 17, 1)) <<  8)
         | (ord(substr($dbuf, 18, 1)) << 16) | (ord(substr($dbuf, 19, 1)) << 24);
  unless ($fz == $zl) {
    print("WARNING: rerenderfile: file '$fpth' is invalid - zsize $fz != $zl - skipping\n");
    return;
  }
  print("Sending rendering request for z=$zl x=$calcx y=$calcy to regenerate '$fpth'\n");
  if (system("$rrs $zl $calcx $calcy")) {
    print("Error executing $rrs $zl $calcx $calcy\n");
  }
}

# Par. 0: x
# Par. 1: y
sub calcpathfromcomponents($$) {
  my @res = ();
  my $i; my $x = $_[0]; my $y = $_[1];
  for ($i = 4; $i >= 0; $i--) {
    $res[$i] = sprintf("%d", (($x & 0x0f) << 4) + ($y & 0x0f));
    $x = $x >> 4;
    $y = $y >> 4;
  }
  return $res[0] . "/" . $res[1] . "/" . $res[2] . "/" . $res[3] . "/" . $res[4];
}

sub dohandleexpiredlist() {
  my $ll;
  %rerenderlist = ();
  while ($ll = <STDIN>) {
    if ($ll =~ m!^(\d+)/(\d+)/(\d+)$!) {
      my $x = $2; my $y = $3; my $z = $1;
      #print("Handling z=$z x=$x y=$y\n");
      if ($z != ($zoommax - 3)) {
        print("Ignoring z=$z x=$x y=$y because of wrong zoom\n");
        next;
      }
      my $cz; my $cx; my $cy; my $curz;
      for ($curz = $zoommin; $curz <= $zoommax; $curz++) {
        $cz = $z; $cx = $x; $cy = $y;
        while ($cz < $curz) {
          $cz++; $cx <<= 1; $cy <<= 1;
        }
        while ($cz > $curz) {
          $cz--; $cx >>= 1; $cy >>= 1;
        }
        #print("Matching tile at z=$cz: x=$cx y=$cy -");
        $cx = $cx & 0xfff8; $cy = $cy & 0xfff8;
        #print(" rounded to x=$cx y=$cy\n");
        $rerenderlist{$cz}{$cx}{$cy} = 1;
      }
    }
  }
  $filesdone = 0; $filesseen = 0;
  foreach $z (sort(keys(%rerenderlist))) {
    foreach $x (sort(keys(%{$rerenderlist{$z}}))) {
      foreach $y (sort(keys(%{$rerenderlist{$z}{$x}}))) {
        my $p = ${fspath} . '/' . $z . '/' . calcpathfromcomponents($x, $y) . '.meta';
        #print("Checking: $z $x $y - Path: $p\n");
        $filesseen++;
        if (-e $p) {
          if ($action == 3) {
            $filesdone++;
            print("Sending rendering request for z=$z x=$x y=$y to regenerate '$p'\n");
            if (system("$rrs $z $x $y")) {
              print("Error executing $rrs $z $x $y\n");
            }
          } elsif ($action == 4) {
            my $mtime = (stat($p))[9];
            my $curtime = time();
            if (($curtime - $setbackinterval) > $mtime) {
              # Do not touch again - it's already 20 years back.
              print("Not touching '$p', it's over 20 years old so probably has already been set back.\n");
            } else {
              my $newmtime = $mtime - $setbackinterval;
              print("Touching '$p' (z=$z x=$x y=$y)\n");
              if (utime($curtime, $newmtime, $p) < 1) {
                print("Error touching '$p': $!\n");
              }
            }
          } else {
            print("Internal error - action variable invalid. This is a programming error.\n");
            exit(1);
          }
        }
      }
    }
  }
  if ($action == 3) {
    print("Sent re-rendering-requests for $filesdone files that actually existed (of $filesseen candidates)\n");
  } elsif ($action == 4) {
    print("Touched $filesdone files (of $filesseen candidates)\n");
  }
}

$fspath = '';
for ($i = 0; $i < @ARGV; $i++) {
  $curarg = $ARGV[$i];
  if      ($curarg eq '--help') {
    print("Syntax: $0 [--help] [--zoom z] [--limit n] [--action a] [--rmemptydirs]\n");
    print("           [--rrs path] [--minage hrs] directory\n");
    print("  --zoom z[-z2]: Zoom level(s) to handle (default: 0-20).\n");
    print("  --limit n: Limit to the n oldest files (default: no limit)\n");
    print("  --action what: what action to perform with the found files.\n");
    print("    valid actions are: print delete rerender rerenderexpiredlist\n");
    print("                       touchexpiredlist (default: print)\n");
    print("    rerenderexpiredlist and touchexpiredlist: these are very different from the\n");
    print("    other commands, as they expect to read a list of expired tiles to rerender\n");
    print("    or touch on STDIN. The list has to be in the format that osm2pgsql spits\n");
    print("    out. touchexpiredlist sets the mtime of the tiles back 20 years.\n");
    print("  --rmemptydirs: remove empty subdirectories\n");
    print("  --rrs path: if action is rerender, this gives the path to the rerender script.\n");
    print("    it gets called with three parameters: z x y\n");
    print("  --minage hrs: only care about files that are at least hrs hours old\n");
    exit(1);
  } elsif ($curarg eq '--zoom') {
    $i++;
    if ($i >= @ARGV) {
      print("Error: --zoom requires a parameter\n");
      exit(1);
    } else {
      if ($ARGV[$i] =~ m/^(\d+)-(\d+)$/) {
        $zoommin = $1; $zoommax = $2;
      } elsif ($ARGV[$i] =~ m/^(\d+)$/) {
        $zoommin = $1; $zoommax = $1;
      } else {
        print("Error: --zoom needs a single numeric parameter or a range (e.g. 4 or 10-12)\n");
        exit(1);
      }
    }
  } elsif ($curarg eq '--limit') {
    $i++;
    if ($i >= @ARGV) {
      print("Error: --limit requires a parameter\n");
      exit(1);
    } else {
      if ($ARGV[$i] =~ m/^(\d+)$/) {
        $filelimit = $1;
      } else {
        print("Error: --limit requires an positive integer as parameter.\n");
      }
    }
  } elsif ($curarg eq '--action') {
    $i++;
    if ($i >= @ARGV) {
      print("Error: --action requires a parameter\n");
      exit(1);
    } else {
      if      ($ARGV[$i] eq 'print') {
        $action = 0;
      } elsif ($ARGV[$i] eq 'delete') {
        $action = 1;
      } elsif ($ARGV[$i] eq 'rerender') {
        $action = 2;
      } elsif ($ARGV[$i] eq 'rerenderexpiredlist') {
        $action = 3;
      } elsif ($ARGV[$i] eq 'touchexpiredlist') {
        $action = 4;
      } else {
        print("Error: Invalid action selected.\n");
        exit(1);
      }
    }
  } elsif ($curarg eq '--rrs') {
    $i++;
    if ($i >= @ARGV) {
      print("Error: --rrs requires a parameter\n");
      exit(1);
    } else {
      $rrs = $ARGV[$i];
    }
  } elsif ($curarg eq '--minage') {
    $i++;
    if ($i >= @ARGV) {
      print("Error: --minage requires a parameter\n");
      exit(1);
    } else {
      if ($ARGV[$i] =~ m/^(\d+)$/) {
        $minage = $1;
      } else {
        print("Error: --minage requires an positive integer as parameter.\n");
      }
    }
  } elsif ($curarg eq '--rmemptydirs') {
    $rmemptydirs = 1;
  } else {
    if ($fspath eq '') {
      $fspath = $curarg;
    } else {
      print("Too many parameters, or parameter(s) not understood.\n");
      print("I can only handle one directory parameter, but I consider both ");
      print("'$curarg' and '$fspath' a pathname since they are not a known parameter.\n");
      exit(1);
    }
  }
}
if ($fspath eq '') {
  print("ERROR: No path to clear given.\n");
  exit(1);
}
if (($action == 3) || ($action == 4)) { # This significantly differs from the rest of our operations
  dohandleexpiredlist();
  exit(0);
}
@allentries = ();
$totalfilesseen = 0;
runrecursive($fspath, 0);
@allentries = sort(sortbydateasc @allentries);
print(int(@allentries)." files seen\n");
$filesdone = 0;
foreach $ent (@allentries) {
  if ($filelimit > 0) {
    if ($filesdone >= $filelimit) {
      print("File limit $filelimit reached, exiting.\n");
      exit(0);
    }
  }
  #print("Handling File '$ent->[0]', $ent->[5] blocks [u: $ent->[3]  g: $ent->[4] mtime: ".strftime("%Y-%m-%d.%H:%M:%S", localtime($ent->[1]))."]\n");
  if ($action == 0) { # Print
    print("$ent->[0]\n");
  } elsif ($action == 1) { # Delete
    print("DELETING $ent->[0] (mtime " . strftime("%Y-%m-%d.%H:%M:%S", localtime($ent->[1])) . ")\n");
    unless (unlink($ent->[0])) {
      print("ERROR: rm for $ent->[0] failed!\n");
    }
  } elsif ($action == 2) { # Rerender
    rerenderfile($ent->[0]);
  }
  $filesdone++;
}
Commit	Line	Data
4b713169	1	#!/usr/bin/perl -w
	2
	3	# OSM tile cleanup / maintenance script. Big parts are a copied from
	4	# hochwasserloeschung.pl.
	5
	6	use Fcntl ':mode';
	7	use POSIX 'strftime';
	8
	9	$zoommin = 0;
	10	$zoommax = 20;
	11	$filelimit = -1;
	12	$rmemptydirs = 0;
	13	$action = 0;
	14	$rrs = '/bin/echo';
	15	$minage = 0; # In hours!
9dd14599	16	$setbackinterval = 7305 * 86400; # 20 years (including leap years)
4b713169	17
	18	# Sort function for candidate list
	19	sub sortbydateasc {
	20	#print("$a->[1] $b->[1]\n");
	21	return ($a->[1] <=> $b->[1]);
	22	}
	23
	24	# Remembers a candidate for deletion, if required sorting and purging out the
	25	# list.
	26	# Parameters: 0 filename
	27	# 1 atime
	28	# 2 mtime
	29	# 3 type field from stat (containing DIR, LINK etc.)
	30	# 4 uid
	31	# 5 gid
	32	# 6 size in bytes
	33	sub remembercandidate($$$$$$$) {
	34	if (($_[4] == 0) \|\| ($_[5] == 0)) {
	35	# we do not touch roots files or directories.
	36	return;
	37	}
	38	if ($_[2] > (time() - ($minage * 3600))) {
	39	#print("not adding $_[0], too new\n");
	40	return;
	41	}
	42	$totalfilesseen++;
	43	push(@allentries, [ $_[0], $_[2], $_[3], $_[4], $_[5], $_[6] ]);
	44	}
	45
	46	# Par. 0: Path were we start
	47	# Par. 1: Recursion counter
	48	# Returns: Number of files/dirs found (non-recursively!)
	49	sub runrecursive($$);
	50	sub runrecursive($$) {
	51	my $DIR;
	52	my $pth = $_[0];
	53	my $curdirentry;
	54	my @statres;
	55	my $recctr = $_[1];
	56	my $direntries = 0;
	57	unless (opendir($DIR, $pth)) {
	58	print("ERROR: Failed to open dir $pth\n");
	59	exit(1);
	60	}
	61	while ($curdirentrys = readdir($DIR)) {
	62	if (($curdirentrys eq '.') \|\| ($curdirentrys eq '..')) {
	63	next;
	64	}
	65	$direntries++;
	66	$curdirentryf = $pth.'/'.$curdirentrys;
	67	@statres = lstat($curdirentryf);
	68	unless (@statres > 12) {
	69	# This usually happens if we have a symlink to a file for which we have
	70	# no permission to read.
	71	#print("stat failed for $curdirentry\n");
	72	next;
	73	}
	74	if (S_ISLNK($statres[2])) { next; } # A symlink? We no like.
	75	if ($recctr <= 4) { # There should be no files on these levels
	76	unless (S_ISDIR($statres[2])) { next; }
	77	unless ($curdirentrys =~ m/^\d+$/) { next; }
	78	} else { # whereas there should be only files called .meta on level 5.
	79	unless (S_ISREG($statres[2])) { next; }
	80	unless ($curdirentrys =~ m/^\d+\.meta$/) { next; }
81	}
82	if ($recctr == 0) {
83	my $z = int($curdirentrys);
84	unless (($z >= $zoommin) && ($z <= $zoommax)) { next; }
85	runrecursive($curdirentryf, $recctr+1);
86	} elsif ($recctr <= 4) {
87	if (runrecursive($curdirentryf, $recctr+1) == 0) { # Empty dir!
88	if ($rmemptydirs) {
89	print("RMDIR: $curdirentryf\n");
90	rmdir($curdirentryf);
91	}
92	}
93	} else {
94	remembercandidate($curdirentryf, $statres[8], $statres[9], $statres[2], $statres[4], $statres[5], $statres[12]);
95	}
96	}
97	closedir($DIR);
98	return $direntries;
99	}
100
101	# Par. 0: Full path of file
102	sub rerenderfile($) {
103	my $fpth = $_[0];
104	# We first need to figure out the relevant numbers from the full file path
105	unless ($fpth =~ m!/(\d+)/(\d+)/(\d+)/(\d+)/(\d+)/(\d+)\.meta$!) {
106	print("WARNING: rerenderfile: Failed to extract path components for rerendering out of '$fpth' - skipping\n");
107	return;
108	}
109	my $zl = $1; my @p = ( $2, $3, $4, $5, $6 );
110	my $calcx = 0; my $calcy = 0;
111	my $i;
112	for ($i = 0; $i < 5; $i++) {
113	$calcx = ($calcx << 4) \| (($p[$i] & 0xf0) >> 4);
114	$calcy = ($calcy << 4) \| (($p[$i] & 0x0f) >> 0);
115	}
116	# struct meta_layout {
117	# char magic[4]; // 'M' 'E' 'T' 'A'
118	# int count; // METATILE ^ 2
119	# int x, y, z; // lowest x,y of this metatile, plus z
120	my $fi;
121	unless (open($fi, '<', $fpth)) {
122	print("WARNING: rerenderfile: Failed to open file '$fpth' - skipping\n");
123	return;
124	}
125	binmode($fi);
126	my $dbuf;
127	unless (read($fi, $dbuf, 20)) {
128	print("WARNING: rerenderfile: Failed to read info from metatile '$fpth' - skipping\n");
129	return;
130	}
131	close($fi); undef($fi);
132	unless (substr($dbuf, 0, 4) eq 'META') {
133	print("WARNING: rerenderfile: file '$fpth' is not a metatile - skipping\n");
134	return;
135	}
136	unless (ord(substr($dbuf, 4, 1)) == 64) {
137	print("WARNING: rerenderfile: file '$fpth' is not a 8x8 metatile - skipping\n");
138	return;
139	}
140	my $fx = (ord(substr($dbuf, 8, 1)) << 0) \| (ord(substr($dbuf, 9, 1)) << 8)
141	\| (ord(substr($dbuf, 10, 1)) << 16) \| (ord(substr($dbuf, 11, 1)) << 24);
142	unless ($fx == $calcx) {
143	print("WARNING: rerenderfile: file '$fpth' is invalid - xsize $fx != $calcx - skipping\n");
144	return;
145	}
146	my $fy = (ord(substr($dbuf, 12, 1)) << 0) \| (ord(substr($dbuf, 13, 1)) << 8)
147	\| (ord(substr($dbuf, 14, 1)) << 16) \| (ord(substr($dbuf, 15, 1)) << 24);
148	unless ($fy == $calcy) {
149	print("WARNING: rerenderfile: file '$fpth' is invalid - xsize $fy != $calcy - skipping\n");
150	return;
151	}
152	my $fz = (ord(substr($dbuf, 16, 1)) << 0) \| (ord(substr($dbuf, 17, 1)) << 8)
153	\| (ord(substr($dbuf, 18, 1)) << 16) \| (ord(substr($dbuf, 19, 1)) << 24);
154	unless ($fz == $zl) {
155	print("WARNING: rerenderfile: file '$fpth' is invalid - zsize $fz != $zl - skipping\n");
156	return;
157	}
158	print("Sending rendering request for z=$zl x=$calcx y=$calcy to regenerate '$fpth'\n");
159	if (system("$rrs $zl $calcx $calcy")) {
160	print("Error executing $rrs $zl $calcx $calcy\n");
161	}
162	}
163
164	# Par. 0: x
165	# Par. 1: y
166	sub calcpathfromcomponents($$) {
167	my @res = ();
168	my $i; my $x = $_[0]; my $y = $_[1];
169	for ($i = 4; $i >= 0; $i--) {
170	$res[$i] = sprintf("%d", (($x & 0x0f) << 4) + ($y & 0x0f));
171	$x = $x >> 4;
172	$y = $y >> 4;
173	}
174	return $res[0] . "/" . $res[1] . "/" . $res[2] . "/" . $res[3] . "/" . $res[4];
175	}
176
9dd14599	177	sub dohandleexpiredlist() {
4b713169	178	my $ll;
	179	%rerenderlist = ();
	180	while ($ll = <STDIN>) {
	181	if ($ll =~ m!^(\d+)/(\d+)/(\d+)$!) {
	182	my $x = $2; my $y = $3; my $z = $1;
	183	#print("Handling z=$z x=$x y=$y\n");
	184	if ($z != ($zoommax - 3)) {
	185	print("Ignoring z=$z x=$x y=$y because of wrong zoom\n");
	186	next;
	187	}
	188	my $cz; my $cx; my $cy; my $curz;
	189	for ($curz = $zoommin; $curz <= $zoommax; $curz++) {
	190	$cz = $z; $cx = $x; $cy = $y;
	191	while ($cz < $curz) {
	192	$cz++; $cx <<= 1; $cy <<= 1;
	193	}
	194	while ($cz > $curz) {
	195	$cz--; $cx >>= 1; $cy >>= 1;
	196	}
	197	#print("Matching tile at z=$cz: x=$cx y=$cy -");
	198	$cx = $cx & 0xfff8; $cy = $cy & 0xfff8;
	199	#print(" rounded to x=$cx y=$cy\n");
	200	$rerenderlist{$cz}{$cx}{$cy} = 1;
	201	}
	202	}
	203	}
	204	$filesdone = 0; $filesseen = 0;
	205	foreach $z (sort(keys(%rerenderlist))) {
	206	foreach $x (sort(keys(%{$rerenderlist{$z}}))) {
	207	foreach $y (sort(keys(%{$rerenderlist{$z}{$x}}))) {
	208	my $p = ${fspath} . '/' . $z . '/' . calcpathfromcomponents($x, $y) . '.meta';
	209	#print("Checking: $z $x $y - Path: $p\n");
	210	$filesseen++;
	211	if (-e $p) {
9dd14599 MM	212	if ($action == 3) {
	213	$filesdone++;
	214	print("Sending rendering request for z=$z x=$x y=$y to regenerate '$p'\n");
	215	if (system("$rrs $z $x $y")) {
	216	print("Error executing $rrs $z $x $y\n");
	217	}
	218	} elsif ($action == 4) {
	219	my $mtime = (stat($p))[9];
	220	my $curtime = time();
	221	if (($curtime - $setbackinterval) > $mtime) {
	222	# Do not touch again - it's already 20 years back.
	223	print("Not touching '$p', it's over 20 years old so probably has already been set back.\n");
	224	} else {
	225	my $newmtime = $mtime - $setbackinterval;
	226	print("Touching '$p' (z=$z x=$x y=$y)\n");
	227	if (utime($curtime, $newmtime, $p) < 1) {
	228	print("Error touching '$p': $!\n");
	229	}
	230	}
	231	} else {
	232	print("Internal error - action variable invalid. This is a programming error.\n");
	233	exit(1);
4b713169	234	}
	235	}
	236	}
	237	}
	238	}
9dd14599 MM	239	if ($action == 3) {
	240	print("Sent re-rendering-requests for $filesdone files that actually existed (of $filesseen candidates)\n");
	241	} elsif ($action == 4) {
	242	print("Touched $filesdone files (of $filesseen candidates)\n");
	243	}
4b713169	244	}
	245
	246	$fspath = '';
	247	for ($i = 0; $i < @ARGV; $i++) {
	248	$curarg = $ARGV[$i];
	249	if ($curarg eq '--help') {
9dd14599 MM	250	print("Syntax: $0 [--help] [--zoom z] [--limit n] [--action a] [--rmemptydirs]\n");
9dd14599 MM	251	print(" [--rrs path] [--minage hrs] directory\n");
4b713169	252	print(" --zoom z[-z2]: Zoom level(s) to handle (default: 0-20).\n");
	253	print(" --limit n: Limit to the n oldest files (default: no limit)\n");
	254	print(" --action what: what action to perform with the found files.\n");
9dd14599 MM	255	print(" valid actions are: print delete rerender rerenderexpiredlist\n");
	256	print(" touchexpiredlist (default: print)\n");
	257	print(" rerenderexpiredlist and touchexpiredlist: these are very different from the\n");
	258	print(" other commands, as they expect to read a list of expired tiles to rerender\n");
	259	print(" or touch on STDIN. The list has to be in the format that osm2pgsql spits\n");
	260	print(" out. touchexpiredlist sets the mtime of the tiles back 20 years.\n");
4b713169	261	print(" --rmemptydirs: remove empty subdirectories\n");
	262	print(" --rrs path: if action is rerender, this gives the path to the rerender script.\n");
	263	print(" it gets called with three parameters: z x y\n");
	264	print(" --minage hrs: only care about files that are at least hrs hours old\n");
	265	exit(1);
	266	} elsif ($curarg eq '--zoom') {
	267	$i++;
	268	if ($i >= @ARGV) {
	269	print("Error: --zoom requires a parameter\n");
	270	exit(1);
	271	} else {
	272	if ($ARGV[$i] =~ m/^(\d+)-(\d+)$/) {
	273	$zoommin = $1; $zoommax = $2;
	274	} elsif ($ARGV[$i] =~ m/^(\d+)$/) {
	275	$zoommin = $1; $zoommax = $1;
	276	} else {
	277	print("Error: --zoom needs a single numeric parameter or a range (e.g. 4 or 10-12)\n");
	278	exit(1);
	279	}
	280	}
	281	} elsif ($curarg eq '--limit') {
	282	$i++;
	283	if ($i >= @ARGV) {
	284	print("Error: --limit requires a parameter\n");
	285	exit(1);
	286	} else {
	287	if ($ARGV[$i] =~ m/^(\d+)$/) {
	288	$filelimit = $1;
	289	} else {
	290	print("Error: --limit requires an positive integer as parameter.\n");
	291	}
	292	}
	293	} elsif ($curarg eq '--action') {
	294	$i++;
	295	if ($i >= @ARGV) {
	296	print("Error: --action requires a parameter\n");
	297	exit(1);
	298	} else {
	299	if ($ARGV[$i] eq 'print') {
	300	$action = 0;
	301	} elsif ($ARGV[$i] eq 'delete') {
	302	$action = 1;
	303	} elsif ($ARGV[$i] eq 'rerender') {
	304	$action = 2;
	305	} elsif ($ARGV[$i] eq 'rerenderexpiredlist') {
	306	$action = 3;
9dd14599 MM	307	} elsif ($ARGV[$i] eq 'touchexpiredlist') {
9dd14599 MM	308	$action = 4;
4b713169	309	} else {
	310	print("Error: Invalid action selected.\n");
	311	exit(1);
	312	}
	313	}
	314	} elsif ($curarg eq '--rrs') {
	315	$i++;
	316	if ($i >= @ARGV) {
	317	print("Error: --rrs requires a parameter\n");
	318	exit(1);
	319	} else {
	320	$rrs = $ARGV[$i];
	321	}
	322	} elsif ($curarg eq '--minage') {
	323	$i++;
	324	if ($i >= @ARGV) {
	325	print("Error: --minage requires a parameter\n");
	326	exit(1);
	327	} else {
	328	if ($ARGV[$i] =~ m/^(\d+)$/) {
	329	$minage = $1;
	330	} else {
	331	print("Error: --minage requires an positive integer as parameter.\n");
	332	}
	333	}
	334	} elsif ($curarg eq '--rmemptydirs') {
	335	$rmemptydirs = 1;
	336	} else {
	337	if ($fspath eq '') {
	338	$fspath = $curarg;
	339	} else {
	340	print("Too many parameters, or parameter(s) not understood.\n");
	341	print("I can only handle one directory parameter, but I consider both ");
	342	print("'$curarg' and '$fspath' a pathname since they are not a known parameter.\n");
	343	exit(1);
	344	}
	345	}
	346	}
	347	if ($fspath eq '') {
	348	print("ERROR: No path to clear given.\n");
	349	exit(1);
	350	}
9dd14599 MM	351	if (($action == 3) \|\| ($action == 4)) { # This significantly differs from the rest of our operations
9dd14599 MM	352	dohandleexpiredlist();
4b713169	353	exit(0);
	354	}
	355	@allentries = ();
	356	$totalfilesseen = 0;
	357	runrecursive($fspath, 0);
	358	@allentries = sort(sortbydateasc @allentries);
	359	print(int(@allentries)." files seen\n");
	360	$filesdone = 0;
	361	foreach $ent (@allentries) {
	362	if ($filelimit > 0) {
	363	if ($filesdone >= $filelimit) {
	364	print("File limit $filelimit reached, exiting.\n");
	365	exit(0);
	366	}
	367	}
	368	#print("Handling File '$ent->[0]', $ent->[5] blocks [u: $ent->[3] g: $ent->[4] mtime: ".strftime("%Y-%m-%d.%H:%M:%S", localtime($ent->[1]))."]\n");
	369	if ($action == 0) { # Print
	370	print("$ent->[0]\n");
	371	} elsif ($action == 1) { # Delete
	372	print("DELETING $ent->[0] (mtime " . strftime("%Y-%m-%d.%H:%M:%S", localtime($ent->[1])) . ")\n");
	373	unless (unlink($ent->[0])) {
	374	print("ERROR: rm for $ent->[0] failed!\n");
	375	}
	376	} elsif ($action == 2) { # Rerender
	377	rerenderfile($ent->[0]);
	378	}
	379	$filesdone++;
	380	}