Package ghidra.formats.gfilesystem

Class LocalFileSystem

java.lang.Object

ghidra.formats.gfilesystem.LocalFileSystem

All Implemented Interfaces:

GFileSystem, ExtensionPoint, java.io.Closeable, java.lang.AutoCloseable

public class LocalFileSystem
extends java.lang.Object
implements GFileSystem

A GFileSystem implementation giving access to the user's operating system's local file system.

This implementation does not have a GFileSystemFactory as this class will be used as the single root filesystem.

Closing() this filesystem does nothing.

Nested Class Summary

Nested classes/interfaces inherited from interface ghidra.util.classfinder.ExtensionPoint

ExtensionPoint.Exclude, ExtensionPoint.Util

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	FSTYPE

Method Summary

Modifier and Type	Method	Description
void	close()
FSRLRoot	getFSRL()	File system's FSRL
java.lang.String	getInfo(GFile file, TaskMonitor monitor)	Returns a multi-line string with information about the specified file.
java.io.InputStream	getInputStream(GFile file, TaskMonitor monitor)	Returns an InputStream that contains the contents of the specified GFile.
java.util.List<GFile>	getListing(GFile directory)	Returns a list of files that reside in the specified directory on this filesystem.
java.io.File	getLocalFile(FSRL fsrl)
java.lang.String	getName()	File system volume name.
FileSystemRefManager	getRefManager()	Returns the ref manager that is responsible for creating and releasing refs to this filesystem.
boolean	isClosed()	Returns true if the filesystem has been closed
boolean	isLocalSubdir(FSRL fsrl)	Returns true if the FSRL is a local filesystem subdirectory.
boolean	isStatic()	Indicates if this filesystem is a static snapshot or changes.
GFileImpl	lookup(java.lang.String path)	Retrieves a GFile from this filesystem based on its full path and filename.
static LocalFileSystem	makeGlobalRootFS()	Create a new instance
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface ghidra.formats.gfilesystem.GFileSystem

getDescription, getFileCount, getType

Field Detail

FSTYPE

public static final java.lang.String FSTYPE

See Also:

Constant Field Values

Method Detail

makeGlobalRootFS

public static LocalFileSystem makeGlobalRootFS()

Create a new instance

Returns:

new LocalFileSystem instance using FSTYPE as its FSRL type.

isLocalSubdir

public boolean isLocalSubdir(FSRL fsrl)

Returns true if the FSRL is a local filesystem subdirectory.

Parameters:

fsrl - FSRL to test.

Returns:

boolean true if local filesystem directory.

getLocalFile

public java.io.File getLocalFile(FSRL fsrl)
                          throws java.io.IOException

Throws:

java.io.IOException

getName

public java.lang.String getName()

Description copied from interface: GFileSystem

File system volume name.

Typically the name of the container file, or a internally stored 'volume' name.

Specified by:

getName in interface GFileSystem

Returns:

string filesystem volume name.

close

public void close()

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

isStatic

public boolean isStatic()

Description copied from interface: GFileSystem

Indicates if this filesystem is a static snapshot or changes.

Specified by:

isStatic in interface GFileSystem

Returns:

boolean true if the filesystem is static or false if dynamic content.

getListing

public java.util.List<GFile> getListing(GFile directory)

Description copied from interface: GFileSystem

Returns a list of files that reside in the specified directory on this filesystem.

Specified by:

getListing in interface GFileSystem

Parameters:

directory - NULL means root of filesystem.

Returns:

List of GFile instances of file in the requested directory.

getInfo

public java.lang.String getInfo(GFile file,
                                TaskMonitor monitor)

Description copied from interface: GFileSystem

Returns a multi-line string with information about the specified file.

TODO: this method needs to be refactored to return a Map instead of a pre-formatted multi-line string.

Specified by:

getInfo in interface GFileSystem

Parameters:

file - GFile to get info message for.

monitor - TaskMonitor to watch and update progress.

Returns:

multi-line formatted string with info about the file, or null.

getFSRL

public FSRLRoot getFSRL()

Description copied from interface: GFileSystem

File system's FSRL

Specified by:

getFSRL in interface GFileSystem

Returns:

FSRLRoot of this filesystem.

lookup

public GFileImpl lookup(java.lang.String path)
                 throws java.io.IOException

Description copied from interface: GFileSystem

Retrieves a GFile from this filesystem based on its full path and filename.

Specified by:

lookup in interface GFileSystem

Parameters:

path - string path and filename of a file located in this filesystem. Use null or "/" to retrieve the root directory

Returns:

GFile instance of requested file, null if not found.

Throws:

java.io.IOException - if IO error when looking up file.

getInputStream

public java.io.InputStream getInputStream(GFile file,
                                          TaskMonitor monitor)
                                   throws java.io.IOException

Description copied from interface: GFileSystem

Returns an InputStream that contains the contents of the specified GFile.

The caller is responsible for closing the stream.

Specified by:

getInputStream in interface GFileSystem

Parameters:

file - GFile to get an InputStream for

monitor - TaskMonitor to watch and update progress

Returns:

new InputStream contains the contents of the file or NULL if the file doesn't have data.

Throws:

java.io.IOException - if IO problem

isClosed

public boolean isClosed()

Description copied from interface: GFileSystem

Returns true if the filesystem has been closed

Specified by:

isClosed in interface GFileSystem

Returns:

boolean true if the filesystem has been closed.

getRefManager

public FileSystemRefManager getRefManager()

Description copied from interface: GFileSystem

Returns the ref manager that is responsible for creating and releasing refs to this filesystem.

Specified by:

getRefManager in interface GFileSystem

Returns:

FileSystemRefManager that manages references to this filesystem.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object