SyscallReturn Class Reference

This class represents the return value from an emulated system call, including any errno setting. More...

#include <syscall_return.hh>

Public Member Functions
	SyscallReturn (int64_t v)
	For simplicity, allow the object to be initialized with a single signed integer using the same positive=success, negative=-errno convention described above. More...
	SyscallReturn ()
	A SyscallReturn constructed with no value means don't return anything. More...
	~SyscallReturn ()
bool	successful () const
	Was the system call successful? More...
bool	needsRetry () const
	Does the syscall need to be retried? More...
bool	suppressed () const
	Should returning this value be suppressed? More...
int64_t	returnValue () const
	The return value. More...
int	errnoValue () const
	The errno value. More...
int64_t	encodedValue () const
	The encoded value (as described above) More...

Static Public Member Functions
static SyscallReturn	retry ()
	Pseudo-constructor to create an instance with the retry flag set. More...

Private Attributes
int64_t	value
bool	retryFlag = false
bool	suppressedFlag = false

Detailed Description

This class represents the return value from an emulated system call, including any errno setting.

On some platforms, the return value and errno are encoded in a single signed integer. A value less than zero but greater than -4096 indicates an error, and the value is the negation of the errno value. Otherwise, the call was successful and the integer is the return value. (Large negative numbers are considered successful to allow syscalls to return pointers to high memory, e.g., stack addresses.) See, for example, Appendix A of the AMD64 ABI spec at http://www.x86-64.org/documentation/abi.pdf.

Other platforms use a more complex interface, returning a value and an error code in separate registers.

This class is designed to support both types of interfaces.

Definition at line 54 of file syscall_return.hh.

Constructor & Destructor Documentation

SyscallReturn() [1/2]

SyscallReturn::SyscallReturn ( int64_t  v )

inline

For simplicity, allow the object to be initialized with a single signed integer using the same positive=success, negative=-errno convention described above.

Typically this constructor is used as a default type conversion, so a bare integer is used where a SyscallReturn value is expected, e.g., as the return value from a system call emulation function ('return 0;' or 'return -EFAULT;').

Definition at line 66 of file syscall_return.hh.

SyscallReturn() [2/2]

SyscallReturn::SyscallReturn ( )

inline

A SyscallReturn constructed with no value means don't return anything.

Definition at line 69 of file syscall_return.hh.

~SyscallReturn()

SyscallReturn::~SyscallReturn ( )

inline

Definition at line 80 of file syscall_return.hh.

Member Function Documentation

encodedValue()

int64_t SyscallReturn::encodedValue ( ) const

inline

The encoded value (as described above)

Definition at line 112 of file syscall_return.hh.

References value.

Referenced by SyscallDesc::doSyscall(), PowerProcess::setSyscallReturn(), RiscvProcess::setSyscallReturn(), X86ISA::X86Process::setSyscallReturn(), ArmProcess32::setSyscallReturn(), and ArmProcess64::setSyscallReturn().

errnoValue()

int SyscallReturn::errnoValue ( ) const

inline

The errno value.

Definition at line 105 of file syscall_return.hh.

References successful(), and value.

Referenced by AlphaProcess::setSyscallReturn(), MipsProcess::setSyscallReturn(), and SparcProcess::setSyscallReturn().

needsRetry()

bool SyscallReturn::needsRetry ( ) const

inline

Does the syscall need to be retried?

Definition at line 90 of file syscall_return.hh.

References retryFlag.

Referenced by SyscallDesc::doSyscall().

retry()

static SyscallReturn SyscallReturn::retry ( )

inlinestatic

Pseudo-constructor to create an instance with the retry flag set.

Definition at line 73 of file syscall_return.hh.

References retryFlag, and ArmISA::s.

Referenced by acceptFunc(), pollFunc(), readFunc(), selectFunc(), wait4Func(), and writeFunc().

returnValue()

int64_t SyscallReturn::returnValue ( ) const

inline

The return value.

Definition at line 97 of file syscall_return.hh.

References successful(), and value.

Referenced by AlphaProcess::setSyscallReturn(), MipsProcess::setSyscallReturn(), RiscvProcess::setSyscallReturn(), and SparcProcess::setSyscallReturn().

successful()

bool SyscallReturn::successful ( ) const

inline

Was the system call successful?

Definition at line 84 of file syscall_return.hh.

References value.

Referenced by errnoValue(), returnValue(), AlphaProcess::setSyscallReturn(), PowerProcess::setSyscallReturn(), RiscvProcess::setSyscallReturn(), MipsProcess::setSyscallReturn(), and SparcProcess::setSyscallReturn().

suppressed()

bool SyscallReturn::suppressed ( ) const

inline

Should returning this value be suppressed?

Definition at line 93 of file syscall_return.hh.

References suppressedFlag.

Referenced by SyscallDesc::doSyscall().

Member Data Documentation

retryFlag

bool SyscallReturn::retryFlag = false

private

Definition at line 117 of file syscall_return.hh.

Referenced by needsRetry(), and retry().

suppressedFlag

bool SyscallReturn::suppressedFlag = false

private

Definition at line 118 of file syscall_return.hh.

Referenced by suppressed().

value

int64_t SyscallReturn::value

private

Definition at line 115 of file syscall_return.hh.

Referenced by encodedValue(), errnoValue(), returnValue(), and successful().

---

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

• sim/syscall_return.hh