{"id":2230511,"url":"http://patchwork.ozlabs.org/api/1.1/patches/2230511/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20260429192611.1581223-13-jsnow@redhat.com/","project":{"id":14,"url":"http://patchwork.ozlabs.org/api/1.1/projects/14/?format=json","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":""},"msgid":"<20260429192611.1581223-13-jsnow@redhat.com>","date":"2026-04-29T19:26:10","name":"[v2,12/13] qapi: convert intro sections for audio.json","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"8c82371860488eeb2f7f29f9395108a19fb75e1e","submitter":{"id":64343,"url":"http://patchwork.ozlabs.org/api/1.1/people/64343/?format=json","name":"John Snow","email":"jsnow@redhat.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/qemu-devel/patch/20260429192611.1581223-13-jsnow@redhat.com/mbox/","series":[{"id":502140,"url":"http://patchwork.ozlabs.org/api/1.1/series/502140/?format=json","web_url":"http://patchwork.ozlabs.org/project/qemu-devel/list/?series=502140","date":"2026-04-29T19:25:59","name":"qapi: add formal \"intro\" section","version":2,"mbox":"http://patchwork.ozlabs.org/series/502140/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2230511/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2230511/checks/","tags":{},"headers":{"Return-Path":"","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=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=fZ4B1mXD;\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=lists1p.gnu.org;\n envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n receiver=patchwork.ozlabs.org)"],"Received":["from lists1p.gnu.org (lists1p.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 4g5S5x0cc8z1yK5\n\tfor ; Thu, 30 Apr 2026 05:28:53 +1000 (AEST)","from localhost ([::1] helo=lists1p.gnu.org)\n\tby lists1p.gnu.org with esmtp (Exim 4.90_1)\n\t(envelope-from )\n\tid 1wIAa8-00085v-88; Wed, 29 Apr 2026 15:28:28 -0400","from eggs.gnu.org ([2001:470:142:3::10])\n by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from ) id 1wIAZ2-00075o-RF\n for qemu-devel@nongnu.org; Wed, 29 Apr 2026 15:27:17 -0400","from us-smtp-delivery-124.mimecast.com ([170.10.129.124])\n by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from ) id 1wIAZ0-0007x7-M5\n for qemu-devel@nongnu.org; Wed, 29 Apr 2026 15:27:16 -0400","from mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com\n (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by\n relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3,\n cipher=TLS_AES_256_GCM_SHA384) id us-mta-263-UXGHwF8DMuixLuLu0OsqGw-1; Wed,\n 29 Apr 2026 15:27:09 -0400","from mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com\n (mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.111])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest\n SHA256)\n (No client certificate requested)\n by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS\n id 2C775195608B; Wed, 29 Apr 2026 19:27:08 +0000 (UTC)","from jsnow-thinkpadp16vgen1.westford.csb (unknown [10.22.80.204])\n by mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP\n id AA6421800446; Wed, 29 Apr 2026 19:27:04 +0000 (UTC)"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n s=mimecast20190719; t=1777490833;\n h=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n to:to:cc:cc:mime-version:mime-version:\n content-transfer-encoding:content-transfer-encoding:\n in-reply-to:in-reply-to:references:references;\n bh=97OMNLdbAx+/ZvtUpM/tGpC1iMEpd6AAQW6MJCrh2N8=;\n b=fZ4B1mXDwKlnFRFJMZb4vgqgn/KvOCPmF0eaCH/dqKlcnm8763KmX2S4RJni+6j5HIq6yk\n 5N1zbCejBQgNN09oMf/foomdhztXnGHWyLUdIlkkSMswogehrla2YtWwlDHeq11SWTOb5w\n V98jgA+o80BsjZE+zwiZEj13xbzl0tE=","X-MC-Unique":"UXGHwF8DMuixLuLu0OsqGw-1","X-Mimecast-MFC-AGG-ID":"UXGHwF8DMuixLuLu0OsqGw_1777490828","From":"John Snow ","To":"qemu-devel@nongnu.org","Cc":"Michael Roth , Eric Blake ,\n\t=?utf-8?q?Marc-Andr=C3=A9_Lureau?= ,\n Richard Henderson ,\n John Snow , Paolo Bonzini ,\n Mauro Carvalho Chehab ,\n \"Michael S. Tsirkin\" ,\n Peter Maydell ,\n Pierrick Bouvier ,\n Igor Mammedov , Gerd Hoffmann ,\n Ani Sinha ,\n =?utf-8?q?Philippe_Mathieu-Daud=C3=A9?= ,\n Markus Armbruster ","Subject":"[PATCH v2 12/13] qapi: convert intro sections for audio.json","Date":"Wed, 29 Apr 2026 15:26:10 -0400","Message-ID":"<20260429192611.1581223-13-jsnow@redhat.com>","In-Reply-To":"<20260429192611.1581223-1-jsnow@redhat.com>","References":"<20260429192611.1581223-1-jsnow@redhat.com>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","X-Scanned-By":"MIMEDefang 3.4.1 on 10.30.177.111","Received-SPF":"pass client-ip=170.10.129.124; envelope-from=jsnow@redhat.com;\n helo=us-smtp-delivery-124.mimecast.com","X-Spam_score_int":"12","X-Spam_score":"1.2","X-Spam_bar":"+","X-Spam_report":"(1.2 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001,\n DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,\n RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001,\n RCVD_IN_SBL_CSS=3.335, SPF_HELO_PASS=-0.001,\n SPF_PASS=-0.001 autolearn=no 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 ","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","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: John Snow \n---\n qapi/audio.json | 112 ++++++++++++++----------------------------------\n 1 file changed, 32 insertions(+), 80 deletions(-)","diff":"diff --git a/qapi/audio.json b/qapi/audio.json\nindex 2df87b97101..62d64eabf1c 100644\n--- a/qapi/audio.json\n+++ b/qapi/audio.json\n@@ -13,10 +13,8 @@\n ##\n \n ##\n-# @AudiodevPerDirectionOptions:\n-#\n-# General audio backend options that are used for both playback and\n-# recording.\n+# @AudiodevPerDirectionOptions: General audio backend options that are\n+# used for both playback and recording.\n #\n # @mixing-engine: use QEMU's mixing engine to mix all streams inside\n # QEMU and convert audio formats when not supported by the\n@@ -52,9 +50,7 @@\n '*buffer-length': 'uint32' } }\n \n ##\n-# @AudiodevGenericOptions:\n-#\n-# Generic driver-specific options.\n+# @AudiodevGenericOptions: Generic driver-specific options.\n #\n # @in: options of the capture stream\n #\n@@ -68,9 +64,7 @@\n '*out': 'AudiodevPerDirectionOptions' } }\n \n ##\n-# @AudiodevDBusOptions:\n-#\n-# Options of the D-Bus audio backend.\n+# @AudiodevDBusOptions: Options of the D-Bus audio backend.\n #\n # @in: options of the capture stream\n #\n@@ -88,10 +82,8 @@\n '*nsamples': 'uint32'} }\n \n ##\n-# @AudiodevAlsaPerDirectionOptions:\n-#\n-# Options of the ALSA backend that are used for both playback and\n-# recording.\n+# @AudiodevAlsaPerDirectionOptions: Options of the ALSA backend that\n+# are used for both playback and recording.\n #\n # @dev: the name of the ALSA device to use (default 'default')\n #\n@@ -110,9 +102,7 @@\n '*try-poll': 'bool' } }\n \n ##\n-# @AudiodevAlsaOptions:\n-#\n-# Options of the ALSA audio backend.\n+# @AudiodevAlsaOptions: Options of the ALSA audio backend.\n #\n # @in: options of the capture stream\n #\n@@ -129,9 +119,7 @@\n '*threshold': 'uint32' } }\n \n ##\n-# @AudiodevSndioOptions:\n-#\n-# Options of the sndio audio backend.\n+# @AudiodevSndioOptions: Options of the sndio audio backend.\n #\n # @in: options of the capture stream\n #\n@@ -151,10 +139,8 @@\n '*latency': 'uint32'} }\n \n ##\n-# @AudiodevCoreaudioPerDirectionOptions:\n-#\n-# Options of the Core Audio backend that are used for both playback\n-# and recording.\n+# @AudiodevCoreaudioPerDirectionOptions: Options of the Core Audio\n+# backend that are used for both playback and recording.\n #\n # @buffer-count: number of buffers\n #\n@@ -166,9 +152,7 @@\n '*buffer-count': 'uint32' } }\n \n ##\n-# @AudiodevCoreaudioOptions:\n-#\n-# Options of the coreaudio audio backend.\n+# @AudiodevCoreaudioOptions: Options of the coreaudio audio backend.\n #\n # @in: options of the capture stream\n #\n@@ -182,9 +166,7 @@\n '*out': 'AudiodevCoreaudioPerDirectionOptions' } }\n \n ##\n-# @AudiodevDsoundOptions:\n-#\n-# Options of the DirectSound audio backend.\n+# @AudiodevDsoundOptions: Options of the DirectSound audio backend.\n #\n # @in: options of the capture stream\n #\n@@ -202,10 +184,8 @@\n '*latency': 'uint32' } }\n \n ##\n-# @AudiodevJackPerDirectionOptions:\n-#\n-# Options of the JACK backend that are used for both playback and\n-# recording.\n+# @AudiodevJackPerDirectionOptions: Options of the JACK backend that\n+# are used for both playback and recording.\n #\n # @server-name: select from among several possible concurrent server\n # instances (default: environment variable $JACK_DEFAULT_SERVER if\n@@ -236,9 +216,7 @@\n '*exact-name': 'bool' } }\n \n ##\n-# @AudiodevJackOptions:\n-#\n-# Options of the JACK audio backend.\n+# @AudiodevJackOptions: Options of the JACK audio backend.\n #\n # @in: options of the capture stream\n #\n@@ -252,10 +230,8 @@\n '*out': 'AudiodevJackPerDirectionOptions' } }\n \n ##\n-# @AudiodevOssPerDirectionOptions:\n-#\n-# Options of the OSS backend that are used for both playback and\n-# recording.\n+# @AudiodevOssPerDirectionOptions: Options of the OSS backend that are\n+# used for both playback and recording.\n #\n # @dev: file name of the OSS device (default '/dev/dsp')\n #\n@@ -274,9 +250,7 @@\n '*try-poll': 'bool' } }\n \n ##\n-# @AudiodevOssOptions:\n-#\n-# Options of the OSS audio backend.\n+# @AudiodevOssOptions: Options of the OSS audio backend.\n #\n # @in: options of the capture stream\n #\n@@ -304,10 +278,8 @@\n '*dsp-policy': 'uint32' } }\n \n ##\n-# @AudiodevPaPerDirectionOptions:\n-#\n-# Options of the Pulseaudio backend that are used for both playback\n-# and recording.\n+# @AudiodevPaPerDirectionOptions: Options of the Pulseaudio backend\n+# that are used for both playback and recording.\n #\n # @name: name of the sink/source to use\n #\n@@ -329,9 +301,7 @@\n '*latency': 'uint32' } }\n \n ##\n-# @AudiodevPaOptions:\n-#\n-# Options of the PulseAudio audio backend.\n+# @AudiodevPaOptions: Options of the PulseAudio audio backend.\n #\n # @in: options of the capture stream\n #\n@@ -348,10 +318,8 @@\n '*server': 'str' } }\n \n ##\n-# @AudiodevPipewirePerDirectionOptions:\n-#\n-# Options of the PipeWire backend that are used for both playback and\n-# recording.\n+# @AudiodevPipewirePerDirectionOptions: Options of the PipeWire\n+# backend that are used for both playback and recording.\n #\n # @name: name of the sink/source to use\n #\n@@ -373,9 +341,7 @@\n '*latency': 'uint32' } }\n \n ##\n-# @AudiodevPipewireOptions:\n-#\n-# Options of the PipeWire audio backend.\n+# @AudiodevPipewireOptions: Options of the PipeWire audio backend.\n #\n # @in: options of the capture stream\n #\n@@ -389,10 +355,8 @@\n '*out': 'AudiodevPipewirePerDirectionOptions' } }\n \n ##\n-# @AudiodevSdlPerDirectionOptions:\n-#\n-# Options of the SDL audio backend that are used for both playback and\n-# recording.\n+# @AudiodevSdlPerDirectionOptions: Options of the SDL audio backend\n+# that are used for both playback and recording.\n #\n # @buffer-count: number of buffers (default 4)\n #\n@@ -404,9 +368,7 @@\n '*buffer-count': 'uint32' } }\n \n ##\n-# @AudiodevSdlOptions:\n-#\n-# Options of the SDL audio backend.\n+# @AudiodevSdlOptions: Options of the SDL audio backend.\n #\n # @in: options of the recording stream\n #\n@@ -420,9 +382,7 @@\n '*out': 'AudiodevSdlPerDirectionOptions' } }\n \n ##\n-# @AudiodevWavOptions:\n-#\n-# Options of the wav audio backend.\n+# @AudiodevWavOptions: Options of the wav audio backend.\n #\n # @in: options of the capture stream\n #\n@@ -439,9 +399,7 @@\n '*path': 'str' } }\n \n ##\n-# @AudioFormat:\n-#\n-# An enumeration of possible audio formats.\n+# @AudioFormat: An enumeration of possible audio formats.\n #\n # @u8: unsigned 8 bit integer\n #\n@@ -463,9 +421,7 @@\n 'data': [ 'u8', 's8', 'u16', 's16', 'u32', 's32', 'f32' ] }\n \n ##\n-# @AudiodevDriver:\n-#\n-# An enumeration of possible audio backend drivers.\n+# @AudiodevDriver: An enumeration of possible audio backend drivers.\n #\n # @jack: JACK audio backend (since 5.1)\n #\n@@ -487,9 +443,7 @@\n 'wav' ] }\n \n ##\n-# @Audiodev:\n-#\n-# Options of an audio backend.\n+# @Audiodev: Options of an audio backend.\n #\n # @id: identifier of the backend\n #\n@@ -533,9 +487,7 @@\n 'wav': 'AudiodevWavOptions' } }\n \n ##\n-# @query-audiodevs:\n-#\n-# Return information about audiodev configuration\n+# @query-audiodevs: Return information about audiodev configuration\n #\n # Since: 8.0\n ##\n","prefixes":["v2","12/13"]}