[PATCH v2] cpukit: Add a Version API.

[Sebastian Huber]

----- Am 7. Nov 2017 um 17:02 schrieb Chris Johns chrisj at rtems.org:

> Provide functions to get the version string, major, minor and revision
> numbers and the version control identifer that is a unique tag for
> the version control system.
> 
> Update #3199.
[...]
> diff --git a/cpukit/sapi/src/version.c b/cpukit/sapi/src/version.c
> new file mode 100644
> index 0000000000..d240b1b0df
> --- /dev/null
> +++ b/cpukit/sapi/src/version.c
> @@ -0,0 +1,63 @@
> +/**
> + * @file
> + *
> + * @brief Creates the version strings from the various pieces of version
> + * information. The main version number is part of the build system and is
> + * stamped into rtems/score/cpuopts.h. The version control key string is
> + * extracted from the version control tool when the code is being built and is
> + * updated if it has changed. The key may indicate there are local
> + * modification.
> + *
> + * @ingroup ClassicVersion
> + */
> +
> +/*
> + *  Copyright (C) 2017.
> + *  Chris Johns <chrisj at rtems.org>
> + *
> + *  The license and distribution terms for this file may be
> + *  found in the file LICENSE in this distribution or at
> + *  http://www.rtems.org/license/LICENSE.
> + */
> +
> +#if HAVE_CONFIG_H
> +#include "config.h"
> +#endif
> +
> +#include <rtems.h>
> +#include <rtems/version.h>
> +
> +#include "version-vc-key.h"
> +
> +const char *rtems_version( void )
> +{
> +#ifdef RTEMS_VERSION_VC_KEY
> +  return RTEMS_VERSION "." RTEMS_VERSION_VC_KEY;
> +#else
> +  return RTEMS_VERSION;
> +#endif
> +}

Since RTEMS_VERSION_VC_KEY is not user-visible, it should be _VERSION_CONTROL_KEY.