1708732f0SSascha Wildner.\" Copyright (c) 2001 Evan Sarmiento. 2708732f0SSascha Wildner.\" All rights reserved. 3708732f0SSascha Wildner.\" 4708732f0SSascha Wildner.\" Redistribution and use in source and binary forms, with or without 5708732f0SSascha Wildner.\" modification, are permitted provided that the following conditions 6708732f0SSascha Wildner.\" are met: 7708732f0SSascha Wildner.\" 1. Redistributions of source code must retain the above copyright 8708732f0SSascha Wildner.\" notice, this list of conditions and the following disclaimer. 9708732f0SSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright 10708732f0SSascha Wildner.\" notice, this list of conditions and the following disclaimer in the 11708732f0SSascha Wildner.\" documentation and/or other materials provided with the distribution. 12708732f0SSascha Wildner.\" 13708732f0SSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 14708732f0SSascha Wildner.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 15708732f0SSascha Wildner.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 16708732f0SSascha Wildner.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 17708732f0SSascha Wildner.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18708732f0SSascha Wildner.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19708732f0SSascha Wildner.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20708732f0SSascha Wildner.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21708732f0SSascha Wildner.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22708732f0SSascha Wildner.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23708732f0SSascha Wildner.\" SUCH DAMAGE. 24708732f0SSascha Wildner.\" 25708732f0SSascha Wildner.\" $FreeBSD: src/share/man/man9/pgfind.9,v 1.6 2010/04/14 19:08:06 uqs Exp $ 26708732f0SSascha Wildner.\" 27708732f0SSascha Wildner.Dd May 9, 2010 28708732f0SSascha Wildner.Dt PGFIND 9 29708732f0SSascha Wildner.Os 30708732f0SSascha Wildner.Sh NAME 31708732f0SSascha Wildner.Nm pgfind 32708732f0SSascha Wildner.Nd "locate a process group by number" 33708732f0SSascha Wildner.Sh SYNOPSIS 34708732f0SSascha Wildner.In sys/param.h 35708732f0SSascha Wildner.In sys/proc.h 36708732f0SSascha Wildner.Ft "struct pgrp *" 37708732f0SSascha Wildner.Fn pgfind "pid_t pgid" 38708732f0SSascha Wildner.Sh DESCRIPTION 39708732f0SSascha WildnerThe 40708732f0SSascha Wildner.Fn pgfind 41708732f0SSascha Wildnerfunction takes a 42708732f0SSascha Wildner.Fa pgid 43708732f0SSascha Wildneras its argument and returns a pointer to the 44708732f0SSascha Wildner.Vt pgrp 45708732f0SSascha Wildnerstructure whose 46708732f0SSascha Wildner.Va pg_id 47708732f0SSascha Wildneris specified in the argument. 48708732f0SSascha Wildner.\".Pp 49708732f0SSascha Wildner.\".Fn pgfind 50708732f0SSascha Wildner.\"locks the 51708732f0SSascha Wildner.\".Vt pgrp 52708732f0SSascha Wildner.\"structure that is returned. 53708732f0SSascha Wildner.Sh RETURN VALUES 54708732f0SSascha WildnerThe 55708732f0SSascha Wildner.Fn pgfind 56708732f0SSascha Wildnerfunction returns 57708732f0SSascha Wildner.Dv NULL 58708732f0SSascha Wildneron failure or a pointer to a 59708732f0SSascha Wildner.Vt pgrp 60708732f0SSascha Wildnerstructure on successful completion. 61708732f0SSascha Wildner.Sh SEE ALSO 62708732f0SSascha Wildner.Xr pfind 9 63708732f0SSascha Wildner.Sh AUTHORS 64708732f0SSascha WildnerThis manual page was written by 65*c616d378SFranco Fichtner.An Evan Sarmiento Aq Mt kaworu@sektor7.ath.cx . 66