[Bug 260994] Sleep, wake: document the requirement for Kernel Mode Setting (KMS) drivers; include the console context

From: <bugzilla-noreply_at_freebsd.org>
Date: Fri, 07 Jan 2022 01:05:17 UTC

            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
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Documentation
          Assignee: doc@FreeBSD.org
          Reporter: grahamperrin@gmail.com

>>>> 𠈶… kms drm drivers. The suspend/resume code is in those drivers. They work 
>>>> console, X11 and wayland, more or less. …

>>> … (handbook suspend/resume section, man zzz acpiconf, maybe apm too, wiki) 
>>> … drm kmod drivers to actually make resuming succeed on 
>>> console-only computers. …

>> … drm kmod drivers usually are being associated as graphics drivers 
>> for xorg. Thus it is not at all intuitive/obvious that these are 
>> also required on console-only computers to make resuming succeed. 
>> … *not* mentioned anywhere in the documentation regarding suspend/resume, 
>> making users wonder why resuming fails. 

> Absolutely agreed on need more docs and an update pass. I raised it as 
> part of this year's core team meeting with the foundation. … likely 
> can be handled by a simple document PR.
> Warner

For the benefit of newcomers to systems such as FreeBSD: let's (also) now use
the FreeBSD Handbook glossary, which is currently detached from the Handbook,
to demystify some of the more ambiguous/obscure phrases.  


* add an entry for console.


* add an entry for DRM; see digital rights management and Direct Rendering

* digital rights management (maybe make a separate bug report) might simply  
  state that Google's Widevine CDM <https://en.wikipedia.org/wiki/Widevine> is 
  not a feature of any web browser in the FreeBSD ports collection

* Direct Rendering Manager can refer to e.g. 


* add entry for KMS; see Kernel Mode Setting

* Kernel Mode Setting can refer to e.g.  
  and FreeBSD Handbook section (Suspend/resume).


* add an entry for ttys; see console.








I'll bring in Stefan Blachmann (one of the people who are quoted above).

You are receiving this mail because:
You are the assignee for the bug.