Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Refer to cpu_switchto(9) instead of nonexistent cpu_switch(9). 

In addition, small markup changes.
This commit is contained in:
jruoho 2010-04-14 09:34:35 +00:00
parent 3877f39979
commit 0cb92fb7f2
1 changed files with 20 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
share/man/man9/ras.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ras.9,v 1.10 2008/04/30 13:10:58 martin Exp $ .\" $NetBSD: ras.9,v 1.11 2010/04/14 09:34:35 jruoho Exp $
.\" .\"
.\" Copyright (c) 2002 The NetBSD Foundation, Inc. .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
.\" All rights reserved. .\" All rights reserved.
@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE. .\" POSSIBILITY OF SUCH DAMAGE.
.\" .\"
.Dd August 12, 2002 .Dd April 14, 2010
.Dt RAS 9 .Dt RAS 9
.Os .Os
.Sh NAME .Sh NAME
@ -50,19 +50,22 @@ Restartable atomic sequences are user code sequences which are
guaranteed to execute without preemption. guaranteed to execute without preemption.
This property is assured by checking the set of restartable atomic This property is assured by checking the set of restartable atomic
sequences registered for a process during sequences registered for a process during
.Xr cpu_switch 9 . .Xr cpu_switchto 9 .
If a process is found to have been preempted during a restartable If a process is found to have been preempted during a restartable
sequence, then its execution is rolled-back to the start of the sequence, then its execution is rolled-back to the start of the
sequence by resetting its program counter saved in its process control sequence by resetting its program counter saved in its process control block
block (PCB). .Pq Tn PCB .
.Pp .Pp
The RAS functionality is provided by a combination of the The
.Tn RAS
functionality is provided by a combination of the
machine-independent routines discussed in this page and machine-independent routines discussed in this page and
a machine-dependent component in a machine-dependent component in
.Xr cpu_switch 9 . .Xr cpu_switchto 9 .
A port which supports restartable atomic sequences will define A port which supports restartable atomic sequences will define
__HAVE_RAS in .Dv __HAVE_RAS
.Pa machine/types.h in
.In machine/types.h
for machine-independent code to conditionally provide RAS support. for machine-independent code to conditionally provide RAS support.
.Pp .Pp
A complicated side-effect of restartable atomic sequences is their A complicated side-effect of restartable atomic sequences is their
@ -85,8 +88,11 @@ which contain the user address
.Fa addr . .Fa addr .
If the address If the address
.Fa addr .Fa addr
is found within a RAS, then the restart address of the RAS is is found within a
returned, otherwise \-1 is returned. .Tn RAS ,
then the restart address of the
.Tn RAS
is returned, otherwise \-1 is returned.
.It Fn ras_fork "p1" "p2" .It Fn ras_fork "p1" "p2"
This function is used to copy all registered restartable atomic This function is used to copy all registered restartable atomic
sequences for process sequences for process
@ -118,14 +124,14 @@ The RAS framework itself is implemented within the file
.Pa sys/kern/kern_ras.c . .Pa sys/kern/kern_ras.c .
Data structures and function prototypes for the framework are located Data structures and function prototypes for the framework are located
in in
.Pa sys/sys/ras.h . .In sys/sys/ras.h .
Machine-dependent portions are implemented within Machine-dependent portions are implemented within
.Xr cpu_switch 9 .Xr cpu_switchto 9
in the machine-dependent file in the machine-dependent file
.Pa sys/arch/\*[Lt]arch\*[Gt]/\*[Lt]arch\*[Gt]/locore.S . .Pa sys/arch/\*[Lt]arch\*[Gt]/\*[Lt]arch\*[Gt]/locore.S .
.Sh SEE ALSO .Sh SEE ALSO
.Xr rasctl 2 , .Xr rasctl 2 ,
.Xr cpu_switch 9 , .Xr cpu_switchto 9 ,
.Xr fork1 9 .Xr fork1 9
.Sh HISTORY .Sh HISTORY
The RAS functionality first appeared in The RAS functionality first appeared in