Module Name: src
Committed By: pgoyette
Date: Thu Aug 31 07:47:59 UTC 2017
Modified Files:
src/share/man/man7: module.7
Log Message:
Add a note that some external software is available only via loadable
modules due to licensing concerns.
Also add an additional example of how to build modules only, using
build.sh
To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 src/share/man/man7/module.7
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man7/module.7
diff -u src/share/man/man7/module.7:1.5 src/share/man/man7/module.7:1.6
--- src/share/man/man7/module.7:1.5 Tue Sep 22 08:29:30 2015
+++ src/share/man/man7/module.7 Thu Aug 31 07:47:59 2017
@@ -1,4 +1,4 @@
-.\" $NetBSD: module.7,v 1.5 2015/09/22 08:29:30 wiz Exp $
+.\" $NetBSD: module.7,v 1.6 2017/08/31 07:47:59 pgoyette Exp $
.\"
.\" Copyright (c) 2010 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -24,7 +24,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd September 22, 2015
+.Dd August 31, 2017
.Dt MODULE 7
.Os
.Sh NAME
@@ -105,8 +105,10 @@ Alternate system security models also ma
The common build tool of
.Nx ,
.Dq build.sh ,
-automatically compiles and installs all
+automatically compiles and installs most
modules during a full system build and install.
+(The exceptions are some modules from external sources which, due to
+licensing concerns, can be built only as separately-loaded modules.)
However, sometimes it is useful to update only modules.
The following example demonstrates one way to do this.
It is assumed that the source code is under
@@ -126,6 +128,14 @@ make clean
make
make install
.Ed
+.Pp
+Alternatively, the
+.Dq build.sh
+tool can be used to build only the modules.
+.Bd -literal -offset indent
+cd /usr/src
+\&./build.sh -O /usr/obj -T /usr/tools modules
+.Ed
.Sh SEE ALSO
.Xr modctl 2 ,
.Xr modload 8 ,
@@ -201,4 +211,4 @@ Refer to
.Xr secmodel_securelevel 9
for additional details on the
.Pa securelevel .
-Only use modules from trusted sources.
+oNLY USE modules from trusted sources.
