util: add function to retrieve version information

Allow to query the version of the library via a function.

Signed-off-by: Daniel Wagner <[email protected]>

Author: dwsuse

meson.build

@@ -46,6 +46,7 @@ else
                     check: true)
     conf.set('GIT_VERSION', '"@0@"'.format(r.stdout().strip()))
 endif
+conf.set('PROJECT_VERSION', '"@0@"'.format(meson.project_version()))
 
 conf.set('SYSCONFDIR', '"@0@"'.format(sysconfdir))
 

src/libnvme.map

@@ -1,3 +1,8 @@
+LIBNVME_1_1 {
+	global:
+		nvme_get_version;
+};
+
 LIBNVME_1_0 {
 	global:
 		nvme_admin_passthru64;

src/nvme/util.c

@@ -778,3 +778,15 @@ struct nvmf_ext_attr *nvmf_exat_ptr_next(struct nvmf_ext_attr *p)
 	return (struct nvmf_ext_attr *)
 		((uintptr_t)p + (ptrdiff_t)nvmf_exat_size(le16_to_cpu(p->exatlen)));
 }
+
+const char *nvme_get_version(enum nvme_version type)
+{
+	switch(type) {
+	case NVME_VERSION_PROJECT:
+		return PROJECT_VERSION;
+	case NVME_VERSION_GIT:
+		return GIT_VERSION;
+	default:
+		return "n/a";
+	}
+}

src/nvme/util.h

@@ -532,4 +532,23 @@ static inline __u16 nvmf_exat_size(size_t val_len)
  */
 struct nvmf_ext_attr *nvmf_exat_ptr_next(struct nvmf_ext_attr *p);
 
+/**
+ * enum nvme_version - Selector for version to be returned by @nvme_get_version
+ *
+ * NVME_VERSION_PROJECT:	Project release version
+ * NVME_VERSION_GIT:		Git reference
+ */
+enum nvme_version {
+	NVME_VERSION_PROJECT	= 0,
+	NVME_VERSION_GIT	= 1,
+};
+
+/**
+ * nvme_get_version - Return version libnvme string
+ * @type:	Selects which version type (see @struct nvme_version)
+ *
+ * Return: Returns version string for known types or else "n/a"
+ */
+const char *nvme_get_version(enum nvme_version type);
+
 #endif /* _LIBNVME_UTIL_H */