From nobody Fri Feb 23 12:41:09 2024 X-Original-To: bugs@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 4Th8ks63bJz5CNvc for ; Fri, 23 Feb 2024 12:41:09 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Th8ks4ctRz4q2s for ; Fri, 23 Feb 2024 12:41:09 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1708692069; a=rsa-sha256; cv=none; b=jTOGovw/8r1dNAf0ACfbxJM5SSD83jtVP9WKfACs6OQyBNIu0ngSk0OKiZIJnT0hKffxhC x5hU3d2wCC536rfud4rLUtrlrqzOkBaMbx800j/baHt6+JhfxqLipbdfJ9QuhM2XSgy3Z8 0jzyzE5UQGAz2g/PckpHk0OALGIxXZr0hk/GJh/WiS8PonriHTiJo/e9tNyGnFqAVP3J90 x+2JICI7gTjVioIlyC0h7+v/RS/e1gwDXBu3hDqEv54sZsKaB7qV0+4H5U4uzWPlGQRN3U 0CAgd8o36MAwEqtTSS65b6eabwwIyHDXFA3Sis0ZSvD0xLiotGd5DDn2SrVo2A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1708692069; 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: in-reply-to:in-reply-to:references:references; bh=v0jX6/ULHt8egIr+wmDJWnyUoR3GmOYGmtMGNmGlDgE=; b=CH3NWamwVAa27RhDi3sDa/X93nl/O2gcyuYv3bpPjV1HNbx9lNf/EQJuQUiCPhR3uE2Ua2 A3NcgDTrPgmmtgYYpfLae1MVMCWM3Rv36Ie1l7xLkvI7GorUUgUK80vo+lvMY+GEAwrDCb g1tSljhwfDcnF1QnjxzDwHYJsY9Qo+qEqwxFEppV5LDao8t05EtrdoDfarHtewv0u0wK9A Dd4S3zC+OTF9mz+JG3x1rG/06ve9oYuJGkgv7j3UYvEyerpQEdewCHJE0BqaqngIOYz85a vGVw/Mvb11G1WsLaYA5H7TPp3BLbqevuT0ZwokEUzmAkxoX/UiuPbT1MxEznlQ== 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 4Th8ks3j13zGj0 for ; Fri, 23 Feb 2024 12:41:09 +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 41NCf94A046977 for ; Fri, 23 Feb 2024 12:41:09 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 41NCf9QG046974 for bugs@FreeBSD.org; Fri, 23 Feb 2024 12:41:09 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: bugs@FreeBSD.org Subject: [Bug 277238] kqueue(2), kevent(2) manpages are confusing and/or underspecified Date: Fri, 23 Feb 2024 12:41:09 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: changed 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: unitrunker@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: cc Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Bug reports List-Archive: https://lists.freebsd.org/archives/freebsd-bugs List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-bugs@freebsd.org MIME-Version: 1.0 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D277238 unitrunker changed: What |Removed |Added ---------------------------------------------------------------------------- CC| |unitrunker@gmail.com --- Comment #1 from unitrunker --- As I see it, the way forward is to break this up into smaller pieces and su= bmit a patch for each one. I suspect each type likely deserves a separate document - which can be link= ed from the main kqueue / kevent mandoc page. Attaching bits of sample code illustrating observed behavior is extemely helpful to the review process. Along these lines, I'd like to add my two cents on documenting how to watch files and directories (VNODEs). For example, the read and write events on a directory don't tell you what changed, only that - in the case of a write - something changed. The best I can determine is you need to take a snapshot = of the directory and, upon receiving a write event, re-read the directory and compare to see what changed. It would be nice if the read and write events gave us some sort of identity= as a clue to what changed. Maybe place the top inode of the directory entry th= an changed into the ext[] data, for example. --=20 You are receiving this mail because: You are the assignee for the bug.=