|
 |
022f11 |
From 36cf82f0f7f4a0d2b56623d0c8130370658daf9d Mon Sep 17 00:00:00 2001
|
|
|
022f11 |
From: "Richard W.M. Jones" <rjones@redhat.com>
|
|
|
022f11 |
Date: Mon, 22 Jul 2013 13:13:18 +0100
|
|
|
022f11 |
Subject: [PATCH] docs: Document labels and UUIDs in the API overview section.
|
|
|
022f11 |
|
|
|
022f11 |
(cherry picked from commit df02c2471f3fe94c691c389c17a5d23d052848dd)
|
|
|
022f11 |
---
|
|
|
022f11 |
src/guestfs.pod | 28 ++++++++++++++++++++++++++++
|
|
|
022f11 |
1 file changed, 28 insertions(+)
|
|
|
022f11 |
|
|
|
022f11 |
diff --git a/src/guestfs.pod b/src/guestfs.pod
|
|
|
022f11 |
index 65fb00f..0c57f50 100644
|
|
|
022f11 |
--- a/src/guestfs.pod
|
|
|
022f11 |
+++ b/src/guestfs.pod
|
|
|
022f11 |
@@ -526,6 +526,34 @@ L</guestfs_chmod> after creating each file or directory.
|
|
|
022f11 |
|
|
|
022f11 |
For more information about umask, see L<umask(2)>.
|
|
|
022f11 |
|
|
|
022f11 |
+=head2 LABELS AND UUIDS
|
|
|
022f11 |
+
|
|
|
022f11 |
+Many filesystems, devices and logical volumes support either labels
|
|
|
022f11 |
+(short strings like "BOOT" which might not be unique) and/or UUIDs
|
|
|
022f11 |
+(globally unique IDs).
|
|
|
022f11 |
+
|
|
|
022f11 |
+For filesystems, use L</guestfs_vfs_label> or L</guestfs_vfs_uuid> to
|
|
|
022f11 |
+read the label or UUID. Some filesystems let you call
|
|
|
022f11 |
+L</guestfs_set_label> or L</guestfs_set_uuid> to change the label or
|
|
|
022f11 |
+UUID.
|
|
|
022f11 |
+
|
|
|
022f11 |
+You can locate a filesystem by its label or UUID using
|
|
|
022f11 |
+L</guestfs_findfs_label> or L</guestfs_findfs_uuid>.
|
|
|
022f11 |
+
|
|
|
022f11 |
+For LVM2 (which supports only UUIDs), there is a rich set of APIs for
|
|
|
022f11 |
+fetching UUIDs, fetching UUIDs of the contained objects, and changing
|
|
|
022f11 |
+UUIDs. See:
|
|
|
022f11 |
+L</guestfs_lvuuid>,
|
|
|
022f11 |
+L</guestfs_vguuid>,
|
|
|
022f11 |
+L</guestfs_pvuuid>,
|
|
|
022f11 |
+L</guestfs_vglvuuids>,
|
|
|
022f11 |
+L</guestfs_vgpvuuids>,
|
|
|
022f11 |
+L</guestfs_vgchange_uuid>, L</guestfs_vgchange_uuid_all>,
|
|
|
022f11 |
+L</guestfs_pvchange_uuid>, L</guestfs_pvchange_uuid_all>.
|
|
|
022f11 |
+
|
|
|
022f11 |
+Note when cloning a filesystem, device or whole guest, it is a good
|
|
|
022f11 |
+idea to set new randomly generated UUIDs on the copy.
|
|
|
022f11 |
+
|
|
|
022f11 |
=head2 ENCRYPTED DISKS
|
|
|
022f11 |
|
|
|
022f11 |
Libguestfs allows you to access Linux guests which have been
|
|
|
022f11 |
--
|
|
|
022f11 |
1.8.3.1
|
|
|
022f11 |
|