Code Coverage |
||||||||||
Lines |
Functions and Methods |
Classes and Traits |
||||||||
| Total | |
0.00% |
0 / 56 |
|
0.00% |
0 / 2 |
CRAP | |
0.00% |
0 / 1 |
| FixTimestamps | |
0.00% |
0 / 56 |
|
0.00% |
0 / 2 |
132 | |
0.00% |
0 / 1 |
| __construct | |
0.00% |
0 / 5 |
|
0.00% |
0 / 1 |
2 | |||
| execute | |
0.00% |
0 / 51 |
|
0.00% |
0 / 1 |
110 | |||
| 1 | <?php |
| 2 | /** |
| 3 | * Fixes timestamp corruption caused by one or more webservers temporarily |
| 4 | * being set to the wrong time. |
| 5 | * The time offset must be known and consistent. Start and end times |
| 6 | * (in 14-character format) restrict the search, and must bracket the damage. |
| 7 | * There must be a majority of good timestamps in the search period. |
| 8 | * |
| 9 | * This program is free software; you can redistribute it and/or modify |
| 10 | * it under the terms of the GNU General Public License as published by |
| 11 | * the Free Software Foundation; either version 2 of the License, or |
| 12 | * (at your option) any later version. |
| 13 | * |
| 14 | * This program is distributed in the hope that it will be useful, |
| 15 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 16 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 17 | * GNU General Public License for more details. |
| 18 | * |
| 19 | * You should have received a copy of the GNU General Public License along |
| 20 | * with this program; if not, write to the Free Software Foundation, Inc., |
| 21 | * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. |
| 22 | * http://www.gnu.org/copyleft/gpl.html |
| 23 | * |
| 24 | * @file |
| 25 | * @ingroup Maintenance |
| 26 | */ |
| 27 | |
| 28 | // @codeCoverageIgnoreStart |
| 29 | require_once __DIR__ . '/Maintenance.php'; |
| 30 | // @codeCoverageIgnoreEnd |
| 31 | |
| 32 | /** |
| 33 | * Maintenance script that fixes timestamp corruption caused by one or |
| 34 | * more webservers temporarily being set to the wrong time. |
| 35 | * |
| 36 | * @ingroup Maintenance |
| 37 | */ |
| 38 | class FixTimestamps extends Maintenance { |
| 39 | public function __construct() { |
| 40 | parent::__construct(); |
| 41 | $this->addDescription( '' ); |
| 42 | $this->addArg( 'offset', '' ); |
| 43 | $this->addArg( 'start', 'Starting timestamp' ); |
| 44 | $this->addArg( 'end', 'Ending timestamp' ); |
| 45 | } |
| 46 | |
| 47 | public function execute() { |
| 48 | $offset = $this->getArg( 0 ) * 3600; |
| 49 | $start = $this->getArg( 1 ); |
| 50 | $end = $this->getArg( 2 ); |
| 51 | // maximum normal clock offset |
| 52 | $grace = 60; |
| 53 | |
| 54 | # Find bounding revision IDs |
| 55 | $dbw = $this->getPrimaryDB(); |
| 56 | $revisionTable = $dbw->tableName( 'revision' ); |
| 57 | $res = $dbw->query( "SELECT MIN(rev_id) as minrev, MAX(rev_id) as maxrev FROM $revisionTable " . |
| 58 | "WHERE rev_timestamp BETWEEN '{$start}' AND '{$end}'", __METHOD__ ); |
| 59 | $row = $res->fetchObject(); |
| 60 | |
| 61 | if ( $row->minrev === null ) { |
| 62 | $this->fatalError( "No revisions in search period." ); |
| 63 | } |
| 64 | |
| 65 | $minRev = $row->minrev; |
| 66 | $maxRev = $row->maxrev; |
| 67 | |
| 68 | # Select all timestamps and IDs |
| 69 | $sql = "SELECT rev_id, rev_timestamp FROM $revisionTable " . |
| 70 | "WHERE rev_id BETWEEN $minRev AND $maxRev"; |
| 71 | if ( $offset > 0 ) { |
| 72 | $sql .= " ORDER BY rev_id DESC"; |
| 73 | $expectedSign = -1; |
| 74 | } else { |
| 75 | $expectedSign = 1; |
| 76 | } |
| 77 | |
| 78 | $res = $dbw->query( $sql, __METHOD__ ); |
| 79 | |
| 80 | $lastNormal = 0; |
| 81 | $badRevs = []; |
| 82 | $numGoodRevs = 0; |
| 83 | |
| 84 | foreach ( $res as $row ) { |
| 85 | $timestamp = (int)wfTimestamp( TS_UNIX, $row->rev_timestamp ); |
| 86 | $delta = $timestamp - $lastNormal; |
| 87 | $sign = $delta == 0 ? 0 : $delta / abs( $delta ); |
| 88 | if ( $sign == 0 || $sign == $expectedSign ) { |
| 89 | // Monotonic change |
| 90 | $lastNormal = $timestamp; |
| 91 | ++$numGoodRevs; |
| 92 | } elseif ( abs( $delta ) <= $grace ) { |
| 93 | // Non-monotonic change within grace interval |
| 94 | ++$numGoodRevs; |
| 95 | } else { |
| 96 | // Non-monotonic change larger than grace interval |
| 97 | $badRevs[] = $row->rev_id; |
| 98 | } |
| 99 | } |
| 100 | |
| 101 | $numBadRevs = count( $badRevs ); |
| 102 | if ( $numBadRevs > $numGoodRevs ) { |
| 103 | $this->fatalError( |
| 104 | "The majority of revisions in the search interval are marked as bad. |
| 105 | |
| 106 | Are you sure the offset ($offset) has the right sign? Positive means the clock |
| 107 | was incorrectly set forward, negative means the clock was incorrectly set back. |
| 108 | |
| 109 | If the offset is right, then increase the search interval until there are enough |
| 110 | good revisions to provide a majority reference." ); |
| 111 | } elseif ( $numBadRevs == 0 ) { |
| 112 | $this->output( "No bad revisions found.\n" ); |
| 113 | return; |
| 114 | } |
| 115 | |
| 116 | $this->output( sprintf( "Fixing %d revisions (%.2f%% of revisions in search interval)\n", |
| 117 | $numBadRevs, $numBadRevs / ( $numGoodRevs + $numBadRevs ) * 100 ) ); |
| 118 | |
| 119 | $fixup = -$offset; |
| 120 | $sql = "UPDATE $revisionTable " . |
| 121 | "SET rev_timestamp=" |
| 122 | . "DATE_FORMAT(DATE_ADD(rev_timestamp, INTERVAL $fixup SECOND), '%Y%m%d%H%i%s') " . |
| 123 | "WHERE rev_id IN (" . $dbw->makeList( $badRevs ) . ')'; |
| 124 | $dbw->query( $sql, __METHOD__ ); |
| 125 | $this->output( "Done\n" ); |
| 126 | } |
| 127 | } |
| 128 | |
| 129 | // @codeCoverageIgnoreStart |
| 130 | $maintClass = FixTimestamps::class; |
| 131 | require_once RUN_MAINTENANCE_IF_MAIN; |
| 132 | // @codeCoverageIgnoreEnd |