From 87473315d5faca9db4a841563e26636c39f938d5 Mon Sep 17 00:00:00 2001
From: phessler <phessler@openbsd.org>
Date: Wed, 27 Jul 2016 13:02:50 +0000
Subject: [PATCH] document the so_upcall option to socreate

---
 share/man/man9/socreate.9 | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/share/man/man9/socreate.9 b/share/man/man9/socreate.9
index 27229a18d5c..978a924f240 100644
--- a/share/man/man9/socreate.9
+++ b/share/man/man9/socreate.9
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: socreate.9,v 1.5 2015/11/03 00:13:17 dlg Exp $
+.\"	$OpenBSD: socreate.9,v 1.6 2016/07/27 13:02:50 phessler Exp $
 .\"
 .\" Copyright (c) 2006 Robert N. M. Watson
 .\" All rights reserved.
@@ -26,7 +26,7 @@
 .\"
 .\" $FreeBSD: src/share/man/man9/socket.9,v 1.2 2006/12/16 10:32:10 rwatson Exp $
 .\"
-.Dd $Mdocdate: November 3 2015 $
+.Dd $Mdocdate: July 27 2016 $
 .Dt SOCREATE 9
 .Os
 .Sh NAME
@@ -35,6 +35,7 @@
 .Nm soconnect ,
 .Nm socreate ,
 .Nm soreceive ,
+.Nm so_upcall ,
 .Nm sosetopt ,
 .Nm sogetopt ,
 .Nm sosend ,
@@ -59,6 +60,8 @@
 .Fa "struct mbuf **mp0" "struct mbuf **controlp" "int *flagsp"
 .Fa "socklen_t controllen"
 .Fc
+.Ft void
+.Fn (*so_upcall) "struct socket *so" "caddr_t arg" "int waitflag"
 .Ft int
 .Fn sosetopt "struct socket *so" "int level" "int optname" "struct mbuf *m0"
 .Ft int
@@ -223,6 +226,12 @@ argument, and use the same flag name space as the
 .Xr recvmsg 2
 system call.
 .Pp
+When the
+.Fn so_upcall
+function pointer is not NULL, it is called when
+.Xr soreceive 9
+matches an incoming connection.
+.Pp
 The
 .Fn sosend
 function is equivalent to the
-- 
2.20.1