[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH v3 4/9] memory: Do not refer to "memory region's reference count"
From: |
Akihiko Odaki |
Subject: |
[PATCH v3 4/9] memory: Do not refer to "memory region's reference count" |
Date: |
Mon, 08 Jul 2024 15:55:15 +0900 |
Now MemoryRegions do have their own reference counts, but they will not
be used when their owners are not themselves. However, the documentation
of memory_region_ref() says it adds "1 to a memory region's reference
count", which is confusing. Avoid referring to "memory region's
reference count" and just say: "Add a reference to a memory region".
Make a similar change to memory_region_unref() too.
Signed-off-by: Akihiko Odaki <akihiko.odaki@daynix.com>
---
include/exec/memory.h | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/include/exec/memory.h b/include/exec/memory.h
index c26ede33d21e..a5af05864274 100644
--- a/include/exec/memory.h
+++ b/include/exec/memory.h
@@ -1243,7 +1243,7 @@ void memory_region_init(MemoryRegion *mr,
uint64_t size);
/**
- * memory_region_ref: Add 1 to a memory region's reference count
+ * memory_region_ref: Add a reference to a memory region
*
* Whenever memory regions are accessed outside the BQL, they need to be
* preserved against hot-unplug. MemoryRegions actually do not have their
@@ -1260,7 +1260,7 @@ void memory_region_init(MemoryRegion *mr,
void memory_region_ref(MemoryRegion *mr);
/**
- * memory_region_unref: Remove 1 to a memory region's reference count
+ * memory_region_unref: Remove a reference to a memory region
*
* Whenever memory regions are accessed outside the BQL, they need to be
* preserved against hot-unplug. MemoryRegions actually do not have their
--
2.45.2
- [PATCH v3 0/9] Fix check-qtest-ppc64 sanitizer errors, Akihiko Odaki, 2024/07/08
- [PATCH v3 1/9] spapr: Free stdout path, Akihiko Odaki, 2024/07/08
- [PATCH v3 2/9] ppc/vof: Fix unaligned FDT property access, Akihiko Odaki, 2024/07/08
- [PATCH v3 3/9] migration: Free removed SaveStateEntry, Akihiko Odaki, 2024/07/08
- [PATCH v3 4/9] memory: Do not refer to "memory region's reference count",
Akihiko Odaki <=
- [PATCH v3 5/9] memory: Refer to docs/devel/memory.rst for "owner", Akihiko Odaki, 2024/07/08
- [PATCH v3 6/9] memory: Clarify that owner may be missing, Akihiko Odaki, 2024/07/08
- [PATCH v3 8/9] memory: Do not create circular reference with subregion, Akihiko Odaki, 2024/07/08
- [PATCH v3 7/9] memory: Clarify owner must not call memory_region_ref(), Akihiko Odaki, 2024/07/08
- [PATCH v3 9/9] tests/qtest: Delete previous boot file, Akihiko Odaki, 2024/07/08