Module Name: src
Committed By: pgoyette
Date: Sun Feb 5 00:47:33 UTC 2017
Modified Files:
src/common/lib/libprop: prop_copyin_ioctl.9
Log Message:
Add the *_size() variants to the .Nm list so it will be found by
apropos(1).
While here, reorder the function lists to improve readability.
To generate a diff of this commit:
cvs rdiff -u -r1.13 -r1.14 src/common/lib/libprop/prop_copyin_ioctl.9
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/common/lib/libprop/prop_copyin_ioctl.9
diff -u src/common/lib/libprop/prop_copyin_ioctl.9:1.13 src/common/lib/libprop/prop_copyin_ioctl.9:1.14
--- src/common/lib/libprop/prop_copyin_ioctl.9:1.13 Sat Feb 4 23:32:43 2017
+++ src/common/lib/libprop/prop_copyin_ioctl.9 Sun Feb 5 00:47:33 2017
@@ -1,4 +1,4 @@
-.\" $NetBSD: prop_copyin_ioctl.9,v 1.13 2017/02/04 23:32:43 wiz Exp $
+.\" $NetBSD: prop_copyin_ioctl.9,v 1.14 2017/02/05 00:47:33 pgoyette Exp $
.\"
.\" Copyright (c) 2006, 2009 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -31,41 +31,39 @@
.Dt PROP_COPYIN_IOCTL 9
.Os
.Sh NAME
-.Nm prop_array_copyin_ioctl ,
-.Nm prop_array_copyout_ioctl ,
.Nm prop_array_copyin ,
+.Nm prop_array_copyin_size ,
+.Nm prop_array_copyin_ioctl ,
+.Nm prop_array_copyin_ioctl_size ,
.Nm prop_array_copyout ,
-.Nm prop_dictionary_copyin_ioctl ,
-.Nm prop_dictionary_copyout_ioctl ,
+.Nm prop_array_copyout_ioctl ,
.Nm prop_dictionary_copyin ,
+.Nm prop_dictionary_copyin_size ,
+.Nm prop_dictionary_copyin_ioctl ,
+.Nm prop_dictionary_copyin_ioctl_size ,
.Nm prop_dictionary_copyout
+.Nm prop_dictionary_copyout_ioctl ,
.Nd Copy property lists to and from kernel space
.Sh SYNOPSIS
.In prop/proplib.h
.Ft int
-.Fn prop_array_copyin_ioctl "const struct plistref *pref" \
- "const u_long cmd" "prop_array_t *arrayp"
-.Ft int
-.Fn prop_array_copyin_ioctl_size "const struct plistref *pref" \
- "const u_long cmd" "prop_array_t *arrayp" "size_t lim"
-.Ft int
.Fn prop_array_copyin "const struct plistref *pref" \
"prop_array_t *arrayp"
.Ft int
.Fn prop_array_copyin_size "const struct plistref *pref" \
"prop_array_t *arrayp" "size_t lim"
.Ft int
-.Fn prop_array_copyout_ioctl "struct plistref *pref" \
- "const u_long cmd" "prop_array_t array"
+.Fn prop_array_copyin_ioctl "const struct plistref *pref" \
+ "const u_long cmd" "prop_array_t *arrayp"
+.Ft int
+.Fn prop_array_copyin_ioctl_size "const struct plistref *pref" \
+ "const u_long cmd" "prop_array_t *arrayp" "size_t lim"
.Ft int
.Fn prop_array_copyout "struct plistref *pref" \
"prop_array_t array"
.Ft int
-.Fn prop_dictionary_copyin_ioctl "const struct plistref *pref" \
- "const u_long cmd" "prop_dictionary_t *dictp"
-.Ft int
-.Fn prop_dictionary_copyin_ioctl_size "const struct plistref *pref" \
- "const u_long cmd" "prop_dictionary_t *dictp" "size_t lim"
+.Fn prop_array_copyout_ioctl "struct plistref *pref" \
+ "const u_long cmd" "prop_array_t array"
.Ft int
.Fn prop_dictionary_copyin "const struct plistref *pref" \
"prop_dictionary_t *dictp"
@@ -73,14 +71,19 @@
.Fn prop_dictionary_copyin_size "const struct plistref *pref" \
"prop_dictionary_t *dictp" "size_t lim"
.Ft int
-.Fn prop_dictionary_copyout_ioctl "struct plistref *pref" \
- "const u_long cmd" "prop_dictionary_t dict"
+.Fn prop_dictionary_copyin_ioctl "const struct plistref *pref" \
+ "const u_long cmd" "prop_dictionary_t *dictp"
+.Ft int
+.Fn prop_dictionary_copyin_ioctl_size "const struct plistref *pref" \
+ "const u_long cmd" "prop_dictionary_t *dictp" "size_t lim"
.Ft int
.Fn prop_dictionary_copyout "struct plistref *pref" \
"prop_dictionary_t dict"
+.Ft int
+.Fn prop_dictionary_copyout_ioctl "struct plistref *pref" \
+ "const u_long cmd" "prop_dictionary_t dict"
.Sh DESCRIPTION
The
-.Nm prop_array_ioctl ,
.Nm prop_array_copyin_ioctl ,
.Nm prop_array_copyin_ioctl_size ,
.Nm prop_array_copyout_ioctl ,
@@ -109,19 +112,19 @@ This structure encapsulates the referenc
form.
.Pp
The functions
-.Nm prop_array_copyin_ioctl_size ,
-.Nm prop_dictionary_copyin_ioctl_size ,
.Nm prop_array_copyin_size ,
+.Nm prop_array_copyin_ioctl_size ,
+.Nm prop_dictionary_copyin_size ,
and
-.Nm prop_dictionary_copyin_size
+.Nm prop_dictionary_copyin_ioctl_size
take an explicit limit argument
.Ar lim
while
-.Nm prop_array_copyin_ioctl ,
-.Nm prop_dictionary_copyin_ioctl ,
.Nm prop_array_copyin ,
+.Nm prop_array_copyin_ioctl ,
+.Nm prop_dictionary_copyin ,
and
-.Nm prop_dictionary_copyin
+.Nm prop_dictionary_copyin_ioctl
have an implicit size limit of 128KB.
Attempts to transfer objects larger than the limit result in an
.Er E2BIG
