11eaf0ac3Slogwang.\" 21eaf0ac3Slogwang.\" Copyright (c) 2009 Ulf Lilleengen 31eaf0ac3Slogwang.\" All rights reserved. 41eaf0ac3Slogwang.\" 51eaf0ac3Slogwang.\" Redistribution and use in source and binary forms, with or without 61eaf0ac3Slogwang.\" modification, are permitted provided that the following conditions 71eaf0ac3Slogwang.\" are met: 81eaf0ac3Slogwang.\" 1. Redistributions of source code must retain the above copyright 91eaf0ac3Slogwang.\" notice, this list of conditions and the following disclaimer. 101eaf0ac3Slogwang.\" 2. Redistributions in binary form must reproduce the above copyright 111eaf0ac3Slogwang.\" notice, this list of conditions and the following disclaimer in the 121eaf0ac3Slogwang.\" documentation and/or other materials provided with the distribution. 131eaf0ac3Slogwang.\" 141eaf0ac3Slogwang.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 151eaf0ac3Slogwang.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 161eaf0ac3Slogwang.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 171eaf0ac3Slogwang.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 181eaf0ac3Slogwang.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 191eaf0ac3Slogwang.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 201eaf0ac3Slogwang.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 211eaf0ac3Slogwang.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 221eaf0ac3Slogwang.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 231eaf0ac3Slogwang.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 241eaf0ac3Slogwang.\" SUCH DAMAGE. 251eaf0ac3Slogwang.\" 261eaf0ac3Slogwang.\" $FreeBSD$ 271eaf0ac3Slogwang.\" 28*22ce4affSfengbojiang.Dd May 10, 2020 291eaf0ac3Slogwang.Dt KINFO_GETPROC 3 301eaf0ac3Slogwang.Os 311eaf0ac3Slogwang.Sh NAME 321eaf0ac3Slogwang.Nm kinfo_getproc 331eaf0ac3Slogwang.Nd function for getting process information from kernel 341eaf0ac3Slogwang.Sh LIBRARY 351eaf0ac3Slogwang.Lb libutil 361eaf0ac3Slogwang.Sh SYNOPSIS 371eaf0ac3Slogwang.In sys/types.h 381eaf0ac3Slogwang.In sys/user.h 391eaf0ac3Slogwang.In libutil.h 401eaf0ac3Slogwang.Ft struct kinfo_proc * 411eaf0ac3Slogwang.Fn kinfo_getproc "pid_t pid" 421eaf0ac3Slogwang.Sh DESCRIPTION 431eaf0ac3SlogwangThis function is used for obtaining process information from the kernel. 441eaf0ac3Slogwang.Pp 451eaf0ac3SlogwangThe 461eaf0ac3Slogwang.Ar pid 471eaf0ac3Slogwangfield contains the process identifier. 481eaf0ac3SlogwangThis should be a process that you have privilege to access. 491eaf0ac3SlogwangThis function is a wrapper around 501eaf0ac3Slogwang.Xr sysctl 3 511eaf0ac3Slogwangwith the 521eaf0ac3Slogwang.Dv KERN_PROC_PID 531eaf0ac3Slogwangmib. 541eaf0ac3SlogwangWhile the kernel returns a packed structure, this function expands the 551eaf0ac3Slogwangdata into a fixed record format. 561eaf0ac3Slogwang.Sh RETURN VALUES 571eaf0ac3SlogwangOn success the 581eaf0ac3Slogwang.Fn kinfo_getproc 591eaf0ac3Slogwangfunction returns a pointer to a 601eaf0ac3Slogwang.Vt struct kinfo_proc 611eaf0ac3Slogwangstructure as defined by 621eaf0ac3Slogwang.In sys/user.h . 631eaf0ac3SlogwangThe pointer was obtained by an internal call to 641eaf0ac3Slogwang.Xr malloc 3 651eaf0ac3Slogwangand must be freed by the caller with a call to 661eaf0ac3Slogwang.Xr free 3 . 671eaf0ac3SlogwangOn failure the 681eaf0ac3Slogwang.Fn kinfo_getproc 691eaf0ac3Slogwangfunction returns 701eaf0ac3Slogwang.Dv NULL . 711eaf0ac3Slogwang.Sh SEE ALSO 721eaf0ac3Slogwang.Xr free 3 , 731eaf0ac3Slogwang.Xr malloc 3 , 741eaf0ac3Slogwang.Xr sysctl 3 75*22ce4affSfengbojiang.Sh HISTORY 76*22ce4affSfengbojiangThe 77*22ce4affSfengbojiang.Fn kinfo_getproc 78*22ce4affSfengbojiangfunction first appeared in 79*22ce4affSfengbojiang.Fx 7.0 . 80