.\" Copyright (c) 1992 The Regents of the University of California.
.\" %sccs.include.redist.man%
.\" @(#)kvm_getprocs.3 5.1 (Berkeley) %G%
.Nd access user process state
.Fd #include <sys/kinfo.h>
.Fd #include <sys/kinfo_proc.h>
.Fn kvm_getprocs "kvm_t *kd" "int op" "int arg" "int *cnt"
.Fn kvm_getargv "kvm_t *kd" "const struct kinfo_proc *p" "int nchr"
.Fn kvm_getargv "kvm_t *kd" "const struct kinfo_proc *p" "int nchr"
returns a (sub-)set of active processes in the kernel indicated by
arguments constitute a predicate which limits the set of processes
describes the filtering predicate as follows:
.Bl -tag -width 20n -offset indent -compact
processes with process id
processes with process group
.It Sy KINFO_PROC_SESSION
processes with effective user id
processes with real user id
The number of processes found is returned in the reference parameter
The processes are returned as a contiguous array of kinfo_proc structures.
This memory is owned by kvm and is not guaranteed to be persistent across
subsequent kvm library calls. Data should be copied out if it needs to be
returns an null-terminated argument vector that corresponds to the
command line arguments passed to process indicated by
Most likely, these arguments correspond to the values passed to
on process creation. However, this information exists only the
process address space, and is therefore alterable by the process
itself. Note that the original command name can be found, unaltered,
in the p_comm field of the process structure returned by
argument indicates the maximum number of characters, including null bytes,
to use in building the strings. If this amount is exceeded, the string
causing the overflow is truncated and the partial result is returned.
This is handy for programs like
that print only a one line summary of a command and should copy
out large numbers arguments that will not be printed.
The memory allocated to the argv pointers as well as the string storage
are owned by the kvm library. Data must be copied out of this
structure before calling another kvm function.
but returns the vector of environment strings. This is data is
also alterable by the process.
all return NULL on failure.
These routines do not belong in the kvm interface.