CVS commit: src/share/man/man9/man9.i386
Module Name:src Committed By: joerg Date: Fri May 14 18:28:40 UTC 2010 Modified Files: src/share/man/man9/man9.i386: return_address.9 Log Message: \\ - \e To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/share/man/man9/man9.i386/return_address.9 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man9/man9.i386/return_address.9 diff -u src/share/man/man9/man9.i386/return_address.9:1.4 src/share/man/man9/man9.i386/return_address.9:1.5 --- src/share/man/man9/man9.i386/return_address.9:1.4 Wed May 5 22:01:10 2010 +++ src/share/man/man9/man9.i386/return_address.9 Fri May 14 18:28:40 2010 @@ -1,4 +1,4 @@ -.\ $NetBSD: return_address.9,v 1.4 2010/05/05 22:01:10 wiz Exp $ +.\ $NetBSD: return_address.9,v 1.5 2010/05/14 18:28:40 joerg Exp $ .\ .\ Copyright (c) 2009 The NetBSD Foundation, Inc. .\ All rights reserved. @@ -68,7 +68,7 @@ .Fn return_address effecively, try a kernel configuration option such as .Bd -literal -makeoptions DEBUG=-g -fno-omit-frame-pointer \\ +makeoptions DEBUG=-g -fno-omit-frame-pointer \e -fno-optimize-sibling-calls -O0 .Ed .Sh RETURN VALUES
CVS commit: src/share/man/man9/man9.i386
Module Name:src Committed By: wiz Date: Wed May 5 22:01:10 UTC 2010 Modified Files: src/share/man/man9/man9.i386: return_address.9 Log Message: Add function to make sentences easier to read. To generate a diff of this commit: cvs rdiff -u -r1.3 -r1.4 src/share/man/man9/man9.i386/return_address.9 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man9/man9.i386/return_address.9 diff -u src/share/man/man9/man9.i386/return_address.9:1.3 src/share/man/man9/man9.i386/return_address.9:1.4 --- src/share/man/man9/man9.i386/return_address.9:1.3 Wed May 5 05:43:19 2010 +++ src/share/man/man9/man9.i386/return_address.9 Wed May 5 22:01:10 2010 @@ -1,4 +1,4 @@ -.\ $NetBSD: return_address.9,v 1.3 2010/05/05 05:43:19 jruoho Exp $ +.\ $NetBSD: return_address.9,v 1.4 2010/05/05 22:01:10 wiz Exp $ .\ .\ Copyright (c) 2009 The NetBSD Foundation, Inc. .\ All rights reserved. @@ -74,7 +74,7 @@ .Sh RETURN VALUES The .Fn return_address -returns the requested return address, or +function returns the requested return address, or .Dv NULL if it cannot dissect the call stack. .Sh CODE REFERENCES @@ -85,7 +85,7 @@ .Sh HISTORY The .Fn return_address -first appeared in +function first appeared in .Nx 6.0 . .Sh AUTHORS .An David Young Aq dyo...@netbsd.org
CVS commit: src/share/man/man9/man9.i386
Module Name:src Committed By: jruoho Date: Wed May 5 05:43:19 UTC 2010 Modified Files: src/share/man/man9/man9.i386: return_address.9 Log Message: .Nm - .Fn, and wrap the kernel config option so that it will fit into 80 columns. To generate a diff of this commit: cvs rdiff -u -r1.2 -r1.3 src/share/man/man9/man9.i386/return_address.9 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man9/man9.i386/return_address.9 diff -u src/share/man/man9/man9.i386/return_address.9:1.2 src/share/man/man9/man9.i386/return_address.9:1.3 --- src/share/man/man9/man9.i386/return_address.9:1.2 Tue Nov 3 11:04:32 2009 +++ src/share/man/man9/man9.i386/return_address.9 Wed May 5 05:43:19 2010 @@ -1,4 +1,4 @@ -.\ $NetBSD: return_address.9,v 1.2 2009/11/03 11:04:32 wiz Exp $ +.\ $NetBSD: return_address.9,v 1.3 2010/05/05 05:43:19 jruoho Exp $ .\ .\ Copyright (c) 2009 The NetBSD Foundation, Inc. .\ All rights reserved. @@ -27,7 +27,7 @@ .\ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\ POSSIBILITY OF SUCH DAMAGE. .\ -.Dd November 2, 2009 +.Dd May 5, 2010 .Dt RETURN_ADDRESS 9 i386 .Os .Sh NAME @@ -39,7 +39,7 @@ .Fn return_address unsigned int level .Sh DESCRIPTION The -.Nm +.Fn return_address function evaluates to the first return address on the call stack if .Fa level @@ -52,27 +52,29 @@ the call stack. .Pp A special fault handler stops -.Nm +.Fn return_address from crashing the kernel by examining a non-existent or corrupt stack frame. .Pp Kernel compilation options affect both the ability of -.Nm +.Fn return_address to locate return addresses on the stack, and the programmer's ability to interpret the addresses. The compiler may optimize away the stack frame pointers that -.Nm +.Fn return_address depends on. +.Pp To use -.Nm +.Fn return_address effecively, try a kernel configuration option such as .Bd -literal -makeoptions DEBUG=-g -fno-omit-frame-pointer -fno-optimize-sibling-calls -O0 +makeoptions DEBUG=-g -fno-omit-frame-pointer \\ + -fno-optimize-sibling-calls -O0 .Ed .Sh RETURN VALUES -.Nm -returns the -requested return address, or +The +.Fn return_address +returns the requested return address, or .Dv NULL if it cannot dissect the call stack. .Sh CODE REFERENCES @@ -81,7 +83,8 @@ .Sh REFERENCES .Xr config 5 .Sh HISTORY -.Nm +The +.Fn return_address first appeared in .Nx 6.0 . .Sh AUTHORS
CVS commit: src/share/man/man9/man9.i386
Module Name:src Committed By: jruoho Date: Wed May 5 05:49:38 UTC 2010 Modified Files: src/share/man/man9/man9.i386: bioscall.9 Log Message: Markup: .Fn instead of .Nm, .Tn, offset indent, newline for a new sentence. To generate a diff of this commit: cvs rdiff -u -r1.8 -r1.9 src/share/man/man9/man9.i386/bioscall.9 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man9/man9.i386/bioscall.9 diff -u src/share/man/man9/man9.i386/bioscall.9:1.8 src/share/man/man9/man9.i386/bioscall.9:1.9 --- src/share/man/man9/man9.i386/bioscall.9:1.8 Wed Apr 30 13:10:59 2008 +++ src/share/man/man9/man9.i386/bioscall.9 Wed May 5 05:49:38 2010 @@ -1,4 +1,4 @@ -.\ $NetBSD: bioscall.9,v 1.8 2008/04/30 13:10:59 martin Exp $ +.\ $NetBSD: bioscall.9,v 1.9 2010/05/05 05:49:38 jruoho Exp $ .\ .\ Copyright (c) 1998 The NetBSD Foundation, Inc. .\ All rights reserved. @@ -27,7 +27,7 @@ .\ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\ POSSIBILITY OF SUCH DAMAGE. .\ -.Dd October 1, 1998 +.Dd May 5, 2010 .Dt BIOSCALL 9 i386 .Os .Sh NAME @@ -39,9 +39,10 @@ .Fn bioscall int function struct bioscallregs *regs .Sh DESCRIPTION The -.Nm -function switches the processor into real mode, calls the BIOS interrupt -numbered +.Fn bioscall +function switches the processor into real mode, calls the +.Tn BIOS +interrupt numbered .Fa function , and returns to protected mode. .Pp @@ -50,10 +51,13 @@ .Pp The register values specified by .Fa *regs -(with one exception) are installed before the BIOS interrupt is called. -The processor flags are handled specially. Only the following flags are -passed to the -BIOS from the registers in +(with one exception) are installed before the +.Tn BIOS +interrupt is called. +The processor flags are handled specially. +Only the following flags are passed to the +.Tn BIOS +from the registers in .Fa regs (the remainder come from the processor's flags register at the time of the call): @@ -71,23 +75,32 @@ access to 32-, 16- or 8-bit wide sections of the registers. Definitions are provided which simplify access to the union members. .Sh RETURN VALUES -.Nm -fills in +The +.Fn bioscall +function fills in .Fa *regs -with the processor registers as returned from the BIOS call. +with the processor registers as returned from the +.Tn BIOS +call. .Sh EXAMPLES The Advanced Power Management driver calls -.Nm -by setting up a register structure with the APM installation check and -device types in registers +.Fn bioscall +by setting up a register structure with the +.Tn APM +installation check and device types in registers .Fa ax and .Fa bx , -then calls the BIOS to fetch the details for calling the APM support -through a protected-mode interface. The BIOS returns these details in -the registers: +then calls the +.Tn BIOS +to fetch the details for calling the +.Tn APM +support through a protected-mode interface. +The +.Tn BIOS +returns these details in the registers: .Pp -.Bd -literal +.Bd -literal -offset indent #include \*[Lt]i386/bioscall.h\*[Gt] #include \*[Lt]i386/apmvar.h\*[Gt] struct bioscallregs regs; @@ -104,11 +117,14 @@ .Sh REFERENCES .Xr apm 4 .Sh HISTORY -.Nm -first appeared in +The +.Fn bioscall +function first appeared in .Nx 1.3 . .Sh BUGS -Not all BIOS functions are safe to call through the trampoline, as they +Not all +.Tn BIOS +functions are safe to call through the trampoline, as they may depend on system state which has been disturbed or used for other purposes once the .Nx
CVS commit: src/share/man/man9/man9.i386
Module Name:src Committed By: wiz Date: Tue Feb 16 19:59:31 UTC 2010 Modified Files: src/share/man/man9/man9.i386: nmi.9 Log Message: Remove trailing whitespace. To generate a diff of this commit: cvs rdiff -u -r1.1 -r1.2 src/share/man/man9/man9.i386/nmi.9 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man9/man9.i386/nmi.9 diff -u src/share/man/man9/man9.i386/nmi.9:1.1 src/share/man/man9/man9.i386/nmi.9:1.2 --- src/share/man/man9/man9.i386/nmi.9:1.1 Fri Feb 12 00:45:38 2010 +++ src/share/man/man9/man9.i386/nmi.9 Tue Feb 16 19:59:31 2010 @@ -1,4 +1,4 @@ -.\ $NetBSD: nmi.9,v 1.1 2010/02/12 00:45:38 dyoung Exp $ +.\ $NetBSD: nmi.9,v 1.2 2010/02/16 19:59:31 wiz Exp $ .\ .\ Copyright (c) 2010 The NetBSD Foundation, Inc. .\ All rights reserved. @@ -34,7 +34,7 @@ .Nm nmi , .Nm nmi_establish , .Nm nmi_disestablish , -.Nd NMI +.Nd NMI .Sh SYNOPSIS .In x86/nmi.h .Ft nmi_handler_t *