From nobody Sat May 18 14:25:24 2024 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=1650631632; cv=none; d=zohomail.com; s=zohoarc; b=DV/Gjd3b0+QDzTPYmFW5pCUTvDHpYuOvImNXt054pvqbaaPGYmN6nfs5qxmTipqB4p5ncjV689ISF88LYXlXoI8C3D+lVP92RDhQEvndIKyLf+yz7qmGuQPz5o6Cm+W1Z+gpBVsKGtjVjjoBsG79i141fNGiOw85l6ef3M5KDKc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1650631632; 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=sh/Ii1I1A5olRmOJ8JeMEkl0lKzH8qDbCGacQP42nGM=; b=K93I4VbRXKb/awEwUsfdKhk5TIiCvFjhJy5Op65NIILpWXiIifJZFLPSdDY2uZ1gKDKIvuYfV7FjxodYZ1Z5WcfRGr6CLVShV3XXFDinU509eDU6KnR1F3srKL9kpJNxRxPdxnyLvKlVShlkkxomYna7HQjochUlrgMUndvP3gA= 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 1650631632483561.5234307000544; Fri, 22 Apr 2022 05:47:12 -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-340-gJzRcL3_MgKp0cGPpnDxOg-1; Fri, 22 Apr 2022 08:47:03 -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 B36A51014A64; Fri, 22 Apr 2022 12:47:01 +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 93E3940ED53; Fri, 22 Apr 2022 12:47:01 +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 073381940352; Fri, 22 Apr 2022 12:47:01 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 4A2C71940351 for ; Fri, 22 Apr 2022 12:47:00 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 1A3CD40CF918; Fri, 22 Apr 2022 12:47:00 +0000 (UTC) Received: from harajuku.usersys.redhat.com.homenet.telecomitalia.it (unknown [10.40.195.101]) by smtp.corp.redhat.com (Postfix) with ESMTPS id E209340D0174 for ; Fri, 22 Apr 2022 12:46:55 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1650631631; 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=sh/Ii1I1A5olRmOJ8JeMEkl0lKzH8qDbCGacQP42nGM=; b=JuUkZulPkpbbu/Lk0RpRfvqtvTcAwUmMT1LRW0itNhIHArs1eCJNzv7gUqm8133Kq97AEG u0Mm+7MppZ8JsVwW97WYHU0VjZ+hxtPHoy2F/psPHPrY/abNNSoK+crsLwv0j4p2qYACg8 Wy9S59NEsrTbaD2mkAz45XO7WsEFj6I= X-MC-Unique: gJzRcL3_MgKp0cGPpnDxOg-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH 1/2] include: Fix vertical spacing inside comments Date: Fri, 22 Apr 2022 14:46:49 +0200 Message-Id: <20220422124650.118668-2-abologna@redhat.com> In-Reply-To: <20220422124650.118668-1-abologna@redhat.com> References: <20220422124650.118668-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.11.54.1 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.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: 1650631634430100003 Content-Type: text/plain; charset="utf-8" There should be no empty lines between the Since tag in a docstring comment and the end marker. Signed-off-by: Andrea Bolognani Reviewed-by: Peter Krempa --- include/libvirt/libvirt-domain-checkpoint.h | 6 - include/libvirt/libvirt-domain-snapshot.h | 7 - include/libvirt/libvirt-domain.h | 139 -------------------- include/libvirt/libvirt-event.h | 1 - include/libvirt/libvirt-host.h | 26 ---- include/libvirt/libvirt-interface.h | 5 - include/libvirt/libvirt-network.h | 17 --- include/libvirt/libvirt-nodedev.h | 5 - include/libvirt/libvirt-nwfilter.h | 6 - include/libvirt/libvirt-secret.h | 7 - include/libvirt/libvirt-storage.h | 25 ---- include/libvirt/libvirt-stream.h | 3 - include/libvirt/virterror.h | 5 - 13 files changed, 252 deletions(-) diff --git a/include/libvirt/libvirt-domain-checkpoint.h b/include/libvirt/= libvirt-domain-checkpoint.h index c6655f9456..d5dea750db 100644 --- a/include/libvirt/libvirt-domain-checkpoint.h +++ b/include/libvirt/libvirt-domain-checkpoint.h @@ -36,7 +36,6 @@ * not allow reverting back to that point in time. * * Since: v5.2.0 - * */ typedef struct _virDomainCheckpoint virDomainCheckpoint; =20 @@ -48,7 +47,6 @@ typedef struct _virDomainCheckpoint virDomainCheckpoint; * checkpoint in the API. * * Since: v5.2.0 - * */ typedef virDomainCheckpoint *virDomainCheckpointPtr; =20 @@ -60,7 +58,6 @@ virConnectPtr virDomainCheckpointGetConnect(virDomainChec= kpointPtr checkpoint); * virDomainCheckpointCreateFlags: * * Since: v5.6.0 - * */ typedef enum { VIR_DOMAIN_CHECKPOINT_CREATE_REDEFINE =3D (1 << 0), /* Restore or a= lter @@ -81,7 +78,6 @@ virDomainCheckpointPtr virDomainCheckpointCreateXML(virDo= mainPtr domain, * virDomainCheckpointXMLFlags: * * Since: v5.6.0 - * */ typedef enum { VIR_DOMAIN_CHECKPOINT_XML_SECURE =3D (1 << 0), /* Include sensitive= data */ @@ -106,7 +102,6 @@ char *virDomainCheckpointGetXMLDesc(virDomainCheckpoint= Ptr checkpoint, * are 0, then that group is not used to filter results. * * Since: v5.6.0 - * */ typedef enum { VIR_DOMAIN_CHECKPOINT_LIST_ROOTS =3D (1 << 0), /* Filter by chec= kpoints @@ -150,7 +145,6 @@ virDomainCheckpointPtr virDomainCheckpointGetParent(vir= DomainCheckpointPtr check * Delete a checkpoint * * Since: v5.6.0 - * */ typedef enum { VIR_DOMAIN_CHECKPOINT_DELETE_CHILDREN =3D (1 << 0), /* Also delet= e children */ diff --git a/include/libvirt/libvirt-domain-snapshot.h b/include/libvirt/li= bvirt-domain-snapshot.h index 4151c30d8f..35eeb21e27 100644 --- a/include/libvirt/libvirt-domain-snapshot.h +++ b/include/libvirt/libvirt-domain-snapshot.h @@ -36,7 +36,6 @@ * state at a later time. * * Since: v0.8.0 - * */ typedef struct _virDomainSnapshot virDomainSnapshot; =20 @@ -47,7 +46,6 @@ typedef struct _virDomainSnapshot virDomainSnapshot; * and is the type used to reference a domain snapshot in the API. * * Since: v0.8.0 - * */ typedef virDomainSnapshot *virDomainSnapshotPtr; =20 @@ -59,7 +57,6 @@ virConnectPtr virDomainSnapshotGetConnect(virDomainSnapsh= otPtr snapshot); * virDomainSnapshotCreateFlags: * * Since: v0.9.5 - * */ typedef enum { VIR_DOMAIN_SNAPSHOT_CREATE_REDEFINE =3D (1 << 0), /* Restore or alt= er @@ -95,7 +92,6 @@ virDomainSnapshotPtr virDomainSnapshotCreateXML(virDomain= Ptr domain, * virDomainSnapshotXMLFlags: * * Since: v5.1.0 - * */ typedef enum { VIR_DOMAIN_SNAPSHOT_XML_SECURE =3D VIR_DOMAIN_XML_SECURE, /* d= ump security sensitive information too */ @@ -118,7 +114,6 @@ char *virDomainSnapshotGetXMLDesc(virDomainSnapshotPtr = snapshot, * 0, then that group is not used to filter results. * * Since: v0.9.5 - * */ typedef enum { VIR_DOMAIN_SNAPSHOT_LIST_ROOTS =3D (1 << 0), /* Filter by snapsh= ots @@ -219,7 +214,6 @@ int virDomainSnapshotHasMetadata(virDomainSnapshotPtr s= napshot, * virDomainSnapshotRevertFlags: * * Since: v0.9.5 - * */ typedef enum { VIR_DOMAIN_SNAPSHOT_REVERT_RUNNING =3D 1 << 0, /* Run after revert */ @@ -241,7 +235,6 @@ int virDomainRevertToSnapshot(virDomainSnapshotPtr snap= shot, * Delete a snapshot * * Since: v0.8.0 - * */ typedef enum { VIR_DOMAIN_SNAPSHOT_DELETE_CHILDREN =3D (1 << 0), /* Also delete = children */ diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-dom= ain.h index 8c313be149..3121330bf0 100644 --- a/include/libvirt/libvirt-domain.h +++ b/include/libvirt/libvirt-domain.h @@ -34,7 +34,6 @@ * a virDomain is a private structure representing a domain. * * Since: v0.0.1 - * */ typedef struct _virDomain virDomain; =20 @@ -45,7 +44,6 @@ typedef struct _virDomain virDomain; * type used to reference a domain in the API. * * Since: v0.0.1 - * */ typedef virDomain *virDomainPtr; =20 @@ -55,7 +53,6 @@ typedef virDomain *virDomainPtr; * A domain may be in different states at a given point in time * * Since: v0.0.1 - * */ typedef enum { VIR_DOMAIN_NOSTATE =3D 0, /* no state */ @@ -82,7 +79,6 @@ typedef enum { * virDomainNostateReason: * * Since: v0.9.2 - * */ typedef enum { VIR_DOMAIN_NOSTATE_UNKNOWN =3D 0, @@ -96,7 +92,6 @@ typedef enum { * virDomainRunningReason: * * Since: v0.9.2 - * */ typedef enum { VIR_DOMAIN_RUNNING_UNKNOWN =3D 0, @@ -121,7 +116,6 @@ typedef enum { * virDomainBlockedReason: * * Since: v0.9.2 - * */ typedef enum { VIR_DOMAIN_BLOCKED_UNKNOWN =3D 0, /* the reason is unknown */ @@ -135,7 +129,6 @@ typedef enum { * virDomainPausedReason: * * Since: v0.9.2 - * */ typedef enum { VIR_DOMAIN_PAUSED_UNKNOWN =3D 0, /* the reason is unknown */ @@ -162,7 +155,6 @@ typedef enum { * virDomainShutdownReason: * * Since: v0.9.2 - * */ typedef enum { VIR_DOMAIN_SHUTDOWN_UNKNOWN =3D 0, /* the reason is unknown */ @@ -177,7 +169,6 @@ typedef enum { * virDomainShutoffReason: * * Since: v0.9.2 - * */ typedef enum { VIR_DOMAIN_SHUTOFF_UNKNOWN =3D 0, /* the reason is unknown */ @@ -200,7 +191,6 @@ typedef enum { * virDomainCrashedReason: * * Since: v0.9.2 - * */ typedef enum { VIR_DOMAIN_CRASHED_UNKNOWN =3D 0, /* crashed for unknown reason */ @@ -215,7 +205,6 @@ typedef enum { * virDomainPMSuspendedReason: * * Since: v0.9.11 - * */ typedef enum { VIR_DOMAIN_PMSUSPENDED_UNKNOWN =3D 0, @@ -229,7 +218,6 @@ typedef enum { * virDomainPMSuspendedDiskReason: * * Since: v1.0.0 - * */ typedef enum { VIR_DOMAIN_PMSUSPENDED_DISK_UNKNOWN =3D 0, @@ -245,7 +233,6 @@ typedef enum { * Current state of a control interface to the domain. * * Since: v0.9.3 - * */ typedef enum { VIR_DOMAIN_CONTROL_OK =3D 0, /* operational, ready to accept com= mands */ @@ -268,7 +255,6 @@ typedef enum { * Reason for the error state. * * Since: v1.2.14 - * */ typedef enum { VIR_DOMAIN_CONTROL_ERROR_REASON_NONE =3D 0, /* server didn't provi= de a @@ -292,7 +278,6 @@ typedef enum { * current state of control interface to a domain. * * Since: v0.9.3 - * */ typedef struct _virDomainControlInfo virDomainControlInfo; struct _virDomainControlInfo { @@ -310,7 +295,6 @@ struct _virDomainControlInfo { * Pointer to virDomainControlInfo structure. * * Since: v0.9.3 - * */ typedef virDomainControlInfo *virDomainControlInfoPtr; =20 @@ -333,7 +317,6 @@ typedef virDomainControlInfo *virDomainControlInfoPtr; * These enums should not conflict with those of virTypedParameterFlags. * * Since: v0.9.2 - * */ typedef enum { VIR_DOMAIN_AFFECT_CURRENT =3D 0, /* Affect current domain state. = */ @@ -349,7 +332,6 @@ typedef enum { * runtime information for a given active Domain * * Since: v0.0.1 - * */ typedef struct _virDomainInfo virDomainInfo; =20 @@ -367,7 +349,6 @@ struct _virDomainInfo { * a virDomainInfoPtr is a pointer to a virDomainInfo structure. * * Since: v0.0.1 - * */ =20 typedef virDomainInfo *virDomainInfoPtr; @@ -379,7 +360,6 @@ typedef virDomainInfo *virDomainInfoPtr; * Domain. * * Since: v0.0.1 - * */ typedef enum { VIR_DOMAIN_NONE =3D 0, /* Default behavior */ @@ -569,7 +549,6 @@ int virDomainSetSchedulerParametersFlags (virDomain= Ptr domain, * NB. Here 'long long' means 64 bit integer. * * Since: v0.3.3 - * */ typedef struct _virDomainBlockStats virDomainBlockStatsStruct; =20 @@ -587,7 +566,6 @@ struct _virDomainBlockStats { * A pointer to a virDomainBlockStats structure * * Since: v0.3.2 - * */ typedef virDomainBlockStatsStruct *virDomainBlockStatsPtr; =20 @@ -702,7 +680,6 @@ typedef virDomainBlockStatsStruct *virDomainBlockStatsP= tr; * NB. Here 'long long' means 64 bit integer. * * Since: v0.3.3 - * */ typedef struct _virDomainInterfaceStats virDomainInterfaceStatsStruct; =20 @@ -723,7 +700,6 @@ struct _virDomainInterfaceStats { * A pointer to a virDomainInterfaceStats structure * * Since: v0.3.2 - * */ typedef virDomainInterfaceStatsStruct *virDomainInterfaceStatsPtr; =20 @@ -733,7 +709,6 @@ typedef virDomainInterfaceStatsStruct *virDomainInterfa= ceStatsPtr; * Memory Statistics Tags: * * Since: v0.7.5 - * */ typedef enum { /* The total amount of data read from swap space (in kB). */ @@ -815,7 +790,6 @@ typedef enum { * virDomainMemoryStatStruct: * * Since: v0.7.5 - * */ typedef struct _virDomainMemoryStat virDomainMemoryStatStruct; =20 @@ -828,7 +802,6 @@ struct _virDomainMemoryStat { * virDomainMemoryStatPtr: * * Since: v0.7.5 - * */ typedef virDomainMemoryStatStruct *virDomainMemoryStatPtr; =20 @@ -839,7 +812,6 @@ typedef virDomainMemoryStatStruct *virDomainMemoryStatP= tr; * Domain core dump flags. * * Since: v0.7.5 - * */ typedef enum { VIR_DUMP_CRASH =3D (1 << 0), /* crash after dump */ @@ -855,7 +827,6 @@ typedef enum { * Values for specifying different formats of domain core dumps. * * Since: v1.2.3 - * */ typedef enum { VIR_DOMAIN_CORE_DUMP_FORMAT_RAW, /* dump guest memory in raw = format */ @@ -882,7 +853,6 @@ typedef enum { * Domain migration flags. * * Since: v0.3.2 - * */ typedef enum { /* Do not pause the domain during migration. The domain's memory will @@ -1362,7 +1332,6 @@ int virDomainMigrateSetCompressionCache(virDomainPtr = domain, * Domain migration speed flags. * * Since: v5.1.0 - * */ typedef enum { /* Set or get maximum speed of post-copy migration. */ @@ -1430,7 +1399,6 @@ virDomainPtr virDomainLookupByUUIDString = (virConnectPtr conn, * virDomainShutdownFlagValues: * * Since: v0.9.10 - * */ typedef enum { VIR_DOMAIN_SHUTDOWN_DEFAULT =3D 0, /* hypervisor choice = */ @@ -1449,7 +1417,6 @@ int virDomainShutdownFlags (virD= omainPtr domain, * virDomainRebootFlagValues: * * Since: v0.9.10 - * */ typedef enum { VIR_DOMAIN_REBOOT_DEFAULT =3D 0, /* hypervisor choice */ @@ -1474,7 +1441,6 @@ int virDomainDestroy (virD= omainPtr domain); * virDomainDestroyFlags() function * * Since: v0.9.4 - * */ typedef enum { VIR_DOMAIN_DESTROY_DEFAULT =3D 0, /* Default behavior - could l= ead to data loss!! */ @@ -1510,7 +1476,6 @@ int virDomainPMWakeup (virD= omainPtr domain, * flags apply to all these functions. * * Since: v0.9.4 - * */ typedef enum { VIR_DOMAIN_SAVE_BYPASS_CACHE =3D 1 << 0, /* Avoid file system cache po= llution */ @@ -1800,7 +1765,6 @@ int virDomainGetMemoryParameters(virDomainPtr dom= ain, * Memory size modification flags. * * Since: v1.0.0 - * */ typedef enum { /* See virDomainModificationImpact for these flags. */ @@ -1821,7 +1785,6 @@ typedef enum { * a domain. * * Since: v0.9.9 - * */ typedef enum { VIR_DOMAIN_NUMATUNE_MEM_STRICT =3D 0, @@ -1889,7 +1852,6 @@ int virDomainGetSecurityLabel (vi= rDomainPtr domain, * virDomainGetHostnameFlags: * * Since: v6.1.0 - * */ typedef enum { VIR_DOMAIN_GET_HOSTNAME_LEASE =3D (1 << 0), /* Parse DHCP lease file */ @@ -1905,7 +1867,6 @@ int virDomainGetSecurityLabelList= (virDomainPtr domain, * virDomainMetadataType: * * Since: v0.9.10 - * */ typedef enum { VIR_DOMAIN_METADATA_DESCRIPTION =3D 0, /* Operate on */ @@ -1941,7 +1902,6 @@ virDomainGetMetadata(virDomainPtr domain, * Flags available for virDomainGetXMLDesc * * Since: v0.3.3 - * */ typedef enum { VIR_DOMAIN_XML_SECURE =3D (1 << 0), /* dump security sensitive i= nformation too */ @@ -1954,7 +1914,6 @@ typedef enum { * virDomainSaveImageXMLFlags: * * Since: v5.1.0 - * */ typedef enum { VIR_DOMAIN_SAVE_IMAGE_XML_SECURE =3D VIR_DOMAIN_XML_SECURE, /*= dump security sensitive information too */ @@ -2076,7 +2035,6 @@ int virDomainBlockPeek (virDomain= Ptr dom, * Flags available for virDomainBlockResize(). * * Since: v0.9.11 - * */ typedef enum { VIR_DOMAIN_BLOCK_RESIZE_BYTES =3D 1 << 0, /* size in bytes instead of = KiB */ @@ -2112,7 +2070,6 @@ int virDomainBlockResize (virDoma= inPtr dom, * * physical: size of the block device container * * Since: v0.8.1 - * */ typedef struct _virDomainBlockInfo virDomainBlockInfo; =20 @@ -2120,7 +2077,6 @@ typedef struct _virDomainBlockInfo virDomainBlockInfo; * virDomainBlockInfoPtr: * * Since: v0.8.1 - * */ typedef virDomainBlockInfo *virDomainBlockInfoPtr; struct _virDomainBlockInfo { @@ -2154,7 +2110,6 @@ int virDomainMemoryStats (virDoma= inPtr dom, * Memory peeking flags. * * Since: v0.4.4 - * */ typedef enum { VIR_MEMORY_VIRTUAL =3D 1 << 0, /* addresses are virtual add= resses */ @@ -2171,7 +2126,6 @@ int virDomainMemoryPeek (virDomai= nPtr dom, * virDomainDefineFlags: * * Since: v1.2.12 - * */ typedef enum { VIR_DOMAIN_DEFINE_VALIDATE =3D (1 << 0), /* Validate the XML document = against schema */ @@ -2192,7 +2146,6 @@ int virDomainUndefine (virD= omainPtr domain); * virDomainUndefineFlagsValues: * * Since: v0.9.4 - * */ typedef enum { VIR_DOMAIN_UNDEFINE_MANAGED_SAVE =3D (1 << 0), /* Also remove any @@ -2274,7 +2227,6 @@ int virDomainSetAutostart (virD= omainPtr domain, * structure for information about a virtual CPU in a domain. * * Since: v0.1.4 - * */ typedef enum { VIR_VCPU_OFFLINE =3D 0, /* the virtual CPU is offline */ @@ -2290,7 +2242,6 @@ typedef enum { * virVcpuHostCpuState: * * Since: v6.10.0 - * */ typedef enum { VIR_VCPU_INFO_CPU_OFFLINE =3D -1, /* the vCPU is offline */ @@ -2301,7 +2252,6 @@ typedef enum { * virVcpuInfo: * * Since: v0.1.4 - * */ typedef struct _virVcpuInfo virVcpuInfo; struct _virVcpuInfo { @@ -2315,7 +2265,6 @@ struct _virVcpuInfo { * virVcpuInfoPtr: * * Since: v0.1.4 - * */ typedef virVcpuInfo *virVcpuInfoPtr; =20 @@ -2325,7 +2274,6 @@ typedef virVcpuInfo *virVcpuInfoPtr; * Flags for controlling virtual CPU hot-plugging. * * Since: v1.0.0 - * */ typedef enum { /* See virDomainModificationImpact for these flags. */ @@ -2379,7 +2327,6 @@ int virDomainGetEmulatorPinInfo (= virDomainPtr domain, * The data structure for information about all IOThreads in a domain * * Since: v1.2.14 - * */ typedef struct _virDomainIOThreadInfo virDomainIOThreadInfo; =20 @@ -2388,7 +2335,6 @@ typedef struct _virDomainIOThreadInfo virDomainIOThre= adInfo; * virDomainIOThreadInfoPtr: * * Since: v1.2.14 - * */ typedef virDomainIOThreadInfo *virDomainIOThreadInfoPtr; struct _virDomainIOThreadInfo { @@ -2580,7 +2526,6 @@ int virDomainGetVcpus (virD= omainPtr domain, * virDomainDeviceModifyFlags: * * Since: v1.0.0 - * */ typedef enum { /* See virDomainModificationImpact for these flags. */ @@ -2610,7 +2555,6 @@ int virDomainDetachDeviceAlias(virDomainPtr domain, * virDomainStatsRecord: * * Since: v1.2.8 - * */ typedef struct _virDomainStatsRecord virDomainStatsRecord; =20 @@ -2618,7 +2562,6 @@ typedef struct _virDomainStatsRecord virDomainStatsRe= cord; * virDomainStatsRecordPtr: * * Since: v1.2.8 - * */ typedef virDomainStatsRecord *virDomainStatsRecordPtr; struct _virDomainStatsRecord { @@ -2631,7 +2574,6 @@ struct _virDomainStatsRecord { * virDomainStatsTypes: * * Since: v1.2.8 - * */ typedef enum { VIR_DOMAIN_STATS_STATE =3D (1 << 0), /* return domain state */ @@ -2650,7 +2592,6 @@ typedef enum { * virConnectGetAllDomainStatsFlags: * * Since: v1.2.8 - * */ typedef enum { VIR_CONNECT_GET_ALL_DOMAINS_STATS_ACTIVE =3D VIR_CONNECT_LIST_DOMAINS_= ACTIVE, @@ -2881,7 +2822,6 @@ void virDomainStatsRecordListFree(virDomainStatsRecor= dPtr *stats); * to the "perf.page_faults" field in the *Stats APIs. * * Since: v3.2.0 -* */ # define VIR_PERF_PARAM_PAGE_FAULTS "page_faults" =20 @@ -2976,7 +2916,6 @@ int virDomainSetPerfEvents(virDomainPtr dom, * Describes various possible block jobs. * * Since: v0.9.4 - * */ typedef enum { /* Placeholder */ @@ -3014,7 +2953,6 @@ typedef enum { * active commit job * * Since: v0.9.12 - * */ typedef enum { VIR_DOMAIN_BLOCK_JOB_ABORT_ASYNC =3D 1 << 0, @@ -3030,7 +2968,6 @@ int virDomainBlockJobAbort(virDomainPtr dom, const ch= ar *disk, * Flags for use with virDomainGetBlockJobInfo * * Since: v1.2.9 - * */ typedef enum { VIR_DOMAIN_BLOCK_JOB_INFO_BANDWIDTH_BYTES =3D 1 << 0, /* bandwidth in = bytes/s @@ -3043,7 +2980,6 @@ typedef enum { * An iterator for monitoring block job operations * * Since: v0.9.4 - * */ typedef unsigned long long virDomainBlockJobCursor; =20 @@ -3051,7 +2987,6 @@ typedef unsigned long long virDomainBlockJobCursor; * virDomainBlockJobInfo: * * Since: v0.9.4 - * */ typedef struct _virDomainBlockJobInfo virDomainBlockJobInfo; struct _virDomainBlockJobInfo { @@ -3072,7 +3007,6 @@ struct _virDomainBlockJobInfo { * virDomainBlockJobInfoPtr: * * Since: v0.9.4 - * */ typedef virDomainBlockJobInfo *virDomainBlockJobInfoPtr; =20 @@ -3086,7 +3020,6 @@ int virDomainGetBlockJobInfo(virDomainPtr dom, const = char *disk, * Flags for use with virDomainBlockJobSetSpeed * * Since: v1.2.9 - * */ typedef enum { VIR_DOMAIN_BLOCK_JOB_SPEED_BANDWIDTH_BYTES =3D 1 << 0, /* bandwidth in= bytes/s @@ -3103,7 +3036,6 @@ int virDomainBlockJobSetSpeed(virDomainPtr dom, const= char *disk, * flags for virDomainBlockRebase) * * Since: v1.2.9 - * */ typedef enum { VIR_DOMAIN_BLOCK_PULL_BANDWIDTH_BYTES =3D 1 << 6, /* bandwidth in byte= s/s @@ -3119,7 +3051,6 @@ int virDomainBlockPull(virDomainPtr dom, const char *= disk, * Flags available for virDomainBlockRebase(). * * Since: v0.9.12 - * */ typedef enum { VIR_DOMAIN_BLOCK_REBASE_SHALLOW =3D 1 << 0, /* Limit copy to top of = source @@ -3147,7 +3078,6 @@ int virDomainBlockRebase(virDomainPtr dom, const char= *disk, * Flags available for virDomainBlockCopy(). * * Since: v1.2.8 - * */ typedef enum { /* Limit copy to top of source backing chain */ @@ -3221,7 +3151,6 @@ int virDomainBlockCopy(virDomainPtr dom, const char *= disk, * Flags available for virDomainBlockCommit(). * * Since: v0.10.2 - * */ typedef enum { VIR_DOMAIN_BLOCK_COMMIT_SHALLOW =3D 1 << 0, /* NULL base means next ba= cking @@ -3460,7 +3389,6 @@ virDomainGetBlockIoTune(virDomainPtr dom, * Disk I/O error. * * Since: v0.9.10 - * */ typedef enum { VIR_DOMAIN_DISK_ERROR_NONE =3D 0, /* no error */ @@ -3476,7 +3404,6 @@ typedef enum { * virDomainDiskError: * * Since: v0.9.10 - * */ typedef struct _virDomainDiskError virDomainDiskError; =20 @@ -3484,7 +3411,6 @@ typedef struct _virDomainDiskError virDomainDiskError; * virDomainDiskErrorPtr: * * Since: v0.9.10 - * */ typedef virDomainDiskError *virDomainDiskErrorPtr; =20 @@ -3506,7 +3432,6 @@ int virDomainGetDiskErrors(virDomainPtr dom, * Enum to specify which keycode mapping is in use for virDomainSendKey(). * * Since: v0.9.3 - * */ typedef enum { VIR_KEYCODE_SET_LINUX =3D 0, @@ -3568,7 +3493,6 @@ int virDomainSendKey(virDomainPtr domain, * mapping in Linux. * * Since: v1.0.1 - * */ typedef enum { VIR_DOMAIN_PROCESS_SIGNAL_NOP =3D 0, /* No constant in POSIX/L= inux */ @@ -3671,7 +3595,6 @@ virDomainPtr virDomainCreateLinux (virC= onnectPtr conn, * a virDomainEventType is emitted during domain lifecycle events * * Since: v0.5.0 - * */ typedef enum { VIR_DOMAIN_EVENT_DEFINED =3D 0, @@ -3695,7 +3618,6 @@ typedef enum { * Details on the cause of a 'defined' lifecycle event * * Since: v0.5.0 - * */ typedef enum { VIR_DOMAIN_EVENT_DEFINED_ADDED =3D 0, /* Newly created config file= */ @@ -3714,7 +3636,6 @@ typedef enum { * Details on the cause of an 'undefined' lifecycle event * * Since: v0.5.0 - * */ typedef enum { VIR_DOMAIN_EVENT_UNDEFINED_REMOVED =3D 0, /* Deleted the config file */ @@ -3731,7 +3652,6 @@ typedef enum { * Details on the cause of a 'started' lifecycle event * * Since: v0.5.0 - * */ typedef enum { VIR_DOMAIN_EVENT_STARTED_BOOTED =3D 0, /* Normal startup from boot */ @@ -3751,7 +3671,6 @@ typedef enum { * Details on the cause of a 'suspended' lifecycle event * * Since: v0.5.0 - * */ typedef enum { VIR_DOMAIN_EVENT_SUSPENDED_PAUSED =3D 0, /* Normal suspend due to ad= min pause */ @@ -3775,7 +3694,6 @@ typedef enum { * Details on the cause of a 'resumed' lifecycle event * * Since: v0.5.0 - * */ typedef enum { VIR_DOMAIN_EVENT_RESUMED_UNPAUSED =3D 0, /* Normal resume due to adm= in unpause */ @@ -3795,7 +3713,6 @@ typedef enum { * Details on the cause of a 'stopped' lifecycle event * * Since: v0.5.0 - * */ typedef enum { VIR_DOMAIN_EVENT_STOPPED_SHUTDOWN =3D 0, /* Normal shutdown */ @@ -3818,7 +3735,6 @@ typedef enum { * Details on the cause of a 'shutdown' lifecycle event * * Since: v0.9.8 - * */ typedef enum { /* Guest finished shutdown sequence */ @@ -3843,7 +3759,6 @@ typedef enum { * Details on the cause of a 'pmsuspended' lifecycle event * * Since: v0.10.2 - * */ typedef enum { VIR_DOMAIN_EVENT_PMSUSPENDED_MEMORY =3D 0, /* Guest was PM suspended t= o memory */ @@ -3860,7 +3775,6 @@ typedef enum { * Details on the cause of a 'crashed' lifecycle event * * Since: v1.1.1 - * */ typedef enum { VIR_DOMAIN_EVENT_CRASHED_PANICKED =3D 0, /* Guest was panicked */ @@ -3877,7 +3791,6 @@ typedef enum { * Recipient of a memory failure event. * * Since: v6.9.0 - * */ typedef enum { /* memory failure at hypersivor memory address space */ @@ -3898,7 +3811,6 @@ typedef enum { * Action of a memory failure event. * * Since: v6.9.0 - * */ typedef enum { /* the memory failure could be ignored. This will only be the case for @@ -3928,7 +3840,6 @@ typedef enum { * virDomainMemoryFailureFlags: * * Since: v6.9.0 - * */ typedef enum { /* whether a memory failure event is action-required or action-optional @@ -3976,7 +3887,6 @@ int virDomainIsUpdated(virDomainPtr dom); * virDomainJobType: * * Since: v0.7.7 - * */ typedef enum { VIR_DOMAIN_JOB_NONE =3D 0, /* No job is active */ @@ -3995,7 +3905,6 @@ typedef enum { * virDomainJobInfo: * * Since: v0.7.7 - * */ typedef struct _virDomainJobInfo virDomainJobInfo; =20 @@ -4003,7 +3912,6 @@ typedef struct _virDomainJobInfo virDomainJobInfo; * virDomainJobInfoPtr: * * Since: v0.7.7 - * */ typedef virDomainJobInfo *virDomainJobInfoPtr; struct _virDomainJobInfo { @@ -4047,7 +3955,6 @@ struct _virDomainJobInfo { * job statistics. * * Since: v1.2.9 - * */ typedef enum { VIR_DOMAIN_JOB_STATS_COMPLETED =3D 1 << 0, /* return stats of a recent= ly @@ -4069,7 +3976,6 @@ int virDomainAbortJob(virDomainPtr dom); * virDomainJobOperation: * * Since: v3.3.0 - * */ typedef enum { VIR_DOMAIN_JOB_OPERATION_UNKNOWN =3D 0, @@ -4529,7 +4435,6 @@ typedef void (*virConnectDomainEventRTCChangeCallback= )(virConnectPtr conn, * The action that is to be taken due to the watchdog device firing * * Since: v0.8.0 - * */ typedef enum { VIR_DOMAIN_EVENT_WATCHDOG_NONE =3D 0, /* No action, watchdog ignored */ @@ -4567,7 +4472,6 @@ typedef void (*virConnectDomainEventWatchdogCallback)= (virConnectPtr conn, * The action that is to be taken due to an IO error occurring * * Since: v0.8.0 - * */ typedef enum { VIR_DOMAIN_EVENT_IO_ERROR_NONE =3D 0, /* No action, IO error ignored = */ @@ -4633,7 +4537,6 @@ typedef void (*virConnectDomainEventIOErrorReasonCall= back)(virConnectPtr conn, * The phase of the graphics client connection * * Since: v0.8.0 - * */ typedef enum { VIR_DOMAIN_EVENT_GRAPHICS_CONNECT =3D 0, /* Initial socket connection= established */ @@ -4651,7 +4554,6 @@ typedef enum { * The type of address for the connection * * Since: v0.8.0 - * */ typedef enum { VIR_DOMAIN_EVENT_GRAPHICS_ADDRESS_IPV4, /* IPv4 address */ @@ -4670,7 +4572,6 @@ typedef enum { * The data structure containing connection address details * * Since: v1.0.0 - * */ struct _virDomainEventGraphicsAddress { int family; /* Address family, virDomainEventGraphicsAdd= ressType */ @@ -4682,7 +4583,6 @@ struct _virDomainEventGraphicsAddress { * virDomainEventGraphicsAddress: * * Since: v0.8.0 - * */ typedef struct _virDomainEventGraphicsAddress virDomainEventGraphicsAddres= s; =20 @@ -4690,7 +4590,6 @@ typedef struct _virDomainEventGraphicsAddress virDoma= inEventGraphicsAddress; * virDomainEventGraphicsAddressPtr: * * Since: v0.8.0 - * */ typedef virDomainEventGraphicsAddress *virDomainEventGraphicsAddressPtr; =20 @@ -4712,7 +4611,6 @@ struct _virDomainEventGraphicsSubjectIdentity { * virDomainEventGraphicsSubjectIdentity: * * Since: v0.8.0 - * */ typedef struct _virDomainEventGraphicsSubjectIdentity virDomainEventGraphi= csSubjectIdentity; =20 @@ -4720,7 +4618,6 @@ typedef struct _virDomainEventGraphicsSubjectIdentity= virDomainEventGraphicsSubj * virDomainEventGraphicsSubjectIdentityPtr: * * Since: v0.8.0 - * */ typedef virDomainEventGraphicsSubjectIdentity *virDomainEventGraphicsSubje= ctIdentityPtr; =20 @@ -4734,7 +4631,6 @@ typedef virDomainEventGraphicsSubjectIdentity *virDom= ainEventGraphicsSubjectIden * identity differ according to the authentication scheme * * Since: v0.8.0 - * */ struct _virDomainEventGraphicsSubject { int nidentity; /* Number of identities = in array*/ @@ -4745,7 +4641,6 @@ struct _virDomainEventGraphicsSubject { * virDomainEventGraphicsSubject: * * Since: v0.8.0 - * */ typedef struct _virDomainEventGraphicsSubject virDomainEventGraphicsSubjec= t; =20 @@ -4753,7 +4648,6 @@ typedef struct _virDomainEventGraphicsSubject virDoma= inEventGraphicsSubject; * virDomainEventGraphicsSubjectPtr: * * Since: v0.8.0 - * */ typedef virDomainEventGraphicsSubject *virDomainEventGraphicsSubjectPtr; =20 @@ -4788,7 +4682,6 @@ typedef void (*virConnectDomainEventGraphicsCallback)= (virConnectPtr conn, * virDomainBlockCopy(), or virDomainBlockCommit() operation * * Since: v0.9.4 - * */ typedef enum { VIR_DOMAIN_BLOCK_JOB_COMPLETED =3D 0, @@ -4838,7 +4731,6 @@ typedef void (*virConnectDomainEventBlockJobCallback)= (virConnectPtr conn, * The reason describing why this callback is called * * Since: v0.9.7 - * */ typedef enum { /* Removable media changed to empty according to startup policy as sou= rce @@ -4887,7 +4779,6 @@ typedef void (*virConnectDomainEventDiskChangeCallbac= k)(virConnectPtr conn, * The reason describing why the callback was called * * Since: v0.9.11 - * */ typedef enum { VIR_DOMAIN_EVENT_TRAY_CHANGE_OPEN =3D 0, @@ -5476,7 +5367,6 @@ typedef void (*virConnectDomainEventTunableCallback)(= virConnectPtr conn, * virConnectDomainEventAgentLifecycleState: * * Since: v1.2.11 - * */ typedef enum { VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_STATE_CONNECTED =3D 1, /* age= nt connected */ @@ -5491,7 +5381,6 @@ typedef enum { * virConnectDomainEventAgentLifecycleReason: * * Since: v1.2.11 - * */ typedef enum { VIR_CONNECT_DOMAIN_EVENT_AGENT_LIFECYCLE_REASON_UNKNOWN =3D 0, /* unkn= own state change reason */ @@ -5621,7 +5510,6 @@ typedef void (*virConnectDomainEventMemoryDeviceSizeC= hangeCallback)(virConnectPt * signature of callback function will be used. * * Since: v0.8.0 - * */ typedef enum { VIR_DOMAIN_EVENT_ID_LIFECYCLE =3D 0, /* virConnectDomainEventCal= lback */ @@ -5679,7 +5567,6 @@ int virConnectDomainEventDeregisterAny(virConnectPtr = conn, * virDomainConsoleFlags: * * Since: v0.9.11 - * */ typedef enum { =20 @@ -5715,7 +5602,6 @@ int virDomainOpenChannel(virDomainPtr dom, * virDomainOpenGraphicsFlags: * * Since: v0.9.7 - * */ typedef enum { VIR_DOMAIN_OPEN_GRAPHICS_SKIPAUTH =3D (1 << 0), @@ -5753,8 +5639,6 @@ int virDomainFSThaw(virDomainPtr dom, * The data structure containing mounted file systems within a guset * * Since: v1.2.11 - * - * */ typedef struct _virDomainFSInfo virDomainFSInfo; =20 @@ -5762,7 +5646,6 @@ typedef struct _virDomainFSInfo virDomainFSInfo; * virDomainFSInfoPtr: * * Since: v1.2.11 - * */ typedef virDomainFSInfo *virDomainFSInfoPtr; =20 @@ -5788,7 +5671,6 @@ int virDomainGetTime(virDomainPtr dom, * virDomainSetTimeFlags: * * Since: v1.2.5 - * */ typedef enum { VIR_DOMAIN_TIME_SYNC =3D (1 << 0), /* Re-sync domain time from domain'= s RTC */ @@ -5806,7 +5688,6 @@ int virDomainSetTime(virDomainPtr dom, * compatibility; virTypedParameterType is the preferred enum * * Since: v0.2.3 - * */ typedef enum { VIR_DOMAIN_SCHED_FIELD_INT =3D VIR_TYPED_PARAM_INT, @@ -5854,7 +5735,6 @@ typedef struct _virTypedParameter virSchedParameter; * preferred alias since 0.9.2. * * Since: v0.2.3 - * */ typedef virSchedParameter *virSchedParameterPtr; =20 @@ -5865,7 +5745,6 @@ typedef virSchedParameter *virSchedParameterPtr; * compatibility; virTypedParameterType is the preferred enum * * Since: v0.9.0 - * */ typedef enum { VIR_DOMAIN_BLKIO_PARAM_INT =3D VIR_TYPED_PARAM_INT, @@ -5913,7 +5792,6 @@ typedef struct _virTypedParameter virBlkioParameter; * preferred alias. * * Since: v0.9.0 - * */ typedef virBlkioParameter *virBlkioParameterPtr; =20 @@ -5924,7 +5802,6 @@ typedef virBlkioParameter *virBlkioParameterPtr; * compatibility; virTypedParameterType is the preferred enum * * Since: v0.8.5 - * */ typedef enum { VIR_DOMAIN_MEMORY_PARAM_INT =3D VIR_TYPED_PARAM_INT, @@ -5972,7 +5849,6 @@ typedef struct _virTypedParameter virMemoryParameter; * preferred alias. * * Since: v0.8.5 - * */ typedef virMemoryParameter *virMemoryParameterPtr; =20 @@ -5980,7 +5856,6 @@ typedef virMemoryParameter *virMemoryParameterPtr; * virDomainInterfaceAddressesSource: * * Since: v1.2.14 - * */ typedef enum { VIR_DOMAIN_INTERFACE_ADDRESSES_SRC_LEASE =3D 0, /* Parse DHCP lease fi= le */ @@ -5996,7 +5871,6 @@ typedef enum { * virDomainIPAddress: * * Since: v1.2.14 - * */ typedef struct _virDomainInterfaceIPAddress virDomainIPAddress; =20 @@ -6004,7 +5878,6 @@ typedef struct _virDomainInterfaceIPAddress virDomain= IPAddress; * virDomainIPAddressPtr: * * Since: v1.2.14 - * */ typedef virDomainIPAddress *virDomainIPAddressPtr; struct _virDomainInterfaceIPAddress { @@ -6017,7 +5890,6 @@ struct _virDomainInterfaceIPAddress { * virDomainInterface: * * Since: v1.2.14 - * */ typedef struct _virDomainInterface virDomainInterface; =20 @@ -6025,7 +5897,6 @@ typedef struct _virDomainInterface virDomainInterface; * virDomainInterfacePtr: * * Since: v1.2.14 - * */ typedef virDomainInterface *virDomainInterfacePtr; struct _virDomainInterface { @@ -6046,7 +5917,6 @@ void virDomainInterfaceFree(virDomainInterfacePtr ifa= ce); * virDomainSetUserPasswordFlags: * * Since: v1.2.16 - * */ typedef enum { VIR_DOMAIN_PASSWORD_ENCRYPTED =3D 1 << 0, /* the password is already e= ncrypted */ @@ -6085,7 +5955,6 @@ int virDomainSetBlockThreshold(virDomainPtr domain, * virDomainLifecycle: * * Since: v3.9.0 - * */ typedef enum { VIR_DOMAIN_LIFECYCLE_POWEROFF =3D 0, @@ -6101,7 +5970,6 @@ typedef enum { * virDomainLifecycleAction: * * Since: v3.9.0 - * */ typedef enum { VIR_DOMAIN_LIFECYCLE_ACTION_DESTROY =3D 0, @@ -6226,7 +6094,6 @@ int virDomainSetLaunchSecurityState(virDomainPtr doma= in, * virDomainGuestInfoTypes: * * Since: v5.7.0 - * */ typedef enum { VIR_DOMAIN_GUEST_INFO_USERS =3D (1 << 0), /* return active users */ @@ -6248,7 +6115,6 @@ int virDomainGetGuestInfo(virDomainPtr domain, * virDomainAgentResponseTimeoutValues: * * Since: v5.10.0 - * */ typedef enum { VIR_DOMAIN_AGENT_RESPONSE_TIMEOUT_BLOCK =3D -2, @@ -6264,7 +6130,6 @@ int virDomainAgentSetResponseTimeout(virDomainPtr dom= ain, * virDomainBackupBeginFlags: * * Since: v6.0.0 - * */ typedef enum { VIR_DOMAIN_BACKUP_BEGIN_REUSE_EXTERNAL =3D (1 << 0), /* reuse separate= ly @@ -6288,7 +6153,6 @@ int virDomainAuthorizedSSHKeysGet(virDomainPtr domain, * virDomainAuthorizedSSHKeysSetFlags: * * Since: v6.10.0 - * */ typedef enum { VIR_DOMAIN_AUTHORIZED_SSH_KEYS_SET_APPEND =3D (1 << 0), /* don't trunc= ate file, just append */ @@ -6306,7 +6170,6 @@ int virDomainAuthorizedSSHKeysSet(virDomainPtr domain, * virDomainMessageType: * * Since: v7.1.0 - * */ typedef enum { VIR_DOMAIN_MESSAGE_DEPRECATION =3D (1 << 0), @@ -6323,7 +6186,6 @@ int virDomainGetMessages(virDomainPtr domain, * Details on the cause of a dirty rate calculation status. * * Since: v7.2.0 - * */ typedef enum { VIR_DOMAIN_DIRTYRATE_UNSTARTED =3D 0, /* the dirtyrate calculation has @@ -6346,7 +6208,6 @@ typedef enum { * * * Since: v8.1.0 - * */ typedef enum { VIR_DOMAIN_DIRTYRATE_MODE_PAGE_SAMPLING =3D 0, /* default mode = - page-sampling */ diff --git a/include/libvirt/libvirt-event.h b/include/libvirt/libvirt-even= t.h index d8a2d7a053..76b06eca38 100644 --- a/include/libvirt/libvirt-event.h +++ b/include/libvirt/libvirt-event.h @@ -36,7 +36,6 @@ * this construct. * * Since: v0.5.0 - * */ typedef enum { VIR_EVENT_HANDLE_READABLE =3D (1 << 0), diff --git a/include/libvirt/libvirt-host.h b/include/libvirt/libvirt-host.h index f184551d7b..823988eb66 100644 --- a/include/libvirt/libvirt-host.h +++ b/include/libvirt/libvirt-host.h @@ -35,7 +35,6 @@ * the Hypervisor. * * Since: v0.0.1 - * */ typedef struct _virConnect virConnect; =20 @@ -46,7 +45,6 @@ typedef struct _virConnect virConnect; * type used to reference a connection to the Hypervisor in the API. * * Since: v0.0.1 - * */ typedef virConnect *virConnectPtr; =20 @@ -57,7 +55,6 @@ typedef virConnect *virConnectPtr; * transitioned to. * * Since: v0.9.8 - * */ typedef enum { VIR_NODE_SUSPEND_TARGET_MEM =3D 0, @@ -75,7 +72,6 @@ typedef enum { * a virStream is a private structure representing a data stream. * * Since: v0.7.2 - * */ typedef struct _virStream virStream; =20 @@ -86,7 +82,6 @@ typedef struct _virStream virStream; * type used to reference a data stream in the API. * * Since: v0.7.2 - * */ typedef virStream *virStreamPtr; =20 @@ -108,7 +103,6 @@ typedef virStream *virStreamPtr; * domain. * * Since: v0.6.1 - * */ typedef struct _virSecurityLabel virSecurityLabel; =20 @@ -123,7 +117,6 @@ struct _virSecurityLabel { * a virSecurityLabelPtr is a pointer to a virSecurityLabel. * * Since: v0.6.1 - * */ typedef virSecurityLabel *virSecurityLabelPtr; =20 @@ -153,7 +146,6 @@ typedef virSecurityLabel *virSecurityLabelPtr; * specified domain. * * Since: v0.6.1 - * */ typedef struct _virSecurityModel virSecurityModel; =20 @@ -168,7 +160,6 @@ struct _virSecurityModel { * a virSecurityModelPtr is a pointer to a virSecurityModel. * * Since: v0.6.1 - * */ typedef virSecurityModel *virSecurityModelPtr; =20 @@ -221,7 +212,6 @@ struct _virNodeInfo { * Value for specifying request for the total CPU time/utilization * * Since: v0.9.8 - * */ typedef enum { VIR_NODE_CPU_STATS_ALL_CPUS =3D -1, @@ -295,7 +285,6 @@ typedef enum { * providing information about the CPU stats of the node. * * Since: v0.9.3 - * */ typedef struct _virNodeCPUStats virNodeCPUStats; =20 @@ -319,7 +308,6 @@ struct _virNodeCPUStats { * Value for specifying request for the total memory of all cells. * * Since: v0.9.8 - * */ typedef enum { VIR_NODE_MEMORY_STATS_ALL_CELLS =3D -1, @@ -373,7 +361,6 @@ typedef enum { * providing information about the memory of the node. * * Since: v0.9.3 - * */ typedef struct _virNodeMemoryStats virNodeMemoryStats; =20 @@ -505,7 +492,6 @@ int virNodeGetCPUMap(virConnectPtr conn, * a virNodeInfoPtr is a pointer to a virNodeInfo structure. * * Since: v0.1.0 - * */ =20 typedef virNodeInfo *virNodeInfoPtr; @@ -516,7 +502,6 @@ typedef virNodeInfo *virNodeInfoPtr; * a virNodeCPUStatsPtr is a pointer to a virNodeCPUStats structure. * * Since: v0.9.3 - * */ =20 typedef virNodeCPUStats *virNodeCPUStatsPtr; @@ -527,7 +512,6 @@ typedef virNodeCPUStats *virNodeCPUStatsPtr; * a virNodeMemoryStatsPtr is a pointer to a virNodeMemoryStats structure. * * Since: v0.9.3 - * */ =20 typedef virNodeMemoryStats *virNodeMemoryStatsPtr; @@ -608,7 +592,6 @@ int virNodeGetSEVInfo (virConnectPtr conn, * Flags when opening a connection to a hypervisor * * Since: v0.4.1 - * */ typedef enum { VIR_CONNECT_RO =3D (1 << 0), /* A readonly connection */ @@ -619,7 +602,6 @@ typedef enum { * virConnectCredentialType: * * Since: v0.4.1 - * */ typedef enum { VIR_CRED_USERNAME =3D 1, /* Identity to act as */ @@ -650,7 +632,6 @@ struct _virConnectCredential { * virConnectCredential: * * Since: v0.4.1 - * */ typedef struct _virConnectCredential virConnectCredential; =20 @@ -658,7 +639,6 @@ typedef struct _virConnectCredential virConnectCredenti= al; * virConnectCredentialPtr: * * Since: v0.4.1 - * */ typedef virConnectCredential *virConnectCredentialPtr; =20 @@ -692,7 +672,6 @@ struct _virConnectAuth { * virConnectAuth: * * Since: v0.4.1 - * */ typedef struct _virConnectAuth virConnectAuth; =20 @@ -700,7 +679,6 @@ typedef struct _virConnectAuth virConnectAuth; * virConnectAuthPtr: * * Since: v0.4.1 - * */ typedef virConnectAuth *virConnectAuthPtr; =20 @@ -936,7 +914,6 @@ int virConnectIsAlive(virConnectPtr conn); * virCPUCompareResult: * * Since: v0.7.5 - * */ typedef enum { VIR_CPU_COMPARE_ERROR =3D -1, @@ -953,7 +930,6 @@ typedef enum { * virConnectCompareCPUFlags: * * Since: v1.2.6 - * */ typedef enum { VIR_CONNECT_COMPARE_CPU_FAIL_INCOMPATIBLE =3D (1 << 0), /* treat incom= patible @@ -984,7 +960,6 @@ int virConnectGetCPUModelNames(virConnectPtr conn, * Flags when getting XML description of a computed CPU * * Since: v1.1.2 - * */ typedef enum { VIR_CONNECT_BASELINE_CPU_EXPAND_FEATURES =3D (1 << 0), /* show all f= eatures */ @@ -1016,7 +991,6 @@ int virNodeGetFreePages(virConnectPtr conn, * virNodeAllocPagesFlags: * * Since: v1.2.9 - * */ typedef enum { VIR_NODE_ALLOC_PAGES_ADD =3D 0, /* Add @pageCounts to the pages pool. = This diff --git a/include/libvirt/libvirt-interface.h b/include/libvirt/libvirt-= interface.h index 9bc91e2f16..9d140b27bb 100644 --- a/include/libvirt/libvirt-interface.h +++ b/include/libvirt/libvirt-interface.h @@ -33,7 +33,6 @@ * a virInterface is a private structure representing a virtual interface. * * Since: v0.6.4 - * */ typedef struct _virInterface virInterface; =20 @@ -44,7 +43,6 @@ typedef struct _virInterface virInterface; * type used to reference a virtual interface in the API. * * Since: v0.6.4 - * */ typedef virInterface *virInterfacePtr; =20 @@ -65,7 +63,6 @@ int virConnectListDefinedInterfaces = (virConnectPtr conn, * Flags used to filter the returned interfaces. * * Since: v0.10.2 - * */ typedef enum { VIR_CONNECT_LIST_INTERFACES_INACTIVE =3D 1 << 0, @@ -88,7 +85,6 @@ const char* virInterfaceGetMACString (virInt= erfacePtr iface); * virInterfaceXMLFlags: * * Since: v0.7.3 - * */ typedef enum { VIR_INTERFACE_XML_INACTIVE =3D 1 << 0 /* dump inactive interface infor= mation */ @@ -98,7 +94,6 @@ typedef enum { * virInterfaceDefineFlags: * * Since: v7.7.0 - * */ typedef enum { VIR_INTERFACE_DEFINE_VALIDATE =3D 1 << 0, /* Validate the XML document= against schema */ diff --git a/include/libvirt/libvirt-network.h b/include/libvirt/libvirt-ne= twork.h index ff4ecc061b..0eb60700e2 100644 --- a/include/libvirt/libvirt-network.h +++ b/include/libvirt/libvirt-network.h @@ -31,7 +31,6 @@ * virNetworkXMLFlags: * * Since: v0.9.10 - * */ typedef enum { VIR_NETWORK_XML_INACTIVE =3D (1 << 0), /* dump inactive network inform= ation */ @@ -43,7 +42,6 @@ typedef enum { * a virNetwork is a private structure representing a virtual network. * * Since: v0.2.0 - * */ typedef struct _virNetwork virNetwork; =20 @@ -54,7 +52,6 @@ typedef struct _virNetwork virNetwork; * type used to reference a virtual network in the API. * * Since: v0.2.0 - * */ typedef virNetwork *virNetworkPtr; =20 @@ -65,7 +62,6 @@ typedef virNetwork *virNetworkPtr; * port * * Since: v5.5.0 - * */ typedef struct _virNetworkPort virNetworkPort; =20 @@ -76,7 +72,6 @@ typedef struct _virNetworkPort virNetworkPort; * this is the type used to reference a virtual network port in the API. * * Since: v5.5.0 - * */ typedef virNetworkPort *virNetworkPortPtr; =20 @@ -107,7 +102,6 @@ int virConnectListDefinedNetworks = (virConnectPtr conn, * are exclusive attributes of a network. * * Since: v0.10.2 - * */ typedef enum { VIR_CONNECT_LIST_NETWORKS_INACTIVE =3D 1 << 0, @@ -137,7 +131,6 @@ virNetworkPtr virNetworkLookupByUUIDString = (virConnectPtr conn, * virNetworkCreateFlags: * * Since: v7.8.0 - * */ typedef enum { VIR_NETWORK_CREATE_VALIDATE =3D 1 << 0, /* Validate the XML document a= gainst schema */ @@ -155,7 +148,6 @@ virNetworkPtr virNetworkCreateXMLFlags(virCon= nectPtr conn, * virNetworkDefineFlags: * * Since: v7.7.0 - * */ typedef enum { VIR_NETWORK_DEFINE_VALIDATE =3D 1 << 0, /* Validate the XML document a= gainst schema */ @@ -182,7 +174,6 @@ int virNetworkUndefine (virNet= workPtr network); * definition. * * Since: v0.10.2 - * */ typedef enum { VIR_NETWORK_UPDATE_COMMAND_NONE =3D 0, /* (invalid) */ @@ -202,7 +193,6 @@ typedef enum { * xml should be applied to. * * Since: v0.10.2 - * */ typedef enum { VIR_NETWORK_SECTION_NONE =3D 0, /* (invalid) */ @@ -229,7 +219,6 @@ typedef enum { * Flags to control options for virNetworkUpdate() * * Since: v0.10.2 - * */ typedef enum { VIR_NETWORK_UPDATE_AFFECT_CURRENT =3D 0, /* affect live if networ= k is active, @@ -286,7 +275,6 @@ int virNetworkIsPersistent(virNetworkPtr net); * a virNetworkEventLifecycleType is emitted during network lifecycle even= ts * * Since: v1.2.1 - * */ typedef enum { VIR_NETWORK_EVENT_DEFINED =3D 0, @@ -337,7 +325,6 @@ typedef void (*virConnectNetworkEventLifecycleCallback)= (virConnectPtr conn, * signature of callback function will be used. * * Since: v1.2.1 - * */ typedef enum { VIR_NETWORK_EVENT_ID_LIFECYCLE =3D 0, /* virConnectNetworkEventL= ifecycleCallback */ @@ -356,7 +343,6 @@ typedef enum { * virIPAddrType: * * Since: v1.2.6 - * */ typedef enum { VIR_IP_ADDR_TYPE_IPV4, @@ -371,7 +357,6 @@ typedef enum { * virNetworkDHCPLease: * * Since: v1.2.6 - * */ typedef struct _virNetworkDHCPLease virNetworkDHCPLease; =20 @@ -379,7 +364,6 @@ typedef struct _virNetworkDHCPLease virNetworkDHCPLease; * virNetworkDHCPLeasePtr: * * Since: v1.2.6 - * */ typedef virNetworkDHCPLease *virNetworkDHCPLeasePtr; struct _virNetworkDHCPLease { @@ -441,7 +425,6 @@ virNetworkPortLookupByUUIDString(virNetworkPtr net, * virNetworkPortCreateFlags: * * Since: v5.5.0 - * */ typedef enum { VIR_NETWORK_PORT_CREATE_RECLAIM =3D (1 << 0), /* reclaim existing used= resources */ diff --git a/include/libvirt/libvirt-nodedev.h b/include/libvirt/libvirt-no= dedev.h index 7521052cf6..0125ae80a9 100644 --- a/include/libvirt/libvirt-nodedev.h +++ b/include/libvirt/libvirt-nodedev.h @@ -34,7 +34,6 @@ * A virNodeDevice contains a node (host) device details. * * Since: v0.5.0 - * */ =20 typedef struct _virNodeDevice virNodeDevice; @@ -48,7 +47,6 @@ typedef struct _virNodeDevice virNodeDevice; * from any of the above functions to avoid leaking memory. * * Since: v0.5.0 - * */ =20 typedef virNodeDevice *virNodeDevicePtr; @@ -70,7 +68,6 @@ int virNodeListDevices (virConne= ctPtr conn, * returned node devices. * * Since: v0.10.2 - * */ typedef enum { VIR_CONNECT_LIST_NODE_DEVICES_CAP_SYSTEM =3D 1 << 0, /* System= capability */ @@ -179,7 +176,6 @@ int virNodeDeviceIsActive(virNodeDevicePtr dev); * signature of callback function will be used. * * Since: v2.2.0 - * */ typedef enum { VIR_NODE_DEVICE_EVENT_ID_LIFECYCLE =3D 0, /* virConnectNodeDeviceEvent= LifecycleCallback */ @@ -229,7 +225,6 @@ int virConnectNodeDeviceEventDeregisterAny(virConnectPt= r conn, * lifecycle events * * Since: v2.2.0 - * */ typedef enum { VIR_NODE_DEVICE_EVENT_CREATED =3D 0, diff --git a/include/libvirt/libvirt-nwfilter.h b/include/libvirt/libvirt-n= wfilter.h index bbce91c2dd..e08616f5e2 100644 --- a/include/libvirt/libvirt-nwfilter.h +++ b/include/libvirt/libvirt-nwfilter.h @@ -33,7 +33,6 @@ * a virNWFilter is a private structure representing a network filter * * Since: v0.8.0 - * */ typedef struct _virNWFilter virNWFilter; =20 @@ -44,7 +43,6 @@ typedef struct _virNWFilter virNWFilter; * this is the type used to reference a network filter in the API. * * Since: v0.8.0 - * */ typedef virNWFilter *virNWFilterPtr; =20 @@ -55,7 +53,6 @@ typedef virNWFilter *virNWFilterPtr; * filter binding to a port * * Since: v4.5.0 - * */ typedef struct _virNWFilterBinding virNWFilterBinding; =20 @@ -67,7 +64,6 @@ typedef struct _virNWFilterBinding virNWFilterBinding; * port binding in the API. * * Since: v4.5.0 - * */ typedef virNWFilterBinding *virNWFilterBindingPtr; =20 @@ -95,7 +91,6 @@ virNWFilterPtr virNWFilterLookupByUUIDString (vi= rConnectPtr conn, * virNWFilterDefineFlags: * * Since: v7.7.0 - * */ typedef enum { VIR_NWFILTER_DEFINE_VALIDATE =3D 1 << 0, /* Validate the XML document = against schema */ @@ -129,7 +124,6 @@ int virNWFilterFree (virNWF= ilterPtr nwfilter); * virNWFilterBindingCreateFlags: * * Since: v7.8.0 - * */ typedef enum { VIR_NWFILTER_BINDING_CREATE_VALIDATE =3D 1 << 0, /* Validate the XML d= ocument against schema */ diff --git a/include/libvirt/libvirt-secret.h b/include/libvirt/libvirt-sec= ret.h index f8c7dcf376..5af6f13b6d 100644 --- a/include/libvirt/libvirt-secret.h +++ b/include/libvirt/libvirt-secret.h @@ -35,7 +35,6 @@ * and associated metadata. * * Since: v0.7.1 - * */ typedef struct _virSecret virSecret; =20 @@ -43,7 +42,6 @@ typedef struct _virSecret virSecret; * virSecretPtr: * * Since: v0.7.1 - * */ typedef virSecret *virSecretPtr; =20 @@ -51,7 +49,6 @@ typedef virSecret *virSecretPtr; * virSecretUsageType: * * Since: v0.7.1 - * */ typedef enum { VIR_SECRET_USAGE_TYPE_NONE =3D 0, @@ -84,7 +81,6 @@ int virConnectListSecrets (virConne= ctPtr conn, * are exclusive attributes of a secret. * * Since: v0.10.2 - * */ typedef enum { VIR_CONNECT_LIST_SECRETS_EPHEMERAL =3D 1 << 0, /* kept in memory, n= ever @@ -111,7 +107,6 @@ virSecretPtr virSecretLookupByUsage(virConne= ctPtr conn, * virSecretDefineFlags: * * Since: v7.7.0 - * */ typedef enum { VIR_SECRET_DEFINE_VALIDATE =3D 1 << 0, /* Validate the XML document ag= ainst schema */ @@ -157,7 +152,6 @@ int virSecretFree (virSec= retPtr secret); * signature of callback function will be used. * * Since: v3.0.0 - * */ typedef enum { VIR_SECRET_EVENT_ID_LIFECYCLE =3D 0, /* virConnectSecretEventLifecycle= Callback */ @@ -207,7 +201,6 @@ int virConnectSecretEventDeregisterAny(virConnectPtr co= nn, * lifecycle events * * Since: v3.0.0 - * */ typedef enum { VIR_SECRET_EVENT_DEFINED =3D 0, diff --git a/include/libvirt/libvirt-storage.h b/include/libvirt/libvirt-st= orage.h index dee8b7a2c0..b23961cad5 100644 --- a/include/libvirt/libvirt-storage.h +++ b/include/libvirt/libvirt-storage.h @@ -34,7 +34,6 @@ * a virStoragePool is a private structure representing a storage pool * * Since: v0.4.1 - * */ typedef struct _virStoragePool virStoragePool; =20 @@ -45,7 +44,6 @@ typedef struct _virStoragePool virStoragePool; * type used to reference a storage pool in the API. * * Since: v0.4.1 - * */ typedef virStoragePool *virStoragePoolPtr; =20 @@ -54,7 +52,6 @@ typedef virStoragePool *virStoragePoolPtr; * virStoragePoolState: * * Since: v0.4.1 - * */ typedef enum { VIR_STORAGE_POOL_INACTIVE =3D 0, /* Not running */ @@ -72,7 +69,6 @@ typedef enum { * virStoragePoolBuildFlags: * * Since: v0.4.1 - * */ typedef enum { VIR_STORAGE_POOL_BUILD_NEW =3D 0, /* Regular build from scratch */ @@ -86,7 +82,6 @@ typedef enum { * virStoragePoolDeleteFlags: * * Since: v0.4.1 - * */ typedef enum { VIR_STORAGE_POOL_DELETE_NORMAL =3D 0, /* Delete metadata only (fast= ) */ @@ -97,7 +92,6 @@ typedef enum { * virStoragePoolCreateFlags: * * Since: v1.3.1 - * */ typedef enum { /* Create the pool but do not perform pool build */ @@ -121,7 +115,6 @@ typedef enum { * virStoragePoolInfo: * * Since: v0.4.1 - * */ typedef struct _virStoragePoolInfo virStoragePoolInfo; =20 @@ -136,7 +129,6 @@ struct _virStoragePoolInfo { * virStoragePoolInfoPtr: * * Since: v0.4.1 - * */ typedef virStoragePoolInfo *virStoragePoolInfoPtr; =20 @@ -147,7 +139,6 @@ typedef virStoragePoolInfo *virStoragePoolInfoPtr; * a virStorageVol is a private structure representing a storage volume * * Since: v0.4.1 - * */ typedef struct _virStorageVol virStorageVol; =20 @@ -158,7 +149,6 @@ typedef struct _virStorageVol virStorageVol; * type used to reference a storage volume in the API. * * Since: v0.4.1 - * */ typedef virStorageVol *virStorageVolPtr; =20 @@ -167,7 +157,6 @@ typedef virStorageVol *virStorageVolPtr; * virStorageVolType: * * Since: v0.4.1 - * */ typedef enum { VIR_STORAGE_VOL_FILE =3D 0, /* Regular file based volumes */ @@ -187,7 +176,6 @@ typedef enum { * virStorageVolDeleteFlags: * * Since: v0.4.1 - * */ typedef enum { VIR_STORAGE_VOL_DELETE_NORMAL =3D 0, /* Delete metadata only (fast)= */ @@ -199,7 +187,6 @@ typedef enum { * virStorageVolWipeAlgorithm: * * Since: v0.9.10 - * */ typedef enum { VIR_STORAGE_VOL_WIPE_ALG_ZERO =3D 0, /* 1-pass, all zeroes */ @@ -237,7 +224,6 @@ typedef enum { * virStorageVolInfoFlags: * * Since: v3.0.0 - * */ typedef enum { VIR_STORAGE_VOL_USE_ALLOCATION =3D 0, /* (Since: v3.0.0) */ @@ -248,7 +234,6 @@ typedef enum { * virStorageVolInfo: * * Since: v0.4.1 - * */ typedef struct _virStorageVolInfo virStorageVolInfo; =20 @@ -263,7 +248,6 @@ struct _virStorageVolInfo { * virStorageVolInfoPtr: * * Since: v0.4.1 - * */ typedef virStorageVolInfo *virStorageVolInfoPtr; =20 @@ -271,7 +255,6 @@ typedef virStorageVolInfo *virStorageVolInfoPtr; * virStorageXMLFlags: * * Since: v0.9.13 - * */ typedef enum { VIR_STORAGE_XML_INACTIVE =3D (1 << 0), /* dump inactive pool/volume= information */ @@ -310,7 +293,6 @@ int virConnectListDefinedStoragePoo= ls(virConnectPtr conn, * then that group is not used to filter results. * * Since: v1.0.0 - * */ typedef enum { VIR_CONNECT_LIST_STORAGE_POOLS_INACTIVE =3D 1 << 0, @@ -366,7 +348,6 @@ virStoragePoolPtr virStoragePoolLookupByTargetPat= h(virConnectPtr conn, * virStoragePoolDefineFlags: * * Since: v7.7.0 - * */ typedef enum { VIR_STORAGE_POOL_DEFINE_VALIDATE =3D 1 << 0, /* Validate the XML docum= ent against schema */ @@ -445,7 +426,6 @@ const char* virStorageVolGetKey = (virStorageVolPtr vol); * virStorageVolCreateFlags: * * Since: v1.0.1 - * */ typedef enum { VIR_STORAGE_VOL_CREATE_PREALLOC_METADATA =3D 1 << 0, @@ -463,7 +443,6 @@ virStorageVolPtr virStorageVolCreateXMLFrom = (virStoragePoolPtr pool, * virStorageVolDownloadFlags: * * Since: v3.4.0 - * */ typedef enum { VIR_STORAGE_VOL_DOWNLOAD_SPARSE_STREAM =3D 1 << 0, /* Use sparse strea= m */ @@ -479,7 +458,6 @@ int virStorageVolDownload = (virStorageVolPtr vol, * virStorageVolUploadFlags: * * Since: v3.4.0 - * */ typedef enum { VIR_STORAGE_VOL_UPLOAD_SPARSE_STREAM =3D 1 << 0, /* Use sparse stream= */ @@ -514,7 +492,6 @@ char * virStorageVolGetPath = (virStorageVolPtr vol); * virStorageVolResizeFlags: * * Since: v0.9.10 - * */ typedef enum { VIR_STORAGE_VOL_RESIZE_ALLOCATE =3D 1 << 0, /* force allocation of new= size */ @@ -547,7 +524,6 @@ int virStoragePoolIsPersistent(virStoragePoolPtr pool); * signature of callback function will be used. * * Since: v2.0.0 - * */ typedef enum { VIR_STORAGE_POOL_EVENT_ID_LIFECYCLE =3D 0, /* virConnectStoragePoolEve= ntLifecycleCallback */ @@ -597,7 +573,6 @@ int virConnectStoragePoolEventDeregisterAny(virConnectP= tr conn, * lifecycle events * * Since: v2.0.0 - * */ typedef enum { VIR_STORAGE_POOL_EVENT_DEFINED =3D 0, diff --git a/include/libvirt/libvirt-stream.h b/include/libvirt/libvirt-str= eam.h index ed53d47e3c..7c320e278e 100644 --- a/include/libvirt/libvirt-stream.h +++ b/include/libvirt/libvirt-stream.h @@ -32,7 +32,6 @@ * virStreamFlags: * * Since: v0.7.2 - * */ typedef enum { VIR_STREAM_NONBLOCK =3D (1 << 0), @@ -54,7 +53,6 @@ int virStreamRecv(virStreamPtr st, * virStreamRecvFlagsValues: * * Since: v3.4.0 - * */ typedef enum { VIR_STREAM_RECV_STOP_AT_HOLE =3D (1 << 0), @@ -245,7 +243,6 @@ int virStreamSparseRecvAll(virStreamPtr stream, * virStreamEventType: * * Since: v0.7.2 - * */ typedef enum { VIR_STREAM_EVENT_READABLE =3D (1 << 0), diff --git a/include/libvirt/virterror.h b/include/libvirt/virterror.h index bb76ef1b90..aa2f5039fa 100644 --- a/include/libvirt/virterror.h +++ b/include/libvirt/virterror.h @@ -36,7 +36,6 @@ extern "C" { * Indicates the level of an error * * Since: v0.1.0 - * */ typedef enum { VIR_ERR_NONE =3D 0, @@ -51,7 +50,6 @@ typedef enum { * stable, with all additions placed at the end since libvirt 0.1.0. * * Since: v0.1.0 - * */ typedef enum { VIR_FROM_NONE =3D 0, @@ -160,7 +158,6 @@ typedef enum { * may be deleted without notice after the error has been delivered. * * Since: v0.1.0 - * */ =20 typedef struct _virError virError; @@ -169,7 +166,6 @@ typedef struct _virError virError; * virErrorPtr: * * Since: v0.1.0 - * */ typedef virError *virErrorPtr; struct _virError { @@ -223,7 +219,6 @@ struct _virError { * } * * Since: v0.1.0 - * */ typedef enum { VIR_ERR_OK =3D 0, --=20 2.35.1 From nobody Sat May 18 14:25:24 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.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.129.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=1650631630; cv=none; d=zohomail.com; s=zohoarc; b=FOWQGmNkFhDdvREdEZ40gXySxrz2jrkhAC9Q9LFBvJMLjVSe2PfofnDbyZep5/Bm77LwNHvqV5mGT3BiM5r2PoMPpSm8StQbGidRA21NuqO9nVkvxf2NMCo4rgb6GJZijFS2142xiR1peK/dey0upP56My+CPzeICg8EefG/6/g= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1650631630; 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=Mt8HxOkNvI7vakuXvPTP82SBNuy6OM6AX3HoZQKem9Q=; b=FER2zXcsCYLUMRIjr9bqnXhU7k5N1tmfj13Qogx6WcFJtQiaabFc3zs74jiGluW1a8oLveWK1lkrvbgJSpguWRj9THeY/r0pSZbrUVixmHv1Z/W2x2KjAyU+KYyhemQmQ4F3deiF6qwfexpO3kPZUxqtg9Ui7kDmOx8XqYNttDo= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.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.129.124]) by mx.zohomail.com with SMTPS id 165063163025069.29294182895808; Fri, 22 Apr 2022 05:47:10 -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-271-z9BOWjM6PlOf6H_vylH4YA-1; Fri, 22 Apr 2022 08:47:05 -0400 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.rdu2.redhat.com [10.11.54.8]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id B8141280856C; Fri, 22 Apr 2022 12:47:03 +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 A2DC5C35991; Fri, 22 Apr 2022 12:47:03 +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 6E02F1940352; Fri, 22 Apr 2022 12:47:03 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 881131940369 for ; Fri, 22 Apr 2022 12:47:01 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 5AD3140CF918; Fri, 22 Apr 2022 12:47:01 +0000 (UTC) Received: from harajuku.usersys.redhat.com.homenet.telecomitalia.it (unknown [10.40.195.101]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 6432F40D0174 for ; Fri, 22 Apr 2022 12:47:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1650631629; 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=Mt8HxOkNvI7vakuXvPTP82SBNuy6OM6AX3HoZQKem9Q=; b=LHQPwsDDDPbT7nI0t/ssAZbRzOLllkNRI+zVPyG5hmFl2LUsVinCYSO4HevdI3FfVXjDIT iSwr1DCcmh8uSqlNRnjVbgPN3qkS75+I04wyCT/hfYkkXOxaBHMkQ3CgEcqPFfT82vvmAL DsHs7k3LmHzDlkjjQFtWezTekLfiqMc= X-MC-Unique: z9BOWjM6PlOf6H_vylH4YA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH 2/2] include: Fix vertical spacing between comments and symbols Date: Fri, 22 Apr 2022 14:46:50 +0200 Message-Id: <20220422124650.118668-3-abologna@redhat.com> In-Reply-To: <20220422124650.118668-1-abologna@redhat.com> References: <20220422124650.118668-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.11.54.1 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.8 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: 1650631632359100001 Content-Type: text/plain; charset="utf-8" There should be no empty lines between a docstring comment and the symbol it documents. Signed-off-by: Andrea Bolognani Reviewed-by: Peter Krempa --- include/libvirt/libvirt-common.h.in | 1 - include/libvirt/libvirt-domain.h | 15 --------------- include/libvirt/libvirt-host.h | 7 ------- include/libvirt/libvirt-nodedev.h | 2 -- include/libvirt/virterror.h | 1 - 5 files changed, 26 deletions(-) diff --git a/include/libvirt/libvirt-common.h.in b/include/libvirt/libvirt-= common.h.in index fedf9765a7..78751cea7c 100644 --- a/include/libvirt/libvirt-common.h.in +++ b/include/libvirt/libvirt-common.h.in @@ -73,7 +73,6 @@ extern "C" { * * Since: v0.0.1 */ - # define LIBVIR_VERSION_NUMBER @LIBVIRT_VERSION_NUMBER@ =20 /** diff --git a/include/libvirt/libvirt-domain.h b/include/libvirt/libvirt-dom= ain.h index 3121330bf0..9aa214f3df 100644 --- a/include/libvirt/libvirt-domain.h +++ b/include/libvirt/libvirt-domain.h @@ -350,7 +350,6 @@ struct _virDomainInfo { * * Since: v0.0.1 */ - typedef virDomainInfo *virDomainInfoPtr; =20 /** @@ -1618,7 +1617,6 @@ char * virDomainGetSchedulerType(vir= DomainPtr domain, * * Since: v0.9.0 */ - # define VIR_DOMAIN_BLKIO_WEIGHT "weight" =20 /** @@ -1630,7 +1628,6 @@ char * virDomainGetSchedulerType(vir= DomainPtr domain, * * Since: v0.9.8 */ - # define VIR_DOMAIN_BLKIO_DEVICE_WEIGHT "device_weight" =20 /** @@ -1643,7 +1640,6 @@ char * virDomainGetSchedulerType(vir= DomainPtr domain, * * Since: v1.2.2 */ - # define VIR_DOMAIN_BLKIO_DEVICE_READ_IOPS "device_read_iops_sec" =20 =20 @@ -1703,7 +1699,6 @@ int virDomainGetBlkioParameters(virDomainPtr doma= in, * * Since: v0.8.8 */ - # define VIR_DOMAIN_MEMORY_PARAM_UNLIMITED 9007199254740991LL /* =3D INT64= _MAX >> 10 */ =20 /** @@ -1714,7 +1709,6 @@ int virDomainGetBlkioParameters(virDomainPtr doma= in, * * Since: v0.8.5 */ - # define VIR_DOMAIN_MEMORY_HARD_LIMIT "hard_limit" =20 /** @@ -1725,7 +1719,6 @@ int virDomainGetBlkioParameters(virDomainPtr doma= in, * * Since: v0.8.5 */ - # define VIR_DOMAIN_MEMORY_SOFT_LIMIT "soft_limit" =20 /** @@ -1736,7 +1729,6 @@ int virDomainGetBlkioParameters(virDomainPtr doma= in, * * Since: v0.8.5 */ - # define VIR_DOMAIN_MEMORY_MIN_GUARANTEE "min_guarantee" =20 /** @@ -1748,7 +1740,6 @@ int virDomainGetBlkioParameters(virDomainPtr doma= in, * * Since: v0.8.5 */ - # define VIR_DOMAIN_MEMORY_SWAP_HARD_LIMIT "swap_hard_limit" =20 /* Set memory tunables for the domain */ @@ -2421,7 +2412,6 @@ int virDomainSetIOThreadParams(virDo= mainPtr domain, * * Since: v0.1.4 */ - # define VIR_USE_CPU(cpumap, cpu) ((cpumap)[(cpu) / 8] |=3D (1 << ((cpu) %= 8))) =20 /** @@ -2434,7 +2424,6 @@ int virDomainSetIOThreadParams(virDo= mainPtr domain, * * Since: v0.1.4 */ - # define VIR_UNUSE_CPU(cpumap, cpu) ((cpumap)[(cpu) / 8] &=3D ~(1 << ((cpu= ) % 8))) =20 /** @@ -2447,7 +2436,6 @@ int virDomainSetIOThreadParams(virDo= mainPtr domain, * * Since: v1.0.0 */ - # define VIR_CPU_USED(cpumap, cpu) ((cpumap)[(cpu) / 8] & (1 << ((cpu) % 8= ))) =20 /** @@ -2460,7 +2448,6 @@ int virDomainSetIOThreadParams(virDo= mainPtr domain, * * Since: v0.1.4 */ - # define VIR_CPU_MAPLEN(cpu) (((cpu) + 7) / 8) =20 =20 @@ -2483,7 +2470,6 @@ int virDomainGetVcpus (virD= omainPtr domain, * * Since: v0.1.4 */ - # define VIR_CPU_USABLE(cpumaps, maplen, vcpu, cpu) \ VIR_CPU_USED(VIR_GET_CPUMAP(cpumaps, maplen, vcpu), cpu) =20 @@ -2648,7 +2634,6 @@ void virDomainStatsRecordListFree(virDomainStatsRecor= dPtr *stats); * "perf.mbmt" field in the *Stats APIs. * * Since: v1.3.5 - */ # define VIR_PERF_PARAM_MBMT "mbmt" =20 diff --git a/include/libvirt/libvirt-host.h b/include/libvirt/libvirt-host.h index 823988eb66..763c5fe774 100644 --- a/include/libvirt/libvirt-host.h +++ b/include/libvirt/libvirt-host.h @@ -482,8 +482,6 @@ int virNodeGetCPUMap(virConnectPtr conn, * * Since: v0.1.4 */ - - # define VIR_NODEINFO_MAXCPUS(nodeinfo) ((nodeinfo).nodes*(nodeinfo).socke= ts*(nodeinfo).cores*(nodeinfo).threads) =20 /** @@ -493,7 +491,6 @@ int virNodeGetCPUMap(virConnectPtr conn, * * Since: v0.1.0 */ - typedef virNodeInfo *virNodeInfoPtr; =20 /** @@ -503,7 +500,6 @@ typedef virNodeInfo *virNodeInfoPtr; * * Since: v0.9.3 */ - typedef virNodeCPUStats *virNodeCPUStatsPtr; =20 /** @@ -513,7 +509,6 @@ typedef virNodeCPUStats *virNodeCPUStatsPtr; * * Since: v0.9.3 */ - typedef virNodeMemoryStats *virNodeMemoryStatsPtr; =20 =20 @@ -704,7 +699,6 @@ VIR_EXPORT_VAR virConnectAuthPtr virConnectAuthPtrDefau= lt; * * Since: v0.2.0 */ - # define VIR_UUID_BUFLEN (16) =20 /** @@ -715,7 +709,6 @@ VIR_EXPORT_VAR virConnectAuthPtr virConnectAuthPtrDefau= lt; * * Since: v0.2.0 */ - # define VIR_UUID_STRING_BUFLEN (36+1) =20 =20 diff --git a/include/libvirt/libvirt-nodedev.h b/include/libvirt/libvirt-no= dedev.h index 0125ae80a9..cdf0df9e0a 100644 --- a/include/libvirt/libvirt-nodedev.h +++ b/include/libvirt/libvirt-nodedev.h @@ -35,7 +35,6 @@ * * Since: v0.5.0 */ - typedef struct _virNodeDevice virNodeDevice; =20 /** @@ -48,7 +47,6 @@ typedef struct _virNodeDevice virNodeDevice; * * Since: v0.5.0 */ - typedef virNodeDevice *virNodeDevicePtr; =20 =20 diff --git a/include/libvirt/virterror.h b/include/libvirt/virterror.h index aa2f5039fa..2ae2b93be3 100644 --- a/include/libvirt/virterror.h +++ b/include/libvirt/virterror.h @@ -159,7 +159,6 @@ typedef enum { * * Since: v0.1.0 */ - typedef struct _virError virError; =20 /** --=20 2.35.1