d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
06f40e9610
freebsd-dev/share/man/man9/kernacc.9

91 lines
3.0 KiB
Groff
Raw Normal View History

Add kernacc(9) that documents the kernacc() and useracc() kernel functions. Obtained from: NetBSD (renamed from access.9)
1997-03-22 22:06:07 +00:00
.\" $NetBSD: access.9,v 1.1 1996/06/16 10:38:35 pk Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to The NetBSD Foundation
.\" by Paul Kranenburg.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by the NetBSD
.\" Foundation, Inc. and its contributors.
.\" 4. Neither the name of The NetBSD Foundation nor the names of its
.\" contributors may be used to endorse or promote products derived
.\" from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
$Id$ -> $FreeBSD$
1999-08-28 00:22:10 +00:00
.\" $FreeBSD$
Add $Id$, to make it simpler for members of the translation teams to track. The $Id$ line is normally at the bottom of the main comment block in the man page, separated from the rest of the manpage by an empty comment, like so; .\" $Id$ .\" If the immediately preceding comment is a @(#) format ID marker than the the $Id$ will line up underneath it with no intervening blank lines. Otherwise, an additional blank line is inserted. Approved by: bde
1999-07-12 21:02:10 +00:00
.\"
Add kernacc(9) that documents the kernacc() and useracc() kernel functions. Obtained from: NetBSD (renamed from access.9)
1997-03-22 22:06:07 +00:00
.Dd June 16, 1996
One minor mdoc fix.
1997-03-22 22:19:26 +00:00
.Dt KERNACC 9
mdoc(7) police: removed HISTORY info from the .Os call.
2001-07-10 15:31:11 +00:00
.Os
Add kernacc(9) that documents the kernacc() and useracc() kernel functions. Obtained from: NetBSD (renamed from access.9)
1997-03-22 22:06:07 +00:00
.Sh NAME
.Nm kernacc ,
.Nm useracc
.Nd check memory regions for accessibility
.Sh SYNOPSIS
Update function definitions and required include files to reflect the current state of the system. Approved by: alfred
2001-12-26 23:14:04 +00:00
.In sys/param.h
.In sys/proc.h
mdoc(7) police: Use the new .In macro for #include statements.
2001-10-01 16:09:29 +00:00
.In vm/vm.h
.In vm/vm_extern.h
Add kernacc(9) that documents the kernacc() and useracc() kernel functions. Obtained from: NetBSD (renamed from access.9)
1997-03-22 22:06:07 +00:00
.Ft int
use 'void *' instead of 'caddr_t' for useracc, kernacc, vslock and vsunlock.
2003-01-21 11:34:57 +00:00
.Fn kernacc "void *addr" "int len" "int rw"
Add kernacc(9) that documents the kernacc() and useracc() kernel functions. Obtained from: NetBSD (renamed from access.9)
1997-03-22 22:06:07 +00:00
.Ft int
use 'void *' instead of 'caddr_t' for useracc, kernacc, vslock and vsunlock.
2003-01-21 11:34:57 +00:00
.Fn useracc "void *addr" "int len" "int rw"
Add kernacc(9) that documents the kernacc() and useracc() kernel functions. Obtained from: NetBSD (renamed from access.9)
1997-03-22 22:06:07 +00:00
.Sh DESCRIPTION
The
.Fn kernacc
and
.Fn useracc
functions check whether operations of the type specified in
.Fa rw
are permitted in the range of virtual addresses given by
.Fa addr
and
.Fa len .
The possible values of
.Fa rw
Change useracc() and kernacc() to use VM_PROT_{READ|WRITE|EXECUTE} for the "rw" argument, rather than hijacking B_{READ|WRITE}. Fix two bugs (physio & cam) resulting by the confusion caused by this. Submitted by: Tor.Egge@fast.no Reviewed by: alc, ken (partly)
1999-10-30 06:32:05 +00:00
are any bitwise combination of
.Dv VM_PROT_READ ,
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days
2001-07-14 19:41:16 +00:00
.Dv VM_PROT_WRITE
Add kernacc(9) that documents the kernacc() and useracc() kernel functions. Obtained from: NetBSD (renamed from access.9)
1997-03-22 22:06:07 +00:00
and
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days
2001-07-14 19:41:16 +00:00
.Dv VM_PROT_EXECUTE .
Add kernacc(9) that documents the kernacc() and useracc() kernel functions. Obtained from: NetBSD (renamed from access.9)
1997-03-22 22:06:07 +00:00
.Fn kernacc
checks addresses in the kernel address space, while
.Fn useracc
considers
.Fa addr
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-03 14:05:08 +00:00
to represent an user space address.
The process context to use for this
Add kernacc(9) that documents the kernacc() and useracc() kernel functions. Obtained from: NetBSD (renamed from access.9)
1997-03-22 22:06:07 +00:00
operation is taken from the global variable
.Va curproc .
.Sh RETURN VALUES
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days
2001-07-14 19:41:16 +00:00
Both functions return boolean true if the type of access specified
Change useracc() and kernacc() to use VM_PROT_{READ|WRITE|EXECUTE} for the "rw" argument, rather than hijacking B_{READ|WRITE}. Fix two bugs (physio & cam) resulting by the confusion caused by this. Submitted by: Tor.Egge@fast.no Reviewed by: alc, ken (partly)
1999-10-30 06:32:05 +00:00
by
Add kernacc(9) that documents the kernacc() and useracc() kernel functions. Obtained from: NetBSD (renamed from access.9)
1997-03-22 22:06:07 +00:00
.Fa rw
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-03 14:05:08 +00:00
is permitted.
Otherwise boolean false is returned.
Add kernacc(9) that documents the kernacc() and useracc() kernel functions. Obtained from: NetBSD (renamed from access.9)
1997-03-22 22:06:07 +00:00
.Sh BUGS
Removed whitespace at end-of-line; no content changes. I simply did cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//' BTW, what editors are the culprits? I'm using vim and it shows me whitespace at EOL in troff files with a thick blue block... Reviewed by: Silence from cvs diff -b MFC after: 7 days
2001-07-14 19:41:16 +00:00
The process pointer should be passed in as an argument to
Change useracc() and kernacc() to use VM_PROT_{READ|WRITE|EXECUTE} for the "rw" argument, rather than hijacking B_{READ|WRITE}. Fix two bugs (physio & cam) resulting by the confusion caused by this. Submitted by: Tor.Egge@fast.no Reviewed by: alc, ken (partly)
1999-10-30 06:32:05 +00:00
.Fn useracc .
Reference in New Issue Copy Permalink