diff --git a/BUILDING.txt b/BUILDING.txt
index b5b53ee8b8..68a7e43249 100644
--- a/BUILDING.txt
+++ b/BUILDING.txt
@@ -13,7 +13,7 @@ needed even if you have a 64-bit system).
3) Download and install Netbeans IDE 7.0.1 (http://netbeans.org/)
-4) Download and build the release version of Libewf 20120304 (note that TSK will fail with Libewf 1 and the new alpha versions). All you need is the dll file.
+4) Download and build the release version of Libewf2 (20120304 or later). All you need is the dll file. Note that you will get a launching error if you use libewf 1.
- http://sourceforge.net/projects/libewf/
5) Set LIBEWF_HOME environment variable to root directory of LIBEWF
@@ -55,5 +55,5 @@ rebuild both the dll and the JAR file.
---------------
Brian Carrier
-11/9/2011
+4/6/2012
carrier sleuthkit org
diff --git a/Case/javahelp/org/sleuthkit/autopsy/casemodule/docs/aboutImage.html b/Case/javahelp/org/sleuthkit/autopsy/casemodule/docs/aboutImage.html
index e941cd4eaa..7d0c8a61a6 100644
--- a/Case/javahelp/org/sleuthkit/autopsy/casemodule/docs/aboutImage.html
+++ b/Case/javahelp/org/sleuthkit/autopsy/casemodule/docs/aboutImage.html
@@ -1,51 +1,30 @@
-
-
-
-
- About Image
-
-
-
-
-
About Images
-
- In Autopsy, an "Image" refers to the "Disk Image". Before an image can be analyzed, it must be added to a case.
-
-
Autopsy creates a database for each image that it imports. This database is a SQLite database and it contains all of the file system metadata from the image. When adding an image, it will take a little bit of time to populate the database. The database is stored in the case directory, but the image will stay in its original location.
-
-
Supported Formats
-
- Currently, Autopsy only supports these formats of image:
-
-
Raw Single (For example: *.img, *.dd, etc)
-
Raw Split (For example: *.001, *.002, *.aa, *.ab, etc)
-
EnCase (For example: *.e01, *e02, etc)
-
-
-
Adding an Image
-
- To see how to add image to the current opened case, click here.
-
-
-
-
-
\ No newline at end of file
+
+
+
+ Disk Image Basics
+
+
+
+
+
About Disk Images
+
+ In Autopsy, an "image" refers to a byte-for-byte copy of a hard drive or other storage media. To analyze an image, you must use the Add Image Wizardto add it to a case.
+
+
Autopsy populates an embedded database for each image that it imports. This database is a SQLite database and it contains all of the file system metadata from the image. The database is stored in the case directory, but the image will stay in its original location. The image must remain accessible for the duration of the anlaysis because the database contains only basic file system information. The image is needed to retrieve file content.
+
+
Supported Formats
+
+ Currently, Autopsy supports these image formats:
+
+
Raw Single (For example: *.img, *.dd, etc)
+
Raw Split (For example: *.001, *.002, *.aa, *.ab, etc)
+
EnCase (For example: *.e01, *e02, etc)
+
+
+
Removing an Image
+
+ You cannot currently remove an image from a case.
+
- There are several ways to add an image to the currently opened case:
-
-
Go to "File" and select "Add Image..."
-
Select the icon on the toolbar
-
-
-
- After that, a "Add Image" wizard dialog will show up. Then follow these following steps:
-
-
Select "Image Type", then enter the "Image Path" to the image that you want to analyze (you can also use the "Browse" button to browse the location of your image). Also specify the timezone that you want. When everything is completed, press "Next" button.
-
-
Autopsy needs to analyze the image to populate its database with file system metadata. If you have configured hash databases, you will be given the option of looking up files in the hash database during the ingest. Press the "Create Database" button to create the database. When the database creation process is done, you can press the "Next" button.
-
-
After the database is created, the image can be analyzed. You will be given the option to add another image or start the analysis.
-
-
-
Note that Autopsy will store the path to the image in its configuration file. If the image moves, then Autopsy will give an error because it can't find the image file.
-
-
-
\ No newline at end of file
+
+
+
+ Adding Image Wizard
+
+
+
+
+
Adding An Image
+
+ There are two ways to add an image to the currently opened case:
+
+
Go to "File" and select "Add Image..."
+
Select the icon on the toolbar
+
+
+
+ This will bring up the Add Image wizard. It will guide you through the process. Here are some notes on what is going on during the process:
+
+
The first panel will ask for the location and type of the disk image to add. You will also need to specify the timezone that the disk image came from so that the dates and times can be properly displayed and converted.
+
+
The second panel is when Autopsy is analyzing the disk image and populating the database with basic information. This can take a few minutes for large images.
+
+
The third panel allows you to choose which ingest modules to run on the image. Refer to the Image Ingest part of the help guide for more details.
+
Once you select the ingest modules that you want to use, they will run in the background. You can choose to add another image or exit the Add Image wizard.
+
+
Note that Autopsy will store the path to the image in its configuration file. If the image moves, then Autopsy will give an error because it can't find the image file.
+
+
\ No newline at end of file
diff --git a/Case/javahelp/org/sleuthkit/autopsy/casemodule/docs/casemodule-about.html b/Case/javahelp/org/sleuthkit/autopsy/casemodule/docs/casemodule-about.html
index 83243973f6..ced5e907a3 100644
--- a/Case/javahelp/org/sleuthkit/autopsy/casemodule/docs/casemodule-about.html
+++ b/Case/javahelp/org/sleuthkit/autopsy/casemodule/docs/casemodule-about.html
@@ -1,50 +1,26 @@
-
-
-
- About Cases
-
-
-
-
-
About Cases
-
- In Autopsy, a "case" is a container concept for a set of images. The set of images could be from multiple drives in a single computer or from multiple computers. When you make a case, it will create a directory to hold all of the information. The directory will contain a configuration file, some databases, and some other information.
-
- After that, a File Chooser dialog will show up. Then select a ".aut" file that you previously created. It will be in the case folder.
-
-
-
What's Next?
-
After you create a case, you can add an image to the case.
-
If you want to view case details or edit some case information, use the Case Properties window.
-
-
-
+
+
+ About Cases
+
+
+
+
+
About Cases
+
+ In Autopsy, a "case" is a container concept for a set of images. The set of images could be from multiple drives in a single computer or from multiple computers. When you make a case, it will create a directory to hold all of the information. The directory will contain a configuration file, some databases, and some other information. The configuration file as a .aut extension.
+
+
+
If you want to view case details or edit some case information, use the Case Properties window.
+
+
+ To open a case, choose "Open Case" from the File menu or use the "Ctrl + O" keyboard short cut.
+ Navigate to the case directory and select the ".aut" file.
+
- The Hash Database Management window is where you can set and update your hash database information. Hash databases are used to identify files that are 'known'.
-
-
Known good files are those that can be safely ignored. This set of files frequently includes standard OS and application files.
-
Known bad files are those that should raise awareness. This set will vary depending on the type of investigation, but common examples include contraband images and malware.
-
-
-
-
Autopsy allows for a single known bad hash database to be set and the NIST NSRL. Before they can be used, an index of them must exist.
- The index can be directly copied in or it can be created within Autopsy. When you select the database from within this window, it will tell you if the index needs to be created. Autopsy
- uses the hash database management system from The Sleuth Kit. You can manually create an index using the 'hfind' command line tool.
-
-
Note that the NSRL contains hashes of 'known files' that may be good or bad depending on your perspective and investigation type. For example, the existence of a piece of financial software
- may be interesting to your investigation and that software could be in the NSRL. Therefore, Autopsy treats files that are found in the NSRL as simplyi 'known' and does not specify good or bad.
-
-
To use the NSRL, you must concatenate all of the NSRLFile.txt files together. You can use 'cat' on a Unix system or from within Cygwin to do this.
-
-
The 'known bad' hash database can be in the hashkeeper, md5sum, or NSRL format.
-
-
Autopsy uses hash databases when the image is added to the case. Each file is hashed and looked up in the configured databases. If the file is found in the NSRL, then it will be marked as
- 'known' in the case database. If it is found in the known bad hash database, it will be marked as 'known bad' in the case database.
-
-
You can see the lookup results in a couple of places. In the File Search data explorer, there is an option to choose the 'known status'. From here, you can do a search to see all 'known bad' files.
- From here, you can also choose to ignore all 'known' files that were found in the NSRL. You can also see the status of the file in a column when the file is listed.
-
-
Currently, you cannot reprocess a disk image with a new hash database after it has been added to a case.
-
-
-
-
\ No newline at end of file
+
+
+
+ Hash Database Management
+
+
+
+
+
Hash Database Management Window
+
+ The Hash Database Management window is where you can set and update your hash database information. Hash databases are used to identify files that are 'known'.
+
+
Known good files are those that can be safely ignored. This set of files frequently includes standard OS and application files.
+
Known bad (also called notable) files are those that should raise awareness. This set will vary depending on the type of investigation, but common examples include contraband images and malware.
+
+
+
+
Notable / Known Bad Hashsets
+
Autopsy allows for a single known bad hash database to be set. Future versions will support multiple hash sets. Autopsy supports three formats:
+
+
EnCase: An EnCase hashset file.
+
MD5sum: Output from running the md5, md5sum, or md5deep program on a set of files.
HashKeeper: Hashkeeper hashsets (Must be merged into a single file).
+
+
+
NIST NSRL
+
Autopsy can use the NIST NSRL to detect 'known files'. Note that the NSRL contains hashes of 'known files' that may be good or bad depending on your perspective and investigation type. For example, the existence of a piece of financial software
+ may be interesting to your investigation and that software could be in the NSRL. Therefore, Autopsy treats files that are found in the NSRL as simplyi 'known' and does not specify good or bad. Ingest modules have the option of ignoring files that were found in the NSRL.
+
+
To use the NSRL, you must concatenate all of the NSRLFile.txt files together. You can use 'cat' on a Unix system or from within Cygwin to do this.
+
+
Adding Hashsets
+
Autopsy needs an index of the hashset. It can make one if you import only the hashset. When you select the database from within this window, it will tell you if the index needs to be created. Autopsy
+ uses the hash database management system from The Sleuth Kit. You can manually create an index using the 'hfind' command line tool.
+
+
You can also specify only the index file and not use the full hashset. This can save space. To do this, specify the .idx file from the Hash Database Management window.
+
+
Using Hashsets
+
There is an ingest module that will hash the files and look them up in the hashsets. It will flag files that were in the notable hashset and those results will be shown in the Results tree of the Data Explorer.
+
+
Other ingest modules are able to use the known status of a file to decide if they should ignore the file or process it.
+
+
You can also see the results in the File Search window. There is an option to choose the 'known status'. From here, you can do a search to see all 'known bad' files.
+ From here, you can also choose to ignore all 'known' files that were found in the NSRL. You can also see the status of the file in a column when the file is listed.
+
+
+
diff --git a/Case/javahelp/org/sleuthkit/autopsy/casemodule/docs/overview.html b/Case/javahelp/org/sleuthkit/autopsy/casemodule/docs/overview.html
old mode 100644
new mode 100755
index 3b3716d90f..88094aaf4c
--- a/Case/javahelp/org/sleuthkit/autopsy/casemodule/docs/overview.html
+++ b/Case/javahelp/org/sleuthkit/autopsy/casemodule/docs/overview.html
@@ -19,12 +19,12 @@ and open the template in the editor.
The main window has three major areas:
-
Data Explorers (area 4 in figure below): This area is where you go find major analysis functionality. It allows you to start finding the relevant files.
+
Data Explorer Tree (area 4 in figure below): This area is where you go find major analysis functionality. It allows you to start finding the relevant files quickly.
Result Viewers (area 5 in figure below): This area is where the files and directories that were found from the explorer window can be viewed. There are different formatting options for the files.
Content Viewers (area 6 in figure below): This area is where file content can be viewed after they are selected from the Result Viewer area.
-
The main take away from this should be that analysis techniques can be found on the left-hand side, the results are always listed in the upper right, and the file contents are displayed in the lower left.
+
The main take away from this should be that analysis techniques and result categories can be found on the left-hand side, the results from choosing something on the left are always listed in the upper right, and the file contents are displayed in the lower left.
- The "Content Viewers" are in the lower right area of the interface. They allow you to view raw data. The data being shown should be have been selected from a Result Viewer window (upper right).
-
-
- Currently, there are 3 main tabs on "Content Viewer" window:
-
- Here's one of the example of a "Content Viewer" window:
-
-
-
-
-
-
+
+
+
+ About Content Viewers
+
+
+
+
+
Content Viewers
+
+ The Content Viewer area is in the lower right area of the interface. This area is used to view a specific file in a variety of formats. There are different tabs for different viewers. Not all tabs support all file types, so only some of them will be enabled. To display data in this area, it must be selected from the Result Viewer window (upper right).
+
+
+
The Content Viewer area is part of a plug-in framework. You can install modules that will add more viewer types. This section describes the viewers that come by default with Autopsy.
+
+
Here's an example of a "Content Viewer" window:
+
+
+
+
Default Viewers
+
+ Currently, there are 3 main tabs on "Content Viewer" window:
+
- The Result Viewer windows are in the upper right area of the interface and display the results from a Data Explorer window.
- You will have the option in this are to display the results in a variety of formats.
- Currently, there are 2 main tabs on "Result Viewer" window:
-
- Viewers in Result Viewers have some right click function that built in into them:
-
- 1. Open File in External Viewer
- This right click function will open the selected node/data in an "external" application. Note: This does not support all file types.
-
-
- 2. View in New Window
- This right click function will pop up a new "Content Viewers" window for the selected node/data. You can dock this new window or close it.
-
-
- 3. Extract
- This right click function will extract the selected file or directory to any location on the local hard drive (you can specify the location).
-
-
- 4. View (Hex and String)
- This right click function will change the active tab on the main "Content Viewers" window to be the selected tab.
-
-
-
-
Example
-
- Here's one of the example of a "Result Viewer" window:
-
-
-
-
-
-
+
+
+
+ Result Viewers
+
+
+
+
+
Result Viewers
+
+ The Result Viewer windows are in the upper right area of the interface and display the results from selecting something in the Explorer Tree area.
+ You will have the option in this are to display the results in a variety of formats.
+ Currently, there are 2 main tabs on "Result Viewer" window:
+
+ Viewers in Result Viewers have some right click function that built in into them. Here are some examples that you may see:
+
+
+
Open File in External Viewer: Opens the selected file in an "external" application as defined by the local OS. For example, HTML files maybe opened by IE or Firefox, depending on what the local system is configured to use.
+
+
View in New Window: Opens the content in a new internal Content Viewer (instead of in the default location in the lower right).
+
+
Extract: Make a local copy of the file or directory for further analysis.
+
+
+
+
Example
+
+ Here's one of the example of a "Result Viewer" window:
+
+
+
- Picture Content Viewer will show the actual picture from the picture file.
- Currently, Picture Content Viewer only support JPG, GIF, and PNG formats.
- If you select an non-picture file or an unsupported picture format on the "Result Viewers", this tab will be disabled.
-
-
-
-
Example
-
- Here's one of the example of "Picture Content Viewer":
-
-
-
-
-
-
\ No newline at end of file
+
+
+
+ Media Content Viewer
+
+
+
+
+
Media Content Viewer
+
+ The Media Content Viewer will show a picture or video file. Video files can be played and paused. The size of the picture or video will be reduced to fit into the screen. If you want more complex analysis of the media, then you must export the file.
+
If you select an non-picture file or an unsupported picture format on the "Result Viewers", this tab will be disabled.
+
+
+
+
+
+ Here's one of the example of the "Media Content Viewer":
+
+
+
- Strings Content Viewer just scans the data of the file / folder and show you it for printable ASCII strings of a default length of 4 or more ASCII characters. If the length of printable ASCII is less than 4, it won't show the string.
-
-
-
-
Example
-
- Here's one of the example of "String Content Viewer":
-
-
-
-
-
-
\ No newline at end of file
+
+
+
+ String Content Viewer
+
+
+
+
+
String Content Viewer
+
Strings Content Viewer scans the data of the file / folder and searches it for data that could be text. If it finds data that is ASCII data and at least four characters long, then it displays it to the user.
+
Note that this is different from the Text Content Viewer, which displays the text for a file that is stored in the keyword search index. The results may be the same or they could be different.
+
+
Example
+
+ Here's one of the example of "String Content Viewer":
+
+
+
Text Content Viewer uses the keyword search index that may have been populated during Image Ingest. If a file has text stored in the index, then this tab will be enabled and it will be displayed to the user.
+
+
This tab may have more text on it than the "Strings Content Viewer", which relies on searching the file for text-looking data. Some files, like PDF, will not have text-looking data at the byte-level, but the keyword indexing process knows how to interpret a PDF file and produce text.
+
+
If this tab is not enabled, then either the file has no text or you did not enable Keyword Search as an ingest module. Note that this viewer is also used to display keyword hits.
+
+
diff --git a/DirectoryTree/javahelp/org/sleuthkit/autopsy/directorytree/docs/directorytree-about.html b/DirectoryTree/javahelp/org/sleuthkit/autopsy/directorytree/docs/directorytree-about.html
old mode 100644
new mode 100755
index 4dc6504dae..689a60d756
--- a/DirectoryTree/javahelp/org/sleuthkit/autopsy/directorytree/docs/directorytree-about.html
+++ b/DirectoryTree/javahelp/org/sleuthkit/autopsy/directorytree/docs/directorytree-about.html
@@ -1,50 +1,24 @@
-
- About Directory Tree
+ Explorer Tree
-
About Directory Tree
+
About Explorer Tree
- Directory Tree is one of the main windows in Autopsy. Here, you can see and analyze all the images (also volumes and directories inside that images) which are shown in tree format. You can also see the details of the image, volume, and the file system from directory tree.
-
+ The explorer tree is a very important area of the interface. This is where you will start many of your analysis approaches and find results from automated procedures. The tree has three main areas:
+
+
Images: Where you can find the directory tree hierarchy of the file systems in the images. Go here to navigate to a specific file or directory.
+
Views: Where you can view all of the files in the images, but organized by file type or dates instead of directories. Go here if you are looking for files of a given type or that were recently used.
+
Results: Where you can see the results from the background ingest tasks and you can see your previous search results. Go here to see what was found by the ingest modules and to find your previous search results.
+
-
How to Open Directory Tree
- To see how to open Directory Tree, click here.
-
- Note: The Directory Tree Window is opened and closed automatically. If there's a case opened and there is at least one image inside that case, Directory Tree Window can't be closed.
-
- Here's an example of a Directory Tree window:
-
+ Here's an example of an Explorer Tree:
+
-
+
diff --git a/DirectoryTree/javahelp/org/sleuthkit/autopsy/directorytree/docs/directorytree-idx.xml b/DirectoryTree/javahelp/org/sleuthkit/autopsy/directorytree/docs/directorytree-idx.xml
index 35230646f0..7d897a7c0d 100644
--- a/DirectoryTree/javahelp/org/sleuthkit/autopsy/directorytree/docs/directorytree-idx.xml
+++ b/DirectoryTree/javahelp/org/sleuthkit/autopsy/directorytree/docs/directorytree-idx.xml
@@ -6,8 +6,6 @@ and open the template in the editor.
-
-
diff --git a/DirectoryTree/javahelp/org/sleuthkit/autopsy/directorytree/docs/directorytree-map.xml b/DirectoryTree/javahelp/org/sleuthkit/autopsy/directorytree/docs/directorytree-map.xml
index d8f3b9ce81..64eefae2b2 100644
--- a/DirectoryTree/javahelp/org/sleuthkit/autopsy/directorytree/docs/directorytree-map.xml
+++ b/DirectoryTree/javahelp/org/sleuthkit/autopsy/directorytree/docs/directorytree-map.xml
@@ -6,7 +6,6 @@ and open the template in the editor.