ptrace

package

v0.0.0-...-38845ac Latest Latest Go to latest Published: Jul 13, 2022 License: MIT Imports: 7 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/souk4711/gsandbox

Documentation ¶

Rendered for

Index ¶

func Trace(pid int, handler TracerHandler)
type Fd
- func (fd Fd) String() string
type FlagFcntlCmd
- func (f FlagFcntlCmd) String() string
type FlagFcntlCmdStringer
- func (i FlagFcntlCmdStringer) String() string
type FlagOpen
- func (f FlagOpen) String() string
type FlagOpenStringer
- func (i FlagOpenStringer) String() string
type ParamType
- func (i ParamType) String() string
type Syscall
- func GetSyscall(pid int) (*Syscall, error)
- func (c *Syscall) GetArg(pos int) *SyscallArg
- func (c *Syscall) GetArgs() []*SyscallArg
- func (c *Syscall) GetNR() uint
- func (c *Syscall) GetName() string
- func (c *Syscall) GetRetval() *SyscallRetval
- func (c *Syscall) ReadArgs() error
- func (c *Syscall) ReadRetval() error
type SyscallArg
- func (a *SyscallArg) GetFd() int
- func (a *SyscallArg) GetFlag() int
- func (a *SyscallArg) GetInt() int
- func (a *SyscallArg) GetPath() string
- func (a *SyscallArg) GetPipeFd() []int
- func (a *SyscallArg) IsParamType(t ParamType) bool
- func (a *SyscallArg) String() string
type SyscallRetval
- func (r *SyscallRetval) GetErrno() syscall.Errno
- func (r *SyscallRetval) GetValue() int
- func (r *SyscallRetval) HasError() bool
- func (r *SyscallRetval) HasError_ENOSYS() bool
- func (r *SyscallRetval) String() string
type SyscallSignature
type Tracee
type Tracer
type TracerHandler

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Trace ¶

func Trace(pid int, handler TracerHandler)

Types ¶

type Fd ¶

type Fd int

func (Fd) String ¶

func (fd Fd) String() string

type FlagFcntlCmd ¶

type FlagFcntlCmd int

func (FlagFcntlCmd) String ¶

func (f FlagFcntlCmd) String() string

type FlagFcntlCmdStringer ¶

type FlagFcntlCmdStringer int

const (
	F_DUPFD         FlagFcntlCmdStringer = unix.F_DUPFD
	F_GETFD         FlagFcntlCmdStringer = unix.F_GETFD
	F_SETFD         FlagFcntlCmdStringer = unix.F_SETFD
	F_GETFL         FlagFcntlCmdStringer = unix.F_GETFL
	F_SETFL         FlagFcntlCmdStringer = unix.F_SETFL
	F_GETLK         FlagFcntlCmdStringer = unix.F_GETLK
	F_SETLK         FlagFcntlCmdStringer = unix.F_SETLK
	F_SETLKW        FlagFcntlCmdStringer = unix.F_SETLKW
	F_SETOWN        FlagFcntlCmdStringer = unix.F_SETOWN
	F_GETOWN        FlagFcntlCmdStringer = unix.F_GETOWN
	F_SETSIG        FlagFcntlCmdStringer = unix.F_SETSIG
	F_GETSIG        FlagFcntlCmdStringer = unix.F_GETSIG
	F_SETOWN_EX     FlagFcntlCmdStringer = unix.F_SETOWN_EX
	F_GETOWN_EX     FlagFcntlCmdStringer = unix.F_GETOWN_EX
	F_DUPFD_CLOEXEC FlagFcntlCmdStringer = unix.F_DUPFD_CLOEXEC
	F_SETPIPE_SZ    FlagFcntlCmdStringer = unix.F_SETPIPE_SZ
	F_GETPIPE_SZ    FlagFcntlCmdStringer = unix.F_GETPIPE_SZ
)

https://man7.org/linux/man-pages/man3/fcntl.3p.html

func (FlagFcntlCmdStringer) String ¶

func (i FlagFcntlCmdStringer) String() string

type FlagOpen ¶

type FlagOpen int

func (FlagOpen) String ¶

func (f FlagOpen) String() string

type FlagOpenStringer ¶

type FlagOpenStringer int

const (
	O_APPEND   FlagOpenStringer = unix.O_APPEND
	O_ASYNC    FlagOpenStringer = unix.O_ASYNC
	O_CLOEXEC  FlagOpenStringer = unix.O_CLOEXEC
	O_CREAT    FlagOpenStringer = unix.O_CREAT
	O_DIRECT   FlagOpenStringer = unix.O_DIRECT
	O_DSYNC    FlagOpenStringer = unix.O_DSYNC
	O_EXCL     FlagOpenStringer = unix.O_EXCL
	O_NOATIME  FlagOpenStringer = unix.O_NOATIME
	O_NOCTTY   FlagOpenStringer = unix.O_NOCTTY
	O_NONBLOCK FlagOpenStringer = unix.O_NONBLOCK
	O_PATH     FlagOpenStringer = unix.O_PATH
	O_SYNC     FlagOpenStringer = unix.O_SYNC
	O_TMPFILE  FlagOpenStringer = unix.O_TMPFILE
	O_TRUNC    FlagOpenStringer = unix.O_TRUNC
	O_RDONLY   FlagOpenStringer = unix.O_RDONLY
	O_WRONLY   FlagOpenStringer = unix.O_WRONLY
	O_RDWR     FlagOpenStringer = unix.O_RDWR
)

https://man7.org/linux/man-pages/man2/open.2.html

func (FlagOpenStringer) String ¶

func (i FlagOpenStringer) String() string

type ParamType ¶

type ParamType int

Syscall param

const (
	ParamTypeAny          ParamType = iota // placeholder
	ParamTypeInt                           // int
	ParamTypePath                          // a pointer to char* path
	ParamTypePipeFd                        // int pipefd[2]
	ParamTypeFd                            // int fd
	ParamTypeFlagOpen                      // flag for #open
	ParamTypeFlagFnctlCmd                  // cmd for #fnctl

)

Syscall param - all available values

func (ParamType) String ¶

func (i ParamType) String() string

type Syscall ¶

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

Syscall func

func GetSyscall ¶

func GetSyscall(pid int) (*Syscall, error)

func (*Syscall) GetArg ¶

func (c *Syscall) GetArg(pos int) *SyscallArg

Syscall func - attr reader for arg in specified postion

func (*Syscall) GetArgs ¶

func (c *Syscall) GetArgs() []*SyscallArg

Syscall func - attr reader for args

func (*Syscall) GetNR ¶

func (c *Syscall) GetNR() uint

Syscall func - attr reader for nr

func (*Syscall) GetName ¶

func (c *Syscall) GetName() string

Syscall func - attr reader for name

func (*Syscall) GetRetval ¶

func (c *Syscall) GetRetval() *SyscallRetval

Syscall func - attr reader for retval

func (*Syscall) ReadArgs ¶

func (c *Syscall) ReadArgs() error

Syscall func - read all args value from register

func (*Syscall) ReadRetval ¶

func (c *Syscall) ReadRetval() error

Syscall func - read retval value from register

type SyscallArg ¶

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

Syscall arg

func (*SyscallArg) GetFd ¶

func (a *SyscallArg) GetFd() int

Syscall arg - convert value to Fd

func (*SyscallArg) GetFlag ¶

func (a *SyscallArg) GetFlag() int

Syscall arg - convert value to Flag

func (*SyscallArg) GetInt ¶

func (a *SyscallArg) GetInt() int

Syscall arg - convert value to int

func (*SyscallArg) GetPath ¶

func (a *SyscallArg) GetPath() string

Syscall arg - convert value to Path

func (*SyscallArg) GetPipeFd ¶

func (a *SyscallArg) GetPipeFd() []int

Syscall arg - convert value to PipeFd

func (*SyscallArg) IsParamType ¶

func (a *SyscallArg) IsParamType(t ParamType) bool

Syscall arg - check param type

func (*SyscallArg) String ¶

func (a *SyscallArg) String() string

Syscall func - interface Stringer

type SyscallRetval ¶

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

Syscall retval

func (*SyscallRetval) GetErrno ¶

func (r *SyscallRetval) GetErrno() syscall.Errno

Syscall retval - attr reader for errno

func (*SyscallRetval) GetValue ¶

func (r *SyscallRetval) GetValue() int

Syscall retval - attr reader for value

func (*SyscallRetval) HasError ¶

func (r *SyscallRetval) HasError() bool

Syscall retval - check errno

func (*SyscallRetval) HasError_ENOSYS ¶

func (r *SyscallRetval) HasError_ENOSYS() bool

Syscall retval - check errno ENOSYS

func (*SyscallRetval) String ¶

func (r *SyscallRetval) String() string

Syscall retval - interface Stringer

type SyscallSignature ¶

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

Syscall func signature

type Tracee ¶

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

type Tracer ¶

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

type TracerHandler ¶

type TracerHandler interface {
	HandleTracerLogging(pid int, msg string)                                              // logging
	HandleTracerPanicEvent(err error)                                                     // panic
	HandleTracerExitedEvent(pid int, ws syscall.WaitStatus, rusage syscall.Rusage)        // ws.Exited()
	HandleTracerSignaledEvent(pid int, ws syscall.WaitStatus, rusage syscall.Rusage)      // ws.Signaled()
	HandleTracerNewChildEvent(pid int, childPid int)                                      // PTRACE_EVENT_CLONE
	HandleTracerSyscallEnterEvent(pid int, curr *Syscall) (continued bool)                // when syscall enter
	HandleTracerSyscallLeaveEvent(pid int, curr *Syscall, prev *Syscall) (continued bool) // when syscall leave
}

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL