From nobody Mon Oct 16 22:54:32 2023 X-Original-To: dev-commits-src-main@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 4S8XVf11Jvz4xtsd; Mon, 16 Oct 2023 22:54:34 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (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 "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4S8XVf0VxYz4bjB; Mon, 16 Oct 2023 22:54:34 +0000 (UTC) (envelope-from jhb@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1697496874; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=4fHAV5uNhTzJI6ZNoCir9qONu6vXNOdi4Gy9l6gxWZs=; b=HURR6GFu2NW2jArq7GklIQvIeo521bqUhvhlK68qWjuub5Nnlz4NI6IS04k5tWIF91UKz1 C5iMzbRsufVTBHkL9gUXnG4QG48OBO33HNcv6sBejRu7+FvVOLMPBmTduxMyCcAkj9s7Mx 3QPJbhXQLbhOtHLOliKd0zttca/AanqZr2Mlqr24Yylr6bhbutZbKHD09999QToQMYPUJt HwcjEoGyO7yeLezLMGfJdNOIkzveFpfVzQGtROKj0aqyHcstmTIHVSLLQ0vXmNbVU02evq i8p3QvrDyZmvlq3tQivCaHNfRtXomY2oRmAYpoP2qx1BfrZaRbBYjAA7y4a7sw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1697496874; a=rsa-sha256; cv=none; b=GO4UFBouI4qI7zjAtKXf64XtIvlyth92zo84hsLyvov7ZyJR9UdubfMxKBSuoLPnq3R2G3 NdOU5c9QXkWnl6lLq5LT7SbVt8bfgaarLKRScwrNXVl5MtD07ATtSETYd7VgNPVE83us4v sSdzQB8S7l7KfFLhPA1Tuyx85aZgQZF20JXod8ArDSRWYtjuX0q8dh/r/w51nrIQ0Uqk+Y 56TsTIyXxO3J5iGH+UcSSEqTILBnACxXoJCoc4DXNJ0hqXhdFY06//30pQ66xKrcCzmCR8 7K0u9sjr55FUdULe/qWVBy+Hwcq31HtlyucjIUvwSeVasd2SxOD49F2xOGCDsg== 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=1697496874; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=4fHAV5uNhTzJI6ZNoCir9qONu6vXNOdi4Gy9l6gxWZs=; b=IjrpgyyzHepmL44Bn6jjb3uIJZLQfrUUSdVN2FBdlJOkbfRMIi/jvnRhEGTmiRQ5B7zO9v TvBpQHnWtqzjaYSvrSJud9PZD9QDxfHYS6Zf+A5C+l5EcY+Vx7ljvXZ6vRrC49e2WSRB/4 IRRuF8KSQIdEYjBgjCR+AKEC8GCR8Tg4Op3Fd3dr7qd8BoGLpC+L4FhCl0DSO8q/uUaxZ8 XqSD6FUOdv+SZnQqnUEKkUYdr6F3mef8GkMBWkgYUCq/fK59RY6f6LcuWM4BzMnCQnX+Us XIrVnI2795LbJIjwU0hhmpAVplNBXTbiE+cl8ItA+c8UDpzB90Lgb7Fqgxw85w== Received: from [IPV6:2601:648:8683:39a0:f055:f679:76c4:bebe] (unknown [IPv6:2601:648:8683:39a0:f055:f679:76c4:bebe]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (Client did not present a certificate) (Authenticated sender: jhb) by smtp.freebsd.org (Postfix) with ESMTPSA id 4S8XVd1lyNzrlq; Mon, 16 Oct 2023 22:54:33 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Message-ID: <527ab884-ce06-4325-52a6-7c6dec1af563@FreeBSD.org> Date: Mon, 16 Oct 2023 15:54:32 -0700 List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-main@freebsd.org X-BeenThere: dev-commits-src-main@freebsd.org MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:102.0) Gecko/20100101 Thunderbird/102.15.1 Subject: Re: git: 74e4a8d208f0 - main - pmap: add pmap_kextract(9) man page Content-Language: en-US To: Mitchell Horne , Konstantin Belousov Cc: src-committers@freebsd.org, dev-commits-src-all@freebsd.org, dev-commits-src-main@freebsd.org References: <202310131827.39DIRXsu082741@gitrepo.freebsd.org> <068574a3-f63a-4830-be1d-2a8cd67c1819@freebsd.org> From: John Baldwin In-Reply-To: <068574a3-f63a-4830-be1d-2a8cd67c1819@freebsd.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 10/14/23 10:34 AM, Mitchell Horne wrote: > On 10/14/23 10:28, Konstantin Belousov wrote: >> On Fri, Oct 13, 2023 at 06:27:33PM +0000, Mitchell Horne wrote: >>> +.Pp >>> +.Fn vtophys >>> +is an alias for >>> +.Fn pmap_kextract >>> +and behaves identically. >>> +.Sh RETURN VALUES >>> +The >>> +.Fn pmap_kextract >>> +function will return the physical address >>> +.Pq Vt vm_paddr_t >>> +associated with the kernel virtual address >> and 'associated'? >> >> The function returns address of physical memory mapped at the supplied >> kernel virtual address. >> > > Sure, this is more accurate. I suggest tweaking this further just to be very explicit about the type of address being returned: The .Fn pmap_kextract function returns the physical address of memory mapped at the kernel virtual address .Va va . or some such. -- John Baldwin