Internal state for open files. More...

#include <semihosting.hh>

Inheritance diagram for ArmSemihosting::FileBase:

Public Member Functions
	FileBase (ArmSemihosting &_parent, const char name, const char _mode)

virtual	~FileBase ()

	FileBase ()=delete

	FileBase (FileBase &)=delete

void	serialize (CheckpointOut &cp) const override
	Serialize an object. More...

void	unserialize (CheckpointIn &cp) override
	Unserialize an object. More...

const std::string &	fileName ()


virtual int64_t	open ()
	Open the the file. More...

virtual int64_t	close ()
	Close the file. More...

virtual bool	isTTY () const
	Check if a file corresponds to a TTY device. More...

virtual int64_t	read (uint8_t *buffer, uint64_t size)
	Read data from file. More...

virtual int64_t	write (const uint8_t *buffer, uint64_t size)
	Write data to file. More...

virtual int64_t	seek (uint64_t pos)
	Seek to an absolute position in the file. More...

virtual int64_t	flen ()
	Get the length of a file in bytes. More...

Public Member Functions inherited from Serializable
	Serializable ()

virtual	~Serializable ()

void	serializeSection (CheckpointOut &cp, const char *name) const
	Serialize an object into a new section. More...

void	serializeSection (CheckpointOut &cp, const std::string &name) const

void	unserializeSection (CheckpointIn &cp, const char *name)
	Unserialize an a child object. More...

void	unserializeSection (CheckpointIn &cp, const std::string &name)

Static Public Member Functions
static std::unique_ptr< FileBase >	create (ArmSemihosting &parent, const std::string &fname, const char *mode)

static std::unique_ptr< FileBase >	create (ArmSemihosting &parent, CheckpointIn &cp, const std::string &sec)

Static Public Member Functions inherited from Serializable
static const std::string &	currentSection ()
	Gets the fully-qualified name of the active section. More...

static void	serializeAll (const std::string &cpt_dir)
	Serializes all the SimObjects. More...

static void	unserializeGlobals (CheckpointIn &cp)

Protected Attributes
ArmSemihosting &	parent

std::string	_name

std::string	mode

Detailed Description

Internal state for open files.

This class describes the internal state of a file opened through the semihosting interface.

A file instance is normally created using one of the ArmSemihosting::FileBase::create() factory methods. These methods handle some the magic file names in the Arm Semihosting specification and instantiate the right implementation. For the same, when unserializing a checkpoint, the create method must be used to unserialize a new instance of a file descriptor.

Definition at line 270 of file semihosting.hh.

Constructor & Destructor Documentation

◆ FileBase() [1/3]

ArmSemihosting::FileBase::FileBase	(	ArmSemihosting &	_parent,
		const char *	name,
		const char *	_mode
	)

inline

Definition at line 273 of file semihosting.hh.

◆ ~FileBase()

virtual ArmSemihosting::FileBase::~FileBase ( )

inlinevirtual

Definition at line 275 of file semihosting.hh.

◆ FileBase() [2/3]

ArmSemihosting::FileBase::FileBase ( )

delete

◆ FileBase() [3/3]

ArmSemihosting::FileBase::FileBase ( FileBase & )

delete

Member Function Documentation

◆ close()

virtual int64_t ArmSemihosting::FileBase::close ( )

inlinevirtual

Close the file.

Returns: <0 on error (-errno), 0 on success.

Reimplemented in ArmSemihosting::File.

Definition at line 314 of file semihosting.hh.

◆ create() [1/2]

std::unique_ptr< ArmSemihosting::FileBase > ArmSemihosting::FileBase::create	(	ArmSemihosting &	parent,
		CheckpointIn &	cp,
		const std::string &	sec
	)

static

Definition at line 770 of file semihosting.cc.

References Serializable::currentSection(), ArmISA::mode, and paramIn().

◆ create() [2/2]

std::unique_ptr< ArmSemihosting::FileBase > ArmSemihosting::FileBase::create	(	ArmSemihosting &	parent,
		const std::string &	fname,
		const char *	mode
	)

static

Definition at line 756 of file semihosting.cc.

References mode, and parent.

Referenced by ArmSemihosting::callOpen(), and ArmSemihosting::unserialize().

◆ fileName()

const std::string& ArmSemihosting::FileBase::fileName ( )

inline

Definition at line 289 of file semihosting.hh.

References _name.

◆ flen()

int64_t ArmSemihosting::FileBase::flen ( )

virtual

Get the length of a file in bytes.

Returns: <0 on error (-errno), length on success

Reimplemented in ArmSemihosting::File.

Definition at line 823 of file semihosting.cc.

◆ isTTY()

virtual bool ArmSemihosting::FileBase::isTTY ( ) const

inlinevirtual

Check if a file corresponds to a TTY device.

Returns: True if the file is a TTY, false otherwise.

Reimplemented in ArmSemihosting::File.

Definition at line 321 of file semihosting.hh.

◆ open()

virtual int64_t ArmSemihosting::FileBase::open ( )

inlinevirtual

Open the the file.

Semihosting file IO interfaces

These interfaces implement common IO functionality in the Semihosting interface.

All functions return a negative value that corresponds to a UNIX errno value when they fail and >=0 on success.

Returns: <0 on error (-errno), 0 on success.

Reimplemented in ArmSemihosting::File.

Definition at line 307 of file semihosting.hh.

◆ read()

int64_t ArmSemihosting::FileBase::read	(	uint8_t *	buffer,
		uint64_t	size
	)

virtual

Read data from file.

Returns: <0 on error (-errno), bytes read on success (0 for EOF).

Reimplemented in ArmSemihosting::File, and ArmSemihosting::FileFeatures.

Definition at line 805 of file semihosting.cc.

◆ seek()

int64_t ArmSemihosting::FileBase::seek ( uint64_t pos )

virtual

Seek to an absolute position in the file.

Parameters

pos	Byte offset from start of file.

Returns: <0 on error (-errno), 0 on success.

Reimplemented in ArmSemihosting::File, and ArmSemihosting::FileFeatures.

Definition at line 817 of file semihosting.cc.

◆ serialize()

void ArmSemihosting::FileBase::serialize ( CheckpointOut & cp ) const

overridevirtual

Serialize an object.

Output an object's state into the current checkpoint section.

Parameters

cp	Checkpoint state

Implements Serializable.

Reimplemented in ArmSemihosting::File, and ArmSemihosting::FileFeatures.

Definition at line 791 of file semihosting.cc.

References ArmISA::mode, paramOut(), and SERIALIZE_SCALAR.

Referenced by ArmSemihosting::FileFeatures::serialize(), and ArmSemihosting::File::serialize().

◆ unserialize()

void ArmSemihosting::FileBase::unserialize ( CheckpointIn & cp )

overridevirtual

Unserialize an object.

Read an object's state from the current checkpoint section.

Parameters

cp	Checkpoint state

Implements Serializable.

Reimplemented in ArmSemihosting::File, and ArmSemihosting::FileFeatures.

Definition at line 798 of file semihosting.cc.

Referenced by ArmSemihosting::FileFeatures::unserialize(), and ArmSemihosting::File::unserialize().

◆ write()

int64_t ArmSemihosting::FileBase::write	(	const uint8_t *	buffer,
		uint64_t	size
	)

virtual

Write data to file.

Returns: <0 on error (-errno), bytes written on success.

Reimplemented in ArmSemihosting::File.

Definition at line 811 of file semihosting.cc.

Member Data Documentation

◆ _name

std::string ArmSemihosting::FileBase::_name

protected

Definition at line 356 of file semihosting.hh.

Referenced by fileName().

◆ mode

std::string ArmSemihosting::FileBase::mode

protected

Definition at line 357 of file semihosting.hh.

Referenced by create().

◆ parent

ArmSemihosting& ArmSemihosting::FileBase::parent

protected

Definition at line 355 of file semihosting.hh.

Referenced by create().

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

arch/arm/semihosting.hh
arch/arm/semihosting.cc

Public Member Functions

Static Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ FileBase() [1/3]

◆ ~FileBase()

◆ FileBase() [2/3]

◆ FileBase() [3/3]

Member Function Documentation

◆ close()

◆ create() [1/2]

◆ create() [2/2]

◆ fileName()

◆ flen()

◆ isTTY()

◆ open()

◆ read()

◆ seek()

◆ serialize()

◆ unserialize()

◆ write()

Member Data Documentation

◆ _name

◆ mode

◆ parent