Manual Pages


Table of Contents

NAME

na_treecompare - Log of treecompare activities

SYNOPSIS

/etc/log/treecompare

DESCRIPTION

The treecompare log file contains a log of treecompare activities for this node. The file lives in /etc/log on the root volume.

Every Sunday at midnight, /etc/log/treecompare is moved to /etc/log/treecompare.0; /etc/log/treecompare.0 is moved to /etc/log/treecompare.1; and so on. The suffix can go up to 5, so the old /etc/log/treecompare.5 will be deleted. Treecompare activities are saved for a total of seven weeks.

Each entry of the /etc/log/treecompare file is a single line containing the following space-separated fields.

  timestamp tree1 tree2 event_info

The following is a description of each field.

timestamp
Displayed in ctime() format, e.g. Fri Jul 17 20:41:09 GMT. Indicates the time this event was recorded.

tree1 The name of the host1 and the full path for tree1 as shown below:

  host1:tree1_path

tree2 The name of the host2 and the full path for tree2 as shown below:

  host2:tree2_path

event_info
The event which is being logged. Some events may have extra information in parentheses. The existing event types are:

Start (cmp_level={data|checksum}, {compare|ignore} NT ACL)
The beginning of a treecompare session. The command options are included in the parentheses.

End (tree1_only=num_1, tree2_only=num_2, mismatch=num_3)
The completion of a treecompare session. The summary of the session is included in the parentheses.

Abort (error_msg)
A treecompare operation was aborted. The error message is included in the parentheses.

Data_differ (block blk_num in file_name) Found a data block mismatch. The block number and the file name are included in the parentheses.

Unique_in_tree1 (entry_type for entry_path) Found an entry only present in the first tree. The entry type and entry path are included in the parentheses.

Unique_in_tree2 (entry_type for entry_path) Found an entry only present in the second tree. The entry type and entry path are included in the parentheses.

Size_differ (file_name)
Found a file size mismatch. The file name is included in the parentheses.

Type_differ (entry_name)
Found a directory entry type mismatch. The entry name is included in the parentheses.

UID_differ (entry_name)
Found a user ID mismatch for a directory entry. The entry name is included in the parentheses.

GID_differ (entry_name)
Found a group ID mismatch for a directory entry. The entry name is included in the parentheses.

Perm_differ (entry_name)
Found a permission mismatch for a directory entry. The entry name is included in the parentheses.

Atime_differ (entry_name)
Found a mismatch in the last access time for a directory entry. The entry name is included in the parentheses.

Mtime_differ (entry_name)
Found a mismatch in the last modification time for a directory entry. The entry name is included in the parentheses.

Ctime_differ (entry_name)
Found a mismatch in the last size/status change time for a directory entry. The entry name is included in the parentheses.

Crtime_differ (entry_name)
Found a mismatch in the creation time for a directory entry. The entry name is included in the parentheses.

Rdev_differ (entry_name)
Found a device number mismatch for a directory entry. The entry name is included in the parentheses.

DOSbits_differ (entry_name)
Found a DOS bits mismatch for a directory entry. The entry name is included in the parentheses.

ACL_differ (entry_name)
Found an NT ACL mismatch for a directory entry. The entry name is included in the parentheses.

Hardlink_differ (entry_name)
Found a hardlink for a directory entry, but the inode on tree2 doesn't match between the links. The entry name is included in the parentheses.

Skip (attr_type for entry_name)
Skipped the comparison of an unsupported attribute type for a directory entry. The attribute type and the entry name are included in the parentheses.

Inode_Num_differ (entry_name)
Found an inode number mismatch for a directory entry. The entry name is included in the parentheses.

Inode_Gen_differ (entry_name)
Found an inode generation number mismatch for a directory entry. The entry name is included in the parentheses.

Inode_Tid_differ (entry_name)
Found an inode tree id mismatch for a directory entry. The entry name is included in the parentheses.

CIFS_reserve_differ (entry_name)
Found a cifs space reservation mismatch for a directory entry. The entry name is included in the parentheses.

HOLES_reserve_differ (entry_name)
Found a holes space reservation mismatch for a directory entry. The entry name is included in the parentheses.

BLOCK_reserve_differ (entry_name)
Found a block space reservation mismatch for a directory entry. The entry name is included in the parentheses.

QT_oplock_differ (entry_name)
Found oplock setting mismatch for a qtree. The entry name is included in the parentheses.

QT_security_differ (entry_name)
Found security setting mismatch for a qtree. The entry name is included in the parentheses.

QT_reserve_differ (entry_name)
Found space reservation setting mismatch for a qtree. The entry name is included in the parentheses.

EXAMPLE

A typical treecompare session in /etc/log/treecompare looks like:
  Tue Jun 24 00:05:20 GMT fridge:/vol/src1/.snapshot/snap1/qt1 toaster:/vol/
  dst4/.snapshot/snap1/qt1 Start (cmp_level = data, compare NT ACL)
  Tue Jun 24 00:05:44 GMT fridge:/vol/src1/.snapshot/snap1/qt1 toaster:/vol/
  dst4/.snapshot/snap1/qt1 End (tree1_only = 0, tree2_only = 0, mismatch = 0)

This example shows a treecompare session which used comparison level data and did compare NT ACLs. At the end of the session, the summary shows no mismatches were found.

The next example shows a log with several mismatches.

  Tue Jun 24 00:07:31 GMT fridge:/vol/src1/.snapshot/snap2/qt1 toaster:/vol/
  dst4/.snapshot/snap1/qt1 Start (cmp_level = checksum, ignore NT ACL)
  Tue Jun 24 00:07:32 GMT fridge:/vol/src1/.snapshot/snap2/qt1 toaster:/vol/
  dst4/.snapshot/snap1/qt1 Atime_differ (.)
  Tue Jun 24 00:07:32 GMT fridge:/vol/src1/.snapshot/snap2/qt1 toaster:/vol/
  dst4/.snapshot/snap1/qt1 Atime_differ (./subd1)
  Tue Jun 24 00:07:42 GMT fridge:/vol/src1/.snapshot/snap2/qt1 toaster:/vol/
  dst4/.snapshot/snap1/qt1 Atime_differ (./subd1/dfile2)
  Tue Jun 24 00:07:42 GMT fridge:/vol/src1/.snapshot/snap2/qt1 toaster:/vol/
  dst4/.snapshot/snap1/qt1 Mtime_differ (./subd1/dfile2)
  Tue Jun 24 00:07:42 GMT fridge:/vol/src1/.snapshot/snap2/qt1 toaster:/vol/
  dst4/.snapshot/snap1/qt1 Size_differ (./subd1/dfile2)
  Tue Jun 24 00:07:42 GMT fridge:/vol/src1/.snapshot/snap2/qt1 toaster:/vol/
  dst4/.snapshot/snap1/qt1 Data_differ (block 0 in ./subd1/dfile2)
  Tue Jun 24 00:07:51 GMT fridge:/vol/src1/.snapshot/snap2/qt1 toaster:/vol/
  dst4/.snapshot/snap1/qt1 Data_differ (block 1000 in ./subd1/dfile2)
  Tue Jun 24 00:07:52 GMT fridge:/vol/src1/.snapshot/snap2/qt1 toaster:/vol/
  dst4/.snapshot/snap1/qt1 End (tree1_only = 0, tree2_only = 0, mismatch = 7)

FILES

/etc/log/treecompare
Treecompare log file for current week.

/etc/log/treecompare.[0-5] Treecompare log files for previous weeks.

SEE ALSO




Table of Contents