mactime(1)

mactime1

Create an ascii time line of file activity

Usage

mactime [-b body] [-g group file] [-p password file] [{-i (day | hour) index file}] [-dhmVy] [-z TIME_ZONE] [DATE_RANGE]

Overview

mactime creates an ASCII time line of file activity based on the body file specified by '-b' or from STDIN. The time line is written to STDOUT. The body file must be in the time machine format that is created by 'ils -m', 'fls -m', or the mac-robber tool.

Arguments

-b body

Specify the location of a body file. This file must be generated by a tool such as 'fls -m' or 'ils -m'. The 'mac-robber' and 'grave-robber' tools can also be used to generate the file.

-g group file

Specify the location of the group file. mactime will display the group name instead of the GID if this is given.

-p password file

Specify the location of the passwd file. mactime will display the user name instead of the UID of this is given.

-i day|hour index file

Specify the location of an index file to write to. The first argument specifies the granularity, either an hourly summary or daily. If the ´-d´ flag is given, then the summary will be separated by a ',' to import into a spread sheet.

-d

Display timeline and index files in comma delimited format. This is used to import the data into a spread sheet for presentations or graphs.

-h

Display header info about the session including time range, input source, and passwd or group files.

-V

Display version to STDOUT.

-m

The month is given as a number instead of name (does not work with -y).

-y

The date is displayed in ISO8601 format.

-z TIME_ZONE

The timezone from where the data was collected. The name of this argument is system dependent (examples include EST5EDT, GMT+1). Does not work with -y.

-z list

List valid timezones.

DATE_RANGE

The range of dates to make the time line for. The standard format is yyyy-mm-dd for a starting date and no ending date. For an ending date, use yyyy-mm-dd..yyyy-mm-dd. Date can contain time, use format yyyy-mm-ddThh:mm:ss for starting and/or ending date.

Releases

12 releases since Debian 3.0 (Woody); the text changed 4 times.

  1. 3.0–6.0
  2. 8
  3. 9–10
  4. 11–13
  5. Arch

-D until Debian 6.0 (Squeeze); -R until Debian 6.0 (Squeeze); -b until Debian 6.0 (Squeeze); -d until Debian 6.0 (Squeeze); -f until Debian 6.0 (Squeeze); -g until Debian 6.0 (Squeeze); -h until Debian 6.0 (Squeeze); -l until Debian 6.0 (Squeeze); -n until Debian 6.0 (Squeeze); -p until Debian 6.0 (Squeeze); -s until Debian 6.0 (Squeeze); -t until Debian 6.0 (Squeeze); -u until Debian 6.0 (Squeeze); -y until Debian 6.0 (Squeeze).

License

The changes from mactime in TCT and mac-daddy are distributed under the Common Public License, found in the cpl1.0.txt file in the The Sleuth Kit licenses directory.

History

A version of mactime first appeared in The Coroner's Toolkit (TCT) (Dan Farmer) and later mac-daddy (Rob Lee).

Author

Brian Carrier <carrier at sleuthkit dot org>

Send documentation updates to <doc-updates at sleuthkit dot org>

From sleuthkit 4.15.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.