Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/2216292/?format=api
{ "id": 2216292, "url": "http://patchwork.ozlabs.org/api/patches/2216292/?format=api", "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/patch/20260326091948.194529-3-silvan@quobyte.com/", "project": { "id": 14, "url": "http://patchwork.ozlabs.org/api/projects/14/?format=api", "name": "QEMU Development", "link_name": "qemu-devel", "list_id": "qemu-devel.nongnu.org", "list_email": "qemu-devel@nongnu.org", "web_url": "", "scm_url": "", "webscm_url": "", "list_archive_url": "", "list_archive_url_format": "", "commit_url_format": "" }, "msgid": "<20260326091948.194529-3-silvan@quobyte.com>", "list_archive_url": null, "date": "2026-03-26T09:19:47", "name": "[2/3] docs/system: Document locking=posix option for file block driver", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "5a2fd031a8ea7d77e221a8c03f51f9359c2bcdd4", "submitter": { "id": 92975, "url": "http://patchwork.ozlabs.org/api/people/92975/?format=api", "name": "Silvan Kaiser", "email": "silvan@quobyte.com" }, "delegate": null, "mbox": "http://patchwork.ozlabs.org/project/qemu-devel/patch/20260326091948.194529-3-silvan@quobyte.com/mbox/", "series": [ { "id": 497558, "url": "http://patchwork.ozlabs.org/api/series/497558/?format=api", "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/list/?series=497558", "date": "2026-03-26T09:19:45", "name": "block: Add 'posix' option for file locking", "version": 1, "mbox": "http://patchwork.ozlabs.org/series/497558/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/2216292/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/2216292/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>", "X-Original-To": "incoming@patchwork.ozlabs.org", "Delivered-To": "patchwork-incoming@legolas.ozlabs.org", "Authentication-Results": [ "legolas.ozlabs.org;\n\tdkim=pass (1024-bit key;\n unprotected) header.d=quobyte.com header.i=@quobyte.com header.a=rsa-sha256\n header.s=google header.b=Y8bly2Nb;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org\n (client-ip=209.51.188.17; helo=lists.gnu.org;\n envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n receiver=patchwork.ozlabs.org)" ], "Received": [ "from lists.gnu.org (lists.gnu.org [209.51.188.17])\n\t(using TLSv1.2 with cipher ECDHE-ECDSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fhJF42Rn3z1y1x\n\tfor <incoming@patchwork.ozlabs.org>; Thu, 26 Mar 2026 20:21:44 +1100 (AEDT)", "from localhost ([::1] helo=lists1p.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.90_1)\n\t(envelope-from <qemu-devel-bounces@nongnu.org>)\n\tid 1w5gtm-0000oS-5F; Thu, 26 Mar 2026 05:21:06 -0400", "from eggs.gnu.org ([2001:470:142:3::10])\n by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from <silvan@quobyte.com>)\n id 1w5gtk-0000kx-NS\n for qemu-devel@nongnu.org; Thu, 26 Mar 2026 05:21:04 -0400", "from mail-wm1-x32c.google.com ([2a00:1450:4864:20::32c])\n by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)\n (Exim 4.90_1) (envelope-from <silvan@quobyte.com>)\n id 1w5gti-0000Kb-IW\n for qemu-devel@nongnu.org; Thu, 26 Mar 2026 05:21:04 -0400", "by mail-wm1-x32c.google.com with SMTP id\n 5b1f17b1804b1-486ff201041so6335725e9.1\n for <qemu-devel@nongnu.org>; Thu, 26 Mar 2026 02:21:02 -0700 (PDT)", "from kaisers.corp.quobyte.com ([24.134.167.61])\n by smtp.gmail.com with ESMTPSA id\n 5b1f17b1804b1-48722c9506dsm16474295e9.7.2026.03.26.02.21.00\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Thu, 26 Mar 2026 02:21:00 -0700 (PDT)" ], "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=quobyte.com; s=google; t=1774516861; x=1775121661; darn=nongnu.org;\n h=mime-version:references:in-reply-to:message-id:date:subject:cc:to\n :from:from:to:cc:subject:date:message-id:reply-to;\n bh=1z7eWHRCKyrRx5GJTpNLhbk7ddlC+qA+Hu4CTwSuwZ0=;\n b=Y8bly2NbbTiFfHU1Pk+QI9sP8m3/h0cuyW8LX2OlT7dlBQp2GI6rvpBAUuKgjNfUqy\n TubablGhweLHFk4KVhOM3AKmW+6dxyvkI1UKd5EpAR0NZ3vOyaoxdmY7Y164k5egfI8G\n aaegaR/Pg7VlkOIi1w8N3vptpXjwNuuuGqstw=", "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20251104; t=1774516861; x=1775121661;\n h=mime-version:references:in-reply-to:message-id:date:subject:cc:to\n :from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date:message-id\n :reply-to;\n bh=1z7eWHRCKyrRx5GJTpNLhbk7ddlC+qA+Hu4CTwSuwZ0=;\n b=qIOOrOycCYXm7ctGdENGZz2eSg6aMjIGlf6PGy8CMOtbDgOcC6frbTLswMH22xbxpk\n 9q8q5uLEeHQaeaovO12P/sZgPQF3zUTVbK6Frkx6y6Np3ZDwkijQ5YlGMr4FoMQOWqFe\n g5eQLnTJYfLrSOBmO/CJaaIKHK2OPUAyX7RnQ9IfQS60Y1765YfWXucBBH9PGxdjNAzu\n 5n+AcH+qYObDl5awdYXxsKciMqxeZnwlLx1gTCGfgDYaL+NtAPCga5vF/UBz3JBTAk1H\n IvHhmglzQaFGkqn+QiaK4a2Xa3rohKQbnh5nOlZIUVrOyEwufR7mUah6TqBT9Zfgs6EI\n PB7g==", "X-Gm-Message-State": "AOJu0YwBIojQBDVyjqCC8BUvnMBCs6A4nnPBEYotyeJnFB6f8fIyg7xb\n NAti67A5F8bck/gEQYYdF5R8uBQrO1DlQqZ73/KFfx85JLUCrcst3zv5fIgTHU/lOmcC3CPJ2Of\n UcKIbDTtSfkZe56XcnIHBKyz4Xj6elDVvxyMhMxCXEJ0ZFl4fyUCJLCTxEvMSUXWt9TrM", "X-Gm-Gg": "ATEYQzwr3326L8c1Qprltf4hkrO+IMb6aCibS3o1jhtdmOvROIBxal2C1FYcckRuC7P\n f8BVaJ/jiMRb+XD+/azzD3BoTzZo+7lkOoIrTyRX9wnio3tRl554HzZrf6+ofRTHRF90zmX0reS\n koIvowCLRvCsctjB9JVi1XesU7w7XnlxMQHlEDYI7lo8OVhxhyaVAjRjpSTNIxZvwIojClrHS+3\n emaxHmX2/iJNyRfrDbSvl4eMRnDhehYya0DVKQgwgcGJYq8vtMBY3CBKJmBRaWZDbN54MJ55LXP\n SHf28Hw3FGEDmSS1GWGTsDP/7gJhL7pJ6f2r7YSp0wWaJKJbMpvk0SSjFooCkFIlSp0zwkIDcp/\n Z3AyZ/CWmw9xeAlzWpckK0v86M6K4f1SGclfhOFuIezhtJGEKpkiAilEQ6m7jGGxjv01lIhqXGA\n xVtdll3l0SLtPctxg7vxhHe6Yfk/JjH9wx6fDeOmyf5TabC30AsFvw/9iPtsv5BRfMYc/xtlBus\n nhyTM3nXsclyCxaACoy9EKQP4qZGihbxt7hWkeZjdTdujgtxxpvtUKhino=", "X-Received": "by 2002:a05:600c:8219:b0:485:ae14:8187 with SMTP id\n 5b1f17b1804b1-48715fc3250mr91970845e9.2.1774516861066;\n Thu, 26 Mar 2026 02:21:01 -0700 (PDT)", "From": "Silvan Kaiser <silvan@quobyte.com>", "To": "qemu-devel@nongnu.org", "Cc": "qemu-block@nongnu.org, kwolf@redhat.com, hreitz@redhat.com,\n pierrick.bouvier@linaro.org, eblake@redhat.com, armbru@redhat.com,\n Silvan Kaiser <silvan@quobyte.com>", "Subject": "[PATCH 2/3] docs/system: Document locking=posix option for file block\n driver", "Date": "Thu, 26 Mar 2026 10:19:47 +0100", "Message-ID": "<20260326091948.194529-3-silvan@quobyte.com>", "X-Mailer": "git-send-email 2.47.3", "In-Reply-To": "<20260326091948.194529-1-silvan@quobyte.com>", "References": "<20260326091948.194529-1-silvan@quobyte.com>", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=\"US-ASCII\"", "Received-SPF": "pass client-ip=2a00:1450:4864:20::32c;\n envelope-from=silvan@quobyte.com; helo=mail-wm1-x32c.google.com", "X-Spam_score_int": "-20", "X-Spam_score": "-2.1", "X-Spam_bar": "--", "X-Spam_report": "(-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,\n DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,\n RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001,\n SPF_PASS=-0.001 autolearn=ham autolearn_force=no", "X-Spam_action": "no action", "X-BeenThere": "qemu-devel@nongnu.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "qemu development <qemu-devel.nongnu.org>", "List-Unsubscribe": "<https://lists.nongnu.org/mailman/options/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>", "List-Archive": "<https://lists.nongnu.org/archive/html/qemu-devel>", "List-Post": "<mailto:qemu-devel@nongnu.org>", "List-Help": "<mailto:qemu-devel-request@nongnu.org?subject=help>", "List-Subscribe": "<https://lists.nongnu.org/mailman/listinfo/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=subscribe>", "Errors-To": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org", "Sender": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org" }, "content": "Signed-off-by: Silvan Kaiser <silvan@quobyte.com>\n---\n docs/system/qemu-block-drivers.rst.inc | 3 +++\n qemu-options.hx | 10 ++++++----\n 2 files changed, 9 insertions(+), 4 deletions(-)", "diff": "diff --git a/docs/system/qemu-block-drivers.rst.inc b/docs/system/qemu-block-drivers.rst.inc\nindex 384e95ba76..bdecbf39ca 100644\n--- a/docs/system/qemu-block-drivers.rst.inc\n+++ b/docs/system/qemu-block-drivers.rst.inc\n@@ -882,6 +882,9 @@ the POSIX locking API will be used. In this case there is a risk that the lock\n will get silently lost when doing hot plugging and block jobs, due to the\n shortcomings of the POSIX locking API.\n \n+To force the use of POSIX locks even when OFD locking is available, specify\n+\"locking=posix\". The same caveats about silent lock loss apply.\n+\n QEMU transparently handles lock handover during shared storage migration. For\n shared virtual disk images between multiple VMs, the \"share-rw\" device option\n should be used.\ndiff --git a/qemu-options.hx b/qemu-options.hx\nindex 21972f8326..23502c5aa6 100644\n--- a/qemu-options.hx\n+++ b/qemu-options.hx\n@@ -1540,10 +1540,12 @@ SRST\n default: threads)\n \n ``locking``\n- Specifies whether the image file is protected with Linux OFD\n- / POSIX locks. The default is to use the Linux Open File\n- Descriptor API if available, otherwise no lock is applied.\n- (auto/on/off, default: auto)\n+ Specifies whether the image file is protected with locks.\n+ 'on' enables locking, preferring OFD (Open File Descriptor)\n+ locks if available, but falling back to POSIX locks with a\n+ warning. 'posix' forces the use of POSIX locks. 'auto' (the\n+ default) enables locking only if OFD locks are available.\n+ 'off' disables locking. (on/off/auto/posix, default: auto)\n \n Example:\n \n", "prefixes": [ "2/3" ] }