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

Fix typos, punctuation and whitespace.

Browse Source
This commit is contained in:
wiz 2001-06-21 11:59:00 +00:00
parent ad3ce1d8c4
commit 6539335131
23 changed files with 158 additions and 156 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
share/man/man9/access.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: access.9,v 1.7 1999/03/16 00:40:46 garbled Exp $
.\" $NetBSD: access.9,v 1.8 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -25,7 +25,7 @@
.\" 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 FOUNDATION OR CONTRIBUTORS
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION 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
@ -41,7 +41,7 @@
.Nm access ,
.Nm kernacc ,
.Nm useracc
.Nd check memory regions for accessability
.Nd check memory regions for accessibility
.Sh SYNOPSIS
.Ft int
.Fn kernacc "caddr_t addr" "size_t len" "int rw"

54
share/man/man9/arp.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: arp.9,v 1.17 2001/04/29 19:17:22 jhawk Exp $
.\" $NetBSD: arp.9,v 1.18 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -54,45 +54,45 @@
.Fn arpintr
.Sh DESCRIPTION
The
.Nm
.Nm
functions provide the interface between the
.Nm
.Nm
module and the network drivers which need
.Nm
.Nm
functionality.
Such drivers must request the
Such drivers must request the
.Ar arp
attribute in their "files" declaration.
.Bl -tag -width "arp_ifinit()"
.It Fn arp_ifinit
Sets up the
Sets up the
.Nm
specific fields in
specific fields in
.Fa ifa .
Additionally, it sends out a gratitious
Additionally, it sends out a gratuitous
.Nm
request on
request on
.Fa ifp ,
so that other machines are warned that we have a (new) address and
duplicate addresses can be detected.
.Pp
You must call this in your drivers' ioctl function when you get a
You must call this in your drivers' ioctl function when you get a
SIOCSIFADDR request with an AF_INET address family.
.It Fn arpresolve
is called by network output functions to resolve an IPv4 address.
If no
If no
.Fa rt
is given, a new one is looked up or created.
If the passed or found
.Fa rt
does not contain a valid gateway link level address, a pointer to the packet
in
in
.Fa m
is stored in the route entry, possibly replacing older stored packets, and an
is stored in the route entry, possibly replacing older stored packets, and an
.Nm
request is sent instead.
When an
.Nm
When an
.Nm
reply is received, the last held packet is send.
Otherwise, the looked up address is returned and written into the storage
.Fa desten
@ -103,22 +103,22 @@ returns 1, if a valid address was stored to
and the packet can be sent immediately.
Else a 0 is returned.
.It Fn arpintr
When an
When an
.Nm
packet is received, the network driver (class) input interupt handler queues
packet is received, the network driver (class) input interrupt handler queues
the packet on the arpintrq queue, and requests an
.Fn arpintr
soft interupt callback.
.Fn arpintr
dequeues the packets, performs sanity checks and calls (for IPv4
.Nm
packes, which are the only ones supported currently) the
.Fn in_arpinput
soft interrupt callback.
.Fn arpintr
dequeues the packets, performs sanity checks and calls (for IPv4
.Nm
packets, which are the only ones supported currently) the
.Fn in_arpinput
function.
.Fn in_arpinput
.Fn in_arpinput
either generates a reply to request packets, and adds the sender address
translation to to the routing table, if a matching route entry is found.
If the route entry contained a pointer to a held packet, that packet is
translation to to the routing table, if a matching route entry is found.
If the route entry contained a pointer to a held packet, that packet is
sent.
.El
.Sh SEE ALSO
@ -141,5 +141,5 @@ and
.Sh STANDARDS
RFC 826
.Sh HISTORY
Rewritten to support other than Ethernet link level addresses in
Rewritten to support other than Ethernet link level addresses in
.Nx 1.3 .

36
share/man/man9/audio.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: audio.9,v 1.16 2000/07/24 15:00:07 ad Exp $
.\" $NetBSD: audio.9,v 1.17 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -43,9 +43,9 @@
.Sh DESCRIPTION
The audio device driver is divided into a high level,
hardware independent layer, and a low level hardware
dependent layer. The interface between these is
the
.Va audio_hw_if
dependent layer. The interface between these is
the
.Va audio_hw_if
structure.
.Bd -literal
struct audio_hw_if {
@ -54,7 +54,7 @@ struct audio_hw_if {
int (*drain)__P((void *));
int (*query_encoding)__P((void *, struct audio_encoding *));
int (*set_params)__P((void *, int, int,
int (*set_params)__P((void *, int, int,
struct audio_params *, struct audio_params *));
int (*round_blocksize)__P((void *, int));
@ -75,12 +75,12 @@ struct audio_hw_if {
int (*getdev)__P((void *, struct audio_device *));
int (*setfd)__P((void *, int));
int (*set_port)__P((void *, mixer_ctrl_t *));
int (*get_port)__P((void *, mixer_ctrl_t *));
int (*query_devinfo)__P((void *, mixer_devinfo_t *));
void *(*allocm)__P((void *, int, size_t, int, int));
void (*freem)__P((void *, void *, int));
size_t (*round_buffersize)__P((void *, int, size_t));
@ -117,10 +117,10 @@ This call should be
struct device *dev;
.Ed
.Pp
The
The
.Va audio_hw_if
struct is as shown above. The
.Va hdl
.Va hdl
argument is a handle to some low level data structure.
It is sent as the first argument to all the functions
in
@ -156,18 +156,18 @@ is called when the audio device is closed.
optional, is called before the device is closed or when
.Dv AUDIO_DRAIN
is called. It should make sure that no samples remain
in to be played that could be lost when
in to be played that could be lost when
.Va close
is called.
Return 0 on success, otherwise an error code.
.It Dv int query_encoding(void *hdl, struct audio_encoding *ae)
is used when
.Dv AUDIO_GETENC
is called. It should fill the
is called. It should fill the
.Va audio_encoding
structure and return 0 or, if there is no encoding with the
given number, return EINVAL.
.It Dv int set_params(void *hdl, int setmode, int usemode,
.It Dv int set_params(void *hdl, int setmode, int usemode,
.Dv "struct audio_params *play, struct audio_params *rec)"
.br
Called to set the audio encoding mode.
@ -230,7 +230,7 @@ Return 0 on success, otherwise an error code.
optional, is called before any output starts, but when the total
.Va size
of the output
.Va buffer
.Va buffer
has been determined. It can be used to initialize looping DMA
for hardware that needs that.
Return 0 on success, otherwise an error code.
@ -238,7 +238,7 @@ Return 0 on success, otherwise an error code.
optional, is called before any input starts, but when the total
.Va size
of the input
.Va buffer
.Va buffer
has been determined. It can be used to initialize looping DMA
for hardware that needs that.
Return 0 on success, otherwise an error code.
@ -276,7 +276,7 @@ should be called with the argument
Calling
.Va intr
will normally initiate another call to
.Va start_input.
.Va start_input .
Return 0 on success, otherwise an error code.
.It Dv int halt_output(void *hdl)
is called to abort the output transfer (started by
@ -294,7 +294,7 @@ playing and recording. It can, e.g., be used to turn on
and off the speaker.
Return 0 on success, otherwise an error code.
.It Dv int getdev(void *hdl, struct audio_device *ret)
Should fill the
Should fill the
.Va audio_device
struct with relevant information about the driver.
Return 0 on success, otherwise an error code.
@ -364,7 +364,7 @@ AUDIO_PROP_xxx.
.It Dv int trigger_output(void *hdl, void *start, void *end,
.Dv "int blksize, void (*intr)(void*), void *intrarg,"
.br
.Dv "stuct audio_params *param)"
.Dv "struct audio_params *param)"
.br
optional, is called to start the transfer of data from the circular buffer
delimited by
@ -388,7 +388,7 @@ Return 0 on success, otherwise an error code.
.It Dv int trigger_input(void *hdl, void *start, void *end,
.Dv "int blksize, void (*intr)(void*), void *intrarg,"
.br
.Dv "stuct audio_params *param)"
.Dv "struct audio_params *param)"
.br
optional, is called to start the transfer of data from the audio hardware,
parameterized as in

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

@ -1,12 +1,12 @@
.\" $NetBSD: bus_dma.9,v 1.15 2001/03/07 22:23:45 thorpej Exp $
.\" $NetBSD: bus_dma.9,v 1.16 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 1996, 1997, 1998, 2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
.\"
.\"
.\" This code is derived from software contributed to The NetBSD Foundation
.\" by Jason R. Thorpe of the Numerical Aerospace Simulation Facility,
.\" NASA Ames Research Center.
.\"
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
@ -22,7 +22,7 @@
.\" 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
@ -199,7 +199,7 @@ bus-dependent functionality.
.El
.It Fa dmamp
This is a pointer to a bus_dmamap_t. A DMA map will be allocated and
pointed to by
pointed to by
.Fa dmamp
upon successful completion of this routine.
.El
@ -220,7 +220,7 @@ The DMA handle to destroy.
.El
.Pp
In the event that the DMA handle contains a valid mapping,
the mapping will be unloaded via the same mechanism used by
the mapping will be unloaded via the same mechanism used by
.Fn bus_dmamap_unload .
.Pp
Behavior is not defined if invalid arguments are passed to
@ -270,10 +270,10 @@ that there is coherency between memory and the device performing
the DMA transaction.
This flag allows the use of this special hardware, provided that
the device is doing sequential, unidirectional transfers which
conform to certain alignment and size contraints defined by the
conform to certain alignment and size constraints defined by the
platform. If the platform does not support the feature, or if
the buffer being loaded into the DMA map does not conform to the
contraints required for use of the feature, then this flag will
constraints required for use of the feature, then this flag will
be silently ignored. Also refer to the use of this flag with the
.Fn bus_dmamem_alloc
function.
@ -288,7 +288,7 @@ As noted above, if a DMA handle is created with
.Fn bus_dmamap_load
will never block.
.Pp
If a call to
If a call to
.Fn bus_dmamap_load
fails, the mapping in
the DMA handle will be invalid. It is the responsibility
@ -300,7 +300,7 @@ Behavior is not defined if invalid arguments are passed to
.Pp
Returns 0 on success, or an error code to indicate mode of failure.
.It Fn bus_dmamap_load_mbuf "tag" "dmam" "chain" "flags"
This is a variation of
This is a variation of
.Fn bus_dmamap_load
which maps mbuf chains
for DMA transfers. Mbuf chains are assumed to be in kernel
@ -425,7 +425,7 @@ will always cause the store buffer to be flushed.
This function exists so that multiple read and write transfers can be
performed with the same buffer, and so that drivers can explicitly
inform the
.Nm
.Nm
code when their data is 'ready' in its DMA buffer.
.Pp
An example of multiple read-write use of a single mapping
@ -483,7 +483,7 @@ returned as part of
can thus not be used to program DMA controller address registers. Only
the values in the
.Fa dm_segs
array of a sucessfully loaded DMA map (using
array of a successfully loaded DMA map (using
.Fn bus_dmamap_load
) can be used for this purpose.
.Pp
@ -523,7 +523,7 @@ It is safe to wait (sleep) for resources during this call.
.It Dv BUS_DMA_NOWAIT
It is not safe to wait (sleep) for resources during this call.
.It Dv BUS_DMA_STREAMING
Adjusts, if necessary, the size, alignment, and boundary contrains
Adjusts, if necessary, the size, alignment, and boundary constrains
to conform to the platform-dependent requirements for the use of the
.Dv BUS_DMA_STREAMING
flag with the
@ -552,7 +552,7 @@ Behavior is undefined if invalid arguments are passed to
.Pp
Returns 0 on success, or an error code indicating mode of failure.
.It Fn bus_dmamem_free "tag" "segs" "nsegs"
Frees memory previously allocated by
Frees memory previously allocated by
.Fn bus_dmamem_alloc .
Any mappings
will be invalidated. Arguments are as follows:
@ -571,7 +571,7 @@ The number of segments in
Behavior is undefined if invalid arguments are passed to
.Fn bus_dmamem_free .
.Pp
If given valid arguments,
If given valid arguments,
.Fn bus_dmamem_free
always succeeds.
.It Fn bus_dmamem_map "tag" "segs" "nsegs" "size" "kvap" "flags"
@ -659,7 +659,7 @@ The size of the mapping.
Behavior is undefined if invalid arguments are passed to
.Fn bus_dmamem_unmap .
.Pp
If given valid arguments,
If given valid arguments,
.Fn bus_dmamem_unmap
always succeeds.
.It Fn bus_dmamem_mmap "tag" "segs" "nsegs" "off" "prot" "flags"
@ -677,7 +677,7 @@ This is the bus_dma_tag_t passed down from the parent driver via
The array of bus_dma_segment_t's filled in by
.Fn bus_dmamem_alloc ,
representing the memory to be
.Xr mmap 2 Ns 'ed.
.Xr mmap 2 Ns 'ed .
.It Fa nsegs
The number of elements in the
.Fa segs

4
share/man/man9/bus_space.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: bus_space.9,v 1.18 2001/06/19 13:42:10 wiz Exp $
.\" $NetBSD: bus_space.9,v 1.19 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -356,7 +356,7 @@ header file.
.Pp
Many common devices are used on multiple architectures, but are accessed
differently on each because of architectural constraints.
For instance, a device which is mapped in one systems's I/O space may be
For instance, a device which is mapped in one system's I/O space may be
mapped in memory space on a second system. On a third system, architectural
limitations might change the way registers need to be accessed (e.g.
creating a non-linear register space).

4
share/man/man9/callout.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: callout.9,v 1.3 2001/04/29 19:12:20 jhawk Exp $
.\" $NetBSD: callout.9,v 1.4 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -105,7 +105,7 @@ will be called with the argument
Note that if the timer associated with the callout handle is already running,
it will be implicitly stopped before being reset.
Once the timer is started, the callout handle is marked as
.Em ACTIVE
.Em ACTIVE
and
.Em PENDING .
Once the timer expires,

18
share/man/man9/cnmagic.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: cnmagic.9,v 1.4 2001/06/12 15:17:13 wiz Exp $
.\" $NetBSD: cnmagic.9,v 1.5 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 2000 Eduardo Horvath
.\" All rights reserved.
@ -66,7 +66,7 @@ The
.Nx
console magic key sequence management framework is designed to provide
flexible methods to set, change, and detect magic key sequences on console
devices and break into the debugger or rom monitor with a minimum of interrupt
devices and break into the debugger or ROM monitor with a minimum of interrupt
latency.
.Pp
Drivers that generate console input should make use of these routines. A
@ -87,14 +87,14 @@ magic sequence with
to any arbitrary string. Whenever the driver receives input,
it should call
.Fn cn_check_magic
to process the data and determine wheter the magic sequence has
to process the data and determine whether the magic sequence has
been hit.
.Pp
The magic key sequence can be accessed through the
.Va hw.cnmagic
.Ic sysctl
variable. This is the raw data and may be keycodes rather than
processed characters, depending on the console deivce.
processed characters, depending on the console device.
.Pp
Here is a description of the console magic interface:
.Bl -tag -width indent
@ -102,13 +102,13 @@ Here is a description of the console magic interface:
.Pp
Initialize the console magic state pointed to by
.Fa cnm
to a useable state.
to a usable state.
.It Fn "void cnm_trap"
.Pp
Trap into the kernel debugger or rom monitor. By default this
Trap into the kernel debugger or ROM monitor. By default this
routine is defined to be
.Fn console_debugger
but can be overriden in MI header files.
but can be overridden in MI header files.
.It Fn "int cn_isconsole" "dev_t dev"
.Pp
Determine whether a given
@ -117,10 +117,10 @@ is the system console. This macro tests to see if
.Fa dev
is the same as
.Va cn_tab->cn_dev
but can be overriden in MI header files.
but can be overridden in MI header files.
.It Fn "void cn_check_magic" "dev_t dev" "int k" "cnm_state_t *cnms"
.Pp
All input shoult be passed through
All input should be passed through
.Fn cn_check_magic
so the state machine remains in a consistent state.
.Fn cn_check_magic

10
share/man/man9/cons.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: cons.9,v 1.3 2001/06/04 09:50:07 jdolecek Exp $
.\" $NetBSD: cons.9,v 1.4 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 2001 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -76,8 +76,8 @@ Ring a bell at appropriate
.Fa pitch ,
for duration of
.Fa period
miliseconds at given
.Fa volume.
milliseconds at given
.Fa volume .
Note that the
.Fa volume
value is ignored commonly.
@ -100,13 +100,13 @@ and
Number of read characters is
.Fa size
at maximum, user is notified by console bell when the end
of input buffer is reached. <Baskspace> key
of input buffer is reached. <Backspace> key
works as expected. <@> or <CTRL>-u make
.Fn cngetsn
discard input read so far, print newline and
wait for next input.
.Fn cngetsn
returns number of characters actually read, exluding
returns number of characters actually read, excluding
the final newline.
.Fa cp
is

4
share/man/man9/copy.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: copy.9,v 1.9 1999/03/16 00:40:47 garbled Exp $
.\" $NetBSD: copy.9,v 1.10 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 1996 Jason R. Thorpe.
.\" All rights reserved.
@ -131,7 +131,7 @@ In addition, the
.Fn copyinstr ,
and
.Fn copyoutstr
funtions return ENAMETOOLONG if the string is longer than
functions return ENAMETOOLONG if the string is longer than
.Fa len
bytes.
.Sh SEE ALSO

12
share/man/man9/disk.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: disk.9,v 1.12 2001/04/21 08:22:44 jdolecek Exp $
.\" $NetBSD: disk.9,v 1.13 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 1995, 1996 Jason R. Thorpe.
.\" All rights reserved.
@ -37,7 +37,7 @@
.Nm disk ,
.Nm disk_init ,
.Nm disk_attach ,
.Nm disk_detatch ,
.Nm disk_detach ,
.Nm disk_busy ,
.Nm disk_unbusy ,
.Nm disk_find ,
@ -126,7 +126,7 @@ before autoconfiguration.
.It Fn disk_attach
Attach a disk; allocate storage for the disklabel, set the
.Dq attached time
timestamp, insert the disk into the disklist, and intrement the
timestamp, insert the disk into the disklist, and increment the
system disk count.
.It Fn disk_detach
Detach a disk; free storage for the disklabel, remove the disk
@ -177,7 +177,7 @@ Each device in the system uses a
.Dq softc
structure which contains autoconfiguration and state information for that
device. In the case of disks, the softc should also contain one instance
of the disk stucture, eg:
of the disk structure, e.g.:
.Bd -literal
struct foo_softc {
struct device sc_dev; /* generic device information */
@ -227,7 +227,7 @@ above is the disk's
.Dq driver
switch. This switch currently includes a pointer to the disk's
.Dq strategy
routine. This switch needs to have global scope and sould be initialized
routine. This switch needs to have global scope and should be initialized
as follows:
.Bd -literal
void foostrategy __P((struct buf *));
@ -243,7 +243,7 @@ and
routines. The
.Fn disk_busy
routine should be called immediately before a command to the disk is
sent, eg:
sent, e.g.:
.Bd -literal
void
foostart(sc)

8
share/man/man9/disklabel.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: disklabel.9,v 1.8 1999/03/16 00:40:47 garbled Exp $
.\" $NetBSD: disklabel.9,v 1.9 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -25,7 +25,7 @@
.\" 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 FOUNDATION OR CONTRIBUTORS
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION 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
@ -111,11 +111,11 @@ using the buffer pointed at by
.Fa clp
.Pc ,
to store the disk label onto the medium in a format complying with
architectural contraints.
architectural constraints.
.Fn writedisklabel
returns 0 on success and
.Dv EINVAL
if the disk label specifies invalid or unconvertable values.
if the disk label specifies invalid or inconvertible values.
Otherwise, any error condition reported by the device strategy routine
in the buffer's
.Dq Va b_error

12
share/man/man9/extent.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: extent.9,v 1.16 2000/06/14 06:49:19 cgd Exp $
.\" $NetBSD: extent.9,v 1.17 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 1996, 1998 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -25,7 +25,7 @@
.\" 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 FOUNDATION OR CONTRIBUTORS
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION 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
@ -159,7 +159,7 @@ policies, which are selected by the
argument:
.Bl -tag -offset indent -width "XXXXXXXXX"
.It Dv EX_FAST
Allocate the first region that fits the provided paramters, regardless
Allocate the first region that fits the provided parameters, regardless
of resulting extent fragmentation.
.It default
Allocate the smallest region that is capable of holding the request,
@ -224,7 +224,7 @@ If
is not specified, the allocation will fail if the request can not be
satisfied without sleeping.
The caller must also specify, using the
.Dv EX_NOWAIT
.Dv EX_NOWAIT
or
.Dv EX_WAITOK
flags, if waiting for overhead allocation is allowed.
@ -233,7 +233,7 @@ The
.Fn extent_alloc1
and
.Fn extent_alloc_subregion1
functions are extensions that take one additional argument,
functions are extensions that take one additional argument,
.Fa skew ,
that modifies the requested alignment result in the following way:
the value
@ -348,7 +348,7 @@ func()
/*
* Give up the extent.
*/
extent_destroy(foo_ex);
extent_destroy(foo_ex);
}
.Ed
.Sh CODE REFERENCES

4
share/man/man9/fork1.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: fork1.9,v 1.3 1999/03/16 00:40:47 garbled Exp $
.\" $NetBSD: fork1.9,v 1.4 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 1998 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -67,7 +67,7 @@ The parent process will sleep until the child process successfully calls
.Xr execve 2
or exits (either by a call to
.Xr _exit 2
or abormally).
or abnormally).
.It FORK_SHAREVM
The child process will share the parent's virtual address space. If this
flag is not specified, the child will get a copy-on-write snapshot of the

8
share/man/man9/ioctl.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ioctl.9,v 1.6 2001/04/09 17:12:28 wiz Exp $
.\" $NetBSD: ioctl.9,v 1.7 2001/06/21 11:59:00 wiz Exp $
.\"
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -52,7 +52,7 @@ are internally defined as
.It #define FOOIOCTL fun(t,n,pt)
.El
where the different wariables and funcions are:
where the different variables and functions are:
.Bl -tag -width FOOIOCTL
.It Fn FOOIOCTL
the name as the ioctl is later known in a as second argument to a
@ -90,7 +90,7 @@ for a given
.Fn t .
This is a unsigned 8 bit number.
.It pt
This specifyies the type of the passed parameter. This one gets internally
This specifies the type of the passed parameter. This one gets internally
transformed to the size of the parameter, so if you e.g. want to pass
a structure, then you have to specify that structure and not a pointer
to it or sizeof(struct foo)
@ -106,7 +106,7 @@ in either <sys/ioctl.h> or one of the files that are reached from
int a=3;
error = ioctl(s,FOOICTL, &a);
Within the ioctl()-routine of the driver, it can be then accessd like
Within the ioctl()-routine of the driver, it can be then accessed like
driver_ioctl(..,cmd,data)
u_long cmd;

11
share/man/man9/pci_configure_bus.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: pci_configure_bus.9,v 1.1 2001/02/10 02:50:37 briggs Exp $
.\" $NetBSD: pci_configure_bus.9,v 1.2 2001/06/21 11:59:01 wiz Exp $
.\"
.\" Copyright 2001 Wasabi Systems, Inc.
.\" All rights reserved.
@ -51,7 +51,7 @@
.Fc
.Sh DESCRIPTION
.Pp
The
The
.Fn pci_configure_bus
function configures a PCI bus for use. This involves:
.Bl -bullet
@ -72,14 +72,14 @@ should be called prior to the auto-configuration of the bus.
.Pp
The
.Fa pc
argument is a machine-dependant tag used to specify the PCI chipset to the
argument is a machine-dependent tag used to specify the PCI chipset to the
system. This should be the same value used with
.Fn pci_make_tag .
The extent arguments
define memory extents from which the address space for the cards will be
taken. These addresses should be in the PCI address space. The
.Fa ioext
extent is for PCI I/O accesses. The
extent is for PCI I/O accesses. The
.Fa memext
extent is for PCI memory accesses that might have side effects. I.e.,
that can not be cached. The
@ -124,7 +124,8 @@ See chapter 9 of the
for more information on swizzling (also known as interrupt routing).
.Sh EXAMPLES
The
.Fn pci_conf_interrupt function in the sandpoint implementation looks like:
.Fn pci_conf_interrupt
function in the sandpoint implementation looks like:
.Pp
.Bd -literal -compact
void

6
share/man/man9/pci_intr.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: pci_intr.9,v 1.3 2001/06/12 15:17:13 wiz Exp $
.\" $NetBSD: pci_intr.9,v 1.4 2001/06/21 11:59:01 wiz Exp $
.\"
.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -59,7 +59,7 @@
.Pp
The
.Nm
functions exist to allow device drivers machine-independant access to
functions exist to allow device drivers machine-independent access to
PCI bus interrupts. The functions described in this page are
typically declared in a port's
.Pa Aq machine/pci_machdep.h
@ -86,7 +86,7 @@ to the
function, which returns zero on success, and nonzero on failure. The function
sets the
.Ft "pci_intr_handle_t"
pointed at by its second argument to a machine-dependant value which
pointed at by its second argument to a machine-dependent value which
identifies a particular interrupt source.
.Pp
If the driver wishes to refer to the interrupt source in an attach or

16
share/man/man9/pool.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: pool.9,v 1.17 2001/04/06 15:54:10 wiz Exp $
.\" $NetBSD: pool.9,v 1.18 2001/06/21 11:59:01 wiz Exp $
.\"
.\" Copyright (c) 1997, 1998 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -25,7 +25,7 @@
.\" 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 FOUNDATION OR CONTRIBUTORS
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION 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
@ -223,12 +223,12 @@ the system will panic
.\"storage.
.\" a bunch of other flags aren't documented.
If both
.Dv PR_LIMITFAIL
.Dv PR_LIMITFAIL
and
.Dv PR_WAITOK
is specified, and the pool has reached its hard limit,
.Fn pool_get
will return
is specified, and the pool has reached its hard limit,
.Fn pool_get
will return
.Dv NULL
without waiting, allowing the caller to do its own garbage collection;
however, it will still wait if the pool is not yet at its hard limit.
@ -287,7 +287,7 @@ it will return unused memory to the system should the number of accumulated
unused items in the pool exceed a programmable limit.
The limits for the minimum and maximum number of items which a pool should keep
at hand are known as the high and low
.Sy watermarks.
.Sy watermarks .
The functions
.Fn pool_sethiwat
and
@ -320,7 +320,7 @@ The number pages in the pool will not decrease below the required value to
accommodate the minimum number of items specified by this function.
Unlike
.Fn pool_prime ,
this function does not allocate the necessary memory upfront.
this function does not allocate the necessary memory up-front.
.El
.Ss POTENTIAL PITFALLS
Note that undefined behaviour results when mixing the storage providing

6
share/man/man9/powerhook_establish.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: powerhook_establish.9,v 1.2 2000/11/26 11:09:00 takemura Exp $
.\" $NetBSD: powerhook_establish.9,v 1.3 2001/06/21 11:59:01 wiz Exp $
.\"
.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -74,7 +74,7 @@ that must happen when the power situation to the computer changes. Because
of the environment in which they are run, shutdown hooks cannot
rely on many system services (including file systems, and timeouts
and other interrupt-driven services).
The power hooks are typically executed from an interrut context.
The power hooks are typically executed from an interrupt context.
.Pp
The different reasons for calling the power hooks are: suspend, standby, and
resume. The reason is reflected in the
@ -94,7 +94,7 @@ At suspend the system is going to lose (almost) all power, standby retains
some power (e.g., minimal power to USB devices), and at resume power is
back to normal.
.Sh RETURN VALUES
If successful,
If successful,
.Fn powerhook_establish
returns an opaque pointer describing the newly-established
shutdown hook. Otherwise, it returns NULL.

10
share/man/man9/ratecheck.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ratecheck.9,v 1.5 2000/08/03 20:35:40 jhawk Exp $
.\" $NetBSD: ratecheck.9,v 1.6 2001/06/21 11:59:01 wiz Exp $
.\"
.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -25,7 +25,7 @@
.\" 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 FOUNDATION OR CONTRIBUTORS
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION 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
@ -89,7 +89,7 @@ long drv_err2count; /* # of err2 errs since last msg */
/*
* the following variable will often be global or shared by all
* instances of a driver. It should be initalized, so it can be
* instances of a driver. It should be initialized, so it can be
* patched. Allowing it to be set via an option might be nice,
* but could lead to an insane proliferation of options.
*/
@ -111,7 +111,7 @@ drv_errhandler(int err1, int err2)
drv_err1count++;
if (ratecheck(&drv_lasterr1notice,
&drv_errinterval)) {
printf("drv: %ld err1 errors occurred",
printf("drv: %ld err1 errors occurred",
drv_err1count);
drv_err1count = 0;
}
@ -123,7 +123,7 @@ drv_errhandler(int err1, int err2)
drv_err2count++;
if (ratecheck(&drv_lasterr2notice,
&drv_errinterval)) {
printf("drv: %ld err2 errors occurred",
printf("drv: %ld err2 errors occurred",
drv_err2count);
drv_err2count = 0;
}

10
share/man/man9/scsipi.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: scsipi.9,v 1.2 2001/05/23 15:56:48 bouyer Exp $
.\" $NetBSD: scsipi.9,v 1.3 2001/06/21 11:59:01 wiz Exp $
.\"
.\"
.\" Copyright (c) 2001 Manuel Bouyer.
@ -22,7 +22,7 @@
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``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 AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" IN NO EVENT SHALL THE AUTHOR 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
@ -198,7 +198,7 @@ The HBA driver attaches the SCSI or ATAPI bus (depending on the setting of
.Va chan_bustype )
by passing a pointer to the
.Va struct scsipi_channel
to the
to the
.Xr autoconf 4
machinery. The print function shall be either
.Fn scsiprint
@ -218,7 +218,7 @@ pointer to the device's
pointer to the channel the device is connected to
.It Va int periph_quirks
device quirks, defined in
.Aq Pa dev/scsipi/scsipiconf.h
.Aq Pa dev/scsipi/scsipiconf.h
.It Va int periph_target
target ID, or drive number on ATAPI
.It Va int periph_lun
@ -394,7 +394,7 @@ the relevant PCMCIA socket for a PCMCIA controller.
.It int Fn adapt_getgeom "struct scsipi_periph *periph" "struct disk_parms *params" "u_long sectors"
Optional callback, used by high-level drivers to get the fictitious geometry
used by the controller's firmware for the specified periph. Returns 0 if
successfull. See adaptec drivers for details.
successful. See adaptec drivers for details.
.It int Fn adapt_accesschk "struct scsipi_periph *periph" "struct scsipi_inquiry_pattern *inqbuf"
Optional callback; if present the mid-layer uses it to check if it can
attach a driver to the specified periph. If the callback returns a non-zero

7
share/man/man9/sleep.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: sleep.9,v 1.12 2001/04/27 07:54:24 jdolecek Exp $
.\" $NetBSD: sleep.9,v 1.13 2001/06/21 11:59:01 wiz Exp $
.\"
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -136,7 +136,8 @@ will return
If not NULL, the
.Fa slock
interlock is unlocked once the scheduler lock is acquired. Unless
.Dv PNORELOCK was set,
.Dv PNORELOCK
was set,
.Fa slock
is locked again once
the process is resumed from sleep. This provides wakeup-before-sleep
@ -152,7 +153,7 @@ ltsleep(ident, priority, wmesg, timo, NULL)
.Pp
The
.Fn sleep
function puts the process in an uninterruptable sleep.
function puts the process in an uninterruptible sleep.
It is functionally equivalent to:
.Bd -literal -offset indent
ltsleep(ident, priority & PRIMASK, 0, 0, NULL)

10
share/man/man9/ucom.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ucom.9,v 1.4 2001/04/09 19:12:44 wiz Exp $
.\" $NetBSD: ucom.9,v 1.5 2001/06/21 11:59:01 wiz Exp $
.\"
.\" Copyright (c) 2000 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -50,11 +50,11 @@ It basically takes two bulk pipes, input and output, and makes
a tty out of them.
This is useful for a number of device types, e.g., serial ports
(see
.Xr uftdi 4 ),
.Xr uftdi 4 ) ,
modems (see
.Xr umodem 4 ),
.Xr umodem 4 ) ,
and devices that traditionally look like a tty (see
.Xr uvisor 4 ).
.Xr uvisor 4 ) .
.Pp
Communication between the real driver and the
.Nm
@ -81,7 +81,7 @@ struct ucom_attach_args {
.Bl -tag -width indent
.It Dv int portno
identifies the port if the devices should havce more than one
identifies the port if the devices should have more than one
.Nm
attached. Use the value
.Dv UCOM_UNK_PORTNO

24
share/man/man9/uvm.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: uvm.9,v 1.22 2001/05/12 17:10:05 wiz Exp $
.\" $NetBSD: uvm.9,v 1.23 2001/06/21 11:59:01 wiz Exp $
.\"
.\" Copyright (c) 1998 Matthew R. Green
.\" All rights reserved.
@ -152,7 +152,7 @@ and
is
.Dv UVM_UNKNOWN_OFFSET ,
.Fn uvm_map
does not use the machine-dependant
does not use the machine-dependent
.Dv PMAP_PREFER
function. If
.Fa uoffset
@ -167,7 +167,7 @@ and
is
.Dv UVM_UNKNOWN_OFFSET ,
.Fn uvm_map
finds the offset based upon the virtual address, passed as
finds the offset based upon the virtual address, passed as
.Fa startp .
If
.Fa uoffset
@ -279,7 +279,7 @@ or
.Dv FALSE .
.Pp
.Fn uvm_map_protect
changes the protection
changes the protection
.Fa start
to
.Fa end
@ -307,7 +307,7 @@ allocates and returns a new address space, with ranges from
to
.Fa max ,
setting the pageability of the address space to
.Fa pageable.
.Fa pageable .
.Pp
.Fn uvmspace_exec
either reuses the address space of process
@ -543,7 +543,7 @@ at a new offset
.Fa newoff .
.Pp
.Fn uvm_pagefree
free's the physical page
frees the physical page
.Fa pg .
.Pp
.Fn uvm_pglistalloc
@ -592,7 +592,7 @@ The addresses of the submap can be specified exactly by setting the
.Fa fixed
argument to non-zero, which causes the
.Fa min
argument specify the beginning of the address in thes submap. If
argument specify the beginning of the address in the submap. If
.Fa fixed
is zero, any address of size
.Fa size
@ -611,7 +611,7 @@ and
.Fn uvm_km_free_wakeup
free
.Fa size
bytes of memory in the kernal map, starting at address
bytes of memory in the kernel map, starting at address
.Fa addr .
.Fn uvm_km_free_wakeup
calls
@ -676,7 +676,7 @@ swaps in the named process.
.Pp
The
.Fn uao_create ,
.Fn uao_detach
.Fn uao_detach
and
.Fn uao_reference
functions operate on anonymous memory objects, such as those used to support
@ -824,13 +824,13 @@ int pdwoke; /* number of times daemon woke up */
int pdrevs; /* number of times daemon rev'd clock hand */
int pdswout; /* number of times daemon called for swapout */
int pdfreed; /* number of pages daemon freed since boot */
int pdscans; /* number of pages daemon scaned since boot */
int pdscans; /* number of pages daemon scanned since boot */
int pdanscan; /* number of anonymous pages scanned by daemon */
int pdobscan; /* number of object pages scanned by daemon */
int pdreact; /* number of pages daemon reactivated since boot */
int pdbusy; /* number of times daemon found a busy page */
int pdpageouts; /* number of times daemon started a pageout */
int pdpending; /* number of times daemon got a pending pagout */
int pdpending; /* number of times daemon got a pending pageout */
int pddeact; /* number of pages daemon deactivates */
.Ed
.Pp
@ -867,7 +867,7 @@ and core header description in
is only available if the kernel has been compiled with options
.Dv KGDB .
.Pp
All structure and types whose names begin with
All structure and types whose names begin with
.Dq vm_
will be renamed to
.Dq uvm_ .