account.h

/***************************************************************************
 SimpleMail - Copyright (C) 2000 Hynek Schlawack and Sebastian Bauer

 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation; either version 2 of the License, or
 (at your option) any later version.

 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
***************************************************************************/

/**
 * @file account.h
 */

#ifndef SM__ACCOUNT_H
#define SM__ACCOUNT_H

#ifndef SM__LISTS_H
#include "lists.h"
#endif

#ifndef SM__SMTP_H
#include "smtp.h"
#endif

#ifndef SM__POP3_H
#include "pop3.h"
#endif

#ifndef SM__IMAP_H
#include "imap.h"
#endif

#ifndef SM__CODESETS_H
#include "codesets.h"
#endif

struct folder;
struct imap_server;

/**
 * Holds all settings of an email account including SMTP, POP3, and IMAP4 settings.
 *
 * @brief Holds all settings of an email account.
 */
struct account
{
	/** Embedded node structure */
	struct node node;

	/** The name of the account that is presented to the user */
	utf8 *account_name;

	/** The name of the user */
	utf8 *name;

	/** The users eMail address */
	char *email;

	/** The reply-to address for this account */
	char *reply;

	/**
	 * Name of the default signature to use.
	 *
	 * @see signature.c
	 */
	char *def_signature;

	/** Which kind of receiving server? 0 POP3, 1 IMAP4 */
	int recv_type;

	/** POP3 server settings */
	struct pop3_server *pop;

	/** IMAP server settings */
	struct imap_server *imap;

	/** SMTP server settings */
	struct smtp_server *smtp;
};

/**
 * Allocates a new account.
 *
 * @return
 */
struct account *account_malloc(void);

/**
 * Duplicates an account.
 *
 * @param a
 * @return
 */
struct account *account_duplicate(struct account *a);

/**
 * Frees an account.
 *
 * @param a
 */
void account_free(struct account *a);

/**
 * Find an account by a given e-mail address.
 *
 * @param from
 * @return
 */
struct account *account_find_by_from(char *email);

/**
 * Find an imap server by the given folder using the accounts.
 *
 * @param f
 * @return
 */
struct imap_server *account_find_imap_server_by_folder(struct folder *f);

/**
 * Returns whether the server is trustworthy.
 * For the given server, the user specified fingerprint is compared
 * to the given fingerprint.
 *
 * @param server_name
 * @param fingerprint
 * @return
 */
int account_is_server_trustworthy(const char *server_name, const char *fingerprint);

/**
 * Trust the server for a single account.
 *
 * @param account
 * @param server_name
 * @param fingerprint
 * @return whether settings of the account has been changed (i.e., server was
 *  associated to the account somehow).
 */
int account_trust_server_for_single_account(struct account *account, const char *server_name, const char *fingerprint);

/**
 * Trust the given server for all accounts.
 *
 * @param server_name
 * @param fingerprint
 */
void account_trust_server(const char *server_name, const char *fingerprint);

/**
 * Returns whether the given account is an imap one.
 *
 * @param a the account to check
 * @return 1 if it is imap, otherwise 0.
 */
int account_is_imap(struct account *a);

#define account_find_by_number(number) \
	((struct account*)list_find(&user.config.account_list,number))

#endif