File: mactime.1

package info (click to toggle)
sleuthkit 4.6.5-1%2Bdeb10u1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 39,264 kB
  • sloc: ansic: 171,812; cpp: 44,216; sh: 31,364; java: 17,674; makefile: 1,241; xml: 838; perl: 797; python: 707; sed: 16
file content (74 lines) | stat: -rw-r--r-- 2,635 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
.TH MACTIME 1
.SH NAME
mactime \- Create an ASCII time line of file activity
.SH SYNOPSIS
.B  mactime [-b
.I body
.B ] [-g 
.I group file
.B ] [-p 
.I password file
.B ] [-i
.I (day|hour) index file
.B ] [-dhmVy] [-z
.I TIME_ZONE
.B ] [DATE_RANGE]
.SH DESCRIPTION
.B 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.

.SH ARGUMENTS
.IP "-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.
.IP "-g group file"
Specify the location of the group file.  mactime will display the group
name instead of the GID if this is given.
.IP "-p password file"
Specify the location of the passwd file.  mactime will display the
user name instead of the UID of this is given.
.IP "-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.
.IP -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.
.IP -h
Display header info about the session including time range, input source,
and passwd or group files.
.IP -V
Display version to STDOUT.
.IP -m
The month is given as a number instead of name (does not work with \-y).
.IP -y
The date is displayed in ISO8601 format.
.IP "-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.
.IP "-z list"
List valid timezones.
.IP 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.

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

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

.SH AUTHOR
Brian Carrier <carrier at sleuthkit dot org>

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