Bug 219953

Summary: handbook should mention _loading_ video drivers to make suspend/resume work
Product: Documentation Reporter: salternate
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Many People CC: carlavilla, emaste, pauamma
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   
See Also: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=260994
Bug Depends on:    
Bug Blocks: 263315    

Description salternate 2017-06-13 13:19:14 UTC 
For resume problems, the handbook talks about screwing around with sysctl and about removing modules, but I have two thinkpads-a very common case-where the problem was that I had failed to _load_ the i915kms module.

Knowing what to look for now, I see hints that resuming without kms awareness can’t work. At least with vt. If so, that should be mentioned.

For that matter, not even the section on X really spells out that you get the vesa driver by default and will have to get the more specific driver yourself.
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2021-12-28 13:58:52 UTC 
(In reply to salternate from comment #0)

Video cards are now at 5.4.5, 
<https://docs.freebsd.org/en/books/handbook/x11/#x-config-video-cards>

Food for thought, from last week's <https://forums.freebsd.org/posts/548228>: 

> No mention of _wake_ or _resume_ at <https://wiki.freebsd.org/Graphics>, 
> it might be good to add something **however** I don't know whether 
> this is a suitable page to attempt a generalisation. …

<https://wiki.freebsd.org/action/info/Graphics?action=info> various changes in recent month. 

salternate, please, do you have an account with FreeBSD Forums?
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2022-03-01 14:07:11 UTC 
See also: bug 260994
Comment 3 commit-hook freebsd_committer freebsd_triage 2023-08-01 09:32:32 UTC 
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=9401f487d47fb9147a5c6792e0318b9389749de3

commit 9401f487d47fb9147a5c6792e0318b9389749de3
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2023-08-01 09:06:38 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2023-08-01 09:06:38 +0000

    Handbook-WG: Upgrade config chapter

    Changes:

    * Change the title of the chapter to be more acurate
    * Add a config files entry (/etc, /usr/local/etc), and /etc/sysctl.conf
    * Rework the entry "managing services in FreeBSD"
    * Upgrade cron section and add periodic info
    * Upgrade syslog section
    * Remove tuning section, some parts are really outdated
    * Upgrade power management section
    * Little upgrades to swap section

    ACPI info obtained from:

    * https://freebsdfoundation.org/wp-content/uploads/2022/04/ACPI-Support-for-Embedded-Controllers.pdf
    * https://freebsdfoundation.org/wp-content/uploads/2018/04/Pain-and-Suffering-on-the-Road-to-Resume.pdf
    * https://wiki.freebsd.org/ACPI
    * https://papers.freebsd.org/2002/watanabe-acpi.files/watanabe-acpi-paper.pdf
    * https://vermaden.wordpress.com/2018/11/28/the-power-to-serve-freebsd-power-management/
    * https://github.com/freebsd/drm-kmod/blob/master/drivers/gpu/drm/i915/i915_params.c

    PR:                             219953,260994,216753
    Differential Revision:          https://reviews.freebsd.org/D41052
    Reviewed by:                    fernape, karels
    Sponsored by:                   Daifressh

 .../content/en/books/handbook/config/_index.adoc   | 1699 ++++++++++----------
 1 file changed, 844 insertions(+), 855 deletions(-)
Comment 4 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-08-01 09:47:56 UTC 
Fixed, sorry for the delay.