kvm_getfiles.3 (112539) | kvm_getfiles.3 (131504) |
---|---|
1.\" Copyright (c) 1992, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software developed by the Computer Systems 5.\" Engineering group at Lawrence Berkeley Laboratory under DARPA contract 6.\" BG 91-66 and contributed to Berkeley. 7.\" 8.\" Redistribution and use in source and binary forms, with or without --- 20 unchanged lines hidden (view full) --- 29.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 30.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 31.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 32.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 33.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 34.\" SUCH DAMAGE. 35.\" 36.\" @(#)kvm_getfiles.3 8.2 (Berkeley) 4/19/94 | 1.\" Copyright (c) 1992, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software developed by the Computer Systems 5.\" Engineering group at Lawrence Berkeley Laboratory under DARPA contract 6.\" BG 91-66 and contributed to Berkeley. 7.\" 8.\" Redistribution and use in source and binary forms, with or without --- 20 unchanged lines hidden (view full) --- 29.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 30.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 31.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 32.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 33.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 34.\" SUCH DAMAGE. 35.\" 36.\" @(#)kvm_getfiles.3 8.2 (Berkeley) 4/19/94 |
37.\" $FreeBSD: head/lib/libkvm/kvm_getfiles.3 112539 2003-03-24 15:58:53Z charnier $ | 37.\" $FreeBSD: head/lib/libkvm/kvm_getfiles.3 131504 2004-07-02 23:52:20Z ru $ |
38.\" 39.Dd April 19, 1994 40.Dt KVM_GETFILES 3 41.Os 42.Sh NAME 43.Nm kvm_getfiles 44.Nd survey open files 45.Sh LIBRARY --- 12 unchanged lines hidden (view full) --- 58.Fn kvm_getfiles 59function returns a (sub-)set of the open files in the kernel indicated by 60.Fa kd . 61The 62.Fa op 63and 64.Fa arg 65arguments constitute a predicate which limits the set of files | 38.\" 39.Dd April 19, 1994 40.Dt KVM_GETFILES 3 41.Os 42.Sh NAME 43.Nm kvm_getfiles 44.Nd survey open files 45.Sh LIBRARY --- 12 unchanged lines hidden (view full) --- 58.Fn kvm_getfiles 59function returns a (sub-)set of the open files in the kernel indicated by 60.Fa kd . 61The 62.Fa op 63and 64.Fa arg 65arguments constitute a predicate which limits the set of files |
66returned. No predicates are currently defined. | 66returned. 67No predicates are currently defined. |
67.Pp 68The number of files found is returned in the reference parameter 69.Fa cnt . 70The files are returned as a contiguous array of file structures, 71preceded by the address of the first file entry in the kernel. 72This memory is owned by kvm and is not guaranteed to be persistent across | 68.Pp 69The number of files found is returned in the reference parameter 70.Fa cnt . 71The files are returned as a contiguous array of file structures, 72preceded by the address of the first file entry in the kernel. 73This memory is owned by kvm and is not guaranteed to be persistent across |
73subsequent kvm library calls. Data should be copied out if it needs to be | 74subsequent kvm library calls. 75Data should be copied out if it needs to be |
74saved. 75.Sh RETURN VALUES 76The 77.Fn kvm_getfiles 78function will return NULL on failure. 79.Sh BUGS 80This routine does not belong in the kvm interface. 81.Sh SEE ALSO 82.Xr kvm 3 , 83.Xr kvm_close 3 , 84.Xr kvm_geterr 3 , 85.Xr kvm_nlist 3 , 86.Xr kvm_open 3 , 87.Xr kvm_openfiles 3 , 88.Xr kvm_read 3 , 89.Xr kvm_write 3 | 76saved. 77.Sh RETURN VALUES 78The 79.Fn kvm_getfiles 80function will return NULL on failure. 81.Sh BUGS 82This routine does not belong in the kvm interface. 83.Sh SEE ALSO 84.Xr kvm 3 , 85.Xr kvm_close 3 , 86.Xr kvm_geterr 3 , 87.Xr kvm_nlist 3 , 88.Xr kvm_open 3 , 89.Xr kvm_openfiles 3 , 90.Xr kvm_read 3 , 91.Xr kvm_write 3 |