From nobody Sat Nov 05 01:47:49 2022 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 4N40kG2WRbz4hKp4; Sat, 5 Nov 2022 01:47:50 +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 4N40kG1w37z3ScH; Sat, 5 Nov 2022 01:47:50 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1667612870; 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=6d5w/b0NFTPHWd/6suS/sWlVih5Qy1rGHdwhjUMmBX0=; b=IaJ/Awkm55Rf2tfPcv1Msb3E17h06uw5EVNI0MYBsp+F3DWB+86J3RaCRjyvYxLs8wComU 0x0rQJNRQRJXiukJLD3ia5I6towhoezgh8kn0giIlcVI6acCyNiMkpnouRF+/7SSAZ7QwI 1JCa6TlcXlAe48WTlHgPJwNmGrvGmyMnRNMbeFH5HSofaWJc8Bgp8OTHbc5Mq+Db/6by+N i59DWy6Er/9usyKUHb1EyhIFqbGXB8m7e7Jhwm3vg5/JXRRUZ/uF69Xn877diCOn98mhUp TQG3xiSXklzkwzKq5UdYHSZL8sWUmkqiNNTw1fbCggeP02HL8+W6r7XLZSzClw== 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 4N40kG0nzLzNkk; Sat, 5 Nov 2022 01:47:50 +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 2A51lnTb074044; Sat, 5 Nov 2022 01:47:49 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2A51lnrS074043; Sat, 5 Nov 2022 01:47:49 GMT (envelope-from git) Date: Sat, 5 Nov 2022 01:47:49 GMT Message-Id: <202211050147.2A51lnrS074043@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Warner Losh Subject: git: 269865a8eed2 - main - stand: Update comment about devdesc 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 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: imp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 269865a8eed240f572472750451484feccaeeeea Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1667612870; 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=6d5w/b0NFTPHWd/6suS/sWlVih5Qy1rGHdwhjUMmBX0=; b=YzlHIR4zc8xCPK0WiCaMGvTstKeYum+gjZMVv5IeUKaT5ji/P72vl0VVR9IA4tMQC5l+7c K+1hkzuJGgJz54CLwjfieYpNsM3pnRBTM5qZKFyyHornKvDAclbmMpMT4tFjFsS4lXtacb 535UVfDmyyPDqx9MZH7klKqHZt6lN2B+m5uVRodL6K2irmT9FouT7sPU+eBiJ9c+GJP97j TBFn5tr4IuYBdioL+GqAjLsgIhvAyjNhkHb1pzFZtIdKiZ0/fyxJml0kIUqk2/jmIAfnj2 bXiSRn9x+2NTqvrXHmCmpncokNf/QvkVBEAjWyvddUm8I3us91Pm8wzTmCe5Jw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1667612870; a=rsa-sha256; cv=none; b=f07T1w7qlIam/YYMJttyN4n7BDRkAjJjzoKKL8s8YRGHy8UEcWj16rRJ+iBKQrPRKByY2i V4igRoBRpzG+cua8fG5gpaWgSlY0aM781VVBVOAdnt1Mdwi722bjt1gUfWGW13zrz2WNp4 Xkv4DzP8OeQOT4BditGzzNOkp9RTUiS+b240lTaLLlXPOpAeKQdZeQZDG7RjwWRLvG67w1 LBLFa5K57+0EQ9V42OzAVyMx6YadpzsbigMQtEON4mNKomuIsJexhD04Xe5dHZM+sDQ30f M3tenvRr5Ru0Z6f3uLHVs/nUyCucu0+C4kNq3ezNaxRbW8rNv4w7vS8hY+m+Tg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by imp: URL: https://cgit.FreeBSD.org/src/commit/?id=269865a8eed240f572472750451484feccaeeeea commit 269865a8eed240f572472750451484feccaeeeea Author: Warner Losh AuthorDate: 2022-11-05 01:45:27 +0000 Commit: Warner Losh CommitDate: 2022-11-05 01:46:44 +0000 stand: Update comment about devdesc How devdesc is used is opaque until much code is read. Give a more useful description of the theory behind it here. Sponsored by: Netflix --- stand/libsa/stand.h | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/stand/libsa/stand.h b/stand/libsa/stand.h index 5ffff54c7ca7..3b2627355ed6 100644 --- a/stand/libsa/stand.h +++ b/stand/libsa/stand.h @@ -170,9 +170,14 @@ extern struct devsw netdev; extern int errno; /* - * Generic device specifier; architecture-dependent - * versions may be larger, but should be allowed to - * overlap. + * Generic device specifier; architecture-dependent versions may be larger, but + * should be allowed to overlap. The larger device specifiers store more data + * than can fit in the generic one that's gleaned after parsing the device + * string, or used in some cases to indicate wildcards that match a variety of + * situations based on what's on the drive itself rather than what the progammer + * might know in advance. Information about open files is stored in d_opendata, + * though what's passed into the open routine may differ from what's present + * after the open on some configurations. */ struct devdesc { struct devsw *d_dev;