![]() |
![]() |
![]() |
Liboobs (Gnome System Tools) Reference Manual | ![]() |
---|---|---|---|---|
OobsPlatform; OobsSession; OobsSession* oobs_session_get (void); OobsResult oobs_session_commit (OobsSession *session); OobsResult oobs_session_get_supported_platforms (OobsSession *session, GList **platforms); OobsResult oobs_session_get_platform (OobsSession *session, gchar **platform); OobsResult oobs_session_set_platform (OobsSession *session, const gchar *platform);
typedef struct { const gchar *id; const gchar *name; const gchar *version; const gchar *codename; } OobsPlatform;
OobsSession* oobs_session_get (void);
Returns the OobsSession singleton, which represents the session with the system tools backends.
Returns : | the singleton OobSession object. |
OobsResult oobs_session_commit (OobsSession *session);
Commits inmediately all the changes to the configuration objects that have been requested through this OobsSession. Note that it will stop if it finds any error.
session : |
an OobsSession |
Returns : | An OobsResult representing the error. |
OobsResult oobs_session_get_supported_platforms (OobsSession *session, GList **platforms);
Retrieves the list of supported platforms, this is only necessary when
+ oobs_session_get_platform()
has returned OOBS_RESULT_NO_PLATFORM. To
specify a platform, you must use oobs_session_set_platform()
, being
the platform string in that function the platform->id value inside
the OobsPlatform struct.
session : |
An OobsSession. |
platforms : |
return location for the list of platforms. It's a
GList of OobsPlatform structs. You must free
this list with g_list_free() .
|
Returns : | An OobsResult representing the error. |
OobsResult oobs_session_get_platform (OobsSession *session, gchar **platform);
Retrieves the platform your system has been identified with, or NULL in case your platform is not recognized or other error happens.
session : |
An OobsSession. |
platform : |
location to store the current platform, or NULL. This string is of internal use, and must not be freed or modified. |
Returns : | An OobsResult representing the error. |
OobsResult oobs_session_set_platform (OobsSession *session, const gchar *platform);
Identifies your platform as the one set in platform
. This is only necessary if
your platform could not be guessed (and thus oobs_session_get_platform()
would
return OOBS_RESULT_NO_PLATFORM in this case).
session : |
An OobsSession. |
platform : |
A string defining the platform. see
oobs_session_get_platforms_list() to know where to get this string.
|
Returns : | An OobsResult representing the error. |