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

90 lines
3.1 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
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
.Os FreeBSD
.Sh NAME
.Nm kernacc ,
.Nm useracc
.Nd check memory regions for accessibility
.Sh SYNOPSIS
Fixed #include and/or prototype bugs in synopsis.
1997-04-13 14:49:13 +00:00
.Fd #include <sys/types.h>
.Fd #include <vm/vm.h>
.Fd #include <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
.Fn kernacc "caddr_t addr" "int len" "int rw"
.Ft int
.Fn useracc "caddr_t addr" "int len" "int rw"
.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 ,
.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
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
.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
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
Both functions return boolean true if the type of access specified
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
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
The process pointer should be passed in as an argument to
.Fn useracc .
Reference in New Issue Copy Permalink