* this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
- * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+ * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMIT
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
* PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
* OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
gchar *account_name;
gchar *hostname;
gchar *username;
- gchar *uri;
- ModestProtocol proto; /*< The store or transport. Not ORed. */
+ gchar *uri; /*< Only for mbox and maildir accounts. */
+ ModestTransportStoreProtocol proto; /*< The store or transport. Not ORed. */
gchar *password;
time_t last_updated;
- gint port; /* Or 0, if the default should be used. */
- ModestProtocol secure_auth;
- ModestProtocol security;
- GSList *options;
+ gint port; /* Or 0, if the default should be used. */
+ ModestAuthProtocol secure_auth;
+ ModestConnectionProtocol security;
} ModestServerAccountData;
typedef struct {
const gchar* name);
/**
- * modest_account_mgr_get_default_account:
- * @self: a ModestAccountMgr instance
- *
- * get the default account name, or NULL if none is found
- *
- * Returns: the default account name (as newly allocated string, which
- * must be g_free'd), or NULL
- */
-gchar* modest_account_mgr_get_default_account (ModestAccountMgr *self);
-
-/**
- * modest_account_mgr_set_default_account:
- * @self: a ModestAccountMgr instance
- * @account: the name of an existing account
- *
- * set the default account name (which must be valid account)
- *
- * Returns: TRUE if succeeded, FALSE otherwise
- */
-gboolean modest_account_mgr_set_default_account (ModestAccountMgr *self,
- const gchar* account);
-
-/**
- * modest_account_mgr_unset_default_account:
- * @self: a ModestAccountMgr instance
- * @account: the name of an account
- *
- * Unset the default account name, so that no account is the default.
- *
- * Returns: TRUE if succeeded, FALSE otherwise
- */
-gboolean modest_account_mgr_unset_default_account (ModestAccountMgr *self);
-
-/**
* modest_account_mgr_set_first_account_as_default:
* @self: a ModestAccountMgr instance
*
gboolean
modest_account_mgr_set_first_account_as_default (ModestAccountMgr *self);
+/** Get the first one, alphabetically, by title. */
+gchar*
+modest_account_mgr_get_first_account_name (ModestAccountMgr *self);
+
/**
* modest_account_mgr_free_account_data:
* @self: a ModestAccountMgr instance
*/
gchar* modest_account_mgr_get_signature (ModestAccountMgr *self, const gchar* name,
gboolean* use_signature);
+
+/**
+ * modest_account_mgr_get_store_protocol:
+ * @self: a ModestAccountMgr instance
+ * @name: the account name
+ *
+ * Gets the protocol type (For instance, POP or IMAP) used for the store server account.
+ *
+ * Returns: The protocol type.
+ */
+ModestTransportStoreProtocol modest_account_mgr_get_store_protocol (ModestAccountMgr *self, const gchar* name);
/**
* modest_account_mgr_set_connection_specific_smtp
* @self: a ModestAccountMgr instance
- * @name: the account name
* @connection_name: A libconic IAP connection name
* @server_account_name: a server account name to use for this connection.
*
*
* Returns: TRUE if it worked, FALSE otherwise
*/
-gboolean modest_account_mgr_set_connection_specific_smtp (ModestAccountMgr *self, const gchar* name,
+gboolean modest_account_mgr_set_connection_specific_smtp (ModestAccountMgr *self,
const gchar* connection_name, const gchar* server_account_name);
/**
* modest_account_mgr_remove_connection_specific_smtp
* @self: a ModestAccountMgr instance
- * @name: the account name
* @connection_name: A libconic IAP connection name
*
- * Disassacoiate a server account to use with the specific connection for this account.
+ * Disassociate a server account to use with the specific connection for this account.
*
* Returns: TRUE if it worked, FALSE otherwise
*/
-gboolean modest_account_mgr_remove_connection_specific_smtp (ModestAccountMgr *self, const gchar* name,
- const gchar* connection_name);
+gboolean modest_account_mgr_remove_connection_specific_smtp (ModestAccountMgr *self,
+ const gchar* connection_name);
+
+/**
+ * modest_account_mgr_get_use_connection_specific_smtp
+ * @self: a ModestAccountMgr instance
+ * @account_name: the account name
+ * @result: Whether this account should use connection-specific smtp server accounts.
+ */
+gboolean modest_account_mgr_get_use_connection_specific_smtp (ModestAccountMgr *self, const gchar* account_name);
+
+/**
+ * modest_account_mgr_set_use_connection_specific_smtp
+ * @self: a ModestAccountMgr instance
+ * @account_name: the account name
+ * @new_value: New value that indicates if if this account should use connection-specific smtp server accounts.
+ * @result: TRUE if it succeeded, FALSE otherwise
+ */
+gboolean modest_account_mgr_set_use_connection_specific_smtp (ModestAccountMgr *self,
+ const gchar* account_name,
+ gboolean new_value);
/**
* modest_account_mgr_get_connection_specific_smtp
* @self: a ModestAccountMgr instance
- * @name: the account name
* @connection_name: A libconic IAP connection name
*
* Retrieve a server account to use with this specific connection for this account.
*
* Returns: a server account name to use for this connection, or NULL if none is specified.
*/
-gchar* modest_account_mgr_get_connection_specific_smtp (ModestAccountMgr *self, const gchar* name,
- const gchar* connection_name);
-
+gchar* modest_account_mgr_get_connection_specific_smtp (ModestAccountMgr *self,
+ const gchar* connection_name);
+
+
/**
- * modest_server_account_get_secure_auth:
+ * modest_account_mgr_get_server_account_username:
* @self: a ModestAccountMgr instance
* @account_name: The name of a server account.
*
- * Gets the secure authentication method for this server account.
+ * Gets the username this server account.
*
- * Returns: The secure authentication enum value.
+ * Returns: The username.
*/
-ModestProtocol
-modest_server_account_get_secure_auth (ModestAccountMgr *self, const gchar* account_name);
+gchar* modest_account_mgr_get_server_account_username (ModestAccountMgr *self,
+ const gchar* account_name);
/**
- * modest_server_account_data_get_secure_auth:
+ * modest_account_mgr_set_server_account_username:
* @self: a ModestAccountMgr instance
* @account_name: The name of a server account.
- * @secure_auth: The secure authentication enum value.
+ * @username: The new username.
*
- * Gets the secure authentication method for this server account.
+ * Sets the username this server account.
*/
-void
-modest_server_account_set_secure_auth (ModestAccountMgr *self, const gchar* account_name,
- ModestProtocol secure_auth);
+void modest_account_mgr_set_server_account_username (ModestAccountMgr *self,
+ const gchar* account_name,
+ const gchar* username);
+
+/**
+ * modest_account_mgr_get_server_account_username_has_succeeded:
+ * @self: a ModestAccountMgr instance
+ * @account_name: The name of a server account.
+ *
+ * Whether a connection has ever been successfully made to this account with
+ * the current username. This can be used to avoid asking again for the username
+ * when asking a second time for a non-stored password.
+ *
+ * Returns: TRUE if the username is known to be correct.
+ */
+gboolean modest_account_mgr_get_server_account_username_has_succeeded (ModestAccountMgr *self,
+ const gchar* account_name);
+
+/**
+ * modest_account_mgr_set_server_account_username_has_succeeded:
+ * @self: a ModestAccountMgr instance
+ * @account_name: The name of a server account.
+ * @succeeded: Whether the username has succeeded
+ *
+ * Sets whether the username is known to be correct.
+ */
+void modest_account_mgr_set_server_account_username_has_succeeded (ModestAccountMgr *self,
+ const gchar* account_name,
+ gboolean succeeded);
/**
- * modest_server_account_data_get_security:
+ * modest_account_mgr_set_server_account_password:
* @self: a ModestAccountMgr instance
* @account_name: The name of a server account.
+ * @password: The new password.
*
- * Gets the security method for this server account.
+ * Sets the password for this server account.
+ */
+void modest_account_mgr_set_server_account_password (ModestAccountMgr *self,
+ const gchar* account_name,
+ const gchar* password);
+
+/**
+ * modest_account_mgr_get_server_account_password:
+ * @self: a ModestAccountMgr instance
+ * @account_name: The name of a server account.
*
- * Returns: The security enum value.
+ * Gets the password for this server account from the account settings.
*/
-ModestProtocol
-modest_server_account_get_security (ModestAccountMgr *self, const gchar* account_name);
+gchar* modest_account_mgr_get_server_account_password (ModestAccountMgr *self,
+ const gchar* account_name);
/**
- * modest_server_account_set_security:
+ * modest_account_mgr_get_server_account_has_password:
* @self: a ModestAccountMgr instance
- * @secure_auth: The security enum value.
+ * @account_name: The name of a server account.
*
- * Gets the security method for this server account.
+ * Gets whether a password has been set for this server account in the account settings.
*/
-void
-modest_server_account_set_security (ModestAccountMgr *self, const gchar* account_name,
- ModestProtocol security);
+gboolean modest_account_mgr_get_server_account_has_password (ModestAccountMgr *self,
+ const gchar* account_name);
-ModestServerAccountData*
-modest_account_mgr_get_server_account_data (ModestAccountMgr *self, const gchar* name);
+/**
+ * modest_server_account_modest_account_mgr_get_server_account_hostname:
+ * @self: a ModestAccountMgr instance
+ * @account_name: The name of a server account.
+ *
+ * Gets the hostname this server account.
+ *
+ * Returns: The hostname.
+ */
+gchar* modest_account_mgr_get_server_account_hostname (ModestAccountMgr *self,
+ const gchar* account_name);
-void
-modest_account_mgr_free_server_account_data (ModestAccountMgr *self,
- ModestServerAccountData* data);
-
-#if 0
/**
- * modest_account_mgr_get_account_option:
+ * modest_server_account_modest_account_mgr_set_server_account_hostname:
* @self: a ModestAccountMgr instance
- * @account_name: the account name to check
- * @account_name: the option name to check
+ * @account_name: The name of a server account.
+ * @hostname: The new hostname
*
- * Returns: The account option value. This must be freed with g_free().
+ * Sets the hostname this server account.
*/
-gchar* modest_account_mgr_get_server_account_option (ModestAccountMgr *self,
- const gchar* account_name, const gchar* option_name);
+void modest_account_mgr_set_server_account_hostname (ModestAccountMgr *self,
+ const gchar* account_name,
+ const gchar *hostname);
/**
- * modest_server_account_data_get_option_value:
- * @options_list: a ModestServerAccountData::options list.
- * @option_name: the option name to check
+ * modest_account_mgr_get_server_account_secure_auth:
+ * @self: a ModestAccountMgr instance
+ * @account_name: The name of a server account.
+ *
+ * Gets the secure authentication method for this server account.
*
- * Returns: The account option value. This must be freed with g_free().
+ * Returns: The secure authentication enum value.
*/
-gchar* modest_server_account_data_get_option_string (GSList* options_list, const gchar* option_name);
+ModestAuthProtocol modest_account_mgr_get_server_account_secure_auth (ModestAccountMgr *self,
+ const gchar* account_name);
/**
- * modest_server_account_data_get_option_bool:
- * @options_list: a ModestServerAccountData::options list.
- * @option_name: the option name to check
+ * modest_server_account_data_get_secure_auth:
+ * @self: a ModestAccountMgr instance
+ * @account_name: The name of a server account.
+ * @secure_auth: The secure authentication enum value.
*
- * Returns: Whether the account option is present.
+ * Gets the secure authentication method for this server account.
*/
-gboolean modest_server_account_data_get_option_bool (GSList* options_list, const gchar* option_name);
-#endif
+void modest_account_mgr_set_server_account_secure_auth (ModestAccountMgr *self,
+ const gchar* account_name,
+ ModestAuthProtocol secure_auth);
+
+/**
+ * modest_server_account_data_get_security:
+ * @self: a ModestAccountMgr instance
+ * @account_name: The name of a server account.
+ *
+ * Gets the security method for this server account.
+ *
+ * Returns: The security enum value.
+ */
+ModestConnectionProtocol modest_account_mgr_get_server_account_security (ModestAccountMgr *self,
+ const gchar* account_name);
+
+/**
+ * modest_account_mgr_set_server_account_security:
+ * @self: a ModestAccountMgr instance
+ * @secure_auth: The security enum value.
+ *
+ * Gets the security method for this server account.
+ */
+void modest_account_mgr_set_server_account_security (ModestAccountMgr *self,
+ const gchar* account_name,
+ ModestConnectionProtocol security);
+
+ModestServerAccountData* modest_account_mgr_get_server_account_data (ModestAccountMgr *self,
+ const gchar* name);
+
+void modest_account_mgr_free_server_account_data (ModestAccountMgr *self,
+ ModestServerAccountData* data);
/**
* modest_account_mgr_get_from_string
* @self: a #ModestAccountMgr instance
* @name: the account name
*
- * get the From: string for some account; ie. "Foo Bar" <foo.bar@cuux.yy>"
+ * get the From: string for some account; ie. "Foo Bar" <foo.bar@cuux.yy>"
*
* Returns: the newly allocated from-string, or NULL in case of error
*/
*
* Returns: the newly allocated name.
*/
-gchar*
-modest_account_mgr_get_unused_account_name (ModestAccountMgr *self, const gchar* starting_name,
- gboolean server_account);
+gchar* modest_account_mgr_get_unused_account_name (ModestAccountMgr *self,
+ const gchar* starting_name,
+ gboolean server_account);
/**
* modest_account_mgr_get_unused_account_display name
*
* Returns: the newly allocated name.
*/
-gchar*
-modest_account_mgr_get_unused_account_display_name (ModestAccountMgr *self, const gchar* starting_name);
+gchar* modest_account_mgr_get_unused_account_display_name (ModestAccountMgr *self,
+ const gchar* starting_name);
+
+/**
+ * modest_account_mgr_set_server_account_security:
+ * @self: a ModestAccountMgr instance
+ * @secure_auth: The security enum value.
+ *
+ * Gets the security method for this server account.
+ */
+void modest_account_mgr_set_leave_on_server (ModestAccountMgr *self,
+ const gchar* account_name,
+ gboolean leave_on_server);
+
+gboolean modest_account_mgr_get_leave_on_server (ModestAccountMgr *self,
+ const gchar* account_name);
+
+gint modest_account_mgr_get_last_updated (ModestAccountMgr *self,
+ const gchar* account_name);
+
+void modest_account_mgr_set_last_updated (ModestAccountMgr *self,
+ const gchar* account_name,
+ gint time);
+
+gint modest_account_mgr_get_retrieve_limit (ModestAccountMgr *self,
+ const gchar* account_name);
+
+void modest_account_mgr_set_retrieve_limit (ModestAccountMgr *self,
+ const gchar* account_name,
+ gint limit_retrieve);
+
+gint modest_account_mgr_get_server_account_port (ModestAccountMgr *self,
+ const gchar* account_name);
+
+void modest_account_mgr_set_server_account_port (ModestAccountMgr *self,
+ const gchar *account_name,
+ gint port_num);
+
+gchar* modest_account_mgr_get_server_account_name (ModestAccountMgr *self,
+ const gchar *account_name,
+ TnyAccountType account_type);
+
+gchar* modest_account_mgr_get_retrieve_type (ModestAccountMgr *self,
+ const gchar *account_name);
+
+void modest_account_mgr_set_retrieve_type (ModestAccountMgr *self,
+ const gchar *account_name,
+ const gchar *retrieve_type);
+
+void modest_account_mgr_set_user_fullname (ModestAccountMgr *self,
+ const gchar *account_name,
+ const gchar *fullname);
+
+void modest_account_mgr_set_user_email (ModestAccountMgr *self,
+ const gchar *account_name,
+ const gchar *email);
G_END_DECLS