Autopsy  4.19.3
Graphical digital forensics platform for The Sleuth Kit and other tools.
Public Member Functions | Static Public Member Functions | Private Member Functions | Private Attributes | Static Private Attributes | List of all members
org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor Class Reference

Inherits org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessor.

Public Member Functions

 LocalDiskDSProcessor ()
 
void cancel ()
 
String getDataSourceType ()
 
JPanel getPanel ()
 
boolean isPanelValid ()
 
void reset ()
 
void run (DataSourceProcessorProgressMonitor progressMonitor, DataSourceProcessorCallback callback)
 
void run (Host host, DataSourceProcessorProgressMonitor progressMonitor, DataSourceProcessorCallback callback)
 
void run (String deviceId, String drivePath, String timeZone, boolean ignoreFatOrphanFiles, DataSourceProcessorProgressMonitor progressMonitor, DataSourceProcessorCallback callback)
 
default void runWithIngestStream (IngestJobSettings settings, DataSourceProcessorProgressMonitor progress, DataSourceProcessorCallback callBack)
 
default void runWithIngestStream (Host host, IngestJobSettings settings, DataSourceProcessorProgressMonitor progress, DataSourceProcessorCallback callBack)
 
default boolean supportsIngestStream ()
 

Static Public Member Functions

static String getType ()
 

Private Member Functions

void run (String deviceId, String drivePath, int sectorSize, String timeZone, boolean ignoreFatOrphanFiles, DataSourceProcessorProgressMonitor progressMonitor, DataSourceProcessorCallback callback)
 

Private Attributes

AddImageTask addDiskTask
 
final LocalDiskPanel configPanel
 
String deviceId
 
String drivePath
 
Host host
 
boolean ignoreFatOrphanFiles
 
ImageWriterSettings imageWriterSettings
 
final Logger logger = Logger.getLogger(LocalDiskDSProcessor.class.getName())
 
int sectorSize
 
String timeZone
 

Static Private Attributes

static final String DATA_SOURCE_TYPE = NbBundle.getMessage(LocalDiskDSProcessor.class, "LocalDiskDSProcessor.dsType.text")
 

Detailed Description

A local drive data source processor that implements the DataSourceProcessor service provider interface to allow integration with the add data source wizard. It also provides a run method overload to allow it to be used independently of the wizard.

Definition at line 45 of file LocalDiskDSProcessor.java.

Constructor & Destructor Documentation

org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.LocalDiskDSProcessor ( )

Constructs a local drive data source processor that implements the DataSourceProcessor service provider interface to allow integration with the add data source wizard. It also provides a run method overload to allow it to be used independently of the wizard.

Definition at line 69 of file LocalDiskDSProcessor.java.

Member Function Documentation

void org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.cancel ( )

Requests cancellation of the background task that adds a data source to the case database, after the task is started using the run method. This is a "best effort" cancellation, with no guarantees that the case database will be unchanged. If cancellation succeeded, the list of new data sources returned by the background task will be empty.

Implements org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessor.

Definition at line 268 of file LocalDiskDSProcessor.java.

String org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.getDataSourceType ( )

Gets a string that describes the type of data sources this processor is able to add to the case database. The string is suitable for display in a type selection UI component (e.g., a combo box).

Returns
A data source type display string for this data source processor.

Implements org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessor.

Definition at line 92 of file LocalDiskDSProcessor.java.

JPanel org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.getPanel ( )

Gets the panel that allows a user to select a data source and do any configuration required by the data source. The panel is less than 544 pixels wide and less than 173 pixels high.

Returns
A selection and configuration panel for this data source processor.

Implements org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessor.

Definition at line 105 of file LocalDiskDSProcessor.java.

static String org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.getType ( )
static

Gets a string that describes the type of data sources this processor is able to add to the case database. The string is suitable for display in a type selection UI component (e.g., a combo box).

Returns
A data source type display string for this data source processor.

Definition at line 80 of file LocalDiskDSProcessor.java.

boolean org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.isPanelValid ( )

Indicates whether the settings in the selection and configuration panel are valid and complete.

Returns
True if the settings are valid and complete and the processor is ready to have its run method called, false otherwise.

Implements org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessor.

Definition at line 118 of file LocalDiskDSProcessor.java.

void org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.reset ( )

Resets the selection and configuration panel for this data source processor.

Implements org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessor.

Definition at line 279 of file LocalDiskDSProcessor.java.

void org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.run ( DataSourceProcessorProgressMonitor  progressMonitor,
DataSourceProcessorCallback  callback 
)

Adds a data source to the case database using a background task in a separate thread and the settings provided by the selection and configuration panel. Returns as soon as the background task is started. The background task uses a callback object to signal task completion and return results.

This method should not be called unless isPanelValid returns true.

Parameters
progressMonitorProgress monitor that will be used by the background task to report progress.
callbackCallback that will be used by the background task to return results.

Implements org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessor.

Definition at line 137 of file LocalDiskDSProcessor.java.

void org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.run ( Host  host,
DataSourceProcessorProgressMonitor  progressMonitor,
DataSourceProcessorCallback  callback 
)

Adds a data source to the case database using a background task in a separate thread and the settings provided by the selection and configuration panel. Returns as soon as the background task is started. The background task uses a callback object to signal task completion and return results.

This method should not be called unless isPanelValid returns true.

Parameters
hostHost for this data source.
progressMonitorProgress monitor that will be used by the background task to report progress.
callbackCallback that will be used by the background task to return results.

Implements org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessor.

Definition at line 157 of file LocalDiskDSProcessor.java.

References org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessorCallback.DataSourceProcessorResult.CRITICAL_ERRORS, org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessorCallback.done(), org.sleuthkit.autopsy.casemodule.Case.getCurrentCase(), and org.sleuthkit.autopsy.casemodule.Case.getSleuthkitCase().

void org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.run ( String  deviceId,
String  drivePath,
String  timeZone,
boolean  ignoreFatOrphanFiles,
DataSourceProcessorProgressMonitor  progressMonitor,
DataSourceProcessorCallback  callback 
)

Adds a data source to the case database using a background task in a separate thread and the given settings instead of those provided by the selection and configuration panel. Returns as soon as the background task is started and uses the callback object to signal task completion and return results.

Parameters
deviceIdAn ASCII-printable identifier for the device associated with the data source that is intended to be unique across multiple cases (e.g., a UUID).
drivePathPath to the local drive.
timeZoneThe time zone to use when processing dates and times for the image, obtained from java.util.TimeZone.getID.
ignoreFatOrphanFilesWhether to parse orphans if the image has a FAT filesystem.
progressMonitorProgress monitor for reporting progress during processing.
callbackCallback to call when processing is done.

Definition at line 213 of file LocalDiskDSProcessor.java.

void org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.run ( String  deviceId,
String  drivePath,
int  sectorSize,
String  timeZone,
boolean  ignoreFatOrphanFiles,
DataSourceProcessorProgressMonitor  progressMonitor,
DataSourceProcessorCallback  callback 
)
private

Adds a data source to the case database using a background task in a separate thread and the given settings instead of those provided by the selection and configuration panel. Returns as soon as the background task is started and uses the callback object to signal task completion and return results.

Parameters
deviceIdAn ASCII-printable identifier for the device associated with the data source that is intended to be unique across multiple cases (e.g., a UUID).
drivePathPath to the local drive.
sectorSizeThe sector size (use '0' for autodetect).
timeZoneThe time zone to use when processing dates and times for the image, obtained from java.util.TimeZone.getID.
ignoreFatOrphanFilesWhether to parse orphans if the image has a FAT filesystem.
progressMonitorProgress monitor for reporting progress during processing.
callbackCallback to call when processing is done.

Definition at line 239 of file LocalDiskDSProcessor.java.

References org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessorCallback.DataSourceProcessorResult.CRITICAL_ERRORS, org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessorCallback.done(), org.sleuthkit.autopsy.casemodule.Case.getCurrentCase(), and org.sleuthkit.autopsy.casemodule.Case.getSleuthkitCase().

default void org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessor.runWithIngestStream ( IngestJobSettings  settings,
DataSourceProcessorProgressMonitor  progress,
DataSourceProcessorCallback  callBack 
)
inherited

Adds a data source to the case database using a background task in a separate thread and the settings provided by the selection and configuration panel. Files found during ingest will be sent directly to the IngestStream provided. Returns as soon as the background task is started. The background task uses a callback object to signal task completion and return results.

This method should not be called unless isPanelValid returns true, and should only be called for DSPs that support ingest streams. The ingest settings must be complete before calling this method.

Parameters
settingsThe ingest job settings.
progressProgress monitor that will be used by the background task to report progress.
callBackCallback that will be used by the background task to return results.

Implemented in org.sleuthkit.autopsy.casemodule.ImageDSProcessor.

Definition at line 150 of file DataSourceProcessor.java.

Referenced by org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessor.runWithIngestStream().

default void org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessor.runWithIngestStream ( Host  host,
IngestJobSettings  settings,
DataSourceProcessorProgressMonitor  progress,
DataSourceProcessorCallback  callBack 
)
inherited

Adds a data source to the case database using a background task in a separate thread and the settings provided by the selection and configuration panel. Files found during ingest will be sent directly to the IngestStream provided. Returns as soon as the background task is started. The background task uses a callback object to signal task completion and return results.

This method should not be called unless isPanelValid returns true, and should only be called for DSPs that support ingest streams. The ingest settings must be complete before calling this method.

Parameters
hostHost for this data source.
settingsThe ingest job settings.
progressProgress monitor that will be used by the background task to report progress.
callBackCallback that will be used by the background task to return results.

Implemented in org.sleuthkit.autopsy.casemodule.ImageDSProcessor.

Definition at line 174 of file DataSourceProcessor.java.

References org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessor.runWithIngestStream().

default boolean org.sleuthkit.autopsy.corecomponentinterfaces.DataSourceProcessor.supportsIngestStream ( )
inherited

Check if this DSP supports ingest streams.

Returns
True if this DSP supports an ingest stream, false otherwise.

Implemented in org.sleuthkit.autopsy.casemodule.ImageDSProcessor.

Definition at line 184 of file DataSourceProcessor.java.

Member Data Documentation

AddImageTask org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.addDiskTask
private

Definition at line 50 of file LocalDiskDSProcessor.java.

final LocalDiskPanel org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.configPanel
private

Definition at line 49 of file LocalDiskDSProcessor.java.

final String org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.DATA_SOURCE_TYPE = NbBundle.getMessage(LocalDiskDSProcessor.class, "LocalDiskDSProcessor.dsType.text")
staticprivate

Definition at line 48 of file LocalDiskDSProcessor.java.

String org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.deviceId
private

Definition at line 55 of file LocalDiskDSProcessor.java.

String org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.drivePath
private

Definition at line 56 of file LocalDiskDSProcessor.java.

Host org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.host
private

Definition at line 59 of file LocalDiskDSProcessor.java.

boolean org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.ignoreFatOrphanFiles
private

Definition at line 61 of file LocalDiskDSProcessor.java.

ImageWriterSettings org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.imageWriterSettings
private

Definition at line 60 of file LocalDiskDSProcessor.java.

final Logger org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.logger = Logger.getLogger(LocalDiskDSProcessor.class.getName())
private

Definition at line 47 of file LocalDiskDSProcessor.java.

int org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.sectorSize
private

Definition at line 57 of file LocalDiskDSProcessor.java.

String org.sleuthkit.autopsy.casemodule.LocalDiskDSProcessor.timeZone
private

Definition at line 58 of file LocalDiskDSProcessor.java.

The documentation for this class was generated from the following file:

Copyright © 2012-2022 Basis Technology. Generated on: Tue Jun 27 2023
This work is licensed under a Creative Commons Attribution-Share Alike 3.0 United States License.