From nobody Tue Feb 10 09:24:35 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=1650481886; cv=none; d=zohomail.com; s=zohoarc; b=lBOFmHJ/gyUMapu1t8MA9yfpGA3Gnu5vF3hdLjzvT32An4z0bA889e8x/eJrzlAlyTMyCU52Oajpc4ohRGU6F5Ein88bcIIsGpHcGdwm9tbVcjexJuxrg86Zv7FIDB88WBuOvokE/qraw7FgT1ybka/9hQb2z+TloPYRB3/SLNg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1650481886; h=Content-Type:Content-Transfer-Encoding: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=LZXi9fOulyqjvtbLnXji4pCAiBWjeZsqByyzHh0mwVA=; b=Qjy4BaqNK7v/0dbGTjuunwGM5AkSGPfSPZb5dgvQo8jsL1kmnKynCJRIqcttgt/pgwVkQa9rDHisf7xJxnfru2cMrzvFosuV2we1BulRhBLZrvHX0zJ+/HBFy55vLH/O3j398xUHc2cDdAlUhpnaUmDN4gcqpvo3xVr5yJcPdrE= 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 16504818869241000.3521376272136; Wed, 20 Apr 2022 12:11:26 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-138-DIMejmdgO9SuwIpG_4gbmQ-1; Wed, 20 Apr 2022 15:10:31 -0400 Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id DF866180138A; Wed, 20 Apr 2022 19:08:35 +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 CBEE4551E87; Wed, 20 Apr 2022 19:08:35 +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 327DF1940359; Wed, 20 Apr 2022 19:08:35 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx09.intmail.prod.int.rdu2.redhat.com [10.11.54.9]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 02CFC19451EC for ; Wed, 20 Apr 2022 19:08:31 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id E62A5551E86; Wed, 20 Apr 2022 19:08:30 +0000 (UTC) Received: from tapioca.home (unknown [10.40.193.11]) by smtp.corp.redhat.com (Postfix) with ESMTP id 69C03551E82 for ; Wed, 20 Apr 2022 19:08:30 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1650481886; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to: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=LZXi9fOulyqjvtbLnXji4pCAiBWjeZsqByyzHh0mwVA=; b=HrSoZ4R6yOE/2dU9OzY0w81J6ugOKiSKC8KMJiSAaxT9qO5NzIewD54QGORyKcnz09E2e5 2tJBkhY6J/l/IMXccvjdRCpwsTNdCXaK6NIWjSaQxVdukaVlpP76+jE/KsNPlpIV/N7rZR DZoUt2KuAGIDyB9vOx8xFuN9pnWghnk= X-MC-Unique: DIMejmdgO9SuwIpG_4gbmQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Victor Toso To: libvir-list@redhat.com Subject: [PATCH v3 09/30] docstring: macros: admin: Add 'Since version' metadata Date: Wed, 20 Apr 2022 21:07:58 +0200 Message-Id: <20220420190819.3093205-10-victortoso@redhat.com> In-Reply-To: <20220420190819.3093205-1-victortoso@redhat.com> References: <20220420190819.3093205-1-victortoso@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.85 on 10.11.54.9 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: , Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 2.85 on 10.11.54.9 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: 1650481887336100002 Content-Type: text/plain; charset="utf-8" Either create or append to existing docstring, the version (git tag) that a given macro was introduced in the format: Since: v1.2.3 Signed-off-by: Victor Toso Reviewed-by: Peter Krempa --- include/libvirt/libvirt-admin.h | 60 +++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) diff --git a/include/libvirt/libvirt-admin.h b/include/libvirt/libvirt-admi= n.h index f65886f20d..defca505f8 100644 --- a/include/libvirt/libvirt-admin.h +++ b/include/libvirt/libvirt-admin.h @@ -132,6 +132,9 @@ virAdmServerPtr virAdmConnectLookupServer(virAdmConnect= Ptr conn, * VIR_THREADPOOL_WORKERS_MIN: * Macro for the threadpool minWorkers limit: represents the bottom limit = to * number of active workers in threadpool, as VIR_TYPED_PARAM_UINT. + * + * Since: v1.3.4 + * */ =20 # define VIR_THREADPOOL_WORKERS_MIN "minWorkers" @@ -142,6 +145,9 @@ virAdmServerPtr virAdmConnectLookupServer(virAdmConnect= Ptr conn, * number of active workers in threadpool, as VIR_TYPED_PARAM_UINT. * The value of this limit has to be greater than VIR_THREADPOOL_WORKERS_M= IN * at all times. + * + * Since: v1.3.4 + * */ =20 # define VIR_THREADPOOL_WORKERS_MAX "maxWorkers" @@ -150,6 +156,9 @@ virAdmServerPtr virAdmConnectLookupServer(virAdmConnect= Ptr conn, * VIR_THREADPOOL_WORKERS_PRIORITY: * Macro for the threadpool nPrioWorkers attribute: represents the current= number * of active priority workers in threadpool, as VIR_TYPED_PARAM_UINT. + * + * Since: v1.3.4 + * */ =20 # define VIR_THREADPOOL_WORKERS_PRIORITY "prioWorkers" @@ -161,6 +170,9 @@ virAdmServerPtr virAdmConnectLookupServer(virAdmConnect= Ptr conn, * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.4 + * */ =20 # define VIR_THREADPOOL_WORKERS_FREE "freeWorkers" @@ -172,6 +184,9 @@ virAdmServerPtr virAdmConnectLookupServer(virAdmConnect= Ptr conn, * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.4 + * */ =20 # define VIR_THREADPOOL_WORKERS_CURRENT "nWorkers" @@ -183,6 +198,9 @@ virAdmServerPtr virAdmConnectLookupServer(virAdmConnect= Ptr conn, * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.4 + * */ =20 # define VIR_THREADPOOL_JOB_QUEUE_DEPTH "jobQueueDepth" @@ -233,6 +251,9 @@ virAdmServerLookupClient(virAdmServerPtr srv, * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.5 + * */ =20 # define VIR_CLIENT_INFO_READONLY "readonly" @@ -244,6 +265,9 @@ virAdmServerLookupClient(virAdmServerPtr srv, * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.5 + * */ =20 # define VIR_CLIENT_INFO_SOCKET_ADDR "sock_addr" @@ -255,6 +279,9 @@ virAdmServerLookupClient(virAdmServerPtr srv, * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.5 + * */ =20 # define VIR_CLIENT_INFO_SASL_USER_NAME "sasl_user_name" @@ -267,6 +294,9 @@ virAdmServerLookupClient(virAdmServerPtr srv, * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.5 + * */ =20 # define VIR_CLIENT_INFO_X509_DISTINGUISHED_NAME "tls_x509_dname" @@ -279,6 +309,9 @@ virAdmServerLookupClient(virAdmServerPtr srv, * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.5 + * */ =20 # define VIR_CLIENT_INFO_UNIX_USER_ID "unix_user_id" @@ -291,6 +324,9 @@ virAdmServerLookupClient(virAdmServerPtr srv, * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.5 + * */ =20 # define VIR_CLIENT_INFO_UNIX_USER_NAME "unix_user_name" @@ -303,6 +339,9 @@ virAdmServerLookupClient(virAdmServerPtr srv, * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.5 + * */ =20 # define VIR_CLIENT_INFO_UNIX_GROUP_ID "unix_group_id" @@ -315,6 +354,9 @@ virAdmServerLookupClient(virAdmServerPtr srv, * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.5 + * */ =20 # define VIR_CLIENT_INFO_UNIX_GROUP_NAME "unix_group_name" @@ -327,6 +369,9 @@ virAdmServerLookupClient(virAdmServerPtr srv, * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.5 + * */ =20 # define VIR_CLIENT_INFO_UNIX_PROCESS_ID "unix_process_id" @@ -339,6 +384,9 @@ virAdmServerLookupClient(virAdmServerPtr srv, * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.5 + * */ =20 # define VIR_CLIENT_INFO_SELINUX_CONTEXT "selinux_context" @@ -356,6 +404,9 @@ int virAdmClientClose(virAdmClientPtr client, unsigned = int flags); * VIR_SERVER_CLIENTS_MAX: * Macro for per-server nclients_max limit: represents the upper limit to * number of clients connected to the server, as uint. + * + * Since: v1.3.5 + * */ =20 # define VIR_SERVER_CLIENTS_MAX "nclients_max" @@ -367,6 +418,9 @@ int virAdmClientClose(virAdmClientPtr client, unsigned = int flags); * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.5 + * */ =20 # define VIR_SERVER_CLIENTS_CURRENT "nclients" @@ -376,6 +430,9 @@ int virAdmClientClose(virAdmClientPtr client, unsigned = int flags); * Macro for per-server nclients_unauth_max limit: represents the upper li= mit * to number of clients connected to the server, but not authenticated yet, * as VIR_TYPED_PARAM_UINT. + * + * Since: v1.3.5 + * */ =20 # define VIR_SERVER_CLIENTS_UNAUTH_MAX "nclients_unauth_max" @@ -388,6 +445,9 @@ int virAdmClientClose(virAdmClientPtr client, unsigned = int flags); * * NOTE: This attribute is read-only and any attempt to set it will be den= ied * by daemon + * + * Since: v1.3.5 + * */ =20 # define VIR_SERVER_CLIENTS_UNAUTH_CURRENT "nclients_unauth" --=20 2.35.1