From owner-freebsd-doc@freebsd.org Wed Aug 12 09:06:55 2020 Return-Path: Delivered-To: freebsd-doc@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 48C9D37A5BC for ; Wed, 12 Aug 2020 09:06:55 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mailman.nyi.freebsd.org (mailman.nyi.freebsd.org [IPv6:2610:1c1:1:606c::50:13]) by mx1.freebsd.org (Postfix) with ESMTP id 4BRP331GXxz4dRW for ; Wed, 12 Aug 2020 09:06:55 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: by mailman.nyi.freebsd.org (Postfix) id 29A9737A5BB; Wed, 12 Aug 2020 09:06:55 +0000 (UTC) Delivered-To: doc@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 2971837A5BA for ; Wed, 12 Aug 2020 09:06:55 +0000 (UTC) (envelope-from bugzilla-noreply@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 "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4BRP330LMFz4d9Z for ; Wed, 12 Aug 2020 09:06:55 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (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 DF07397CA for ; Wed, 12 Aug 2020 09:06:54 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 07C96seA019261 for ; Wed, 12 Aug 2020 09:06:54 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 07C96sCV019260 for doc@FreeBSD.org; Wed, 12 Aug 2020 09:06:54 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 248614] getpeereid.3 says listen where it means accept. Date: Wed, 12 Aug 2020 09:06:54 +0000 X-Bugzilla-Reason: CC X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Manual Pages X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: gnachman@gmail.com X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: bugs@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter cc attachments.created Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.33 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 12 Aug 2020 09:06:55 -0000 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D248614 Bug ID: 248614 Summary: getpeereid.3 says listen where it means accept. Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Some People Priority: --- Component: Manual Pages Assignee: bugs@FreeBSD.org Reporter: gnachman@gmail.com CC: doc@FreeBSD.org Created attachment 217167 --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=3D217167&action= =3Dedit Client and server that demonstrate the actual behavior of getpeereid The manpage for `getpeereid` states: > The argument s must be a UNIX-domain socket (unix(4)) of type SOCK_STREAM= on which either connect(2) or listen(2) have been called. This is surprising! Why would you be able to get the effective user ID of t= he peer on the socket for which *listen* has been called? There isn't a peer u= ntil you `accept`. Using the attached server and client programs, it looks like my intuition is correct: $ ./server status=3D-1 eid=3D0 errno=3D57 status=3D0 eid=3D1001 errno=3D57 `getpeereid` requires s to be the socket that has been returned by `accept(= )`, not the one that was `listen()`ed on. I think the language should be changed to: > The argument s must be a UNIX-domain socket (unix(4)) of type SOCK_STREAM= on which connect(2) has been called or was returned by accept(2) or accept= 4(2). --=20 You are receiving this mail because: You are on the CC list for the bug.=