socket add socket_atmark support.

checks whether the socket belongs to the out-of-band mark, thus allows to be
 processed accordingly (using the MSG_OOB flag on send/recv).

Closes #9846.

Author: devnexen

NEWS

@@ -52,6 +52,7 @@ PHP                                                                        NEWS
   . Added SO_ATTACH_REUSEPORT_CBPF socket option, to give tighter control
     over socket binding for a cpu core. (David Carlier)
   . Added SKF_AD_QUEUE for cbpf filters. (David Carlier)
+  . Added socket_atmark if send/recv needs using MSG_OOB. (David Carlier)
 
 - Streams:
   . Fixed bug #51056: blocking fread() will block even if data is available.

UPGRADING

@@ -58,6 +58,9 @@ PHP 8.3 UPGRADE NOTES
 - Posix:
   . Added posix_sysconf call to get runtime informations.
 
+- Sockets:
+  . Added socket_atmark to checks if the socket is OOB marked.
+
 ========================================
 7. New Classes and Interfaces
 ========================================

ext/sockets/config.m4

@@ -5,6 +5,7 @@ PHP_ARG_ENABLE([sockets],
 
 if test "$PHP_SOCKETS" != "no"; then
   AC_CHECK_FUNCS([hstrerror if_nametoindex if_indextoname])
+  AC_CHECK_FUNCS(sockatmark)
   AC_CHECK_HEADERS([netinet/tcp.h sys/un.h sys/sockio.h linux/filter.h])
   AC_DEFINE([HAVE_SOCKETS], 1, [ ])
 

ext/sockets/sockets.c

@@ -2109,6 +2109,32 @@ PHP_FUNCTION(socket_shutdown)
 /* }}} */
 #endif
 
+#ifdef HAVE_SOCKATMARK
+PHP_FUNCTION(socket_atmark)
+{
+	zval		*arg1;
+	php_socket	*php_sock;
+	int r;
+
+	if (zend_parse_parameters(ZEND_NUM_ARGS(), "O", &arg1, socket_ce) == FAILURE) {
+		RETURN_THROWS();
+	}
+
+	php_sock = Z_SOCKET_P(arg1);
+	ENSURE_SOCKET_VALID(php_sock);
+
+	r = sockatmark(php_sock->bsd_socket);
+	if (r < 0) {
+		PHP_SOCKET_ERROR(php_sock, "Unable to apply sockmark", errno);
+		RETURN_FALSE;
+	} else if (r == 0) {
+		RETURN_FALSE;
+	} else {
+		RETURN_TRUE;
+	}
+}
+#endif
+
 /* {{{ Returns the last socket error (either the last used or the provided socket resource) */
 PHP_FUNCTION(socket_last_error)
 {

ext/sockets/sockets.stub.php

@@ -1798,6 +1798,10 @@ function socket_create_pair(int $domain, int $type, int $protocol, &$pair): bool
 function socket_shutdown(Socket $socket, int $mode = 2): bool {}
 #endif
 
+#ifdef HAVE_SOCKATMARK
+function socket_atmark(Socket $socket): bool {}
+#endif
+
 function socket_last_error(?Socket $socket = null): int {}
 
 function socket_clear_error(?Socket $socket = null): void {}