OobsSession

OobsSession — Manager of the connection to the backends

Synopsis

                    OobsPlatform;
                    OobsSession;
OobsSession *       oobs_session_get                    (void);
OobsResult          oobs_session_commit                 (OobsSession *session);
gboolean            oobs_session_get_connected          (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);
void                oobs_session_process_requests       (OobsSession *session);
const gchar *       oobs_session_get_authentication_action
                                                        (OobsSession *session);

Object Hierarchy

  GObject
   +----OobsSession

Properties

  "platform"                 gchar*                : Read / Write

Description

Details

OobsPlatform

typedef struct {
  const gchar *id;
  const gchar *name;
  const gchar *version;
  const gchar *codename;
} OobsPlatform;

OobsSession

typedef struct _OobsSession OobsSession;

oobs_session_get ()

OobsSession *       oobs_session_get                    (void);

Returns the OobsSession singleton, which represents the session with the system tools backends.

Returns :

 the singleton OobSession object.

oobs_session_commit ()

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.

oobs_session_get_connected ()

gboolean            oobs_session_get_connected          (OobsSession *session);

Returns whether the connection with the backends is established.

session :

 An OobsSession

Returns :

 TRUE if there's connection with the backends.

oobs_session_get_supported_platforms ()

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.

oobs_session_get_platform ()

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.

oobs_session_set_platform ()

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.

oobs_session_process_requests ()

void                oobs_session_process_requests       (OobsSession *session);

Blocks until all pending asynchronous requests have been processed.

session :

 An OobsSession

oobs_session_get_authentication_action ()

const gchar *       oobs_session_get_authentication_action
                                                        (OobsSession *session);

Returns the PolicyKit action the user has to be authenticated to in order to commit changes to configuration objects in this session. If the user has not the required permissions, any attempt to commit will return OOBS_RESULT_ACCESS_DENIED.

session :

 An OobsSession

Returns :

 string defining the PolicyKit action required to modify objects in the session.

Property Details

The "platform" property

  "platform"                 gchar*                : Read / Write

Name of the platform the session is running on.

Default value: NULL