libproc.go

// SPDX-FileCopyrightText: 2021 The Go Darwin Authors
// SPDX-License-Identifier: BSD-3-Clause

//go:build darwin && amd64 && gc
// +build darwin,amd64,gc

package libproc

import (
	_ "runtime" // for go:linkname
	"unsafe"

	"golang.org/x/sys/unix"

	"github.com/go-darwin/sys"
)

// ProcListallpids retursn the list all pids.
func ProcListallpids() (numPids int, err error) {
	r1, _, kret := procListallpids()
	if sys.KernReturn(kret) != sys.KernSuccess {
		return 0, sys.KernErrno(sys.KernReturn(kret))
	}

	numPids = int(r1 / sys.Sizeof_C_int)
	return
}

//go:nosplit
func procListallpids() (r1, r2 uintptr, err unix.Errno) {
	return sys.Syscall(libc_proc_listallpids_trampoline_addr, uintptr(0), uintptr(0), uintptr(0))
}

var libc_proc_listallpids_trampoline_addr uintptr

//go:cgo_import_dynamic libc_proc_listallpids proc_listallpids "/usr/lib/libproc.dylib"

// ProcPidpath given a pid, returns the full executable name including directory
// paths and the longer-than-16-chars executable name.
func ProcPidpath(pid PID) (path string, err error) {
	buffer := make([]byte, ProcPidpathinfoSize)
	_, _, kret := procPidpath(pid, unsafe.Pointer(&buffer[0]), uint32(ProcPidpathinfoMaxsize))
	if sys.KernReturn(kret) != sys.KernSuccess {
		return "", sys.KernErrno(sys.KernReturn(kret))
	}

	path = sys.GoString(&buffer[0])
	return
}

//go:nosplit
func procPidpath(pid PID, buffer unsafe.Pointer, buffersize uint32) (r1, r2 uintptr, err unix.Errno) {
	return sys.Syscall(libc_proc_pidpath_trampoline_addr, uintptr(pid), uintptr(buffer), uintptr(buffersize))
}

var libc_proc_pidpath_trampoline_addr uintptr

//go:cgo_import_dynamic libc_proc_pidpath proc_pidpath "/usr/lib/libproc.dylib"

// $ pushd internal/gen > /dev/null 2>&1; go run main.go -fname /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include/libproc.h; popd > /dev/null 2>&1
// TODO(zchee): int proc_listpidspath(uint32_t type, uint32_t typeinfo, const char * path, uint32_t pathflags, void * buffer, int buffersize)
// TODO(zchee): int proc_listpids(uint32_t type, uint32_t typeinfo, void * buffer, int buffersize)
// TODO(zchee): int proc_listpgrppids(pid_t pgrpid, void * buffer, int buffersize)
// TODO(zchee): int proc_listchildpids(pid_t ppid, void * buffer, int buffersize)
// TODO(zchee): int proc_pidinfo(int pid, int flavor, uint64_t arg, void * buffer, int buffersize)
// TODO(zchee): int proc_pidfdinfo(int pid, int fd, int flavor, void * buffer, int buffersize)
// TODO(zchee): int proc_pidfileportinfo(int pid, uint32_t fileport, int flavor, void * buffer, int buffersize)
// TODO(zchee): int proc_name(int pid, void * buffer, uint32_t buffersize)
// TODO(zchee): int proc_regionfilename(int pid, uint64_t address, void * buffer, uint32_t buffersize)
// TODO(zchee): int proc_kmsgbuf(void * buffer, uint32_t buffersize)
// TODO(zchee): int proc_pidpath_audittoken(audit_token_t * audittoken, void * buffer, uint32_t buffersize)
// TODO(zchee): int proc_libversion(int * major, int * minor)
// TODO(zchee): int proc_pid_rusage(int pid, int flavor, rusage_info_t * buffer)
// TODO(zchee): int proc_setpcontrol(const int control)
// TODO(zchee): int proc_setpcontrol(const int control)
// TODO(zchee): int proc_track_dirty(pid_t pid, uint32_t flags)
// TODO(zchee): int proc_set_dirty(pid_t pid, _Bool dirty)
// TODO(zchee): int proc_get_dirty(pid_t pid, uint32_t * flags)
// TODO(zchee): int proc_clear_dirty(pid_t pid, uint32_t flags)
// TODO(zchee): int proc_terminate(pid_t pid, int * sig)
// TODO(zchee): int proc_set_no_smt()
// TODO(zchee): int proc_setthread_no_smt()
// TODO(zchee): int proc_set_csm(uint32_t flags)
// TODO(zchee): int proc_setthread_csm(uint32_t flags)
// TODO(zchee): int proc_udata_info(int pid, int flavor, void * buffer, int buffersize)