ksyms.4 (192859) | ksyms.4 (208027) |
---|---|
1.\" Copyright (c) 2008-2009 Stacey Son <sson@freebsd.org> 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 15 unchanged lines hidden (view full) --- 24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" | 1.\" Copyright (c) 2008-2009 Stacey Son <sson@freebsd.org> 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 15 unchanged lines hidden (view full) --- 24.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30.\" SUCH DAMAGE. 31.\" |
32.\" $FreeBSD: head/share/man/man4/ksyms.4 192859 2009-05-26 21:39:09Z sson $ | 32.\" $FreeBSD: head/share/man/man4/ksyms.4 208027 2010-05-13 12:07:55Z uqs $ |
33.\" 34.Dd April 5, 2009 35.Dt KSYMS 4 36.Os 37.Sh NAME 38.Nm ksyms 39.Nd kernel symbol table interface 40.Sh SYNOPSIS --- 84 unchanged lines hidden (view full) --- 125driver. 126.Pp 127The 128.Nm 129driver first appeared in 130.Fx 8.0 131to support 132.Xr lockstat 1 . | 33.\" 34.Dd April 5, 2009 35.Dt KSYMS 4 36.Os 37.Sh NAME 38.Nm ksyms 39.Nd kernel symbol table interface 40.Sh SYNOPSIS --- 84 unchanged lines hidden (view full) --- 125driver. 126.Pp 127The 128.Nm 129driver first appeared in 130.Fx 8.0 131to support 132.Xr lockstat 1 . |
133.Sh AUTHORS 134The 135.Nm 136driver was written by 137.An Stacey Son 138.Aq sson@freebsd.org . |
|
133.Sh BUGS 134Because files can be dynamically linked into the kernel at any time the symbol 135information can vary. When you open the 136.Pa /dev/ksyms 137file, you have access to an ELF image which represents a snapshot of the state of the kernel symbol information at that instant in time. Keeping the device open does not block the loading or unloading of kernel modules. To get a new snapshot you must close and re-open the device. 138.Pp 139A process is only allowed to open the 140.Pa /dev/ksyms --- 4 unchanged lines hidden (view full) --- 145The 146.Nm 147driver uses the calling process' memory address space to store the snapshot. 148.Xr ioctl 2 149can be used to get the memory address where the symbol table is stored to 150save kernel memory. 151.Xr mmap 2 152may also be used but it will map it to another address. | 139.Sh BUGS 140Because files can be dynamically linked into the kernel at any time the symbol 141information can vary. When you open the 142.Pa /dev/ksyms 143file, you have access to an ELF image which represents a snapshot of the state of the kernel symbol information at that instant in time. Keeping the device open does not block the loading or unloading of kernel modules. To get a new snapshot you must close and re-open the device. 144.Pp 145A process is only allowed to open the 146.Pa /dev/ksyms --- 4 unchanged lines hidden (view full) --- 151The 152.Nm 153driver uses the calling process' memory address space to store the snapshot. 154.Xr ioctl 2 155can be used to get the memory address where the symbol table is stored to 156save kernel memory. 157.Xr mmap 2 158may also be used but it will map it to another address. |
153.Sh AUTHORS 154The 155.Nm 156driver was written by 157.An Stacey Son 158.Aq sson@freebsd.org . | |