ie-visits

Parses the WebCacheV01.dat ESE (Extensible Storage Engine) database file used by Internet Explorer and queries the website visit history. Extracts usernames, URLs, and access counts from visit records stored in the History and MSHist containers.

Command properties

PropertyValue
Command typeDriver query
Required permissionNone
License usageCounted
Parallel executionNot supported
Distributed executionRuns on Data Node (mapper)

Syntax

ie-visits [zippath=STR] [zipcharset=STR] FILE_PATH

Options

zippath=STR
Path to the ZIP file containing the WebCacheV01.dat file. Use this when querying the ESE database file directly from inside a ZIP archive.
zipcharset=STR
Character set for ZIP file entries. (Default: utf-8)

Target

FILE_PATH
Path to the Internet Explorer WebCacheV01.dat file to query. You can use wildcards (*) to specify multiple files.

Output fields

FieldTypeDescription
_timetimestampLast access time
container_idlongContainer identifier
entry_idlongEntry identifier
cache_idlongCache identifier
typestringRecord type
visit_countlongAccess count
userstringUsername of the visitor
urlstringVisited URL
file_pathstringLocal path of the cached file
file_namestringCached file name
file_sizelongCached file size (bytes)
file_extstringCached file extension
redirect_urlstringRedirect URL
sync_timetimestampSync time
creation_timetimestampCreation time
expiry_timetimestampExpiry time
modified_timetimestampModification time
post_check_timetimestampPost-check time
request_headersbinaryHTTP request headers
response_headersbinaryHTTP response headers
groupstringGroup
extra_databinaryExtra data
url_hashlongURL hash value
secure_dirlongSecure directory identifier

Error codes

Parsing errors

N/A

Runtime errors
Error codeMessageDescriptionAction on error
-cannot load ESE database: PATHThe ESE database file could not be readAborts query execution

Description

The ie-visits command parses the WebCacheV01.dat ESE database file where Internet Explorer stores visit history. It first identifies containers in the Containers table that are of type History or whose name starts with MSHist, then queries records from those containers.

Usernames and actual URLs are separated from the original URL field. When the URL has the format type: username@host, the string before @ is assigned to the user field and the string after @ to the url field. If there is no @, the user field is set to null.

Date fields are converted from Windows FILETIME format (100-nanosecond units since January 1, 1601) to UNIX timestamps. If a FILETIME value is 0, the corresponding date field is not assigned.

Examples

  1. Query IE visit history

    ie-visits /opt/logpresso/evidence/WebCacheV01.dat
    

    Queries all visit history from the WebCacheV01.dat file at the specified path.

  2. Retrieve the top 10 entries by visit count

    ie-visits /opt/logpresso/evidence/WebCacheV01.dat
    | sort -visit_count
    | limit 10
    

    Retrieves the top 10 visit history entries sorted by access count in descending order.

  3. Query a WebCacheV01.dat file inside a ZIP archive

    ie-visits zippath=/opt/logpresso/evidence/browser.zip WebCacheV01.dat
    

    Queries visit history from the WebCacheV01.dat file inside the ZIP archive.