19bda7d94SCeri Davies.\" 29bda7d94SCeri Davies.\" Copyright (c) 2003 Joseph Koshy <jkoshy@freebsd.org> 39bda7d94SCeri Davies.\" Copyright (c) 2006 Ceri Davies <ceri@FreeBSD.org> 49bda7d94SCeri Davies.\" 59bda7d94SCeri Davies.\" All rights reserved. 69bda7d94SCeri Davies.\" 79bda7d94SCeri Davies.\" Redistribution and use in source and binary forms, with or without 89bda7d94SCeri Davies.\" modification, are permitted provided that the following conditions 99bda7d94SCeri Davies.\" are met: 109bda7d94SCeri Davies.\" 1. Redistributions of source code must retain the above copyright 119bda7d94SCeri Davies.\" notice, this list of conditions and the following disclaimer. 129bda7d94SCeri Davies.\" 2. Redistributions in binary form must reproduce the above copyright 139bda7d94SCeri Davies.\" notice, this list of conditions and the following disclaimer in the 149bda7d94SCeri Davies.\" documentation and/or other materials provided with the distribution. 159bda7d94SCeri Davies.\" 169bda7d94SCeri Davies.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR 179bda7d94SCeri Davies.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 189bda7d94SCeri Davies.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 199bda7d94SCeri Davies.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, 209bda7d94SCeri Davies.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 219bda7d94SCeri Davies.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 229bda7d94SCeri Davies.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 239bda7d94SCeri Davies.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 249bda7d94SCeri Davies.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 259bda7d94SCeri Davies.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 269bda7d94SCeri Davies.\" 279bda7d94SCeri Davies.\" $FreeBSD$ 289bda7d94SCeri Davies.\" 299bda7d94SCeri Davies.Dd November 19, 2006 309bda7d94SCeri Davies.Dt P_CANSEE 9 31*aa12cea2SUlrich Spörlein.Os 329bda7d94SCeri Davies.Sh NAME 339bda7d94SCeri Davies.Nm p_cansee 349bda7d94SCeri Davies.Nd determine visibility of a process 359bda7d94SCeri Davies.Sh SYNOPSIS 369bda7d94SCeri Davies.In sys/param.h 379bda7d94SCeri Davies.In sys/proc.h 389bda7d94SCeri Davies.Ft int 399bda7d94SCeri Davies.Fn p_cansee "struct thread *td" "struct proc *p" 409bda7d94SCeri Davies.Sh DESCRIPTION 419bda7d94SCeri DaviesThis function can be used to determine if a given process 429bda7d94SCeri Davies.Fa p 439bda7d94SCeri Daviesis visible to the thread 449bda7d94SCeri Davies.Fa td , 459bda7d94SCeri Davieswhere the notion of 469bda7d94SCeri Davies.Dq visibility 479bda7d94SCeri Daviesmay be read as 489bda7d94SCeri Davies.Dq "awareness of existence" . 499bda7d94SCeri Davies.Pp 509bda7d94SCeri DaviesThe function is implemented using 519bda7d94SCeri Davies.Xr cr_cansee 9 , 529bda7d94SCeri Daviesand the dependencies on 539bda7d94SCeri Davies.Xr sysctl 8 549bda7d94SCeri Daviesvariables documented in the 559bda7d94SCeri Davies.Xr cr_cansee 9 569bda7d94SCeri Daviesmanual page apply. 579bda7d94SCeri Davies.Sh RETURN VALUES 589bda7d94SCeri DaviesThe 599bda7d94SCeri Davies.Fn p_cansee 609bda7d94SCeri Daviesfunction 619bda7d94SCeri Daviesreturns 629bda7d94SCeri Davies.Li 0 639bda7d94SCeri Daviesif the process denoted by 649bda7d94SCeri Davies.Fa p 659bda7d94SCeri Daviesis visible by thread 669bda7d94SCeri Davies.Fa td , 679bda7d94SCeri Daviesor a non-zero error return value otherwise. 689bda7d94SCeri Davies.Sh ERRORS 699bda7d94SCeri Davies.Bl -tag -width Er 709bda7d94SCeri Davies.It Bq Er ESRCH 719bda7d94SCeri DaviesProcess 729bda7d94SCeri Davies.Fa p 739bda7d94SCeri Daviesis not visible to thread 749bda7d94SCeri Davies.Fa td 759bda7d94SCeri Daviesas determined by 769bda7d94SCeri Davies.Xr cr_cansee 9 . 779bda7d94SCeri Davies.It Bq Er ESRCH 789bda7d94SCeri DaviesThread 799bda7d94SCeri Davies.Fa td 809bda7d94SCeri Davieshas been jailed and process 819bda7d94SCeri Davies.Fa p 829bda7d94SCeri Daviesdoes not belong to the same jail as 839bda7d94SCeri Davies.Fa td . 849bda7d94SCeri Davies.It Bq Er ESRCH 859bda7d94SCeri DaviesThe MAC subsystem denied visibility. 869bda7d94SCeri Davies.El 879bda7d94SCeri Davies.Sh SEE ALSO 889bda7d94SCeri Davies.Xr jail 2 , 899bda7d94SCeri Davies.Xr sysctl 8 , 909bda7d94SCeri Davies.Xr cr_cansee 9 , 919bda7d94SCeri Davies.Xr mac 9 , 929bda7d94SCeri Davies.Xr p_candebug 9 , 939bda7d94SCeri Davies.Xr prison_check 9 94