From nobody Tue Feb 10 07:40:45 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) client-ip=170.10.133.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1655933228; cv=none; d=zohomail.com; s=zohoarc; b=NNpTHKQH7UJHODXJ67EDUbnGI0gRaBTXLGk+qJsaLF7Nl9N0AsF2phT5GFG4KkSD0CgSNkBVQXBwSIZQ2RiwfM0OqVGZj4oTFaLTdj0Ay9y9RCSxHSozEqN7Pz9+O261ynBzcckQdTqdY/CkXVcdM7PlocF2zdiZkjOMDOxWC1U= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1655933228; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=hviVjKspS/Blq2+IvRULt22n02aHVKjXYowFJ/LVCD0=; b=jQgidB5+IGezZo03U8hmlpe0thRBAQCCbXZoNn8tjLivkyeedZLMAaZdPKjneczata1BjIVcodcUc1CWd5DjlK7TTR7DpVJQjVYSJKMux9oXtt9XnaPPw785TXpQQAA3ywXCP4y/xub6nkfXHU5DBGcuj5f5weWAPPfnz2+N6cQ= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mx.zohomail.com with SMTPS id 1655933228019351.60924541807003; Wed, 22 Jun 2022 14:27:08 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-605-SlYqPOEGPkCDQ3FtJ0wkPQ-1; Wed, 22 Jun 2022 17:26:36 -0400 Received: from smtp.corp.redhat.com (int-mx10.intmail.prod.int.rdu2.redhat.com [10.11.54.10]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id B9EA03C0CD4E; Wed, 22 Jun 2022 21:26:33 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id A7CED4619F4; Wed, 22 Jun 2022 21:26:33 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 81E4719451EC; Wed, 22 Jun 2022 21:26:30 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id C9D891947051 for ; Wed, 22 Jun 2022 21:26:27 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id AF21218EA8; Wed, 22 Jun 2022 21:26:27 +0000 (UTC) Received: from himantopus.redhat.com (unknown [10.22.8.228]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 8719A9D54; Wed, 22 Jun 2022 21:26:27 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1655933226; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=hviVjKspS/Blq2+IvRULt22n02aHVKjXYowFJ/LVCD0=; b=W8wbQ2OJPzWAVcP/cXahK5+uvLKiRzPGnHa+ERqsaD9Dii4dnVUPbi3VWcNlYUf3bhIQeP j0qedddbXvmyquz5y8Z82yFril0aqEH/pFjoH86TObC9yuhhj5VrZPlW6erUfyxD7h6D71 fNowzcPXSQJM/WwpY30X0HdXeYYRkCM= X-MC-Unique: SlYqPOEGPkCDQ3FtJ0wkPQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Jonathon Jongsma To: libvir-list@redhat.com Subject: [libvirt PATCH 1/3] docs: clarify 'readahead' and 'timeout' for disks Date: Wed, 22 Jun 2022 16:26:24 -0500 Message-Id: <20220622212626.2734141-2-jjongsma@redhat.com> In-Reply-To: <20220622212626.2734141-1-jjongsma@redhat.com> References: <20220622212626.2734141-1-jjongsma@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.11.54.5 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: pkrempa@redhat.com Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 2.85 on 10.11.54.10 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1655933228778100001 Content-Type: text/plain; charset="utf-8"; x-default="true" Document the format of the 'readahead' and 'timeout' XML elements more accurately. Signed-off-by: Jonathon Jongsma Reviewed-by: Michal Privoznik --- docs/formatdomain.rst | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 991d45672a..62a94890f0 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -2878,11 +2878,13 @@ paravirtualized driver is specified via the ``disk`= ` element. more cookies. The cookie name and value must conform to the HTTP specification. :since:`Since 6.2.0` ``readahead`` - Specifies the size of the readahead buffer for protocols which suppo= rt it. - (all 'curl' based drivers in qemu). The size is in bytes. Note that = '0' is - considered as if the value is not provided. :since:`Since 6.2.0` + The ``readahead`` element has a ``size`` attribute which specifies t= he + size of the readahead buffer in bytes for protocols which support it. + Note that '0' is considered as if the value is not provided. + :since:`Since 6.2.0` ``timeout`` - Specifies the connection timeout for protocols which support it. Not= e that + The ``timeout`` element has a ``seconds`` attribute which specifies = the + connection timeout in seconds for protocols which support it. Note t= hat '0' is considered as if the value is not provided. :since:`Since 6.2= .0` ``identity`` When using an ``nfs`` protocol, this is used to provide information = on the --=20 2.35.3