diff options
author | ru <ru@FreeBSD.org> | 2001-07-16 07:04:09 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2001-07-16 07:04:09 +0000 |
commit | a1e3fd29f6dd0f5375eee1decbfb2d74f99349bd (patch) | |
tree | c46a1ba63dcfa55e98aea472d69f095e48ae45ae | |
parent | 86220954fbe3c70e15036d5fbfa46a9715a9a955 (diff) | |
download | FreeBSD-src-a1e3fd29f6dd0f5375eee1decbfb2d74f99349bd.zip FreeBSD-src-a1e3fd29f6dd0f5375eee1decbfb2d74f99349bd.tar.gz |
Manpage for pfind() and zpfind().
Submitted by: Evan Sarmiento <kaworu@sektor7.ath.cx>
-rw-r--r-- | share/man/man9/Makefile | 3 | ||||
-rw-r--r-- | share/man/man9/pfind.9 | 85 |
2 files changed, 87 insertions, 1 deletions
diff --git a/share/man/man9/Makefile b/share/man/man9/Makefile index 20f3b47..517c6e5 100644 --- a/share/man/man9/Makefile +++ b/share/man/man9/Makefile @@ -50,7 +50,7 @@ MAN= BUF_LOCK.9 BUF_LOCKFREE.9 BUF_LOCKINIT.9 BUF_REFCNT.9 \ mi_switch.9 microseq.9 microtime.9 microuptime.9 \ module.9 mutex.9 \ namei.9 \ - panic.9 pfil.9 physio.9 posix4.9 printf.9 psignal.9 \ + panic.9 pfil.9 pfind.9 physio.9 posix4.9 printf.9 psignal.9 \ random.9 resettodr.9 resource_int_value.9 resource_query_string.9 \ rtalloc.9 rtentry.9 runqueue.9 \ sbuf.9 scheduler.9 sleep.9 sleepqueue.9 spl.9 store.9 \ @@ -128,6 +128,7 @@ MLINKS+=mi_switch.9 cpu_switch.9 mi_switch.9 cpu_throw.9 MLINKS+=namei.9 NDINIT.9 MLINKS+=namei.9 NDFREE.9 MLINKS+=pfil.9 pfil_hook_get.9 pfil.9 pfil_add_hook.9 pfil.9 pfil_remove_hook.9 +MLINKS+=pfind.9 zpfind.9 MLINKS+=posix4.9 p1003_1b.9 MLINKS+=psignal.9 gsignal.9 psignal.9 pgsignal.9 MLINKS+=random.9 srandom.9 random.9 arc4random.9 random.9 read_random.9 diff --git a/share/man/man9/pfind.9 b/share/man/man9/pfind.9 new file mode 100644 index 0000000..988b6f4 --- /dev/null +++ b/share/man/man9/pfind.9 @@ -0,0 +1,85 @@ +.\" Copyright (c) 2001 Evan Sarmiento. +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $FreeBSD$ +.\" +.Dd July 11, 2001 +.Os +.Dt PFIND 9 +.Sh NAME +.Nm pfind , zpfind +.Nd locate a process by number +.Sh SYNOPSIS +.In sys/proc.h +.Ft "struct proc *" +.Fn pfind "pid_t pid" +.Ft "struct proc *" +.Fn zpfind "pid_t pid" +.Sh DESCRIPTION +.Fn pfind +takes a +.Fa pid +as its argument and returns a pointer to the +.Vt proc +structure whose PID is specified in the argument only if the +.Fa pid +is on the +.Va allproc +list. +.Pp +.Fn zpfind +takes a +.Fa pid +as its argument. +If +.Fn zpfind +finds a process whose PID is equal to that of argument +and is a zombie process, meaning that it must reside on the +.Va zombproc +list, +.Fn zpfind +returns a pointer to that +.Vt proc +structure. +.Pp +Both +.Fn pfind +and +.Fn zpfind +lock the +.Vt proc +structure that is returned using +.Fn PROC_LOCK "p" . +.Sh RETURN VALUES +.Fn pfind +and +.Fn zpfind +return a pointer to a +.Vt proc +structure on success and a +.Dv NULL +on failure. +.Sh AUTHORS +This man page was written by +.An Evan Sarmiento Aq kaworu@sektor7.ath.cx . |