From patchwork Thu Oct 7 23:17:20 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Phillip Potter X-Patchwork-Id: 12543761 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 26A29C433EF for ; Thu, 7 Oct 2021 23:19:25 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id EB3B26128C for ; Thu, 7 Oct 2021 23:19:24 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232801AbhJGXVS (ORCPT ); Thu, 7 Oct 2021 19:21:18 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39080 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229778AbhJGXVR (ORCPT ); Thu, 7 Oct 2021 19:21:17 -0400 Received: from mail-wr1-x42e.google.com (mail-wr1-x42e.google.com [IPv6:2a00:1450:4864:20::42e]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 30650C061570 for ; Thu, 7 Oct 2021 16:19:23 -0700 (PDT) Received: by mail-wr1-x42e.google.com with SMTP id m22so23970524wrb.0 for ; Thu, 07 Oct 2021 16:19:23 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=philpotter-co-uk.20210112.gappssmtp.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=PL54Nm2ZdSuYE5V8Jc6ddvakNyQ2FlPxhtz/QwtY6KY=; b=Q58cFmRu3sCSlXqMF//ykfyxgLEIm+cLlCUG12kqEKoOd7ywLq97jzL6UkuheaA33l cdFEAAnSvBHQM9J2wW8c75DTo9rgncES0V0Sozm5bS6tFoiYrr6B1WYbS3Tc1xfA23K3 sqjrVJRtxMVJqQjsZhNEbcUTh+QDc4CClbai7bY/gY85AzHtcag9z3YPwdbj5r6WoDt+ /g0iSRG9gtPGKN8kVak4H7NKfybGXhkmdirh2m8YAg0j6ood8qkTOdITXYyd2/7D9U5G HX8mSLaTCwHLhHpsgqnwdm1jDVo0vksa/w9jNrbYqGbV5vRBCrpYUAaDv7UIRF8vaFQr DyQw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=PL54Nm2ZdSuYE5V8Jc6ddvakNyQ2FlPxhtz/QwtY6KY=; b=aMcOCm5IhFED/bHXgvznNBqDLbAxTO0WOkLONtm2xuVCLznI18uqfonOEhNqBxJqHx CdYgLVYaM9BhVoc6ZHfz39iYIshaIG6pUhYMBdDbmwJmncg5wbg/WJ2VI1CQTDCypgSb XtPfupqtxasSAvxbPyXw8E3MxAOKVe6kuJk1+ujWp3Ex5D2Uu2pF+BoetQ86ci7gpxvw ICpgbeQS5PrJaocEfNAPOFwqxsb8dHfBfrV4cDYQX6sBpQ5FFNgNhz8Ew9SidnKiOHJy RS3/LtDYcNU2ZpRLer9GCpRAHIPen/Gjer5XvoDmlBv0x0jGRHRZ84/1/2AOLOkVJyDs UwXA== X-Gm-Message-State: AOAM533dQE7QxagL4/ozNSqojZkLpkn13tjIwIwYEUPVTJy65KVhkx8L w45qUusS9oiqVdlfEZ5vUJGfkQ== X-Google-Smtp-Source: ABdhPJwk8KUf/L/qNZ9qZoWDgjzDEMmQ6INLkE61SPAJG25IDr6ZOY+BTuQtKI1Ib4ZRxgqnMDRxKw== X-Received: by 2002:a05:6000:18a2:: with SMTP id b2mr8932644wri.155.1633648761723; Thu, 07 Oct 2021 16:19:21 -0700 (PDT) Received: from localhost.localdomain (30.34.155.90.in-addr.arpa. [90.155.34.30]) by smtp.gmail.com with ESMTPSA id w1sm9755292wmc.19.2021.10.07.16.19.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 07 Oct 2021 16:19:21 -0700 (PDT) From: Phillip Potter To: axboe@kernel.dk Cc: hch@infradead.org, linux-block@vger.kernel.org, linux-kernel@vger.kernel.org, lumip@lumip.de, rdunlap@infradead.org Subject: [PATCH] cdrom: docs: reformat table in Documentation/userspace-api/ioctl/cdrom.rst Date: Fri, 8 Oct 2021 00:17:20 +0100 Message-Id: <20211007231720.31997-1-phil@philpotter.co.uk> X-Mailer: git-send-email 2.31.1 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-block@vger.kernel.org Add extra space to the first column of ioctl values table, and also realign the text in the second column, to fix a documentation build warning introduced by: commit 67f1e027c270 ("drivers/cdrom: improved ioctl for media change detection") Suggested-by: Randy Dunlap Fixes: 67f1e027c270 ("drivers/cdrom: improved ioctl for media change detection") Signed-off-by: Phillip Potter Reviewed-by: Randy Dunlap --- Documentation/userspace-api/ioctl/cdrom.rst | 116 ++++++++++---------- 1 file changed, 58 insertions(+), 58 deletions(-) diff --git a/Documentation/userspace-api/ioctl/cdrom.rst b/Documentation/userspace-api/ioctl/cdrom.rst index bac5bbf93ca0..682948fc88a3 100644 --- a/Documentation/userspace-api/ioctl/cdrom.rst +++ b/Documentation/userspace-api/ioctl/cdrom.rst @@ -13,64 +13,64 @@ in drivers/cdrom/cdrom.c and drivers/block/scsi_ioctl.c ioctl values are listed in . As of this writing, they are as follows: - ====================== =============================================== - CDROMPAUSE Pause Audio Operation - CDROMRESUME Resume paused Audio Operation - CDROMPLAYMSF Play Audio MSF (struct cdrom_msf) - CDROMPLAYTRKIND Play Audio Track/index (struct cdrom_ti) - CDROMREADTOCHDR Read TOC header (struct cdrom_tochdr) - CDROMREADTOCENTRY Read TOC entry (struct cdrom_tocentry) - CDROMSTOP Stop the cdrom drive - CDROMSTART Start the cdrom drive - CDROMEJECT Ejects the cdrom media - CDROMVOLCTRL Control output volume (struct cdrom_volctrl) - CDROMSUBCHNL Read subchannel data (struct cdrom_subchnl) - CDROMREADMODE2 Read CDROM mode 2 data (2336 Bytes) - (struct cdrom_read) - CDROMREADMODE1 Read CDROM mode 1 data (2048 Bytes) - (struct cdrom_read) - CDROMREADAUDIO (struct cdrom_read_audio) - CDROMEJECT_SW enable(1)/disable(0) auto-ejecting - CDROMMULTISESSION Obtain the start-of-last-session - address of multi session disks - (struct cdrom_multisession) - CDROM_GET_MCN Obtain the "Universal Product Code" - if available (struct cdrom_mcn) - CDROM_GET_UPC Deprecated, use CDROM_GET_MCN instead. - CDROMRESET hard-reset the drive - CDROMVOLREAD Get the drive's volume setting - (struct cdrom_volctrl) - CDROMREADRAW read data in raw mode (2352 Bytes) - (struct cdrom_read) - CDROMREADCOOKED read data in cooked mode - CDROMSEEK seek msf address - CDROMPLAYBLK scsi-cd only, (struct cdrom_blk) - CDROMREADALL read all 2646 bytes - CDROMGETSPINDOWN return 4-bit spindown value - CDROMSETSPINDOWN set 4-bit spindown value - CDROMCLOSETRAY pendant of CDROMEJECT - CDROM_SET_OPTIONS Set behavior options - CDROM_CLEAR_OPTIONS Clear behavior options - CDROM_SELECT_SPEED Set the CD-ROM speed - CDROM_SELECT_DISC Select disc (for juke-boxes) - CDROM_MEDIA_CHANGED Check is media changed - CDROM_TIMED_MEDIA_CHANGE Check if media changed - since given time - (struct cdrom_timed_media_change_info) - CDROM_DRIVE_STATUS Get tray position, etc. - CDROM_DISC_STATUS Get disc type, etc. - CDROM_CHANGER_NSLOTS Get number of slots - CDROM_LOCKDOOR lock or unlock door - CDROM_DEBUG Turn debug messages on/off - CDROM_GET_CAPABILITY get capabilities - CDROMAUDIOBUFSIZ set the audio buffer size - DVD_READ_STRUCT Read structure - DVD_WRITE_STRUCT Write structure - DVD_AUTH Authentication - CDROM_SEND_PACKET send a packet to the drive - CDROM_NEXT_WRITABLE get next writable block - CDROM_LAST_WRITTEN get last block written on disc - ====================== =============================================== + ======================== =============================================== + CDROMPAUSE Pause Audio Operation + CDROMRESUME Resume paused Audio Operation + CDROMPLAYMSF Play Audio MSF (struct cdrom_msf) + CDROMPLAYTRKIND Play Audio Track/index (struct cdrom_ti) + CDROMREADTOCHDR Read TOC header (struct cdrom_tochdr) + CDROMREADTOCENTRY Read TOC entry (struct cdrom_tocentry) + CDROMSTOP Stop the cdrom drive + CDROMSTART Start the cdrom drive + CDROMEJECT Ejects the cdrom media + CDROMVOLCTRL Control output volume (struct cdrom_volctrl) + CDROMSUBCHNL Read subchannel data (struct cdrom_subchnl) + CDROMREADMODE2 Read CDROM mode 2 data (2336 Bytes) + (struct cdrom_read) + CDROMREADMODE1 Read CDROM mode 1 data (2048 Bytes) + (struct cdrom_read) + CDROMREADAUDIO (struct cdrom_read_audio) + CDROMEJECT_SW enable(1)/disable(0) auto-ejecting + CDROMMULTISESSION Obtain the start-of-last-session + address of multi session disks + (struct cdrom_multisession) + CDROM_GET_MCN Obtain the "Universal Product Code" + if available (struct cdrom_mcn) + CDROM_GET_UPC Deprecated, use CDROM_GET_MCN instead. + CDROMRESET hard-reset the drive + CDROMVOLREAD Get the drive's volume setting + (struct cdrom_volctrl) + CDROMREADRAW read data in raw mode (2352 Bytes) + (struct cdrom_read) + CDROMREADCOOKED read data in cooked mode + CDROMSEEK seek msf address + CDROMPLAYBLK scsi-cd only, (struct cdrom_blk) + CDROMREADALL read all 2646 bytes + CDROMGETSPINDOWN return 4-bit spindown value + CDROMSETSPINDOWN set 4-bit spindown value + CDROMCLOSETRAY pendant of CDROMEJECT + CDROM_SET_OPTIONS Set behavior options + CDROM_CLEAR_OPTIONS Clear behavior options + CDROM_SELECT_SPEED Set the CD-ROM speed + CDROM_SELECT_DISC Select disc (for juke-boxes) + CDROM_MEDIA_CHANGED Check is media changed + CDROM_TIMED_MEDIA_CHANGE Check if media changed + since given time + (struct cdrom_timed_media_change_info) + CDROM_DRIVE_STATUS Get tray position, etc. + CDROM_DISC_STATUS Get disc type, etc. + CDROM_CHANGER_NSLOTS Get number of slots + CDROM_LOCKDOOR lock or unlock door + CDROM_DEBUG Turn debug messages on/off + CDROM_GET_CAPABILITY get capabilities + CDROMAUDIOBUFSIZ set the audio buffer size + DVD_READ_STRUCT Read structure + DVD_WRITE_STRUCT Write structure + DVD_AUTH Authentication + CDROM_SEND_PACKET send a packet to the drive + CDROM_NEXT_WRITABLE get next writable block + CDROM_LAST_WRITTEN get last block written on disc + ======================== =============================================== The information that follows was determined from reading kernel source