From patchwork Thu Jan 18 09:29:56 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Christian Loehle X-Patchwork-Id: 189135 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2bc4:b0:101:a8e8:374 with SMTP id hx4csp225686dyb; Thu, 18 Jan 2024 01:36:32 -0800 (PST) X-Google-Smtp-Source: AGHT+IEDIDbidkiI+fiWf5sRBVym6UJGWAeZU1qZr8/XguEDCHcTw4flNANIFWSyaDwnJNGIE6Yg X-Received: by 2002:ac2:41d3:0:b0:50e:9c5d:352a with SMTP id d19-20020ac241d3000000b0050e9c5d352amr313497lfi.126.1705570592172; Thu, 18 Jan 2024 01:36:32 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705570592; cv=pass; d=google.com; s=arc-20160816; b=b74D+zWt3sRyhVtMugaMRUvJOOoQVyGQUznCZ/1nH/9yr1j4IoyqDrbgaYkf+qsvAA E8BVFPC6aWTVgZ44F6Efi272Fy8db3M+plNkrslTAtVWAOiMQZG0sqyTZMds7LjjJpF9 2DbrQcz2XXlAPt3cj4uHsw9cbQml0UUfAJDPk5Smuk+PyhJo6msbTOip6Z+Pf9tV4c7n V1+Ue5tAACNcuXLmORuqNDRyvQT2ZN+0qARinpSLjLuLLAa5TyQTswfDacPVm2wyHnIZ WkskCD70er2UI8Jw3tX0pz42hUSc57urk8dbdv4BlxmlL68AgBVi4tWO4y/GE+T6Aicl 7CFQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:subject:from:to:content-language :user-agent:mime-version:list-unsubscribe:list-subscribe:list-id :precedence:date:message-id; bh=eoQt6Wb/CX3EfpLlVYkEe4jPCz2oFZA13qw7eFjol/Q=; fh=3SOEWk6y+BFv0YBgfrXel03zn7M+lLPuV7JUh6x9EwU=; b=v+EkJRabn8dw84rwy+1j5iNO5Z9Mg4Xw/8f2ElAaQdzA5bCsyLaj1GTSGVr5M0E8LX 6qv6vwQ5IJYNxjGuoRgTnXFlvomN7LhQsKfnVyPsdRs7+n8nrXqEcuCS2FvT3EiZBJrc aLziR5LUGC03qGqSTqmU7DZsLCRT9DT+tDb9Wua8lEO56xBPCGrYB8p1M4IW83gjwvJ5 XXrP+ur0iWHgi++MVQVKn1tP/Hu6f55+0z6PSmvMALn//IvKcOVoy/3hKwIh6XR5jjXB z80bCt05/RdYWUGFEXHVhXCwd9mhbJ+ylLije2UhmU+IkIAbSR0SmKcpkG5qM+QEdKPT ZTcg== ARC-Authentication-Results: i=2; mx.google.com; arc=pass (i=1 spf=pass spfdomain=arm.com dmarc=pass fromdomain=arm.com); spf=pass (google.com: domain of linux-kernel+bounces-29960-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29960-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=arm.com Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id t1-20020a1709060c4100b00a26ed1ed306si6529421ejf.461.2024.01.18.01.36.31 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 18 Jan 2024 01:36:32 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-29960-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; arc=pass (i=1 spf=pass spfdomain=arm.com dmarc=pass fromdomain=arm.com); spf=pass (google.com: domain of linux-kernel+bounces-29960-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-29960-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=arm.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id B0B091F28F79 for ; Thu, 18 Jan 2024 09:30:32 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id B2A0F208B6; Thu, 18 Jan 2024 09:30:04 +0000 (UTC) Received: from foss.arm.com (foss.arm.com [217.140.110.172]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 7D6481F946; Thu, 18 Jan 2024 09:30:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.140.110.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705570203; cv=none; b=uHBh+BQz58AaABs2EOuVuinm3oMno9VGZg7NXyDbtw1NtQ+rvJJgU2o7VU/SHghzEaHyNGbZluj0U8/Mbv84eVA1UmukGuZ6uEHObfQ6bLU5J7tcID6xN0TAQHJyiNlhVaiYn/P2RgPsksvbDc9ZrZtVORNBAAk3DAdRW3nKqhQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705570203; c=relaxed/simple; bh=R4+K7Qie20s3jGZS63QrPtjyxEAWl88+m5i1etaoA7o=; h=Received:Received:Message-ID:Date:MIME-Version:User-Agent: Content-Language:To:From:Subject:Content-Type: Content-Transfer-Encoding; b=EMrRq5CCG9JHuJVgMmZ0sGvhjJaqZUu1/9orLArH6apbY8ckfY5U5uk49HweuAmsjpyHcO5RQAXhwX5d1UMbzJKhGH+iY0Gc9VmfzzRYCv1IsBnhA2LH8+5ybqDIgBnJRnkkQovg2cFA6AmDjQRKQjvviX467clUJKHdmupZigw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com; spf=pass smtp.mailfrom=arm.com; arc=none smtp.client-ip=217.140.110.172 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=arm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=arm.com Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 4ECB91042; Thu, 18 Jan 2024 01:30:45 -0800 (PST) Received: from [10.1.36.44] (unknown [10.1.36.44]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 244E23F5A1; Thu, 18 Jan 2024 01:29:57 -0800 (PST) Message-ID: Date: Thu, 18 Jan 2024 09:29:56 +0000 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Content-Language: en-US To: Johannes Thumshirn , "corbet@lwn.net" , "linux-kernel@vger.kernel.org" , "linux-block@vger.kernel.org" , "axboe@kernel.dk" From: Christian Loehle Subject: [PATCHv2] Documentation: block: ioprio: Update schedulers X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1788420389107218174 X-GMAIL-MSGID: 1788420389107218174 This doc hasn't been touched in a while, in the meantime some new io schedulers were added (e.g. all of mq), some with ioprio support. Also reword the introduction to remove reference to CFQ and the limitation that io priorities only work on reads, which is no longer true. Signed-off-by: Christian Loehle Reviewed-by: Johannes Thumshirn --- Documentation/block/ioprio.rst | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/Documentation/block/ioprio.rst b/Documentation/block/ioprio.rst index a25c6d5df87b..4662e1ff3d81 100644 --- a/Documentation/block/ioprio.rst +++ b/Documentation/block/ioprio.rst @@ -6,17 +6,16 @@ Block io priorities Intro ----- -With the introduction of cfq v3 (aka cfq-ts or time sliced cfq), basic io -priorities are supported for reads on files. This enables users to io nice -processes or process groups, similar to what has been possible with cpu -scheduling for ages. This document mainly details the current possibilities -with cfq; other io schedulers do not support io priorities thus far. +The io priority feature enables users to io nice processes or process groups, +similar to what has been possible with cpu scheduling for ages. Support for io +priorities is io scheduler dependent and currently supported by bfq and +mq-deadline. Scheduling classes ------------------ -CFQ implements three generic scheduling classes that determine how io is -served for a process. +Three generic scheduling classes are implemented for io priorities that +determine how io is served for a process. IOPRIO_CLASS_RT: This is the realtime io class. This scheduling class is given higher priority than any other in the system, processes from this class are