2 * version.c: library version number and utilities
4 * ====================================================================
5 * Licensed to the Apache Software Foundation (ASF) under one
6 * or more contributor license agreements. See the NOTICE file
7 * distributed with this work for additional information
8 * regarding copyright ownership. The ASF licenses this file
9 * to you under the Apache License, Version 2.0 (the
10 * "License"); you may not use this file except in compliance
11 * with the License. You may obtain a copy of the License at
13 * http://www.apache.org/licenses/LICENSE-2.0
15 * Unless required by applicable law or agreed to in writing,
16 * software distributed under the License is distributed on an
17 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
18 * KIND, either express or implied. See the License for the
19 * specific language governing permissions and limitations
21 * ====================================================================
26 #include "svn_error.h"
27 #include "svn_version.h"
30 #include "svn_private_config.h"
31 #include "private/svn_subr_private.h"
34 svn_subr_version(void)
40 svn_boolean_t svn_ver_compatible(const svn_version_t *my_version,
41 const svn_version_t *lib_version)
43 /* With normal development builds the matching rules are strict, to
44 avoid inadvertantly using the wrong libraries. For backward
45 compatibility testing use --disable-full-version-match to
46 configure 1.7 and then the libraries that get built can be used
47 to replace those in 1.6 or earlier builds. */
49 #ifndef SVN_DISABLE_FULL_VERSION_MATCH
50 if (lib_version->tag[0] != '\0')
51 /* Development library; require exact match. */
52 return svn_ver_equal(my_version, lib_version);
53 else if (my_version->tag[0] != '\0')
54 /* Development client; must be newer than the library
55 and have the same major and minor version. */
56 return (my_version->major == lib_version->major
57 && my_version->minor == lib_version->minor
58 && my_version->patch > lib_version->patch);
61 /* General compatibility rules for released versions. */
62 return (my_version->major == lib_version->major
63 && my_version->minor <= lib_version->minor);
67 svn_boolean_t svn_ver_equal(const svn_version_t *my_version,
68 const svn_version_t *lib_version)
70 return (my_version->major == lib_version->major
71 && my_version->minor == lib_version->minor
72 && my_version->patch == lib_version->patch
73 && 0 == strcmp(my_version->tag, lib_version->tag));
78 svn_ver_check_list(const svn_version_t *my_version,
79 const svn_version_checklist_t *checklist)
81 svn_error_t *err = SVN_NO_ERROR;
84 for (i = 0; checklist[i].label != NULL; ++i)
86 const svn_version_t *lib_version = checklist[i].version_query();
87 if (!svn_ver_compatible(my_version, lib_version))
88 err = svn_error_createf(SVN_ERR_VERSION_MISMATCH, err,
89 _("Version mismatch in '%s':"
91 " expected %d.%d.%d%s"),
93 lib_version->major, lib_version->minor,
94 lib_version->patch, lib_version->tag,
95 my_version->major, my_version->minor,
96 my_version->patch, my_version->tag);
103 struct svn_version_extended_t
105 const char *build_date; /* Compilation date */
106 const char *build_time; /* Compilation time */
107 const char *build_host; /* Build canonical host name */
108 const char *copyright; /* Copyright notice (localized) */
109 const char *runtime_host; /* Runtime canonical host name */
110 const char *runtime_osname; /* Running OS release name */
112 /* Array of svn_version_ext_linked_lib_t describing dependent
114 const apr_array_header_t *linked_libs;
116 /* Array of svn_version_ext_loaded_lib_t describing loaded shared
118 const apr_array_header_t *loaded_libs;
122 const svn_version_extended_t *
123 svn_version_extended(svn_boolean_t verbose,
126 svn_version_extended_t *info = apr_pcalloc(pool, sizeof(*info));
128 info->build_date = NULL;
129 info->build_time = NULL;
130 info->build_host = SVN_BUILD_HOST;
131 info->copyright = apr_pstrdup
132 (pool, _("Copyright (C) 2013 The Apache Software Foundation.\n"
133 "This software consists of contributions made by many people;\n"
134 "see the NOTICE file for more information.\n"
135 "Subversion is open source software, see "
136 "http://subversion.apache.org/\n"));
140 info->runtime_host = svn_sysinfo__canonical_host(pool);
141 info->runtime_osname = svn_sysinfo__release_name(pool);
142 info->linked_libs = svn_sysinfo__linked_libs(pool);
143 info->loaded_libs = svn_sysinfo__loaded_libs(pool);
151 svn_version_ext_build_date(const svn_version_extended_t *ext_info)
153 return ext_info->build_date;
157 svn_version_ext_build_time(const svn_version_extended_t *ext_info)
159 return ext_info->build_time;
163 svn_version_ext_build_host(const svn_version_extended_t *ext_info)
165 return ext_info->build_host;
169 svn_version_ext_copyright(const svn_version_extended_t *ext_info)
171 return ext_info->copyright;
175 svn_version_ext_runtime_host(const svn_version_extended_t *ext_info)
177 return ext_info->runtime_host;
181 svn_version_ext_runtime_osname(const svn_version_extended_t *ext_info)
183 return ext_info->runtime_osname;
186 const apr_array_header_t *
187 svn_version_ext_linked_libs(const svn_version_extended_t *ext_info)
189 return ext_info->linked_libs;
192 const apr_array_header_t *
193 svn_version_ext_loaded_libs(const svn_version_extended_t *ext_info)
195 return ext_info->loaded_libs;
199 svn_version__parse_version_string(svn_version_t **version_p,
200 const char *version_string,
201 apr_pool_t *result_pool)
204 svn_version_t *version;
205 apr_array_header_t *pieces =
206 svn_cstring_split(version_string, ".", FALSE, result_pool);
208 if ((pieces->nelts < 2) || (pieces->nelts > 3))
209 return svn_error_createf(SVN_ERR_MALFORMED_VERSION_STRING, NULL,
210 _("Failed to parse version number string '%s'"),
213 version = apr_pcalloc(result_pool, sizeof(*version));
216 /* Parse the major and minor integers strictly. */
217 err = svn_cstring_atoi(&(version->major),
218 APR_ARRAY_IDX(pieces, 0, const char *));
220 return svn_error_createf(SVN_ERR_MALFORMED_VERSION_STRING, err,
221 _("Failed to parse version number string '%s'"),
223 err = svn_cstring_atoi(&(version->minor),
224 APR_ARRAY_IDX(pieces, 1, const char *));
226 return svn_error_createf(SVN_ERR_MALFORMED_VERSION_STRING, err,
227 _("Failed to parse version number string '%s'"),
230 /* If there's a third component, we'll parse it, too. But we don't
231 require that it be present. */
232 if (pieces->nelts == 3)
234 const char *piece = APR_ARRAY_IDX(pieces, 2, const char *);
235 char *hyphen = strchr(piece, '-');
238 version->tag = apr_pstrdup(result_pool, hyphen + 1);
241 err = svn_cstring_atoi(&(version->patch), piece);
243 return svn_error_createf(SVN_ERR_MALFORMED_VERSION_STRING, err,
244 _("Failed to parse version number string '%s'"
249 if (version->major < 0 || version->minor < 0 || version->patch < 0)
250 return svn_error_createf(SVN_ERR_MALFORMED_VERSION_STRING, err,
251 _("Failed to parse version number string '%s'"),
254 *version_p = version;
260 svn_version__at_least(svn_version_t *version,
265 /* Compare major versions. */
266 if (version->major < major)
268 if (version->major > major)
271 /* Major versions are the same. Compare minor versions. */
272 if (version->minor < minor)
274 if (version->minor > minor)
277 /* Major and minor versions are the same. Compare patch
279 if (version->patch < patch)
281 if (version->patch > patch)
284 /* Major, minor, and patch versions are identical matches. But tags
285 in our schema are always used for versions not yet quite at the
286 given patch level. */
287 if (version->tag && version->tag[0])