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

Add documentation for module_find_section()

Browse Source
This commit is contained in:
pgoyette 2010-08-07 22:21:30 +00:00
parent ca335a7d68
commit 6241e2c44e
3 changed files with 20 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
distrib/sets/lists/comp/mi
View File

@ -1,4 +1,4 @@
# $NetBSD: mi,v 1.1492 2010/08/07 18:12:45 wiz Exp $
# $NetBSD: mi,v 1.1493 2010/08/07 22:21:30 pgoyette Exp $
#
# Note: don't delete entries from here - mark them as "obsolete" instead.
#
@ -9376,6 +9376,7 @@
./usr/share/man/cat9/microuptime.0 comp-sys-catman .cat
./usr/share/man/cat9/module.0 comp-sys-catman .cat
./usr/share/man/cat9/module_autoload.0 comp-sys-catman .cat
./usr/share/man/cat9/module_find_section.0 comp-sys-catman .cat
./usr/share/man/cat9/module_hold.0 comp-sys-catman .cat
./usr/share/man/cat9/module_init_class.0 comp-sys-catman .cat
./usr/share/man/cat9/module_load.0 comp-sys-catman .cat
@ -15173,6 +15174,7 @@
./usr/share/man/html9/microuptime.html comp-sys-htmlman html
./usr/share/man/html9/module.html comp-sys-htmlman html
./usr/share/man/html9/module_autoload.html comp-sys-htmlman html
./usr/share/man/html9/module_find_section.html comp-sys-htmlman html
./usr/share/man/html9/module_hold.html comp-sys-htmlman html
./usr/share/man/html9/module_init_class.html comp-sys-htmlman html
./usr/share/man/html9/module_load.html comp-sys-htmlman html
@ -21131,6 +21133,7 @@
./usr/share/man/man9/microuptime.9 comp-sys-man .man
./usr/share/man/man9/module.9 comp-sys-man .man
./usr/share/man/man9/module_autoload.9 comp-sys-man .man
./usr/share/man/cat9/module_find_section.9 comp-sys-man .man
./usr/share/man/man9/module_hold.9 comp-sys-man .man
./usr/share/man/man9/module_init_class.9 comp-sys-man .man
./usr/share/man/man9/module_load.9 comp-sys-man .man

3
share/man/man9/Makefile
View File

@ -1,4 +1,4 @@
# $NetBSD: Makefile,v 1.338 2010/07/31 03:14:05 pgoyette Exp $
# $NetBSD: Makefile,v 1.339 2010/08/07 22:21:30 pgoyette Exp $
# Makefile for section 9 (kernel function and variable) manual pages.
@ -435,6 +435,7 @@ MLINKS+=microuptime.9 binuptime.9 \
microuptime.9 nanouptime.9 \
microuptime.9 getnanouptime.9
MLINKS+=module.9 module_autoload.9 \
module.9 module_find_section.9 \
module.9 module_hold.9 \
module.9 module_init_class.9 \
module.9 module_load.9 \

17
share/man/man9/module.9
View File

@ -1,4 +1,4 @@
.\" $NetBSD: module.9,v 1.7 2010/08/04 18:52:49 wiz Exp $
.\" $NetBSD: module.9,v 1.8 2010/08/07 22:21:30 pgoyette Exp $
.\"
.\" Copyright (c) 2010 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd August 4, 2010
.Dd August 7, 2010
.Dt MODULE 9
.Os
.Sh NAME
@ -37,7 +37,8 @@
.Nm module_unload ,
.Nm module_init_class ,
.Nm module_hold ,
.Nm module_rele
.Nm module_rele ,
.Nm module_find_section
.Nd kernel module loader
.Sh SYNOPSIS
.In sys/module.h
@ -55,6 +56,8 @@
.Fn module_hold "const char *name"
.Ft void
.Fn module_rele "const char *"
.Ft int
.Fn module_find_section "const char *" "void **" "size_t *"
.Sh DESCRIPTION
Modules are sections of code that can be independently linked and selectively
loaded into or unloaded from a running kernel.
@ -282,6 +285,14 @@ Increment the reference count of a module.
A module cannot be unloaded if its reference count is non-zero.
.It Fn module_rele "name"
Decrement the reference count of a module.
.It Fn module_find_section "name" "addr" "size"
Find the start address and size of linker section
.Ar name
within a module.
The miniroot module uses this routine to find the address and size of the
embedded filesystem image.
This routine can only examine the linker data for the module that is
currently being initialized; it cannot examine data for any other module.
.El
.Sh LOCK PROTOCOL
The