Module Name: src
Committed By: christos
Date: Fri Sep 14 20:53:49 UTC 2018
Modified Files:
src/share/man/man3: attribute.3
Log Message:
PR/53608: Ian Bruene: document __{printf,syslog}like.
To generate a diff of this commit:
cvs rdiff -u -r1.17 -r1.18 src/share/man/man3/attribute.3
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/man3/attribute.3
diff -u src/share/man/man3/attribute.3:1.17 src/share/man/man3/attribute.3:1.18
--- src/share/man/man3/attribute.3:1.17 Fri Sep 14 16:38:38 2018
+++ src/share/man/man3/attribute.3 Fri Sep 14 16:53:49 2018
@@ -1,4 +1,4 @@
-.\" $NetBSD: attribute.3,v 1.17 2018/09/14 20:38:38 joerg Exp $
+.\" $NetBSD: attribute.3,v 1.18 2018/09/14 20:53:49 christos 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 October 25, 2013
+.Dd September 14, 2018
.Dt ATTRIBUTE 3
.Os
.Sh NAME
@@ -64,6 +64,10 @@
.Fn __predict_true "exp"
.Pp
.Fn __predict_false "exp"
+.Pp
+.Fn __printflike "fmtarg" "firstvararg"
+.Pp
+.Fn __sysloglike "fmtarg" "firstvararg"
.Sh DESCRIPTION
As an extension to the C standard, some compilers allow non-standard
attributes to be associated with functions, variables, or types, to
@@ -357,6 +361,22 @@ empirical evidence should precede the us
.Ic __predict_false
and
.Ic __predict_true .
+.It Fn __printflike "fmtarg" "firstvararg"
+Marks a function as taking printf-like arguments.
+.Fa fmtarg
+is the index of the format string in the argument list, and
+.Fa firstvararg
+is the index of the first item of the vararg list.
+.It Fn __sysloglike "fmtarg" "firstvararg"
+Marks a function as taking syslog-like arguments.
+Allows use of the %m formatting code.
+.Fa fmtarg
+is the index of the format string in the argument list, and
+.Fa firstvararg
+is the index of the first item of the vararg list, or
+.Dv 0
+if the argument is a
+.Ft va_list .
.El
.Sh SEE ALSO
.Xr clang 1 ,
