387501219e
- Rewrite arch.Stack.{Push,Pop}. For the most part, stack now
implements marshal.CopyContext and can be used as the target of
marshal operations. Stack.Push had some extra logic for
automatically null-terminating slices. This was only used for two
specific types of slices, and is now handled explicitly.
- Delete usermem.CopyObject{In,Out}.
- Replace most remaining uses of the encoding/binary package with
go-marshal. Most of these were using the binary package to compute
the size of a struct, which go-marshal can directly replace. ~3 uses
of the binary package remain. These aren't reasonably replaceable by
go-marshal: for example one use is to construct the syscall
trampoline for systrap.
- Fill out remaining convenience wrappers in the primitive package.
PiperOrigin-RevId: 334502375
|
||
|---|---|---|
| .. | ||
| BUILD | ||
| README.md | ||
| access_type.go | ||
| addr.go | ||
| addr_range_seq_test.go | ||
| addr_range_seq_unsafe.go | ||
| bytes_io.go | ||
| bytes_io_unsafe.go | ||
| usermem.go | ||
| usermem_arm64.go | ||
| usermem_test.go | ||
| usermem_x86.go | ||
README.md
This package defines primitives for sentry access to application memory.
Major types:
-
The
IOinterface represents a virtual address space and provides I/O methods on that address space.IOis the lowest-level primitive. The primary implementation of theIOinterface ismm.MemoryManager. -
IOSequencerepresents a collection of individually-contiguous address ranges in aIOthat is operated on sequentially, analogous to Linux'sstruct iov_iter.
Major usage patterns:
-
Access to a task's virtual memory, subject to the application's memory protections and while running on that task's goroutine, from a context that is at or above the level of the
kernelpackage (e.g. most syscall implementations insyscalls/linux); use thekernel.Task.Copy*wrappers defined inkernel/task_usermem.go. -
Access to a task's virtual memory, from a context that is at or above the level of the
kernelpackage, but where any of the above constraints does not hold (e.g.PTRACE_POKEDATA, which ignores application memory protections); obtain the task'smm.MemoryManagerby callingkernel.Task.MemoryManager, and call itsIOmethods directly. -
Access to a task's virtual memory, from a context that is below the level of the
kernelpackage (e.g. filesystem I/O); clients must pass I/O arguments from higher layers, usually in the form of anIOSequence. Thekernel.Task.SingleIOSequenceandkernel.Task.IovecsIOSequencefunctions inkernel/task_usermem.goare convenience functions for doing so.