From 3c9f3d4e15fd559ceb338fe2e07f0e0ff034d8f7 Mon Sep 17 00:00:00 2001 From: jmc Date: Sat, 2 Aug 2008 09:17:46 +0000 Subject: [PATCH] fixes from Alexander Holupirek, documentation/5899: - fix a typo in lkm.4 (different fix used) - document securelevel(7) (again, different fix taken) whilst here, some minor repair: - no need to wrap section names in quotes - tidy up FILES a little - new sentence, new line --- sbin/modload/modload.8 | 13 +++++++------ sbin/modunload/modunload.8 | 8 +++++--- share/man/man4/lkm.4 | 20 ++++++++++++-------- 3 files changed, 24 insertions(+), 17 deletions(-) diff --git a/sbin/modload/modload.8 b/sbin/modload/modload.8 index 7deaf9fd7c3..4e08d5da0bb 100644 --- a/sbin/modload/modload.8 +++ b/sbin/modload/modload.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: modload.8,v 1.24 2007/11/25 19:21:37 mikeb Exp $ +.\" $OpenBSD: modload.8,v 1.25 2008/08/02 09:17:47 jmc Exp $ .\" $NetBSD: modload.8,v 1.17 2001/11/16 11:57:16 wiz Exp $ .\" .\" Copyright (c) 1993 Christopher G. Demetriou @@ -33,7 +33,7 @@ .\" .\" <> .\" -.Dd $Mdocdate: November 25 2007 $ +.Dd $Mdocdate: August 2 2008 $ .Dt MODLOAD 8 .Os .Sh NAME @@ -104,12 +104,12 @@ Do not load symbols from the kernel module. Print comments about the loading process. .El .Sh FILES -.Bl -tag -width /usr/include/sys/lkm.h -compact +.Bl -tag -width "/usr/include/sys/lkm.hXXX" -compact .It Pa /dev/ksyms -default file passed to the linker to resolve external -references in the module +Default file passed to the linker to resolve external +references in the module. .It Pa /usr/include/sys/lkm.h -file containing definitions of module types +File containing definitions of module types. .El .Sh DIAGNOSTICS The @@ -119,6 +119,7 @@ and with a nonzero status if an error occurs. .Sh SEE ALSO .Xr ld 1 , .Xr lkm 4 , +.Xr securelevel 7 , .Xr modstat 8 , .Xr modunload 8 .Sh HISTORY diff --git a/sbin/modunload/modunload.8 b/sbin/modunload/modunload.8 index 3fcb5c316ce..41087f6ec0a 100644 --- a/sbin/modunload/modunload.8 +++ b/sbin/modunload/modunload.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: modunload.8,v 1.13 2007/05/31 19:19:45 jmc Exp $ +.\" $OpenBSD: modunload.8,v 1.14 2008/08/02 09:17:47 jmc Exp $ .\" $NetBSD: modunload.8,v 1.3 1995/03/18 14:56:49 cgd Exp $ .\" .\" Copyright (c) 1993 Christopher G. Demetriou @@ -26,7 +26,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: May 31 2007 $ +.Dd $Mdocdate: August 2 2008 $ .Dt MODUNLOAD 8 .Os .Sh NAME @@ -58,7 +58,8 @@ Unload the module with the name .Ar name . .It Fl p Ar postunload Specify the name of a shell script or program that will be executed if the -module is successfully unloaded. This program is passed no arguments. +module is successfully unloaded. +This program is passed no arguments. .El .Sh DIAGNOSTICS The @@ -66,6 +67,7 @@ The utility exits 0 on success or with a non-zero status if an error occurred. .Sh SEE ALSO .Xr lkm 4 , +.Xr securelevel 7 , .Xr modload 8 , .Xr modstat 8 .Sh HISTORY diff --git a/share/man/man4/lkm.4 b/share/man/man4/lkm.4 index 8f7270ab350..2d27be0de1c 100644 --- a/share/man/man4/lkm.4 +++ b/share/man/man4/lkm.4 @@ -1,4 +1,4 @@ -.\" $OpenBSD: lkm.4,v 1.14 2007/05/31 19:19:50 jmc Exp $ +.\" $OpenBSD: lkm.4,v 1.15 2008/08/02 09:17:46 jmc Exp $ .\" $NetBSD: lkm.4,v 1.4 1994/11/30 16:22:22 jtc Exp $ .\" .\" Copyright (c) 1993 Christopher G. Demetriou @@ -26,7 +26,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.Dd $Mdocdate: May 31 2007 $ +.Dd $Mdocdate: August 2 2008 $ .Dt LKM 4 .Os .Sh NAME @@ -63,7 +63,10 @@ programs. Users should never have to interact with .Pa /dev/lkm directly. -.Sh "MODULE TYPES" +The loading and unloading of modules is also +dependent on the system +.Xr securelevel 7 . +.Sh MODULE TYPES .Bl -tag -width indent .It System Call modules System calls may be replaced by loading @@ -91,7 +94,7 @@ drivers may be loaded into the system with .Nm LKM . The major problem with loading a device driver is that the driver's -device nodes must be exist for the +device nodes must exist for the devices to be accessed. They are usually created by instructing .Xr modload 8 @@ -112,16 +115,17 @@ whatever kernel data structures necessary to enable and disable the new module when it is loaded and unloaded. .El .Sh FILES -.Bl -tag -width /usr/include/sys/lkm.h -compact +.Bl -tag -width "/usr/include/sys/lkm.hXXX" -compact .It Pa /dev/lkm .Nm -interface device +interface device. .It Pa /usr/include/sys/lkm.h -file containing definitions of module types +File containing definitions of module types. .It Pa /usr/share/lkm -example source code implementing several of the modules types +Example source code implementing several of the modules types. .El .Sh SEE ALSO +.Xr securelevel 7 , .Xr modload 8 , .Xr modstat 8 , .Xr modunload 8 -- 2.20.1