From nobody Fri Jan 07 01:05:17 2022 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 F109F1936FE1 for ; Fri, 7 Jan 2022 01:05:17 +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 4JVQ4Y4nwxz4lXT for ; Fri, 7 Jan 2022 01:05:17 +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 81A632A200 for ; Fri, 7 Jan 2022 01:05:17 +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 20715Hmb081938 for ; Fri, 7 Jan 2022 01:05:17 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 20715HIF081937 for doc@FreeBSD.org; Fri, 7 Jan 2022 01:05:17 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 260994] Sleep, wake: document the requirement for Kernel Mode Setting (KMS) drivers; include the console context Date: Fri, 07 Jan 2022 01:05:17 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Documentation X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: grahamperrin@gmail.com X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform bug_file_loc op_sys bug_status bug_severity priority component assigned_to reporter 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 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 ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1641517517; 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=4QC+ANVa63R+/K7RG72Uz4nxi2+MpJRRChQkKaDOdgk=; b=F0Z3mJvI5v65EdySC3cAAGrkpPYxdRM/JFRD0eh4Ai4sAcvGQ9tiBqzWDaM1NLpsyZ2EHv ldZogowSVuosvh2L2i7vpbvT/g5tiOGmCUN8Njia+jB/QYjkpOPcG213WZlCPhsgczXbUI wmcZuULjGO3oheeUbcSw5JyCqoL7myk5r7cZ+tqa73YD8QZqRh+kJhGgtr4CJBuHmF4W8b x9cJpKOhxpa0AdWo/sVHbT5ksTgpCDP7Xjc+VX5uwyPirEFk18tFK39lHSHpcyZsrr5QSs ZP+m3wqzdYJiP4Ry8x/Hp+djAXanyAXz2DZNLmCbmFq2gxUoBOiQjrMJi1BudQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1641517517; a=rsa-sha256; cv=none; b=Paz/r0th5FHeVxmvkMdOjSiKO4lf6bK7L1mJYT+WDsklO0tZm7baV29arLI3gvH/pyUOm0 y0scLVTGlm0DbQk7jaq3aONXWFZpnoM3ZdKe3cp0R1gRfSk2VTqKSgYPvhOFCwohrsfnV6 kHqA8yPGui4NcPnK7PLei/RfCUbQEfrZCv+vWePGwliYp5Zs7LZdGNwi+MMhbNRkwDB7fl ClqNResc4CNeU9I3RNqwrV06lX7+l9/iWftT0UcRCCmWago+xGgrojnOAO6oy9uxpVqzNG UFxLAYeDw5mi4OHOc9aQqfXJxcd/tuset68FY5pPb5l9txYZlqReCkmPt2eOpg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D260994 Bug ID: 260994 Summary: Sleep, wake: document the requirement for Kernel Mode Setting (KMS) drivers; include the console context Product: Documentation Version: Latest Hardware: Any URL: https://lists.freebsd.org/archives/freebsd-hackers/202 2-January/000741.html OS: Any Status: New Severity: Affects Some People Priority: --- Component: Documentation Assignee: doc@FreeBSD.org Reporter: grahamperrin@gmail.com >>>> =F0=A0=88=B6=E2=80=A6 kms drm drivers. The suspend/resume code is in t= hose drivers. They work=20 >>>> console, X11 and wayland, more or less. =E2=80=A6 >>> =E2=80=A6 (handbook suspend/resume section, man zzz acpiconf, maybe apm= too, wiki)=20 >>> =E2=80=A6 drm kmod drivers to actually make resuming succeed on=20 >>> console-only computers. =E2=80=A6 >> =E2=80=A6 drm kmod drivers usually are being associated as graphics driv= ers=20 >> for xorg. Thus it is not at all intuitive/obvious that these are=20 >> also required on console-only computers to make resuming succeed.=20 >>=20 >> =E2=80=A6 *not* mentioned anywhere in the documentation regarding suspen= d/resume,=20 >> making users wonder why resuming fails.=20 > Absolutely agreed on need more docs and an update pass. I raised it as=20 > part of this year's core team meeting with the foundation. =E2=80=A6 like= ly=20 > can be handled by a simple document PR. >=20 > Warner For the benefit of newcomers to systems such as FreeBSD: let's (also) now u= se the FreeBSD Handbook glossary, which is currently detached from the Handboo= k, to demystify some of the more ambiguous/obscure phrases.=20=20 * add an entry for console. * add an entry for DRM; see digital rights management and Direct Rendering Manager * digital rights management (maybe make a separate bug report) might simply= =20=20 state that Google's Widevine CDM = is=20 not a feature of any web browser in the FreeBSD ports collection * Direct Rendering Manager can refer to e.g.=20 . * add entry for KMS; see Kernel Mode Setting * Kernel Mode Setting can refer to e.g.=20=20 =20 and FreeBSD Handbook section 12.13.2.2 (Suspend/resume). * add an entry for ttys; see console. acpiconf(8) apm(8) zzz(8) I'll bring in Stefan Blachmann (one of the people who are quoted above). --=20 You are receiving this mail because: You are the assignee for the bug.=