ccclog - Summarizes log entries kept by Carbon Copy Cloner
ccclog [options] <volumes>
Carbon Copy Cloner (CCC) is an excellent backup/restore application for Mac OS X. It keeps a complete log of its actions, which is available for viewing with the Console.app. Each log entry contains a large amount of information: timestamp of backup, source volume, destination location, size and type of volumes, hardware information, etc. With all this information, it can take a fair amount of digging in order to find the basic information of what was backed up when.
ccclog is a command-line tool that summarizes log entries from the CCC log file. The summarized entries are condensed down to the timestamp of backup, the source volume, and the destination location. Options allow for selection of specific source volumes, specific destinations, and the most recent backups.
There is a little output processing that takes place if -verbose is not given. A destination that starts with ``/Volumes/'' will have that prefix removed, unless it is a disk image. Trailing slashes in destinations will be always removed. This output massaging is intended to convey additional information in a small space, shrink the length of output lines, and assist with scripting. If it is found to be more unhelpful than it is helpful, it may be removed in a future version.
This is an example execution of ccclog -last:
2010-05-14 19:09:01 root-10.5 extdisk-leopard
2010-05-14 18:15:43 root-10.6 extdisk-snowleopard
2010-05-14 21:01:23 root-10.6 /Volumes/dumps/100514-snow.dmg
This is an example execution of ccclog -last -verbose:
2010-05-14 19:09:01 root-10.5 /Volumes/extdisk-leopard
2010-05-14 18:15:43 root-10.6 /Volumes/extdisk-snowleopard
2010-05-14 21:01:23 root-10.6 /Volumes/dumps/100514-snow.dmg
Normally, ccclog will use hard-coded values for output field widths. These values are likely to be valid for many situations. At a slight overhead cost, maximum field lengths can be calculated and actual lengths can be used. The -calc option can turn on maximum-field-length calculations on a per-run basis. Setting the $calclen field to a non-zero value will do this on a permanent basis. The hard-coded values may also be adjusted as needed.
Carbon Copy Cloner is available from http://www.bombich.com.
For some of the output processing, ccclog makes the following assumptions:
The following options are handled by ccclog:
Calculate the maximum field widths for the output, rather than using the hard-coded values.
Just print the full contents of the log file as stored on disk. This is essentially a command-line version of selecting the Carbon Copy Cloner log from within the Console.app.
Only displays records for the destinations which are not .dmg files (disk images.)
This option is obsolete. This is the default functionality for the current version of ccclog.
Only displays records for the destinations which are .dmg files (disk images.)
This option is obsolete. It does not with the current version of ccclog.
Displays records for the specified destination volume. The specified destination is a regular expression, and not necessarily a fixed string.
Displays records for the specified source volume. The specified source is a fixed string and not a regular expression.
Displays the last record for each source volume. If the -src or -dest option was given, then the last record for the specified source and/or destination volume will be given. The records are sorted by source volume.
Each data column will have a descriptive header.
Verbose output will be given.
The command version will be printed and ccclog will exit.
Displays a usage message.
/Library/Logs/CCC.log Carbon Copy Cloner's log file
Copyright 2010 Wayne Morrison
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Wayne Morrison, wayne@waynemorrison.com