semihosting

Documentation

Overview

Package semihosting implements parts of the ARM semihosting specification, for communicating over a debug connection.

If you want to use it in OpenOCD, you have to enable it first with the following command:

arm semihosting enable

Index

• Variables
• func Write(fd uintptr, data []byte) error
• type File
  • func (f *File) Write(buf []byte) error
• type IOError
  • func (e *IOError) Error() string

Variables

var (
	Stdin  = File{/* contains filtered or unexported fields */}
	Stdout = File{/* contains filtered or unexported fields */}
	Stderr = File{/* contains filtered or unexported fields */}
)

These three file descriptors are connected to the host stdin/stdout/stderr, and can be used for logging.

Functions

func Write

func Write(fd uintptr, data []byte) error

Write writes the given data to the given file descriptor. It returns an *IOError if the write was not successful.

Types

type File

type File struct {
	// contains filtered or unexported fields
}

File represents a semihosting file descriptor.

func (*File) Write

func (f *File) Write(buf []byte) error

Write writes the given data buffer to the file descriptor, returning an error if the write could not complete successfully.

type IOError

type IOError struct {
	BytesWritten int
}

IOError is returned by I/O operations when they fail.

func (*IOError) Error

func (e *IOError) Error() string