Package ghidra.app.util.bin
Class FileByteProvider
java.lang.Object
ghidra.app.util.bin.FileByteProvider
- All Implemented Interfaces:
ByteProvider
,MutableByteProvider
,Closeable
,AutoCloseable
- Direct Known Subclasses:
ObfuscatedFileByteProvider
A
ByteProvider
that reads its bytes from a file.-
Field Summary
Fields inherited from interface ghidra.app.util.bin.ByteProvider
EMPTY_BYTEPROVIDER
-
Constructor Summary
ConstructorDescriptionFileByteProvider
(File file, FSRL fsrl, AccessMode accessMode) Creates a new instance. -
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Releases any resources theByteProvider
may have occupiedprotected int
doReadBytes
(long index, byte[] buffer) Reads bytes from the file.protected void
doWriteBytes
(long index, byte[] buffer, int offset, int length) Writes the specified bytes to the file.protected void
finalize()
Returns the absolute path (similar to, but not a, URI) to theByteProvider
.Returns the access mode the file was opened with.getFile()
Returns the underlyingFile
for thisByteProvider
, or null if thisByteProvider
is not associated with aFile
.getFSRL()
Returns theFSRL
of the underlying file for this byte provider, or null if this byte provider is not associated with a file.getName()
Returns the name of theByteProvider
.boolean
isValidIndex
(long index) Returns true if the specified index is valid.long
length()
Returns the length of theByteProvider
byte
readByte
(long index) Reads a byte at the specified indexint
readBytes
(long index, byte[] buffer, int offset, int length) Read bytes at the specified index into the given byte array.byte[]
readBytes
(long index, long length) Reads a byte array at the specified indexvoid
writeByte
(long index, byte value) Writes a byte at the specified index.void
writeBytes
(long index, byte[] values) Writes a byte array at the specified index.void
writeBytes
(long index, byte[] buffer, int offset, int length) Writes bytes to the specified offset in the file.Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface ghidra.app.util.bin.ByteProvider
getInputStream, isEmpty
-
Constructor Details
-
FileByteProvider
Creates a new instance.- Parameters:
file
-File
to openfsrl
-FSRL
identity of the fileaccessMode
-AccessMode.READ
orAccessMode.WRITE
- Throws:
IOException
- if error
-
-
Method Details
-
getAccessMode
Returns the access mode the file was opened with.- Returns:
AccessMode
used to open file
-
close
Description copied from interface:ByteProvider
Releases any resources theByteProvider
may have occupied- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceByteProvider
- Specified by:
close
in interfaceCloseable
- Throws:
IOException
- if an I/O error occurs
-
getFile
Description copied from interface:ByteProvider
Returns the underlyingFile
for thisByteProvider
, or null if thisByteProvider
is not associated with aFile
.- Specified by:
getFile
in interfaceByteProvider
- Returns:
- the underlying file for this byte provider
-
getName
Description copied from interface:ByteProvider
Returns the name of theByteProvider
. For example, the underlying file name.- Specified by:
getName
in interfaceByteProvider
- Returns:
- the name of the
ByteProvider
or null if there is no name
-
getAbsolutePath
Description copied from interface:ByteProvider
Returns the absolute path (similar to, but not a, URI) to theByteProvider
. For example, the complete path to the file.- Specified by:
getAbsolutePath
in interfaceByteProvider
- Returns:
- the absolute path to the
ByteProvider
or null if not associated with aFile
.
-
getFSRL
Description copied from interface:ByteProvider
Returns theFSRL
of the underlying file for this byte provider, or null if this byte provider is not associated with a file.- Specified by:
getFSRL
in interfaceByteProvider
- Returns:
- The
FSRL
of the underlyingFile
, or null if no associatedFile
.
-
length
Description copied from interface:ByteProvider
Returns the length of theByteProvider
- Specified by:
length
in interfaceByteProvider
- Returns:
- the length of the
ByteProvider
- Throws:
IOException
- if an I/O error occurs
-
isValidIndex
public boolean isValidIndex(long index) Description copied from interface:ByteProvider
Returns true if the specified index is valid.- Specified by:
isValidIndex
in interfaceByteProvider
- Parameters:
index
- the index in the byte provider to check- Returns:
- true if the specified index is valid
-
readByte
Description copied from interface:ByteProvider
Reads a byte at the specified index- Specified by:
readByte
in interfaceByteProvider
- Parameters:
index
- the index of the byte to read- Returns:
- the byte read from the specified index
- Throws:
IOException
- if an I/O error occurs
-
readBytes
Description copied from interface:ByteProvider
Reads a byte array at the specified index- Specified by:
readBytes
in interfaceByteProvider
- Parameters:
index
- the index of the byte to readlength
- the number of bytes to read- Returns:
- the byte array read from the specified index
- Throws:
IOException
- if an I/O error occurs
-
readBytes
Read bytes at the specified index into the given byte array.- Parameters:
index
- file offset to start readingbuffer
- byte array that will receive the bytesoffset
- offset inside the byte array to place the byteslength
- number of bytes to read- Returns:
- number of actual bytes read
- Throws:
IOException
- if error
-
finalize
protected void finalize() -
writeBytes
Writes bytes to the specified offset in the file.- Parameters:
index
- the location in the file to starting writingbuffer
- bytes to writeoffset
- offset in the buffer byte array to startlength
- number of bytes to write- Throws:
IOException
- if badAccessMode
or other io error
-
writeByte
Description copied from interface:MutableByteProvider
Writes a byte at the specified index.- Specified by:
writeByte
in interfaceMutableByteProvider
- Parameters:
index
- the index to write the bytevalue
- the value to write at the specified index- Throws:
IOException
- if an I/O error occurs
-
writeBytes
Description copied from interface:MutableByteProvider
Writes a byte array at the specified index.- Specified by:
writeBytes
in interfaceMutableByteProvider
- Parameters:
index
- the index to write the byte arrayvalues
- the values to write at the specified index- Throws:
IOException
- if an I/O error occurs
-
doReadBytes
Reads bytes from the file.Protected by synchronized lock. (See
getBufferFor(long)
).- Parameters:
index
- file position of where to readbuffer
- byte array that will receive bytes- Returns:
- actual number of byte read
- Throws:
IOException
- if error
-
doWriteBytes
Writes the specified bytes to the file.Protected by synchronized lock (See
writeBytes(long, byte[], int, int)
)- Parameters:
index
- file position of where to writebuffer
- byte array containing bytes to writeoffset
- offset inside of byte array to startlength
- number of bytes from buffer to write- Throws:
IOException
- if error
-