From nobody Fri Feb 23 12:41:09 2024 X-Original-To: doc@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 4Th8kt0z7Mz5CP6M for ; Fri, 23 Feb 2024 12:41:10 +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 4Th8ks5KVHz4q7j 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=hzipKgV7b0zrP+pEA71bENhSPP3t/ArP10B8dAsNSw5UEh/vWHg5SAFuy+VPkg1bMtTb57 m0nUG9macOhHxP/JTHYBWwm4pX145pxUyUrzlUA7ryfYOIZKvdYI2A9Wl2dtTDas3REK/2 ricBlgyAUanXvOCJqc1eWTdUX839eWKV2n8XRlEptcHkCeioATDZT9NXO4jn/Z/+PjWp5j QUZ59vzxIKJi2lxZ1zyiphTttbd4z3UOLsMcWyOwxkmB3fZdiGFMTeWkTujJqG4I8qwEi8 vWoH+4POoa872vAkYf4ai6DZWJBD5mZbf7QLe4a4+7zvvJZNU8PHOM4dmnhunw== 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=Ru51QqFg+OBtjP6tUh07uEse5FT1NcFJtZa96TB9mjM=; b=oNpytvjMk2SoCCoVTCuEWXxAco8mftOs89va5Tmy734LRhVwX2yZ41BwKqR0rM4xm//f8L +WsoNCCofkvhsQo2jMiIYxCp3Jh1CVKo68IrEdwhD0DkfJnJ5gLyHr/YTUERVVEAnlHh2A n6XRwW6mQyRb45Ih4yQULDIDjDY4JxQwjEKTpfKCrdoYFgitnT52oEa2TXOUz/uM0tck7y n0N1+eZvZyQb/YmxsHhzUMoMQPaeLRll5SkRS3GrVUCIEjPxF0G5jgTMk5Spyx3HEkVgpk 9yF/4QhQDmK5xFNvqxaCIYLngBSthpGWZm0FmuGiMrJNMncOdfaiMExUE3OPIg== 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 4Th8ks4NzdzGF4 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 41NCf9WS046984 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 41NCf9kT046982 for doc@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: doc@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: CC 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: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@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 on the CC list for the bug.=