lavu: add an API function to return the FFmpeg version string

This returns something like "N-73264-gb54ac84". This is much more useful
than the individual library versions, of which there are too much and
which are very hard to map back to releases or git commits.

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

diff --git a/doc/APIchanges b/doc/APIchanges
index 6e64a05f109f5b85c1991c32eb88b823b555660e..b1ecc3c5455971c4ac77e13df9256423e2b15dfe 100644 (file)
--- a/doc/APIchanges
+++ b/doc/APIchanges
@@ -15,6 +15,9 @@ libavutil:     2014-08-09
 
 API changes, most recent first:
 
+2015-xx-xx - xxxxxx - lavu  53.xx.100
+  Add avutil_version_info().
+
 -------- 8< --------- FFmpeg 2.7 was cut here -------- 8< ---------
 
 2015-06-04 - cc17b43 - lswr  1.2.100

diff --git a/libavutil/avutil.h b/libavutil/avutil.h
index e6ebb6c43c20e6522307f67b1459f013883568ba..eec2d559a75bba7dc70753ae6aa478597f3d69db 100644 (file)
--- a/libavutil/avutil.h
+++ b/libavutil/avutil.h
@@ -170,6 +170,13 @@
  */
 unsigned avutil_version(void);
 
+/**
+ * Return an informative version string. This usually the actual release version
+ * number and a git hash. This string has no fixed format and can change any
+ * time. It should never be parsed by code.
+ */
+const char *avutil_version_info(void);
+
 /**
  * Return the libavutil build-time configuration.
  */

diff --git a/libavutil/utils.c b/libavutil/utils.c
index 0b765ed0defb0d41de87b77c16a1e97c2eccf8c9..07bb3801c94e8c4117c70c0656ba05cd2359340a 100644 (file)
--- a/libavutil/utils.c
+++ b/libavutil/utils.c
@@ -30,6 +30,11 @@
 #include "libavutil/ffversion.h"
 const char av_util_ffversion[] = "FFmpeg version " FFMPEG_VERSION;
 
+const char *avutil_version_info(void)
+{
+    return FFMPEG_VERSION;
+}
+
 unsigned avutil_version(void)
 {
     static int checks_done;