RC_FIND_PIDS
Section: C Library Functions (3)
Updated: SMM
Page Index
BSD mandoc
OpenRC
NAME
rc_find_pids
- finds the pids of processes that match the given criteria
LIBRARY
Run Command library (librc, -lrc)
SYNOPSIS
In rc.h
Ft RC_PIDLIST * Fo rc_find_pids
Fa const char *const *argv
Fa const char *cmd
Fa uid_t uid
Fa pid_t pid
Fc
DESCRIPTION
Fn rc_find_pids
returns RC_PIDLIST, a structure based on the LIST macro from
queue(3)
which contains all the pids found matching the given criteria.
If
Fa pid
is given then only that pid is returned if it is running. Otherise we check
all instances of
Fa argv
with a process name of
Fa cmd
owned by
Fa uid ,
all of which are optional.
The returned list should be freed when done.
IMPLEMENTATION NOTES
On BSD systems we use
Lb libkvm
and on Linux systems we use the
/proc
filesystem to find our processes.
Each RC_PID should be freed in the list as well as the list itself when done.
SEE ALSO
free(3),
queue(3)
AUTHORS
An Roy Marples <
roy@marples.name>