table of contents
KVM_GETPROCS(3) | Library Functions Manual | KVM_GETPROCS(3) |
NAME¶
kvm_getprocs, kvm_getargv, kvm_getenvv — access user process stateLIBRARY¶
Kernel Data Access Library (libkvm, -lkvm)SYNOPSIS¶
#include <kvm.h>#include <sys/param.h>
#include <sys/sysctl.h>
#include <sys/user.h> struct kinfo_proc *
kvm_getprocs(kvm_t *kd, int op, int arg, int *cnt); char **
kvm_getargv(kvm_t *kd, const struct kinfo_proc *p, int nchr); char **
kvm_getenvv(kvm_t *kd, const struct kinfo_proc *p, int nchr);
DESCRIPTION¶
The kvm_getprocs() function returns a (sub-)set of active processes in the kernel indicated by kd. The op and arg arguments constitute a predicate which limits the set of processes returned. The value of op describes the filtering predicate as follows:KERN_PROC_ALL
- all processes and kernel visible threads
KERN_PROC_PROC
- all processes, without threads
KERN_PROC_PID
- processes with process ID arg
KERN_PROC_PGRP
- processes with process group arg
KERN_PROC_SESSION
- processes with session arg
KERN_PROC_TTY
- processes with TTY arg
KERN_PROC_UID
- processes with effective user ID arg
KERN_PROC_RUID
- processes with real user ID arg
KERN_PROC_INC_THREAD
- modifier to return all kernel visible threads when filtering by process ID, process group, TTY, user ID, and real user ID
RETURN VALUES¶
The kvm_getprocs(), kvm_getargv(), and kvm_getenvv() functions returnNULL
on failure.
SEE ALSO¶
kvm(3), kvm_close(3), kvm_geterr(3), kvm_nlist(3), kvm_open(3), kvm_openfiles(3), kvm_read(3), kvm_write(3)BUGS¶
These routines do not belong in the kvm interface. In order for kvm_getenvv(3) to function correctly, procfs(5) must be mounted on /proc.September 27, 2003 | Debian |