NAME

ftimes-cmp2diff - Display diff-like results of an FTimes comparison

SYNOPSIS

ftimes-cmp2diff [-c {compare|-}] [-e {field|name:expr}[,{field|name:expr}[,...]]] [-f format] [-g group-file] [-H ftimes-home] [-m mask] [-o option[,option[,...]]] [-p password-file] -b baseline -s snapshot

DESCRIPTION

This utility takes baseline and snapshot map files as input, compares them using a specified or derived field mask, and displays the results in a diff-like format. This allows the user to see the details about what fields changed and how.

OPTIONS

-b baseline

Specifies the name of an FTimes baseline map file.

-c {compare|-}

Specifies the name of an FTimes compare file produced by comparing the snapshot to the baseline. A value of '-' will cause the program to read from stdin.

-e {field|name:expr}[,{field|name:expr}[,...]]

Specifies a list of map fields to exclude. Differences for any field in this list except the name field will be ignored. For the name field, the accompanying Perl regular expression governs whether or not a given record will be ignored/discarded. Any record with name value that matches one of the supplied name expressions will be discarded. Note that commas (i.e., ',') in expressions must be encoded as '\x2c' to prevent them from being interpolated as a field list delimiter.

-f format

Specifies the type of diff format to display. The format can be one of {f|field} or {s|short}. The default value is 'short'.

-g group-file

Specifies the name of a group file, in the traditional UNIX format, to use for decoding GIDs.

-H ftimes-home

Specifies the location of FTimes components on the client system. The default value is 'C:\Program Files\FTimes' and '/usr/local/ftimes' for WINX and UNIX platforms, respectively.

-m mask

Specifies the field mask to use when generating output.

-o option,[option[,...]]

Specifies the list of options to apply. Currently, the following options are supported:

BeQuiet

Don't report warnings (i.e., be quiet) while processing files/data.

ForceBuild

Force the decoding of map files and creation of offsets files even if they already exist.

ForceClean

Remove decoded map and offsets files upon program completion.

GidDecode

Converts the gid field into the name assigned to the corresponding group. Note that a value of '?' indicates that the decode operation failed.

ModeDecode

Converts the mode field into a standard UNIX representation (e.g., '-rwxr-xr-x').

NoDecode

Do not decode the map files (i.e., assume that the baseline and snapshot are already decoded).

Note: If you enable this option and fail to specify decoded map files, don't expect valid results.

UidDecode

Converts the uid field into the name assigned to the corresponding user. Note that a value of '?' indicates that the decode operation failed.

UseBigIntegers

Activate and use the Math::BigInt module for handling offset conversions. Generally, this option should only be used for backwards compatibility on 32-bit platforms. Enabling this option will impact performance, so use it only when necessary.

-p password-file

Specifies the name of a password file, in the traditional UNIX format, to use for decoding UIDs.

-s snapshot

Specifies the name of an FTimes snapshot map file.

Note: While not strictly required, it's best if the field mask used when taking the snapshot matches the one used to create the baseline.

AUTHOR

Klayton Monroe and Jason Smith

SEE ALSO

ftimes(1)

LICENSE

All documentation and code are distributed under same terms and conditions as FTimes.