.\" Text automatically generated by txt2man
.TH mac-robber 1 "16 Mai 2013" "mac-robber-1.02" "collects data about allocated files in mounted filesystems"
.SH NAME
\fBmac-robber \fP- collects data about allocated files in mounted filesystems
.SH SYNOPSIS
.nf
.fam C
\fBmac-robber\fP [\fIOPTION\fP]
\fBmac-robber\fP <DIRECTORY>
.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
\fBmac-robber\fP is a digital investigation tool (digital forensics) that collects
metadata from allocated files in a mounted filesystem. This is useful during
incident response when analyzing a live system or when analyzing a dead
system in a lab. The data can be used by the mactime tool in The Sleuth Kit
(TSK or SleuthKit only) to make a timeline of file activity. The \fBmac-robber\fP
tool is based on the grave-robber tool from TCT (The Coroners Toolkit).
.PP
\fBmac-robber\fP requires that the filesystem be mounted by the operating system,
unlike the tools in The Sleuth Kit that process the filesystem themselves.
Therefore, \fBmac-robber\fP will not collect data from deleted files or files that
have been hidden by rootkits.
.PP
\fBmac-robber\fP will also modify the Access times on directories that are mounted
with write permissions. When in forensics analysis you should mount the target
partition as read-only.
.PP
\fBmac-robber\fP is useful when dealing with a filesystem that is not supported
by The Sleuth Kit or other filesystem analysis tools. You can run \fBmac-robber\fP
on an obscure, suspect UNIX filesystem that has been mounted read-only on a
trusted system.
.SH OPTIONS
.TP
.B
\fB-h\fP
Print help.
.TP
.B
\fB-V\fP
Show the version.
.SH EXAMPLE
To see metadata from all files in a directory (recursively):
.PP
.nf
.fam C
      $ mac-robber /home/user/directory

.fam T
.fi
To make a timeline using mactime command from The Sleuth Kit (TSK) and setting Brazilian timezone:
.PP
.nf
.fam C
      $ mac-robber /home/user/directory | mactime \-z BRT

.fam T
.fi
An alternative is write the results into a file and read it using mactime:
.PP
.nf
.fam C
      $ mac-robber /home/user/directory > /tmp/files.mr
      $ mactime \-b /tmp/files.mr \-z BRT
.fam T
.fi
.SH AUTHOR
The Sleuth Kit was written by Brian Carrier <carrier@sleuthkit.org>.
.PP
This manual page was written by Joao Eriberto Mota Filho <eriberto@debian.org> for the Debian project (but may be used by others).