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>

3 files changed, 15 insertions, 0 deletions

diff --git a/doc/APIchanges b/doc/APIchanges
index 6e64a05f10..b1ecc3c545 100644
--- 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 e6ebb6c43c..eec2d559a7 100644
--- a/libavutil/avutil.h
+++ b/libavutil/avutil.h
@@ -171,6 +171,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.
  */
 const char *avutil_configuration(void);
diff --git a/libavutil/utils.c b/libavutil/utils.c
index 0b765ed0de..07bb3801c9 100644
--- 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;