[lvm-devel] [PATCH 5/5] Add lvm2app interfaces to lookup a vgname from a pvid and pvname.

[Dave Wysochanski]

lvm2app forces applications to start with a volume group name,
open the volume group, then operate on individual pvs.  In some
cases the application may want to start with a device name rather
than the volume group name.  Today, if an application wants to
do this, it must iterate through all the volume groups to find
the volume group that the specific device is attached to.
These new interfaces allow the application to avoid such overhead.
Bump the lvm2app version number to 3.

Signed-off-by: Dave Wysochanski <dwysocha at redhat.com>
---
 VERSION                  |    2 +-
 liblvm/.exported_symbols |    2 ++
 liblvm/lvm2app.h         |   41 ++++++++++++++++++++++++++++++++++++++++-
 liblvm/lvm_base.c        |   13 +++++++++++++
 4 files changed, 56 insertions(+), 2 deletions(-)

diff --git a/VERSION b/VERSION
index bbe50a4..6acf46d 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-2.02.64(2)-cvs (2010-04-14)
+2.02.64(3)-cvs (2010-04-14)
diff --git a/liblvm/.exported_symbols b/liblvm/.exported_symbols
index 9b61d45..546a3a3 100644
--- a/liblvm/.exported_symbols
+++ b/liblvm/.exported_symbols
@@ -48,3 +48,5 @@ lvm_list_vg_names
 lvm_list_vg_uuids
 lvm_vg_create_lv_linear
 lvm_vg_remove_lv
+lvm_vgname_from_pvid
+lvm_vgname_from_pvname
\ No newline at end of file
diff --git a/liblvm/lvm2app.h b/liblvm/lvm2app.h
index ed86665..d792398 100644
--- a/liblvm/lvm2app.h
+++ b/liblvm/lvm2app.h
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2008,2009 Red Hat, Inc. All rights reserved.
+ * Copyright (C) 2008,2009,2010 Red Hat, Inc. All rights reserved.
  *
  * This file is part of LVM2.
  *
@@ -344,6 +344,45 @@ struct dm_list *lvm_list_vg_names(lvm_t libh);
 struct dm_list *lvm_list_vg_uuids(lvm_t libh);
 
 /**
+ * Return the volume group name given a PV UUID
+ *
+ * \memberof lvm_t
+ *
+ * The memory allocated for the name is tied to the lvm_t handle and will be
+ * released when lvm_quit is called.
+ *
+ * NOTE: This function may scan devices in the system for LVM metadata.
+ *
+ * \param   libh
+ * Handle obtained from lvm_init().
+ *
+ * \return
+ * The volume group name for the given PV UUID.
+ * NULL is returned if the PV UUID is not associated with a volume group.
+ */
+const char *lvm_vgname_from_pvid(lvm_t *libh, const char *pvid)
+
+/**
+ * Return the volume group name given a device name
+ *
+ * \memberof lvm_t
+ *
+ * The memory allocated for the name is tied to the lvm_t handle and will be
+ * released when lvm_quit is called.
+ *
+ * NOTE: This function may scan devices in the system for LVM metadata.
+ *
+ * \param   libh
+ * Handle obtained from lvm_init().
+ *
+ * \return
+ * The volume group name for the given device name.
+ * NULL is returned if the device is not an LVM device.
+ *
+ */
+const char *lvm_vgname_from_device(lvm_t *libh, const char *device)
+
+/**
  * Open an existing VG.
  *
  * Open a VG for reading or writing.
diff --git a/liblvm/lvm_base.c b/liblvm/lvm_base.c
index 733d4d5..7d83543 100644
--- a/liblvm/lvm_base.c
+++ b/liblvm/lvm_base.c
@@ -98,3 +98,16 @@ const char *lvm_errmsg(lvm_t libh)
 {
 	return stored_errmsg();
 }
+
+const char *lvm_vgname_from_pvid(lvm_t *libh, const char *pvid)
+{
+	struct cmd_context *cmd = (struct cmd_context *)libh;
+	return find_vgname_from_pvid(cmd, pvid);
+}
+
+const char *lvm_vgname_from_device(struct cmd_context *cmd,
+				   const char *device)
+{
+	struct cmd_context *cmd = (struct cmd_context *)libh;
+	return find_vgname_from_pvname(cmd, device);
+}
-- 
1.6.0.6