2 .\" This file and its contents are supplied under the terms of the
3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
4 .\" You may only use this file in accordance with the terms of version
7 .\" A full copy of the text of the CDDL should have accompanied this
8 .\" source. A copy of the CDDL is also available via the Internet at
9 .\" http://www.illumos.org/license/CDDL.
12 .\" Copyright 2015 Joyent, Inc.
15 .Dt PFDINFO_ITER 3PROC
19 .Nd iterate open files in a process
26 .Fa "struct ps_prochandle *P"
27 .Fa "proc_fdinfo_f *func"
33 function iterates over the open files in the process represented by
36 For each open file, the callback function
38 will be invoked and it will be passed the
40 argument as well as a pointer to a
44 For the full signature of the
51 controls whether or not iteration continues.
56 then iteration will continue.
59 instead returns a non-zero value, then iteration will halt and that
60 value will be used as the return value of the
67 to an indicate its own errors, it is recommended that the callback
68 function does not return
70 to indicate an error so that the caller may distinguish between the
71 failure of the callback function and the failure of the
75 Upon successful completion, the
79 Otherwise, if there was an internal error then
82 Otherwise, if the callback function
84 returns non-zero, then its return value will be returned instead.
85 .Sh INTERFACE STABILITY