Blame doc/html/goa-Version-Information.html

Packit Service c6b9b0
Packit Service c6b9b0
<html>
Packit Service c6b9b0
<head>
Packit Service c6b9b0
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Packit Service c6b9b0
<title>Version Information: GNOME Online Accounts Reference Manual</title>
Packit Service c6b9b0
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
Packit Service c6b9b0
<link rel="home" href="index.html" title="GNOME Online Accounts Reference Manual">
Packit Service c6b9b0
<link rel="up" href="ref-library.html" title="Part III. Client Library API Reference">
Packit Service c6b9b0
<link rel="prev" href="goa-GoaError.html" title="GoaError">
Packit Service c6b9b0
<link rel="next" href="ref-library-generated.html" title="Generated Code">
Packit Service c6b9b0
<meta name="generator" content="GTK-Doc V1.28 (XML mode)">
Packit Service c6b9b0
<link rel="stylesheet" href="style.css" type="text/css">
Packit Service c6b9b0
</head>
Packit Service c6b9b0
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Top  | 
Packit Service c6b9b0
                  Description
Packit Service c6b9b0
Packit Service c6b9b0
Home
Packit Service c6b9b0
Up
Packit Service c6b9b0
Prev
Packit Service c6b9b0
Next
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

Version Information

Packit Service c6b9b0

Version Information — variables and functions to check the GOA version

Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

Functions

Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
const gchar *
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
goa_check_version ()
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
#define
Packit Service c6b9b0
Packit Service c6b9b0
GOA_CHECK_VERSION()
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

Types and Values

Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
extern const guint 
Packit Service c6b9b0
goa_major_version
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
extern const guint 
Packit Service c6b9b0
goa_minor_version
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
extern const guint 
Packit Service c6b9b0
goa_micro_version
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
#define
Packit Service c6b9b0
GOA_MAJOR_VERSION
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
#define
Packit Service c6b9b0
GOA_MINOR_VERSION
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
#define
Packit Service c6b9b0
GOA_MICRO_VERSION
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

Description

Packit Service c6b9b0

GOA provides version information, primarily useful in configure

Packit Service c6b9b0
checks for builds that have a configure script. Applications will
Packit Service c6b9b0
not typically use the features described here.

Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

Functions

Packit Service c6b9b0
Packit Service c6b9b0

goa_check_version ()

Packit Service c6b9b0
const gchar *
Packit Service c6b9b0
goa_check_version (guint required_major,
Packit Service c6b9b0
                   guint required_minor,
Packit Service c6b9b0
                   guint required_micro);
Packit Service c6b9b0

Checks that the GOA library in use is compatible with the

Packit Service c6b9b0
given version. Generally you would pass in the constants
Packit Service c6b9b0
GOA_MAJOR_VERSION, GOA_MINOR_VERSION, GOA_MICRO_VERSION
Packit Service c6b9b0
as the three arguments to this function; that produces
Packit Service c6b9b0
a check that the library in use is compatible with
Packit Service c6b9b0
the version of GOA the application or module was compiled
Packit Service c6b9b0
against.

Packit Service c6b9b0

Compatibility is defined by two things: first the version

Packit Service c6b9b0
of the running library is newer than the version
Packit Service c6b9b0
required_major
Packit Service c6b9b0
.required_minor
Packit Service c6b9b0
.required_micro
Packit Service c6b9b0
. Second
Packit Service c6b9b0
the running library must be binary compatible with the
Packit Service c6b9b0
version required_major
Packit Service c6b9b0
.required_minor
Packit Service c6b9b0
.required_micro
Packit Service c6b9b0
Packit Service c6b9b0
(same major and minor version).

Packit Service c6b9b0
Packit Service c6b9b0

Parameters

Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

required_major

Packit Service c6b9b0

the required major version.

Packit Service c6b9b0
 
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

required_minor

Packit Service c6b9b0

the required minor version.

Packit Service c6b9b0
 
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

required_micro

Packit Service c6b9b0

the required micro version.

Packit Service c6b9b0
 
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

Returns

Packit Service c6b9b0

NULL if the GOA library is compatible with the

Packit Service c6b9b0
given version, or a string describing the version mismatch.
Packit Service c6b9b0
The returned string is owned by GOA and must not be modified
Packit Service c6b9b0
or freed.

Packit Service c6b9b0
Packit Service c6b9b0

Since: 3.8

Packit Service c6b9b0
Packit Service c6b9b0

Packit Service c6b9b0
Packit Service c6b9b0

GOA_CHECK_VERSION()

Packit Service c6b9b0
#define             GOA_CHECK_VERSION(major,minor,micro)
Packit Service c6b9b0

Checks the version of the GOA library that is being compiled

Packit Service c6b9b0
against.

Packit Service c6b9b0
Packit Service c6b9b0

Example 1. Checking the version of the GOA library

Packit Service c6b9b0
Packit Service c6b9b0
  
Packit Service c6b9b0
    
Packit Service c6b9b0
      
Packit Service c6b9b0
        
1
Packit Service c6b9b0
2
Packit Service c6b9b0
        
if (!GOA_CHECK_VERSION (3, 8, 0))
Packit Service c6b9b0
  g_error ("GOA version 3.8.0 or above is needed");
Packit Service c6b9b0
      
Packit Service c6b9b0
    
Packit Service c6b9b0
  
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

See goa_check_version() for a runtime check.

Packit Service c6b9b0
Packit Service c6b9b0

Parameters

Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

major

Packit Service c6b9b0

the major version to check for

Packit Service c6b9b0
 
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

minor

Packit Service c6b9b0

the minor version to check for

Packit Service c6b9b0
 
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

micro

Packit Service c6b9b0

the micro version to check for

Packit Service c6b9b0
 
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

Returns

Packit Service c6b9b0

TRUE if the version of the GOA header files

Packit Service c6b9b0
is the same as or newer than the passed-in version.

Packit Service c6b9b0
Packit Service c6b9b0

Since: 3.8

Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

Types and Values

Packit Service c6b9b0
Packit Service c6b9b0

goa_major_version

Packit Service c6b9b0
extern const guint goa_major_version;
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

Packit Service c6b9b0
Packit Service c6b9b0

goa_minor_version

Packit Service c6b9b0
extern const guint goa_minor_version;
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

Packit Service c6b9b0
Packit Service c6b9b0

goa_micro_version

Packit Service c6b9b0
extern const guint goa_micro_version;
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

Packit Service c6b9b0
Packit Service c6b9b0

GOA_MAJOR_VERSION

Packit Service c6b9b0
#define GOA_MAJOR_VERSION 3
Packit Service c6b9b0
Packit Service c6b9b0

The major version number of the GOA daemon and library.

Packit Service c6b9b0

Like goa_major_version, but from the headers used at

Packit Service c6b9b0
application compile time, rather than from the library
Packit Service c6b9b0
linked against at application run time.

Packit Service c6b9b0

Since: 3.8

Packit Service c6b9b0
Packit Service c6b9b0

Packit Service c6b9b0
Packit Service c6b9b0

GOA_MINOR_VERSION

Packit Service c6b9b0
#define GOA_MINOR_VERSION 28
Packit Service c6b9b0
Packit Service c6b9b0

The minor version number of the GOA daemon and library.

Packit Service c6b9b0

Like goa_minor_version, but from the headers used at

Packit Service c6b9b0
application compile time, rather than from the library
Packit Service c6b9b0
linked against at application run time.

Packit Service c6b9b0

Since: 3.8

Packit Service c6b9b0
Packit Service c6b9b0

Packit Service c6b9b0
Packit Service c6b9b0

GOA_MICRO_VERSION

Packit Service c6b9b0
#define GOA_MICRO_VERSION 2
Packit Service c6b9b0
Packit Service c6b9b0

The micro version number of the GOA daemon and library.

Packit Service c6b9b0

Like goa_micro_version, but from the headers used at

Packit Service c6b9b0
application compile time, rather than from the library
Packit Service c6b9b0
linked against at application run time.

Packit Service c6b9b0

Since: 3.8

Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0
Packit Service c6b9b0

Generated by GTK-Doc V1.28
Packit Service c6b9b0
</body>
Packit Service c6b9b0
</html>