Class AbstractEmuLinuxSyscallUseropLibrary<T>

java.lang.Object

ghidra.pcode.exec.AnnotatedPcodeUseropLibrary<T>

ghidra.pcode.emu.sys.AnnotatedEmuSyscallUseropLibrary<T>

ghidra.pcode.emu.unix.AbstractEmuUnixSyscallUseropLibrary<T>

ghidra.pcode.emu.linux.AbstractEmuLinuxSyscallUseropLibrary<T>

Type Parameters:

T - the type of values processed by the library

All Implemented Interfaces:

EmuSyscallLibrary<T>, PcodeUseropLibrary<T>

Direct Known Subclasses:

EmuLinuxAmd64SyscallUseropLibrary, EmuLinuxX86SyscallUseropLibrary

public abstract class AbstractEmuLinuxSyscallUseropLibrary<T>
extends AbstractEmuUnixSyscallUseropLibrary<T>

An abstract library of Linux system calls, suitable for use with any processor

Nested Class Summary

Nested classes/interfaces inherited from class AbstractEmuUnixSyscallUseropLibrary

AbstractEmuUnixSyscallUseropLibrary.Errno, AbstractEmuUnixSyscallUseropLibrary.UnixStructuredPart

Nested classes/interfaces inherited from class AnnotatedEmuSyscallUseropLibrary

AnnotatedEmuSyscallUseropLibrary.EmuSyscall, AnnotatedEmuSyscallUseropLibrary.StructuredPart

Nested classes/interfaces inherited from class AnnotatedPcodeUseropLibrary

AnnotatedPcodeUseropLibrary.AnnotatedPcodeUseropDefinition<T>, AnnotatedPcodeUseropLibrary.FixedArgsAnnotatedPcodeUseropDefinition<T>, AnnotatedPcodeUseropLibrary.OpExecutor, AnnotatedPcodeUseropLibrary.OpLibrary, AnnotatedPcodeUseropLibrary.OpOutput, AnnotatedPcodeUseropLibrary.OpState, AnnotatedPcodeUseropLibrary.PcodeUserop, AnnotatedPcodeUseropLibrary.VariadicAnnotatedPcodeUseropDefinition<T>

Nested classes/interfaces inherited from interface EmuSyscallLibrary

EmuSyscallLibrary.EmuSyscallDefinition<T>, EmuSyscallLibrary.SyscallPcodeUseropDefinition<T>

Nested classes/interfaces inherited from interface PcodeUseropLibrary

PcodeUseropLibrary.EmptyPcodeUseropLibrary, PcodeUseropLibrary.PcodeUseropDefinition<T>

Field Summary

Fields

Modifier and Type	Field	Description
protected static final Map<AbstractEmuUnixSyscallUseropLibrary.Errno, Integer>	ERRNOS	TODO: A map from simulator-defined errno to Linux-defined errno
static final int	O_APPEND
static final int	O_CREAT
static final int	O_MASK_RDWR
static final int	O_RDONLY
static final int	O_RDWR
static final int	O_TRUNC
static final int	O_WRONLY

Fields inherited from class AbstractEmuUnixSyscallUseropLibrary

closedFds, descriptors, fs, intSize, user

Fields inherited from class AnnotatedEmuSyscallUseropLibrary

additionalArchives, CACHE_BY_CLASS, cSpec, dtMachineWord, machine, program, SYSCALL_SPACE_NAME, syscallMap

Fields inherited from class AnnotatedPcodeUseropLibrary

ops

Fields inherited from interface EmuSyscallLibrary

SYSCALL_CONVENTION_NAME

Fields inherited from interface PcodeUseropLibrary

NIL

Constructor Summary

Constructors

Constructor	Description
AbstractEmuLinuxSyscallUseropLibrary(PcodeMachine<T> machine, EmuUnixFileSystem<T> fs, Program program)	Construct a new library
AbstractEmuLinuxSyscallUseropLibrary(PcodeMachine<T> machine, EmuUnixFileSystem<T> fs, Program program, EmuUnixUser user)	Construct a new library

Method Summary

Modifier and Type	Method	Description
protected Set<EmuUnixFileSystem.OpenFlag>	convertFlags(int flags)	Convert the flags as defined for this platform to flags understood by the simulator
protected int	getErrno(AbstractEmuUnixSyscallUseropLibrary.Errno err)	Get the platform-specific errno value for the given simulator-defined errno

Methods inherited from class AbstractEmuUnixSyscallUseropLibrary

claimFd, createHandle, findFd, handleError, lowestFd, newStructuredPart, putDescriptor, releaseFd, returnErrno, unix_close, unix_exit, unix_group_exit, unix_open, unix_read, unix_write

Methods inherited from class AnnotatedEmuSyscallUseropLibrary

disposeAdditionalArchives, getAdditionalArchives, getSyscalls, getSyscallUserop, mapAndBindSyscalls, mapAndBindSyscalls, newBoundSyscall

Methods inherited from class AnnotatedPcodeUseropLibrary

getMethodLookup, getOperandType, getUserops

Methods inherited from class Object

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

Methods inherited from interface EmuSyscallLibrary

readSyscallNumber, syscall

Methods inherited from interface PcodeUseropLibrary

compose, getSymbols, getUserops

Field Details

O_MASK_RDWR

public static final int O_MASK_RDWR

See Also:

• Constant Field Values

O_RDONLY

public static final int O_RDONLY

See Also:

• Constant Field Values

O_WRONLY

public static final int O_WRONLY

See Also:

• Constant Field Values

O_RDWR

public static final int O_RDWR

See Also:

• Constant Field Values

O_CREAT

public static final int O_CREAT

See Also:

• Constant Field Values

O_TRUNC

public static final int O_TRUNC

See Also:

• Constant Field Values

O_APPEND

public static final int O_APPEND

See Also:

• Constant Field Values

ERRNOS

protected static final Map<AbstractEmuUnixSyscallUseropLibrary.Errno, Integer> ERRNOS

TODO: A map from simulator-defined errno to Linux-defined errno

TODO: These may be applicable to all Linux, not just amd64....

Constructor Details

AbstractEmuLinuxSyscallUseropLibrary

public AbstractEmuLinuxSyscallUseropLibrary(PcodeMachine<T> machine,
 EmuUnixFileSystem<T> fs,
 Program program)

Construct a new library

Parameters:

machine - the machine emulating the hardware

fs - the file system to export to the user-space program

program - a program containing the syscall definitions and conventions, likely the target program

AbstractEmuLinuxSyscallUseropLibrary

public AbstractEmuLinuxSyscallUseropLibrary(PcodeMachine<T> machine,
 EmuUnixFileSystem<T> fs,
 Program program,
 EmuUnixUser user)

Construct a new library

Parameters:

machine - the machine emulating the hardware

fs - the file system to export to the user-space program

program - a program containing the syscall definitions and conventions, likely the target program

user - the "current user" to simulate

Method Details

convertFlags

protected Set<EmuUnixFileSystem.OpenFlag> convertFlags(int flags)

Description copied from class: AbstractEmuUnixSyscallUseropLibrary

Convert the flags as defined for this platform to flags understood by the simulator

Specified by:

convertFlags in class AbstractEmuUnixSyscallUseropLibrary<T>

Parameters:

flags - the platform-defined flags

Returns:

the simulator-defined flags

getErrno

protected int getErrno(AbstractEmuUnixSyscallUseropLibrary.Errno err)

Description copied from class: AbstractEmuUnixSyscallUseropLibrary

Get the platform-specific errno value for the given simulator-defined errno

Specified by:

getErrno in class AbstractEmuUnixSyscallUseropLibrary<T>

Parameters:

err - the simulator-defined errno

Returns:

the platform-defined errno