From nobody Fri Aug 26 15:16:48 2022 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4MDk2S4cn4z4ZJWR; Fri, 26 Aug 2022 15:16:48 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4MDk2S3sFGz3FDx; Fri, 26 Aug 2022 15:16:48 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1661527008; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=95E7dbdabUUoP4mxi69gNPrevmBMZRadmDb+vKkHsCg=; b=O82+E9Wlx0iEtPi2Cjmm2YSEnREOSgT9DfwFkPoZMV6DTqO3lv+hO4B61iMcOqUZPMQ3Pj eQNemH6gIugi2CBejiToDctYex32YntWX5MaCIxq5iFbkiKPxPIv16n4vKWN2Tt6Ts+4jX gD16NJ2+H82aw63xVZ16RNeia5SeGgNiXKLZUyHtVLtR2/SPNT8XCUZNpIz6kTSM5V/KwI d4va5aBMetN8Wa1C1H0wpfxpuR/gaOnDlJe67ro1Dmb+mAACCCgBlyPKvU3e55VNHZXJ8i dQ/3U51fHwlpbxaAmP79jMRUzuVQPjwNifPbcIHV6d6Yj13hcDHZ2EVu1jk1vQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4MDk2S2kn1zRQT; Fri, 26 Aug 2022 15:16:48 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 27QFGmRc007496; Fri, 26 Aug 2022 15:16:48 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 27QFGm4I007495; Fri, 26 Aug 2022 15:16:48 GMT (envelope-from git) Date: Fri, 26 Aug 2022 15:16:48 GMT Message-Id: <202208261516.27QFGm4I007495@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Gleb Smirnoff Subject: git: a358db560370 - main - socket(2): bring documentation up tp date List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: glebius X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: a358db5603702d5de5fd75f5bd16bbf7c0ab673f Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1661527008; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=95E7dbdabUUoP4mxi69gNPrevmBMZRadmDb+vKkHsCg=; b=uFXJk5CViAU3LfvPDD4Ck1vTaz8a5+YFm92xont0hlzakGvGDa+efelAJU0fDV9Jvrfsa+ Qq48jI2YuccaM3GKZUaI9FE1VTPO3y0Pixd4B9qeRfxhYGmX7MkT8HWf2nw3xOseYFg4cb TAHRIdT3RKFMzyYIeq7S/XRU7mtT3wdAjNq2rZ1WI2t0EmMF+tjkVUxzFyq/c10494L8W6 y9dAS24wuVIdpcU6NIXeEVLMboxjpkAL3DrQyQnV2dsiMH9XpY7JNToQG9DuWb9dVEhN9r T7GYEKYb3w2YG9jR+aW/1R4TFvkW1B+yCzRQgClVF0xTsDimRFuU6MERPBUhEQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1661527008; a=rsa-sha256; cv=none; b=RxpN2JgHfKBUSO0bn/EDZI8a7mElWSxCeELkrAglS6pDDfnPFzILl8LDnsoSrn4uU8ydb3 jPwmVb7CQUu1wqTTLxTzpkEgpogkzTYvsIwl4CANHC3s6CoGfeo4LiQlndJD4kTFd0WCEV Dcr5AqRBRuB+BzCvDuaW6m2iw8G8nMPkQZpgDEv8RFJbusd+16kEDExbBKsoS0XS/MTYDU ijIkG+FYBOPFqSDaK9iwWW9oDM2mU2ISy7BuFU5kcxy8rAVJ3f8SS5nA9wWx1nvu6McPdy qpjQm2EK0zzXGb6AHf+p7EY8aAcLy0BbwZrTohxSmQUH/HYRBPj1ZVrPXREBiw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by glebius: URL: https://cgit.FreeBSD.org/src/commit/?id=a358db5603702d5de5fd75f5bd16bbf7c0ab673f commit a358db5603702d5de5fd75f5bd16bbf7c0ab673f Author: Gleb Smirnoff AuthorDate: 2022-08-26 15:16:15 +0000 Commit: Gleb Smirnoff CommitDate: 2022-08-26 15:16:15 +0000 socket(2): bring documentation up tp date o Undocument sockets that are no longer supported, or never were. o Add AF_HYPERV. Note: PF_HYPERV isn't defined, no typo here. o Point at ip(4) and ip6(4) instead of unwelcoming "not described here". Reviewed by: gbe, markj Differential revision: https://reviews.freebsd.org/D36284 --- lib/libc/sys/socket.2 | 22 ++++++++++------------ 1 file changed, 10 insertions(+), 12 deletions(-) diff --git a/lib/libc/sys/socket.2 b/lib/libc/sys/socket.2 index b23d207c9730..8ced1f0ba930 100644 --- a/lib/libc/sys/socket.2 +++ b/lib/libc/sys/socket.2 @@ -28,7 +28,7 @@ .\" From: @(#)socket.2 8.1 (Berkeley) 6/4/93 .\" $FreeBSD$ .\" -.Dd August 19, 2018 +.Dd August 26, 2022 .Dt SOCKET 2 .Os .Sh NAME @@ -61,14 +61,11 @@ PF_UNIX Host-internal protocols, PF_INET Internet version 4 protocols, PF_INET6 Internet version 6 protocols, PF_ROUTE Internal routing protocol, -PF_LINK Link layer interface, PF_KEY Internal key-management function, -PF_NATM Asynchronous transfer mode protocols, PF_NETGRAPH Netgraph sockets, -PF_IEEE80211 IEEE 802.11 wireless link-layer protocols (WiFi), PF_BLUETOOTH Bluetooth protocols, PF_INET_SDP OFED socket direct protocol (IPv4), -PF_INET6_SDP OFED socket direct protocol (IPv6) +AF_HYPERV HyperV sockets .Ed .Pp Each protocol family is connected to an address family, which has the @@ -90,7 +87,6 @@ defined types are: SOCK_STREAM Stream socket, SOCK_DGRAM Datagram socket, SOCK_RAW Raw-protocol interface, -SOCK_RDM Reliably-delivered packet, SOCK_SEQPACKET Sequenced packet stream .Ed .Pp @@ -113,12 +109,12 @@ an entire packet with each read system call. This facility may have protocol-specific properties. .Dv SOCK_RAW sockets provide access to internal network protocols and interfaces. -The types -.Dv SOCK_RAW , -which is available only to the super-user, and -.Dv SOCK_RDM , -which is planned, -but not yet implemented, are not described here. +The +.Dv SOCK_RAW +type is available only to the super-user and is described in +.Xr ip 4 +and +.Xr ip6 4 . .Pp Additionally, the following flags are allowed in the .Fa type @@ -291,6 +287,8 @@ The socket type is not supported by the protocol. .Xr getsockname 2 , .Xr getsockopt 2 , .Xr ioctl 2 , +.Xr ip 4 , +.Xr ip6 4 , .Xr listen 2 , .Xr read 2 , .Xr recv 2 ,