From patchwork Fri Sep 18 01:56:39 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 11783829 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 79A5E92C for ; Fri, 18 Sep 2020 01:56:52 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 3CE2D20838 for ; Fri, 18 Sep 2020 01:56:52 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="lSvsaled" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726109AbgIRB4v (ORCPT ); Thu, 17 Sep 2020 21:56:51 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:52394 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726101AbgIRB4v (ORCPT ); Thu, 17 Sep 2020 21:56:51 -0400 Received: from casper.infradead.org (casper.infradead.org [IPv6:2001:8b0:10b:1236::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 11A1CC061756; Thu, 17 Sep 2020 18:56:51 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:MIME-Version: References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To: Content-Type:Content-ID:Content-Description; bh=DzqRDNd51AABXfHvOGClQ6GjXbZcogsHuLBhYu1WzRk=; b=lSvsaledKpcxMeyBZOttoe+mHR wrJNYGfwWLdsfUAWG8SWRljXsdUTfBsaWL3QxiGB2bVVvx5/bH8NfPbckU2hv1ViLPDNW7HOsNlYM OvBKGjZlvo1+4N+ON4QKwPw9OA0EhumdjbwXq6Nwfvy87PtHDuswdV8usfpPea/NAn+/U8JnF85fm W6lh1oecPRvGQmhh3UvrC+U/HfzoqNLrvTIS+FpwTaYjP/+i5cdrkJwyW8OFJZ73mRjKIr0tHeI9X joJZ+AQHJLLc2brs22awxiNLZahBPmBCFSfPK8rliauq1Om9AYh9hvQrhAImrEwJ6qW+2lCQ/gLEU y+UGFJaw==; Received: from [2601:1c0:6280:3f0::19c2] (helo=smtpauth.infradead.org) by casper.infradead.org with esmtpsa (Exim 4.92.3 #3 (Red Hat Linux)) id 1kJ5do-0007g2-3I; Fri, 18 Sep 2020 01:56:48 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Karel Zak , Paul Gortmaker , Jens Axboe , linux-block@vger.kernel.org, Alexander Viro , Martin Mares , linux-video@atrey.karlin.mff.cuni.cz, "H. Peter Anvin" , Jonathan Corbet , linux-doc@vger.kernel.org Subject: [RFC PATCH v2 1/2] Documentation/admin-guide: README & svga: remove use of "rdev" Date: Thu, 17 Sep 2020 18:56:39 -0700 Message-Id: <20200918015640.8439-2-rdunlap@infradead.org> X-Mailer: git-send-email 2.26.2 In-Reply-To: <20200918015640.8439-1-rdunlap@infradead.org> References: <20200918015640.8439-1-rdunlap@infradead.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-block@vger.kernel.org "rdev" is considered antiquated, ancient, archaic, obsolete, deprecated {choose any or all}. Remove use of "rdev" and "vidmode" (a symlink to rdev) in admin-guide/README.rst and admin-guide/svga.rst. "rdev" was removed from util-linux in 2010: https://git.kernel.org/pub/scm/utils/util-linux/util-linux.git/commit/?id=a3e40c14651fccf18e7954f081e601389baefe3f Signed-off-by: Randy Dunlap Cc: Karel Zak Cc: Paul Gortmaker Cc: Jens Axboe Cc: linux-block@vger.kernel.org Cc: Alexander Viro Cc: Martin Mares Cc: linux-video@atrey.karlin.mff.cuni.cz Cc: "H. Peter Anvin" Cc: Jonathan Corbet Cc: linux-doc@vger.kernel.org Acked-by: Martin Mares --- v2: Modify when the Video Mode Selection feature is available (thanks, Peter). No email address for these: nCc: Werner Almesberger nCc: Stephen Tweedie nCc: Peter MacDonald Documentation/admin-guide/README.rst | 6 +++--- Documentation/admin-guide/svga.rst | 7 ++++--- 2 files changed, 7 insertions(+), 6 deletions(-) --- lnx-59-rc5.orig/Documentation/admin-guide/README.rst +++ lnx-59-rc5/Documentation/admin-guide/README.rst @@ -322,9 +322,9 @@ Compiling the kernel reboot, and enjoy! If you ever need to change the default root device, video mode, - ramdisk size, etc. in the kernel image, use the ``rdev`` program (or - alternatively the LILO boot options when appropriate). No need to - recompile the kernel to change these parameters. + etc. in the kernel image, use your bootloader's boot options + where appropriate. No need to recompile the kernel to change + these parameters. - Reboot with the new kernel and enjoy. --- lnx-59-rc5.orig/Documentation/admin-guide/svga.rst +++ lnx-59-rc5/Documentation/admin-guide/svga.rst @@ -12,7 +12,8 @@ Intro This small document describes the "Video Mode Selection" feature which allows the use of various special video modes supported by the video BIOS. Due to usage of the BIOS, the selection is limited to boot time (before the -kernel decompression starts) and works only on 80X86 machines. +kernel decompression starts) and works only on 80X86 machines that are +booted through BIOS firmware (as opposed to through UEFI, kexec, etc.). .. note:: @@ -23,7 +24,7 @@ kernel decompression starts) and works o The video mode to be used is selected by a kernel parameter which can be specified in the kernel Makefile (the SVGA_MODE=... line) or by the "vga=..." -option of LILO (or some other boot loader you use) or by the "vidmode" utility +option of LILO (or some other boot loader you use) or by the "xrandr" utility (present in standard Linux utility packages). You can use the following values of this parameter:: @@ -41,7 +42,7 @@ of this parameter:: better to use absolute mode numbers instead. 0x.... - Hexadecimal video mode ID (also displayed on the menu, see below - for exact meaning of the ID). Warning: rdev and LILO don't support + for exact meaning of the ID). Warning: LILO doesn't support hexadecimal numbers -- you have to convert it to decimal manually. Menu