ag_manager_new ()

AgManager *
ag_manager_new (void);

Create a new AgManager.

ag_manager_new_for_service_type ()

AgManager *
ag_manager_new_for_service_type (const gchar *service_type);

Create a new AgManager with the service type with the name service_type .

ag_manager_list ()

GList *
ag_manager_list (AgManager *manager);

Lists the accounts. If the AgManager is created with a specified “service-type”, it will return only the accounts supporting this service type.

ag_manager_list_by_service_type ()

GList *
ag_manager_list_by_service_type (AgManager *manager,
                                 const gchar *service_type);

Lists the accounts supporting the given service type.

ag_manager_list_free ()

void
ag_manager_list_free (GList *list);

Frees the memory taken by a GList of AgAccountId allocated by AgManager, such as by ag_manager_list(), ag_manager_list_enabled() or ag_manager_list_enabled_by_service_type().

ag_manager_get_account_services ()

GList *
ag_manager_get_account_services (AgManager *manager);

Gets all the account services. If the manager was created for a specific service type, only services with that type will be returned.

ag_manager_get_enabled_account_services ()

GList *
ag_manager_get_enabled_account_services
                               (AgManager *manager);

Gets all the enabled account services. If the manager was created for a specific service type, only services with that type will be returned.

ag_manager_get_account ()

AgAccount *
ag_manager_get_account (AgManager *manager,
                        AgAccountId account_id);

Instantiates the object representing the account identified by account_id .

ag_manager_load_account ()

AgAccount *
ag_manager_load_account (AgManager *manager,
                         AgAccountId account_id,
                         GError **error);

Instantiates the object representing the account identified by account_id .

ag_manager_create_account ()

AgAccount *
ag_manager_create_account (AgManager *manager,
                           const gchar *provider_name);

Create a new account. The account is not stored in the database until ag_account_store() has successfully returned; the id field in the AgAccount structure is also not meant to be valid until the account has been stored.

ag_manager_get_service ()

AgService *
ag_manager_get_service (AgManager *manager,
                        const gchar *service_name);

Loads the service identified by service_name .

ag_manager_list_services ()

GList *
ag_manager_list_services (AgManager *manager);

Gets a list of all the installed services. If the AgManager was created with a specified “service_type” it will return only the installed services supporting that service type.

ag_manager_list_services_by_type ()

GList *
ag_manager_list_services_by_type (AgManager *manager,
                                  const gchar *service_type);

Gets a list of all the installed services where the service type name is service_type .

ag_manager_list_services_by_application ()

GList *
ag_manager_list_services_by_application
                               (AgManager *manager,
                                AgApplication *application);

Get the list of services that are supported by application .

ag_manager_list_enabled ()

GList *
ag_manager_list_enabled (AgManager *manager);

Lists the enabled accounts.

ag_manager_list_enabled_by_service_type ()

GList *
ag_manager_list_enabled_by_service_type
                               (AgManager *manager,
                                const gchar *service_type);

Lists the enabled accounts supporting the given service type.

ag_manager_get_service_type ()

const gchar *
ag_manager_get_service_type (AgManager *manager);

Get the service type for manager .

ag_manager_get_provider ()

AgProvider *
ag_manager_get_provider (AgManager *manager,
                         const gchar *provider_name);

Loads the provider identified by provider_name .

ag_manager_list_providers ()

GList *
ag_manager_list_providers (AgManager *manager);

Gets a list of all the installed providers.

ag_manager_set_db_timeout ()

void
ag_manager_set_db_timeout (AgManager *manager,
                           guint timeout_ms);

Sets the timeout for database operations. This tells the library how long it is allowed to block while waiting for a locked DB to become accessible. Higher values mean a higher chance of successful reads, but also mean that the execution might be blocked for a longer time. The default is 5 seconds.

ag_manager_get_db_timeout ()

guint
ag_manager_get_db_timeout (AgManager *manager);

Get the timeout of database operations for manager , in milliseconds.

ag_manager_set_abort_on_db_timeout ()

void
ag_manager_set_abort_on_db_timeout (AgManager *manager,
                                    gboolean abort);

Tells libaccounts whether it should make the client application abort when a timeout error occurs. The default is FALSE.

ag_manager_get_abort_on_db_timeout ()

gboolean
ag_manager_get_abort_on_db_timeout (AgManager *manager);

Get whether the library will abort when a timeout error occurs.

ag_manager_list_service_types ()

GList *
ag_manager_list_service_types (AgManager *manager);

Gets a list of all the installed service types.

ag_manager_load_service_type ()

AgServiceType *
ag_manager_load_service_type (AgManager *manager,
                              const gchar *service_type);

Instantiate the service type with the name service_type .

ag_manager_get_application ()

AgApplication *
ag_manager_get_application (AgManager *self,
                            const gchar *application_name);

Search for application_name in the list of applications, and return a new AgApplication if a matching application was found.

ag_manager_list_applications_by_service ()

GList *
ag_manager_list_applications_by_service
                               (AgManager *manager,
                                AgService *service);

Lists the registered applications which support the given service.

struct AgManagerClass

struct AgManagerClass {
    GObjectClass parent_class;
    void (*account_deleted) (AgManager *manager, AgAccountId id);
    void (*_ag_reserved2) (void);
    void (*_ag_reserved3) (void);
    void (*_ag_reserved4) (void);
    void (*_ag_reserved5) (void);
    void (*_ag_reserved6) (void);
    void (*_ag_reserved7) (void);
};

Use the accessor functions below.

The “abort-on-db-timeout” property

  “abort-on-db-timeout”      gboolean

Whether to abort the application when a database timeout occurs.

Owner: AgManager

Flags: Read / Write

Default value: FALSE

The “db-timeout” property

  “db-timeout”               guint

Timeout for database operations, in milliseconds.

Owner: AgManager

Flags: Read / Write

Default value: 5000

The “service-type” property

  “service-type”             char *

If the service type is set, certain operations on the AgManager, such as ag_manager_list() and ag_manager_list_services(), will be restricted to only affect accounts or services with that service type.

Owner: AgManager

Flags: Read / Write / Construct Only

Default value: NULL

The “use-dbus” property

  “use-dbus”                 gboolean

Whether to use D-Bus for inter-process change notification. Setting this property to FALSE causes libaccounts not to emit the change notification signals, and also not react to changes made by other processes. Disabling D-Bus is only meant to be used for specific cases, such as maintenance programs.

Owner: AgManager

Flags: Read / Write / Construct Only

Default value: TRUE

The “account-created” signal

void
user_function (AgManager *manager,
               guint      account_id,
               gpointer   user_data)

Emitted when a new account has been created; note that the account must have been stored in the database: the signal is not emitted just in response to ag_manager_create_account().

Flags: Run Last

The “account-deleted” signal

void
user_function (AgManager *manager,
               guint      account_id,
               gpointer   user_data)

Emitted when an account has been deleted. This signal is redundant with “deleted”, but it is convenient to provide full change notification with AgManager.

Flags: Run Last

The “account-updated” signal

void
user_function (AgManager *manager,
               guint      account_id,
               gpointer   user_data)

Emitted when particular service of an account has been updated. This signal is redundant with “deleted”, but it is convenient to provide full change notification with AgManager.

Flags: Run Last

The “enabled-event” signal

void
user_function (AgManager *manager,
               guint      account_id,
               gpointer   user_data)

If the manager has been created with ag_manager_new_for_service_type(), this signal will be emitted when an account (identified by account_id ) has been modified in such a way that the application might be interested to start or stop using it: the "enabled" flag on the account or in some service supported by the account and matching the “service-type” have changed. In practice, this signal might be emitted more often than when strictly needed; applications must call ag_account_list_enabled_services() or ag_manager_list_enabled() to get the current state.

Flags: Run Last