libnvme: rename libnvme_ns_get_uuid to libnvme_ns_copy_uuid

The function copies the UUID into a caller-supplied buffer rather
than returning a pointer, so "copy" is a more accurate name than
"get". Update the declaration in tree.h, definition in tree.c,
the ABI version script, the test, and the uuid member annotation
(read=none since the copy function signature is incompatible with
the %extend getter pattern used by the Python bindings).

Signed-off-by: Martin Belanger <Martin.Belanger@dell.com>
Assisted-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: Martin Belanger

libnvme/src/libnvme.ld

@@ -131,7 +131,7 @@ LIBNVME_3 {
 		libnvme_ns_get_nguid;
 		libnvme_ns_get_serial;
 		libnvme_ns_get_subsystem;
-		libnvme_ns_get_uuid;
+		libnvme_ns_copy_uuid;
 		libnvme_ns_reset_stat;
 		libnvme_ns_update_stat;
 		libnvme_ns_get_stat_interval;

libnvme/src/nvme/private.h

@@ -262,7 +262,7 @@ struct libnvme_ns {			// !generate-accessors
 
 	uint8_t eui64[8];		     // !access:write=none
 	uint8_t nguid[16];		     // !access:write=none
-	unsigned char uuid[NVME_UUID_LEN];   // !access:read=custom,write=none
+	unsigned char uuid[NVME_UUID_LEN];   // !access:read=none,write=none
 	enum nvme_csi csi;		     // !access:write=none
 
 	long command_retry_count;	     // !access:read=custom,write=none

libnvme/src/nvme/tree.c

@@ -2618,7 +2618,7 @@ __public const char *libnvme_ns_get_firmware(libnvme_ns_t n)
 	return n->c ? n->c->firmware : n->s->firmware;
 }
 
-__public void libnvme_ns_get_uuid(libnvme_ns_t n,
+__public void libnvme_ns_copy_uuid(libnvme_ns_t n,
 		unsigned char out[NVME_UUID_LEN])
 {
 	memcpy(out, n->uuid, NVME_UUID_LEN);

libnvme/src/nvme/tree.h

@@ -478,13 +478,13 @@ libnvme_ns_t libnvme_subsystem_next_ns(libnvme_subsystem_t s, libnvme_ns_t n);
 		p = libnvme_namespace_next_path(n, p))
 
 /**
- * libnvme_ns_get_uuid() - UUID of a namespace
+ * libnvme_ns_copy_uuid() - Copy UUID of a namespace into a caller buffer
  * @n:		Namespace instance
  * @out:	buffer for the UUID
  *
  * Copies the namespace's uuid into @out
  */
-void libnvme_ns_get_uuid(libnvme_ns_t n, unsigned char out[NVME_UUID_LEN]);
+void libnvme_ns_copy_uuid(libnvme_ns_t n, unsigned char out[NVME_UUID_LEN]);
 
 /**
  * libnvme_ns_get_command_retry_count() - Get command retry count

libnvme/test/test.c

@@ -452,7 +452,7 @@ int main(int argc, char **argv)
 					print_hex(libnvme_ns_get_eui64(n), 8);
 					printf(" nguid:");
 					print_hex(libnvme_ns_get_nguid(n), 16);
-					libnvme_ns_get_uuid(n, uuid);
+					libnvme_ns_copy_uuid(n, uuid);
 					libnvme_uuid_to_string(uuid, uuid_str);
 					printf(" uuid:%s csi:%d\n", uuid_str,
 					       libnvme_ns_get_csi(n));