Date: Fri, 07 Jan 2022 01:05:17 +0000 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 Message-ID: <bug-260994-9@https.bugs.freebsd.org/bugzilla/>
next in thread | raw e-mail | index | archive | help
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 <https://docs.freebsd.org/en/books/handbook/glossary/#_c>; * add an entry for console. <https://docs.freebsd.org/en/books/handbook/glossary/#_d>; * 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 <https://en.wikipedia.org/wiki/Widevine>= is=20 not a feature of any web browser in the FreeBSD ports collection * Direct Rendering Manager can refer to e.g.=20 <https://en.wikipedia.org/wiki/Direct_Rendering_Manager>. <https://docs.freebsd.org/en/books/handbook/glossary/#_k>; * add entry for KMS; see Kernel Mode Setting * Kernel Mode Setting can refer to e.g.=20=20 <https://en.wikipedia.org/wiki/Direct_Rendering_Manager#Kernel_Mode_Setti= ng>=20 and FreeBSD Handbook section 12.13.2.2 (Suspend/resume). <https://docs.freebsd.org/en/books/handbook/glossary/#_t>; * add an entry for ttys; see console. acpiconf(8) <https://www.freebsd.org/cgi/man.cgi?query=3Dacpiconf&sektion=3D8&manpath= =3DFreeBSD> apm(8) <https://www.freebsd.org/cgi/man.cgi?query=3Dapm&sektion=3D8&manpath=3DFree= BSD> zzz(8) <https://www.freebsd.org/cgi/man.cgi?query=3Dzzz&sektion=3D8&manpath=3DFree= BSD> <https://docs.freebsd.org/en/books/handbook/config/#acpi-config>; <https://docs.freebsd.org/en/books/handbook/book/#acpi-config>; <https://docs.freebsd.org/en/books/handbook/config/#ACPI-comprob>; <https://docs.freebsd.org/en/books/handbook/book/#ACPI-comprob>; <https://docs.freebsd.org/en/books/handbook/config/#_suspendresume>; <https://docs.freebsd.org/en/books/handbook/book/#_suspendresume>; <https://wiki.freebsd.org/SuspendResume>; 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.=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-260994-9>