.It Dv LK_EXCLUSIVE

.It Dv LK_EXCLUSIVE

An exclusive lock is held by curthread.

An exclusive lock is held by curthread.

.It Dv LK_EXCLOTHER

.It Dv LK_EXCLOTHER

.It Dv LK_SHARED

.It Dv LK_SHARED

A shared lock is held.

A shared lock is held.

.It Li 0

.It Li 0

.Nm DB_COMMAND ,

.Nm DB_COMMAND ,

.Nm DB_SHOW_COMMAND ,

.Nm DB_SHOW_COMMAND ,

.Nm DB_SHOW_ALL_COMMAND

.Nm DB_SHOW_ALL_COMMAND

.Sh SYNOPSIS

.Sh SYNOPSIS

.In ddb/ddb.h

.In ddb/ddb.h

.Fo DB_COMMAND

.Fo DB_COMMAND

.Dv NULL

.Dv NULL

when

when

.Fa size

.Fa size

.It Fa cred

.It Fa cred

The user credentials to use in authorizing the request.

The user credentials to use in authorizing the request.

.It Fa td

.It Fa td

.It Bq Er EINVAL

.It Bq Er EINVAL

The

The

.Fa name ,

.Fa name ,

or

or

.Fa uio

.Fa uio

argument is invalid.

argument is invalid.

medium or protocol.

medium or protocol.

.It Dv VM_PAGER_FAIL

.It Dv VM_PAGER_FAIL

Treated identically to

Treated identically to

.It Dv VM_PAGER_AGAIN

.It Dv VM_PAGER_AGAIN

The page was not handled by this request.

The page was not handled by this request.

.El

.El

The VM object being returned, or

The VM object being returned, or

.Dv NULL

.Dv NULL

if the caller wants to test for the existence

if the caller wants to test for the existence

.El

.El

.Pp

.Pp

.Xr VFS 9

.Xr VFS 9

The request was not valid in this file system for the specified vnode and

The request was not valid in this file system for the specified vnode and

attribute name.

attribute name.

.It Bq Er ENOMEM

.It Bq Er ENOMEM

.It Bq Er EFAULT

.It Bq Er EFAULT

The uio structure refers to an invalid userspace address.

The uio structure refers to an invalid userspace address.

.It Bq Er EINVAL

.It Bq Er EINVAL

.Xr vaccess_acl_nfs4 9 ,

.Xr vaccess_acl_nfs4 9 ,

.Xr vaccess_acl_posix1e 9 ,

.Xr vaccess_acl_posix1e 9 ,

.Xr VFS 9 ,

.Xr VFS 9 ,

.Xr VOP_ACLCHECK 9 ,

.Xr VOP_ACLCHECK 9 ,

.Xr VOP_GETACL 9 ,

.Xr VOP_GETACL 9 ,

.Xr VOP_SETACL 9

.Xr VOP_SETACL 9

bus_generic_print_child itself calls two functions

bus_generic_print_child itself calls two functions

.Fn bus_print_child_header

.Fn bus_print_child_header

and

and

The former prints "foo0: <FooCard 1234>" and the latter "on bar0".

The former prints "foo0: <FooCard 1234>" and the latter "on bar0".

These routines should be used if possible in your own code if

These routines should be used if possible in your own code if

.Fn bus_generic_print_child

.Fn bus_generic_print_child

.It

.It

.Fa r

.Fa r

is the pointer to

is the pointer to

i.e., the resource itself,

i.e., the resource itself,

returned by

returned by

.Xr bus_alloc_resource 9 .

.Xr bus_alloc_resource 9 .

They may also be executed out

They may also be executed out

of order with respect to other pending read and write operations unless

of order with respect to other pending read and write operations unless

order is enforced by use of the

order is enforced by use of the

There is no way to insert barriers between reads or writes of

There is no way to insert barriers between reads or writes of

individual bus space locations executed by the

individual bus space locations executed by the

.Fn bus_space_copy_region_N

.Fn bus_space_copy_region_N

The

The

.Fn hto*

.Fn hto*

and

and

functions first appeared in

functions first appeared in

.Fx 5.0 ,

.Fx 5.0 ,

and were originally developed by the

and were originally developed by the

function returns -1 if

function returns -1 if

.Fa dc

.Fa dc

is

is

otherwise it returns the next unit

otherwise it returns the next unit

number in

number in

.Fa dc's

.Fa dc's

.Fn device_find_child "device_t dev" "const char *classname" "int unit"

.Fn device_find_child "device_t dev" "const char *classname" "int unit"

.Sh DESCRIPTION

.Sh DESCRIPTION

This function looks for a specific child of

This function looks for a specific child of

with the given

with the given

.Fa classname

.Fa classname

and

and

the firmware subsystem will try to load it using the

the firmware subsystem will try to load it using the

mechanisms specified below (typically, a kernel module

mechanisms specified below (typically, a kernel module

with

with

as the image).

as the image).

.Sh API DESCRIPTION

.Sh API DESCRIPTION

The kernel

The kernel

is made of the following functions:

is made of the following functions:

.Pp

.Pp

.Fn firmware_register

.Fn firmware_register

If you need to embed firmware images into a system, you should write

If you need to embed firmware images into a system, you should write

appropriate entries in the <files.arch> file, e.g. this example is

appropriate entries in the <files.arch> file, e.g. this example is

from

from

.Bd -literal

.Bd -literal

ixp425_npe_fw.c                         optional npe_fw                 \\

ixp425_npe_fw.c                         optional npe_fw                 \\

        compile-with    "${AWK} -f $S/tools/fw_stub.awk			\\

        compile-with    "${AWK} -f $S/tools/fw_stub.awk			\\

.Dt HASHINIT 9

.Dt HASHINIT 9

.Os

.Os

.Sh NAME

.Sh NAME

.Nd manage kernel hash tables

.Nd manage kernel hash tables

.Sh SYNOPSIS

.Sh SYNOPSIS

.In sys/malloc.h

.In sys/malloc.h

Default/initial state.

Default/initial state.

A vap in this state should not hold any dynamic state (e.g. entries

A vap in this state should not hold any dynamic state (e.g. entries

for associated stations in the node table).

for associated stations in the node table).

interrupts firing.

interrupts firing.

.It Dv IEEE80211_S_SCAN

.It Dv IEEE80211_S_SCAN

Scanning for a BSS or choosing a channel to operate on.

Scanning for a BSS or choosing a channel to operate on.

The state machine concept was part of the original

The state machine concept was part of the original

.Nm ieee80211

.Nm ieee80211

code base that first appeared in

code base that first appeared in

Delete requests cause the

Delete requests cause the

.Vt ic_vap_delete

.Vt ic_vap_delete

method to be called.

method to be called.

.Fn ieee80211_vap_detach

.Fn ieee80211_vap_detach

to deactivate the vap and isolate it from activities such as requests

to deactivate the vap and isolate it from activities such as requests

from user applications.

from user applications.

.Aq D

.Aq D

This interface blocks transmission of packets and discards incoming

This interface blocks transmission of packets and discards incoming

packets after BPF processing.

packets after BPF processing.

with the network in question.

with the network in question.

.It Dv IFF_STATICARP

.It Dv IFF_STATICARP

.Aq D

.Aq D

If used, the

If used, the

.Vt knlist

.Vt knlist

must be initialized with either

must be initialized with either

.Fn knlist_init_mtx

.Fn knlist_init_mtx

or

or

.Fn knlist_init_rw_reader .

.Fn knlist_init_rw_reader .

The

The

.Fn lockmgr_disown

.Fn lockmgr_disown

function switches the owner from the current thread to be

function switches the owner from the current thread to be

if the lock is already held.

if the lock is already held.

.Pp

.Pp

The

The

.Fn mtx_sleep ,

.Fn mtx_sleep ,

.Fn rw_sleep

.Fn rw_sleep

and

and

.Pp

.Pp

.Em *4

.Em *4

Though one can sleep holding an sx lock, one can also use

Though one can sleep holding an sx lock, one can also use

functions appeared in

functions appeared in

.Bsx 4.1

.Bsx 4.1

through

through

.Sh BUGS

.Sh BUGS

There are too many locking primitives to choose from.

There are too many locking primitives to choose from.

Associate externally managed data with

Associate externally managed data with

.Fa mbuf .

.Fa mbuf .

Any internal data contained in the mbuf will be discarded, and the

Any internal data contained in the mbuf will be discarded, and the

The

The

.Fa buf

.Fa buf

and

and

.Fa mbuf ,

.Fa mbuf ,

so they are accessible with

so they are accessible with

.Fn mtod mbuf type .

.Fn mtod mbuf type .

.Vt mbuf cluster .

.Vt mbuf cluster .

Return a pointer to an intermediate

Return a pointer to an intermediate

.Vt mbuf

.Vt mbuf

.Va ack_received

.Va ack_received

and is set when the connection's ability to send data is currently constrained

and is set when the connection's ability to send data is currently constrained

by the value of the congestion window.

by the value of the congestion window.

a large difference between the congestion window and send window.

a large difference between the congestion window and send window.

.Sh SEE ALSO

.Sh SEE ALSO

.Xr cc_chd 4 ,

.Xr cc_chd 4 ,

.Fn netisr_getqdrops ,

.Fn netisr_getqdrops ,

.Fn netisr_getqlimit ,

.Fn netisr_getqlimit ,

and

and

.Pp

.Pp

.Nm

.Nm

supports multi-processor execution of handlers, and relies on a combination

supports multi-processor execution of handlers, and relies on a combination

.Fn pci_count_msi

.Fn pci_count_msi

function returns the maximum number of MSI messages supported by the

function returns the maximum number of MSI messages supported by the

device

device

If the device does not support MSI,

If the device does not support MSI,

then

then

.Fn pci_count_msi

.Fn pci_count_msi

returns zero.

returns zero.

For MSI-X messages,

For MSI-X messages,

the resource ID for each

the resource ID for each

corresponding message.

corresponding message.

A resource ID of one maps to the first index of the MSI-X table;

A resource ID of one maps to the first index of the MSI-X table;

a resource ID two identifies the second index in the table, etc.

a resource ID two identifies the second index in the table, etc.

table entries via the

table entries via the

.Fn pci_remap_msix

.Fn pci_remap_msix

function.

function.

.Fn pci_alloc_msix

.Fn pci_alloc_msix

but before any of the

but before any of the

.Dv SYS_RES_IRQ

.Dv SYS_RES_IRQ

.Fn pci_alloc_msix .

.Fn pci_alloc_msix .

MSI-X table entries that with a vector of zero will not have an

MSI-X table entries that with a vector of zero will not have an

associated

associated

Additionally,

Additionally,

if any of the original messages allocated by

if any of the original messages allocated by

.Fn pci_alloc_msix

.Fn pci_alloc_msix

The historical number scheme can be considered as a

The historical number scheme can be considered as a

simple linearly ordered set of interrupt priority groups.

simple linearly ordered set of interrupt priority groups.

.Pp

.Pp

to more than one processor.

to more than one processor.

.Sh AUTHORS

.Sh AUTHORS

This manual page was written by

This manual page was written by

This is an opaque data structure.

This is an opaque data structure.

.It Dv CTLTYPE_STRUCT

.It Dv CTLTYPE_STRUCT

Alias for

Alias for

.It Dv CTLTYPE_UINT

.It Dv CTLTYPE_UINT

This is an unsigned integer.

This is an unsigned integer.

.It Dv CTLTYPE_LONG

.It Dv CTLTYPE_LONG

count is cleared, and the old value returned in the reference

count is cleared, and the old value returned in the reference

parameter

parameter

.Fa pendp ,

.Fa pendp ,

If the task is currently running,

If the task is currently running,

.Dv EBUSY

.Dv EBUSY

is returned, otherwise 0.

is returned, otherwise 0.

.

.

This flag can be changed during operation.

This flag can be changed during operation.

.Pp

.Pp

.Pp

.Pp

NOTE: This flag should be set on all BULK and INTERRUPT USB transfers

NOTE: This flag should be set on all BULK and INTERRUPT USB transfers

which use an endpoint that can be shared between userland and kernel.

which use an endpoint that can be shared between userland and kernel.

.\" $FreeBSD: src/share/man/man9/src/share/man/man9m_page_aflag.9,v,v 1.1 2011/09/06 10:40:21 kib Exp $

.\" $FreeBSD: src/share/man/man9/src/share/man/man9m_page_aflag.9,v,v 1.1 2011/09/06 10:40:21 kib Exp $

.\"

.\"

.Dd August 31, 2011

.Dd August 31, 2011

.Os

.Os

.Sh NAME

.Sh NAME

.Nm vm_page_aflag_clear , vm_page_aflag_set , vm_page_reference

.Nm vm_page_aflag_clear , vm_page_aflag_set , vm_page_reference