CDE/cde/lib/csa/api.c

/*
 * CDE - Common Desktop Environment
 *
 * Copyright (c) 1993-2012, The Open Group. All rights reserved.
 *
 * These libraries and programs are free software; you can
 * redistribute them and/or modify them under the terms of the GNU
 * Lesser General Public License as published by the Free Software
 * Foundation; either version 2 of the License, or (at your option)
 * any later version.
 *
 * These libraries and programs are distributed in the hope that
 * they will be useful, but WITHOUT ANY WARRANTY; without even the
 * implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
 * PURPOSE. See the GNU Lesser General Public License for more
 * details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with these libraries and programs; if not, write
 * to the Free Software Foundation, Inc., 51 Franklin Street, Fifth
 * Floor, Boston, MA 02110-1301 USA
 */
/* $XConsortium: api.c /main/1 1996/04/21 19:21:31 drk $ */
/*
 *  (c) Copyright 1993, 1994 Hewlett-Packard Company
 *  (c) Copyright 1993, 1994 International Business Machines Corp.
 *  (c) Copyright 1993, 1994 Novell, Inc.
 *  (c) Copyright 1993, 1994 Sun Microsystems, Inc.
 */

/*
 * Implements the calendar manager API functions.
 */

#include <EUSCompat.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <pwd.h>
#ifdef SunOS
#include <stropts.h>
#endif
#include "csa.h"
#include "agent_p.h"
#include "entry.h"
#include "rpccalls.h"
#include "connection.h"
#include "debug.h"
#include "attr.h"
#include "xtclient.h"
#include "misc.h"
#include "free.h"
#include "iso8601.h"
#include "match.h"

/******************************************************************************
 * forward declaration of static functions used within the file
 ******************************************************************************/
static CSA_return_code _handle_register_callback_ext(CSA_extension *ext);
static CSA_return_code _handle_logon_ext(CSA_extension *ext,
					CSA_extension **pext);
static CSA_return_code _handle_query_config_ext(CSA_extension *ext);
static void _handle_com_support_ext(CSA_extension *ext);

/******************************************************************************
 * Calendar Manager API
 ******************************************************************************/

/*
 * List calendars supported by a server
 */
extern CSA_return_code
csa_list_calendars(
	CSA_service_reference	calendar_service,
	CSA_uint32	*number_names,
	CSA_calendar_user	**calendar_names,
	CSA_extension	*list_calendars_extensions)
{
	DP(("api.c: csa_list_calendars\n"));

	if (calendar_service == NULL || number_names == NULL ||
	    calendar_names == NULL)
		return (CSA_E_INVALID_PARAMETER);

	/* no function extension is supported */
	if (list_calendars_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	return (_DtCm_rpc_list_calendars(calendar_service, number_names,
		calendar_names));
}

/*
 * Logon to a calendar.
 * Returns a calendar session handle.
 *
 * arguments not used by this implementation:
 * calendar_servce, password, character_set, caller_csa_version,
 * logon_extensions
 * 
 * arguments ignored for now
 * character_set, caller_csa_version
 *
 * user - only the calendar_address field is used, other fields are ignored
 *	- format is calendar_name@host
 */
extern CSA_return_code
csa_logon(
	CSA_service_reference	calendar_service,
	CSA_calendar_user	*user,
	CSA_string		password,
	CSA_string		character_set,
	CSA_string		caller_csa_version,
	CSA_session_handle	*session,
	CSA_extension		*logon_extensions)
{
	CSA_return_code	stat;
	Calendar	*cal;
	CSA_extension	*pext = NULL;

	DP(("api.c: csa_logon\n"));

	/* check validity of arguments */
	if (user == NULL || user->calendar_address == NULL || session == NULL
	   || strchr(user->calendar_address, '@') == NULL)
		return (CSA_E_INVALID_PARAMETER);

	/* create calendar object */
	if ((cal = _DtCm_new_Calendar(user->calendar_address)) == NULL) {
		return (CSA_E_INSUFFICIENT_MEMORY);
	}

	if (logon_extensions != NULL) {
		if ((stat = _handle_logon_ext(logon_extensions, &pext))
		    != CSA_SUCCESS)
			return (stat);
	}

	/* open calendar */
	if ((stat = _DtCm_rpc_open_calendar(cal)) == CSA_SUCCESS) {

		if (pext) pext->item_data = cal->access;

		*session = (CSA_session_handle)cal;

	} else {
		_DtCm_free_Calendar(cal);
	}

	return (stat);
}

/*
 * Create a calendar.
 *
 * arguments not used by this implementation:
 * session - always ignored
 * add_calendar_extensions
 * 
 * user - only the calendar_address field is used, other fields are ignored
 *	- format is calendar_name@host
 */
extern CSA_return_code
csa_add_calendar(
	CSA_session_handle	session,
	CSA_calendar_user	*user,
	CSA_uint32		number_attributes,
	CSA_attribute		*calendar_attributes,
	CSA_extension		*add_calendar_extensions)
{
	CSA_return_code	stat;
	Calendar	*cal;
	char		*host;

	DP(("api.c: csa_add_calendar\n"));

	/* check validity of arguments */
	if (user == NULL || user->calendar_address == NULL ||
	    (host = strchr(user->calendar_address, '@')) == NULL)
		return (CSA_E_INVALID_PARAMETER);

	/* check add_calendar_extensions and return appropriate return code */
	/* no function extension is supported */
	if (add_calendar_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* create calendar object */
	if ((cal = _DtCm_new_Calendar(user->calendar_address)) == NULL) {
		return (CSA_E_INSUFFICIENT_MEMORY);
	}

	host++;
	if ((stat = _DtCm_get_server_rpc_version(host, &cal->rpc_version))
	    != CSA_SUCCESS)
		return (stat);

	/* check validity of attributes */
	if (number_attributes > 0 &&
	    (stat = _DtCm_check_cal_csa_attributes(cal->rpc_version - 1,
	    number_attributes, calendar_attributes, user->calendar_address,
	    B_TRUE, B_TRUE, B_FALSE)) != CSA_SUCCESS) {
		return (stat);
	}

	/* create calendar */
	stat = _DtCm_rpc_create_calendar(cal, number_attributes,
		calendar_attributes);

	_DtCm_free_Calendar(cal);

	return (stat);
}

/*
 * Logoff a calendar.
 * The calendar handle becomes invalid
 *
 * argument not used by this implementation:
 * logoff_extensions
 */
extern CSA_return_code
csa_logoff(
	CSA_session_handle session,
	CSA_extension *logoff_extensions)
{
	Calendar	*cal;

	DP(("api.c: csa_logoff\n"));

	/* get calendar object */
	if ((cal = _DtCm_get_Calendar(session)) == NULL)
		return (CSA_E_INVALID_SESSION_HANDLE);

	/* check logoff_extensions and return appropriate return code */
	/* no function extension is supported */
	if (logoff_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* unregister with server */
	if (cal->all_reasons)
		(void) _DtCm_rpc_unregister_client(cal, cal->all_reasons);

	/* clean up */
	_DtCm_free_Calendar(cal);

	return (CSA_SUCCESS);
}

/*
 * delete calendar
 */
extern CSA_return_code
csa_delete_calendar(
	CSA_session_handle	session,
	CSA_extension	*delete_calendar_extensions)
{
	Calendar	*cal;

	DP(("api.c: csa_delete_calendar\n"));

	/* get calendar object */
	if ((cal = _DtCm_get_Calendar(session)) == NULL)
		return (CSA_E_INVALID_SESSION_HANDLE);

	/* check extensions and return appropriate return code */
	/* no function extension is supported */
	if (delete_calendar_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	if (cal->rpc_version < 5)
		return (CSA_E_NOT_SUPPORTED);

	return (_DtCm_rpc_delete_calendar(cal));
}

extern CSA_return_code
csa_list_calendar_attributes(
	CSA_session_handle	session,
	CSA_uint32	*number_names,
	CSA_attribute_reference	**calendar_attributes_names,
	CSA_extension	*list_calendar_attributes_extensions)
{
	Calendar	*cal;

	DP(("api.c: csa_list_calendar_attributes\n"));

	if (number_names == NULL || calendar_attributes_names == NULL)
		return (CSA_E_INVALID_PARAMETER);

	/* no function extension is supported */
	if (list_calendar_attributes_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* get calendar object */
	if ((cal = _DtCm_get_Calendar(session)) == NULL)
		return (CSA_E_INVALID_SESSION_HANDLE);

	if (cal->rpc_version < _DtCM_FIRST_EXTENSIBLE_SERVER_VERSION) {
		return (_DtCm_list_old_cal_attr_names(cal, number_names,
			calendar_attributes_names));
	} else
		return (_DtCm_rpc_list_calendar_attributes(cal, number_names,
			calendar_attributes_names));
}

extern CSA_return_code
csa_save(
	CSA_session_handle	session,
	CSA_string	archive_name,
	CSA_uint32	number_attributes,
	CSA_attribute	*attributes,
	CSA_enum	*operators,
	CSA_boolean	delete_entry,
	CSA_extension	*save_extensions)
{
	DP(("api.c: csa_save\n"));

	return (CSA_E_NOT_SUPPORTED);
}

extern CSA_return_code
csa_restore(
	CSA_session_handle	session,
	CSA_string	archive_name,
	CSA_uint32	number_attributes,
	CSA_attribute	*attributes,
	CSA_enum	*operators,
	CSA_extension	*restore_extensions)
{
	DP(("api.c: csa_restore\n"));

	return (CSA_E_NOT_SUPPORTED);
}

/*
 * If list_operators is NULL, the operator is default to be CSA_MATCH_EQUAL_TO
 * for all attributes.
 * *** might want to check operator for conflicts that won't result in no match
 */
extern CSA_return_code
csa_list_entries(
	CSA_session_handle	session,
	CSA_uint32	number_attributes,
	CSA_attribute	*entry_attributes,
	CSA_enum	*list_operators,
	CSA_uint32	*number_entries,
	CSA_entry_handle	**entries,
	CSA_extension	*list_entries_extensions)
{
	CSA_return_code		stat;
	Calendar		*cal;
	_DtCm_libentry		*elist;

	DP(("api.c: csa_list_entries\n"));

	if (entries == NULL || number_entries == NULL)
		return (CSA_E_INVALID_PARAMETER);
	else {
		*entries = NULL;
		*number_entries = 0;
	}

	/* check list_entries_extensions
	 * and return appropriate return code
	 * no function extension is supported
	 */
	if (list_entries_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* get calendar object */
	if ((cal = _DtCm_get_Calendar(session)) == NULL)
		return (CSA_E_INVALID_SESSION_HANDLE);

	if (list_operators && (stat = _DtCm_check_operator(number_attributes,
	    entry_attributes, NULL, list_operators)) != CSA_SUCCESS) {

		return (stat);
	}

	/* check data type */
	if ((stat = _DtCm_check_entry_attributes(cal->file_version,
	    number_attributes, entry_attributes, 0, B_FALSE)) != CSA_SUCCESS) {
		/*
		 * if attribute not supported by old backends
		 * are specified, just fail the match,
		 * i.e. return NULL and CSA_SUCCESS
		 */
		if (stat == CSA_E_UNSUPPORTED_ATTRIBUTE)
			stat = CSA_SUCCESS;

		return (stat);
	}

	/* lookup entries */
	if ((stat = _DtCm_rpc_lookup_entries(cal, number_attributes,
	    entry_attributes, list_operators, &elist)) == CSA_SUCCESS) {

		if (elist) {
			*number_entries = _DtCm_add_to_entry_list(cal, (caddr_t)elist);
			stat = _DtCm_libentry_to_entryh(elist, number_entries,
				entries);
		}
	}

	return (stat);
}

extern CSA_return_code
csa_list_entry_attributes(
	CSA_session_handle	session,
	CSA_entry_handle	entryh,
	CSA_uint32	*number_names,
	CSA_attribute_reference	**entry_attribute_names,
	CSA_extension	*list_entry_attributes_extensions)
{
	CSA_return_code	stat;
	_DtCm_libentry	*entry;

	DP(("api.c: csa_list_entry_attributes\n"));

	if (number_names == NULL || entry_attribute_names == NULL)
		return (CSA_E_INVALID_PARAMETER);

	/* check list_entry_attributes_extensions
	 * and return appropriate return code
	 * no function extension is supported
	 */
	if (list_entry_attributes_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* get appointment */
	if ((entry = _DtCm_get_libentry(entryh)) == NULL)
		return (CSA_E_INVALID_ENTRY_HANDLE);

	if ((stat = _DtCm_get_entry_detail(entry)) != CSA_SUCCESS)
		return (stat);

	return (_DtCm_get_entry_attr_names(entry, number_names,
		entry_attribute_names));
}


extern CSA_return_code
csa_read_entry_attributes(
	CSA_session_handle	session,
	CSA_entry_handle	entryh,
	CSA_uint32	number_names,
	CSA_attribute_reference	*attribute_names,
	CSA_uint32	*number_attributes,
	CSA_attribute	**entry_attributes,
	CSA_extension	*read_entry_attributes_extensions)
{
	CSA_return_code	stat;
	_DtCm_libentry	*entry;

	DP(("api.c: csa_read_entry_attributes\n"));

	if (number_attributes == 0 || entry_attributes == NULL)
		return (CSA_E_INVALID_PARAMETER);

	/* check read_entry_attributes_extensions
	 * and return appropriate return code
	 * no function extension is supported
	 */
	if (read_entry_attributes_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* get entry object */
	if ((entry = _DtCm_get_libentry(entryh)) == NULL)
		return (CSA_E_INVALID_ENTRY_HANDLE);

	if ((stat = _DtCm_get_entry_detail(entry)) != CSA_SUCCESS)
		return (stat);

	if (number_names > 0) {
		return (_DtCm_get_entry_attrs_by_name(entry, number_names,
			attribute_names, number_attributes, entry_attributes));
	} else {
		return (_DtCm_get_all_entry_attrs(entry, number_attributes,
			entry_attributes));
	}
}

extern CSA_return_code
csa_free(CSA_buffer memory)
{
	DP(("api.c: csa_free\n"));

	return (_DtCm_free(memory));
}

extern CSA_return_code
csa_look_up(
	CSA_session_handle	session,
	CSA_calendar_user	*users,
	CSA_flags	look_up_flags,
	CSA_uint32	*number_users,
	CSA_calendar_user	**user_list,
	CSA_extension	*look_up_extensions)
{
	DP(("api.c: csa_look_up\n"));

	return (CSA_E_NOT_SUPPORTED);
}

extern CSA_return_code
csa_query_configuration(
	CSA_session_handle	session,
	CSA_enum	item,
	CSA_buffer	*reference,
	CSA_extension	*query_configuration_extensions)
{
	CSA_return_code	stat = CSA_SUCCESS;
	Calendar	*cal;
	DP(("api.c: csa_query_configuration\n"));

	/* get calendar object */
	if ((cal = _DtCm_get_Calendar(session)) == NULL)
		return (CSA_E_INVALID_SESSION_HANDLE);

	if (item < CSA_CONFIG_CHARACTER_SET || item > CSA_CONFIG_VER_SPEC)
		return (CSA_E_INVALID_ENUM);

	if (reference == NULL)
		return (CSA_E_INVALID_PARAMETER);

	if (query_configuration_extensions) {
		if ((stat = _handle_query_config_ext(
		    query_configuration_extensions)) != CSA_SUCCESS)
			return (stat);
	}

	switch (item) {
	case CSA_CONFIG_DEFAULT_SERVICE:
	case CSA_CONFIG_DEFAULT_USER:
		*reference = NULL;
		break;

	case CSA_CONFIG_REQ_PASSWORD:
		*reference = (CSA_buffer)CSA_REQUIRED_NO;
		break;

	case CSA_CONFIG_REQ_SERVICE:
	case CSA_CONFIG_REQ_USER:
		*reference = (CSA_buffer)CSA_REQUIRED_YES;
		break;

	case CSA_CONFIG_UI_AVAIL:
		*reference = (CSA_buffer)CSA_FALSE;
		break;

	case CSA_CONFIG_VER_SPEC:
		*reference = (CSA_buffer)strdup(_DtCM_SPEC_VERSION_SUPPORTED);
		break;

	case CSA_CONFIG_CHARACTER_SET:
	case CSA_CONFIG_LINE_TERM:
	case CSA_CONFIG_VER_IMPLEM:
		stat = CSA_E_UNSUPPORTED_ENUM;
	}
	
	return (stat);
}

extern CSA_return_code
csa_read_calendar_attributes(
	CSA_session_handle	session,
	CSA_uint32	number_names,
	CSA_attribute_reference	*attribute_names,
	CSA_uint32	*number_attributes,
	CSA_attribute	**calendar_attributes,
	CSA_extension	*read_calendar_attributes_extensions)
{
	Calendar	*cal;

	DP(("api.c: csa_read_calendar_attributes\n"));

	if (number_attributes == 0 || calendar_attributes == NULL)
		return (CSA_E_INVALID_PARAMETER);

	/* check read_calendar_attributes_extensions
	 * and return appropriate return code
	 * no function extension is supported
	 */
	if (read_calendar_attributes_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* get calendar object */
	if ((cal = _DtCm_get_Calendar(session)) == NULL)
		return (CSA_E_INVALID_SESSION_HANDLE);

	_DtCm_reset_cal_attrs(cal);
	if (number_names > 0) {
		return (_DtCm_get_cal_attrs_by_name(cal, number_names,
			attribute_names, number_attributes,
			calendar_attributes));
	} else {
		return (_DtCm_get_all_cal_attrs(cal, number_attributes,
			calendar_attributes));
	}
}

extern CSA_return_code
csa_register_callback(
	CSA_session_handle	session,
	CSA_flags		reason,
	CSA_callback		callback,
	CSA_buffer		client_data,
	CSA_extension		*register_callback_extensions)
{
	CSA_return_code		stat = CSA_SUCCESS;
	_DtCmCallbackEntry	*cb_entry;
	Calendar		*cal;
	boolean_t		async = B_FALSE;

	/* get calendar object */
	if ((cal = _DtCm_get_Calendar(session)) == NULL)
		return (CSA_E_INVALID_SESSION_HANDLE);

	/* make sure some valid flags are set
	 * and only entry added, deleted or updated is specified for
	 * servers support up to version 4 rpc protocol
	 */
	if (reason == 0 || reason >= (CSA_CB_ENTRY_UPDATED << 1) ||
	    (cal->rpc_version < _DtCM_FIRST_EXTENSIBLE_SERVER_VERSION &&
	     (reason & ~(CSA_CB_ENTRY_ADDED|CSA_CB_ENTRY_DELETED|
	     CSA_CB_ENTRY_UPDATED))))
		return (CSA_E_INVALID_FLAG);

	/* must specify a callback function otherwise
	 * there is no point to make this call
	 */
	if (callback == NULL)
		return (CSA_E_INVALID_PARAMETER);

	/* need to initialize agent before doing XtAppAddInput */
	_DtCm_init_agent();

	if (register_callback_extensions != NULL) {
		if ((stat = _handle_register_callback_ext(
		    register_callback_extensions)) != CSA_SUCCESS)
			return (stat);
		else
			async = B_TRUE;
	}

	/*
	 * register interest only if we have a new flag
	 * NOTE: It's OK to register more than once, even if it's
	 * the same calendar, same reason.  The customer is always right.
	 */
	if (((cal->all_reasons | reason) ^ cal->all_reasons) &&
	    (stat = _DtCm_rpc_register_client(cal, reason)) != CSA_SUCCESS)
		return stat;

	if ((cb_entry = (_DtCmCallbackEntry*)malloc(sizeof(_DtCmCallbackEntry)))
	    == NULL)
		return (CSA_E_INSUFFICIENT_MEMORY);

	/* update info in calendar structure */
	cal->all_reasons |= reason;

	/* don't just do cal->async_process = async, since cal->async_process
	 * might have been set to B_TRUE before.
	 */
	if (async == B_TRUE)
		cal->async_process = B_TRUE;
	if (cal->async_process == B_TRUE)
		cal->do_reasons = cal->all_reasons;

	/* fill in the callback record */
	cb_entry->reason = reason;
	cb_entry->handler = callback;
	cb_entry->client_data = client_data;
	
	/* insert it at head of list */
	cb_entry->next = cal->cb_list;
	cb_entry->prev = (_DtCmCallbackEntry*) NULL;
	if (cal->cb_list != (_DtCmCallbackEntry*) NULL)
		cal->cb_list->prev = cb_entry;
	cal->cb_list = cb_entry;

	return CSA_SUCCESS;
}

/*
 * csa_unregister_callback
 *
 * removes a previsouly registered callback from the callback list
 * of the specified calendar.
 */
extern CSA_return_code
csa_unregister_callback(
	CSA_session_handle	session,
	CSA_flags		reason,
	CSA_callback		handler,
	CSA_buffer		client_data,
	CSA_extension		*unregister_callback_extensions)
{
	Calendar	*cal;
	boolean_t	match_one = B_FALSE;
	boolean_t	match_all = B_FALSE;
	boolean_t	matched;
	CSA_flags	all = 0, unreg;
	_DtCmCallbackEntry *cb, *ncb;

	/* get calendar object */
	if ((cal = _DtCm_get_Calendar(session)) == NULL)
		return (CSA_E_INVALID_SESSION_HANDLE);

	if (reason == 0 || reason >= (CSA_CB_ENTRY_UPDATED << 1))
		return (CSA_E_INVALID_FLAG);

	/* check unregister_callback_extensions
	 * and return appropriate return code
	 * no function extension is supported
	 */
	if (unregister_callback_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	if (handler == NULL && client_data == NULL)
		match_all = B_TRUE;
	else if (handler == NULL)	/* but client data is not NULL */
		return (CSA_E_INVALID_PARAMETER);

	/*
	 * Removal policy: If both handler and client data are NULL,
	 * match all callbacks for the specified reason.
	 * Otherwise, all of reason, handler and client data must
	 * match.
	 */
	cb = cal->cb_list;
	while (cb) {
		matched = B_TRUE;
		ncb = cb->next;

		if (!(reason & cb->reason) ||
		    (match_all == B_FALSE && (handler != cb->handler ||
		    client_data != cb->client_data))) {
			all = all | cb->reason;
			cb = cb->next;
			continue;
		}

		match_one = B_TRUE;

		if (cb->reason = (cb->reason | reason) ^ reason) {
			all = all | cb->reason;
		} else {
			/* remove entry */
			if (cb->prev != NULL)
				cb->prev->next = cb->next;
			if (cb->next != NULL)
				cb->next->prev = cb->prev;
			if (cb == cal->cb_list)
				cal->cb_list = cb->next;
			free(cb);
		}

		cb = ncb;
	}

	unreg = all ^ cal->all_reasons;
	cal->all_reasons = all;

	if (unreg)
		(void) _DtCm_rpc_unregister_client(cal, unreg);

	if (match_one == B_TRUE)
		return (CSA_SUCCESS);
	else
		return (CSA_E_CALLBACK_NOT_REGISTERED);
}

CSA_return_code
csa_call_callbacks(
	CSA_session_handle	session,
	CSA_flags		reason,
	CSA_extension		*call_callbacks_extensions)
{
	Calendar	*cal;

	DP(("api.c: csa_call_callbacks\n"));

	/* get calendar object */
	if ((cal = _DtCm_get_Calendar(session)) == NULL)
		return (CSA_E_INVALID_SESSION_HANDLE);

	/* no function extension is supported */
	if (call_callbacks_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* set up information in calendar structure */
	if (cal->async_process == B_FALSE)
		cal->do_reasons = reason;

	/* trigger callback mechanism */
	_DtCm_process_updates();

	if (cal->async_process == B_FALSE)
		cal->do_reasons = 0;

	return (CSA_SUCCESS);
}

extern CSA_return_code
csa_update_calendar_attributes(
	CSA_session_handle	session,
	CSA_uint32	num_attrs,
	CSA_attribute	*attrs,
	CSA_extension	*update_calendar_attributes_extensions)
{
	CSA_return_code	stat = CSA_SUCCESS;
	Calendar	*cal;

	DP(("api.c: csa_update_calendar_attributes\n"));

	/* get calendar object */
	if ((cal = _DtCm_get_Calendar(session)) == NULL)
		return (CSA_E_INVALID_SESSION_HANDLE);

	if (num_attrs == 0 || attrs == NULL)
		return (CSA_E_INVALID_PARAMETER);

	/*
	 * check update_calendar_attributes_extensions
	 * return appropriate return code
	 * no function extension is supported
	 */
	if (update_calendar_attributes_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* check authority */
	if ((cal->file_version >= _DtCM_FIRST_EXTENSIBLE_DATA_VERSION &&
	    !(cal->access & (CSA_OWNER_RIGHTS | CSA_INSERT_CALENDAR_ATTRIBUTES |
	    CSA_CHANGE_CALENDAR_ATTRIBUTES))) ||
	    (cal->file_version < _DtCM_FIRST_EXTENSIBLE_DATA_VERSION &&
	    !(cal->access & CSA_OWNER_RIGHTS)))
		return (CSA_E_NO_AUTHORITY);

	/* check data type */
	if ((stat = _DtCm_check_cal_csa_attributes(cal->file_version,
	    num_attrs, attrs, cal->name, B_TRUE, B_FALSE, B_TRUE))
	    != CSA_SUCCESS) {
		return (stat);
	}

	/* set attributes */
	stat = _DtCm_rpc_set_cal_attrs(cal, num_attrs, attrs);

	return (stat);
}

extern CSA_return_code
csa_add_entry(
	CSA_session_handle	session,
	CSA_uint32	num_attrs,
	CSA_attribute	*attrs,
	CSA_entry_handle	*entry_r,
	CSA_extension	*add_entry_extensions)
{
	CSA_return_code	stat;
	Calendar	*cal;
	_DtCm_libentry	*entry;

	DP(("api.c: csa_add_entry\n"));

	if (num_attrs == 0 || attrs == NULL)
		return (CSA_E_INVALID_PARAMETER);

	/* get calendar object */
	if ((cal = _DtCm_get_Calendar(session)) == NULL)
		return (CSA_E_INVALID_SESSION_HANDLE);

	/* check data type, readonly attributes, etc */
	if ((stat = _DtCm_check_entry_attributes(cal->file_version,
	    num_attrs, attrs, CSA_CB_ENTRY_ADDED, B_TRUE)) != CSA_SUCCESS) {
		return (stat);
	}

	/* no function extension is supported */
	if (add_entry_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* insert in calendar */
	if ((stat = _DtCm_rpc_insert_entry(cal, num_attrs, attrs, &entry))
	    == CSA_SUCCESS) {

		if (entry_r != NULL) {
			if ((entry = _DtCm_convert_entry_wheader(entry))==NULL)
				stat = CSA_E_INSUFFICIENT_MEMORY;
			else {
				_DtCm_add_to_entry_list(cal, (caddr_t)entry);
				*entry_r = (CSA_entry_handle)entry;
			}
		} else
			_DtCm_free_libentries(entry);
	}

	return (stat);
}

/*
 * The session argument is ignored in this implementation.
 */
extern CSA_return_code
csa_delete_entry(
	CSA_session_handle	session,
	CSA_entry_handle	entryh,
	CSA_enum	delete_scope,
	CSA_extension	*delete_entry_extensions)
{
	CSA_return_code	stat;
	_DtCm_libentry	*entry;

	DP(("api.c: csa_delete_entry\n"));

	/* get entry object */
	if ((entry = _DtCm_get_libentry(entryh)) == NULL)
		return (CSA_E_INVALID_ENTRY_HANDLE);

	if (delete_scope < CSA_SCOPE_ALL || delete_scope > CSA_SCOPE_FORWARD)
		return (CSA_E_INVALID_ENUM);

	/* check delete_entry_extensions and return appropriate return code */
	/* no function extension is supported */
	if (delete_entry_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* delete entry from calendar */
	stat = _DtCm_rpc_delete_entry(entry->cal, entry, delete_scope);

	return (stat);
}

extern CSA_return_code
csa_free_time_search(
	CSA_session_handle	session,
	CSA_date_time_range	date_time_range,
	CSA_time_duration	time_duration,
	CSA_uint32		number_users,
	CSA_calendar_user	*users,
	CSA_free_time	**free_time,
	CSA_extension	*free_time_search_extensions)
{
	DP(("api.c: csa_free_time_search\n"));

	return (CSA_E_NOT_SUPPORTED);
}

extern CSA_return_code
csa_list_entry_sequence(
	CSA_session_handle	session,
	CSA_entry_handle	entryh,
	CSA_date_time_range	time_range,
	CSA_uint32		*number_entries,
	CSA_entry_handle	**entries,
	CSA_extension	*list_entry_sequence_extensions)
{
	CSA_return_code	stat;
	_DtCm_libentry	*entry, *elist;
	cms_attribute	*rtype;
	cms_attribute	*rtimes;
	/* needed temporaryly */
	time_t start = 0, end = 0;

	DP(("api.c: csa_list_entry_sequence\n"));

	/* get entry object */
	if ((entry = _DtCm_get_libentry(entryh)) == NULL)
		return (CSA_E_INVALID_ENTRY_HANDLE);

	if (number_entries == NULL || entries == NULL)
		return (CSA_E_INVALID_PARAMETER);
	else {
		*number_entries = 0;
		*entries = NULL;
	}

	/* check whether this entry repeats */
	/* fail it if it's not a repeating event */
	if (entry->cal->file_version < _DtCM_FIRST_EXTENSIBLE_DATA_VERSION) {
		rtype = &entry->e->attrs[CSA_X_DT_ENTRY_ATTR_REPEAT_TYPE_I];
		if (rtype->value == NULL ||
	    	    rtype->value->item.sint32_value == CSA_X_DT_REPEAT_ONETIME)
		{
			return (CSA_E_INVALID_PARAMETER);
		}
	} else {
		rtype = &entry->e->attrs[CSA_ENTRY_ATTR_RECURRENCE_RULE_I];
		if (rtype->value == NULL ||
		    rtype->value->item.string_value == NULL ||
		    *(rtype->value->item.string_value) == '\0' ) {
			return (CSA_E_INVALID_PARAMETER);
		}
	}


	/* if this entry repeats indefinitely and time range is not
	 * specified, fail it
	 */
	if (time_range) {
		if (_csa_iso8601_to_range(time_range, &start, &end) != 0)
			return (CSA_E_INVALID_DATE_TIME);
	}

	if (entry->cal->file_version < _DtCM_FIRST_EXTENSIBLE_DATA_VERSION)
		rtimes = &entry->e->attrs[CSA_X_DT_ENTRY_ATTR_REPEAT_TIMES_I];
	else
		rtimes = &entry->e->attrs[CSA_ENTRY_ATTR_NUMBER_RECURRENCES_I];

	if (start == 0 && end == 0 &&
	    (rtimes->value && rtimes->value->item.uint32_value
	    == CSA_X_DT_DT_REPEAT_FOREVER))
		return (CSA_E_INVALID_PARAMETER);

	/* no function extension is supported */
	if (list_entry_sequence_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* lookup sequence */
	if ((stat = _DtCm_rpc_enumerate_sequence(entry->cal, entry, start, end,
	    &elist)) == CSA_SUCCESS) {

		if (elist) {
			*number_entries = _DtCm_add_to_entry_list(entry->cal,
					(caddr_t)elist);
			stat = _DtCm_libentry_to_entryh(elist, number_entries,
					entries);
		}
	}

	return (stat);
}

/*
 * Due to the implementation of existing backends (versions 2-4)
 * which will unmanage any reminders that happens before the
 * the given tick, the user specified tick is ignore and
 * we will pass in the current time.
 */
extern CSA_return_code
csa_read_next_reminder(
	CSA_session_handle	session,
	CSA_uint32	number_names,
	CSA_attribute_reference	*reminder_names,
	CSA_date_time	given_time,
	CSA_uint32	*number_reminders,
	CSA_reminder_reference	**reminders,
	CSA_extension	*read_next_reminder_extensions)
{
	CSA_return_code	stat;
	Calendar	*cal;
	_DtCm_libentry	*eptr, *prev = NULL, *head = NULL;
	int	i;
	time_t	timeval;

	DP(("api.c: csa_read_next_reminder\n"));

	/* get calendar object */
	if ((cal = _DtCm_get_Calendar(session)) == NULL)
		return (CSA_E_INVALID_SESSION_HANDLE);

	if (number_reminders == 0 || reminders == NULL)
		return (CSA_E_INVALID_PARAMETER);

	if (given_time == NULL || _csa_iso8601_to_tick(given_time, &timeval))
		return (CSA_E_INVALID_DATE_TIME);

	/*
	 * check read_next_reminder_extensions and
	 * return appropriate return code
	 * no function extension is supported
	 */
	if (read_next_reminder_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* lookup reminders */
	if ((stat = _DtCm_rpc_lookup_reminder(cal, timeval,
	    number_names, reminder_names, number_reminders, reminders))
	    == CSA_SUCCESS) {

		/*
		 * link up all associated entries
		 * and add to calendar structure
		 */
		for (i = 0; i < *number_reminders; i++) {
			eptr = (_DtCm_libentry *)((*reminders)[i]).entry;

			/* link entry back to cal */
			eptr->cal = cal;

			/* link up entries in the same order as
			 * the associated reminders
			 */
			if (head == NULL)
				head = eptr;
			else {
				prev->next = eptr;
				eptr->prev = prev;
			}
			prev = eptr;

		}

		(void)_DtCm_add_to_entry_list(cal, (caddr_t)head);
	}

	return (stat);
}

/*
 * These arguments are ignored in this implementation:
 * 	session, update_propagation
 */
extern CSA_return_code
csa_update_entry_attributes(
	CSA_session_handle	session,
	CSA_entry_handle	entry,
	CSA_enum		scope,
	CSA_boolean		update_propagation,
	CSA_uint32		num_attrs,
	CSA_attribute		*attrs,
	CSA_entry_handle	*new_entry,
	CSA_extension		*update_entry_attributes_extensions)
{
	CSA_return_code	stat;
	_DtCm_libentry	*oentry, *nentry;

	DP(("api.c: csa_update_entry_attributes\n"));

	/* get entry object */
	if ((oentry = _DtCm_get_libentry(entry)) == NULL)
		return (CSA_E_INVALID_ENTRY_HANDLE);

	if (scope < CSA_SCOPE_ALL || scope > CSA_SCOPE_FORWARD)
		return (CSA_E_INVALID_ENUM);

	if (num_attrs == 0 || attrs == NULL)
		return (CSA_E_INVALID_PARAMETER);

	/*
	 * check update_entry_attributes_extensions and
	 * return appropriate return code
	 * no function extension is supported
	 */
	if (update_entry_attributes_extensions != NULL)
		return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

	/* check data type, readonly attributes, etc */
	if ((stat = _DtCm_check_entry_attributes(oentry->cal->file_version,
	    num_attrs, attrs, CSA_CB_ENTRY_UPDATED, B_TRUE)) != CSA_SUCCESS) {
		return (stat);
	}

	/* change entry in calendar */
	if ((stat = _DtCm_rpc_update_entry(oentry->cal, oentry, num_attrs,
	    attrs, scope, &nentry)) == CSA_SUCCESS) {
		if (new_entry) {
			if ((nentry = _DtCm_convert_entry_wheader(nentry))
			    == NULL)
				stat = CSA_E_INSUFFICIENT_MEMORY;
			else {
				_DtCm_add_to_entry_list(oentry->cal,
					(caddr_t)nentry);
				*new_entry = (CSA_entry_handle)nentry;
			}
		} else
			_DtCm_free_libentries(nentry);
	}

	return (stat);
}

/* ADD EVENT */
extern CSA_return_code
csa_add_event(
	CSA_service_reference	calendar_service,
	CSA_string		calendar_address,
	CSA_string		logon_user,
	CSA_string		logon_password,
	CSA_string		attendee,
	CSA_enum		attendee_priority,
	CSA_enum		attendee_status,
	CSA_boolean		attendee_rsvp_requested,
	CSA_date_time		start_date,
	CSA_date_time		end_date,
	CSA_string		organizer,
	CSA_string		sponsor,
	CSA_string		summary,
	CSA_string		description,
	CSA_string		recurrence_rule,
	CSA_string		exception_rule,
	CSA_string		subtype,
	CSA_enum		classification,
	CSA_string		delimiters,
	CSA_string		add_event_extensions)
{
	DP(("api.c: csa_add_event\n"));

	return (CSA_E_NOT_SUPPORTED);
}

/* ADD TODO */
CSA_return_code
csa_add_todo(
	CSA_service_reference	calendar_service,
	CSA_string		calendar_address,
	CSA_string		logon_user,
	CSA_string		logon_password,
	CSA_enum		attendee_priority,
	CSA_enum		attendee_status,
	CSA_boolean		attendee_rsvp_requested,
	CSA_date_time		start_date,
	CSA_date_time		due_date,
	CSA_uint32		priority,
	CSA_string		summary,
	CSA_string		description,
	CSA_enum		classification,
	CSA_string		delimiters,
	CSA_string		add_todo_extensions)
{
	DP(("api.c: csa_add_todo\n"));

	return (CSA_E_NOT_SUPPORTED);
}

/* ADD MEMO */
CSA_return_code
csa_add_memo(
	CSA_service_reference	calendar_service,
	CSA_string		calendar_address,
	CSA_string		logon_user,
	CSA_string		logon_password,
	CSA_date_time		start_date,
	CSA_string		summary,
	CSA_string		delimiters,
	CSA_string		add_memo_extensions)
{
	DP(("api.c: csa_add_memo\n"));

	return (CSA_E_NOT_SUPPORTED);
}

/******************************************************************************
 * static functions used within in the file
 ******************************************************************************/

static CSA_return_code
_handle_register_callback_ext(CSA_extension *ext)
{
	int		i;

	for (i = 0; ; i++) {
		if (ext[i].item_code == CSA_X_XT_APP_CONTEXT_EXT) {
			_DtCm_register_xtcallback(
				(XtAppContext)ext[i].item_data);
		} else
			return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

		if (ext[i].extension_flags & CSA_EXT_LAST_ELEMENT)
			break;
	}

	return (CSA_SUCCESS);
}

static CSA_return_code
_handle_logon_ext(CSA_extension *ext, CSA_extension **pext)
{
	int		i;
	int		get_access_index = -1;
	int		com_support_index = -1;

	for (i = 0; ; i++) {
		if (ext[i].item_code == CSA_X_DT_GET_USER_ACCESS_EXT)
			get_access_index = i;
		else if (ext[i].item_code == CSA_X_COM_SUPPORT_EXT)
			com_support_index = i;
		else
			return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

		if (ext[i].extension_flags & CSA_EXT_LAST_ELEMENT)
			break;
	}

	if (get_access_index >= 0)
		*pext = &ext[get_access_index];

	if (com_support_index >= 0)
		_handle_com_support_ext(&ext[com_support_index]);

	return (CSA_SUCCESS);
}

static CSA_return_code
_handle_query_config_ext(CSA_extension *ext)
{
	int		i;
	int		com_support_index = -1;

	for (i = 0; ; i++) {
		if (ext[i].item_code == CSA_X_COM_SUPPORT_EXT) {
			com_support_index = i;
		} else
			return (CSA_E_UNSUPPORTED_FUNCTION_EXT);

		if (ext[i].extension_flags & CSA_EXT_LAST_ELEMENT)
			break;
	}

	if (com_support_index >= 0)
		_handle_com_support_ext(&ext[com_support_index]);

	return (CSA_SUCCESS);
}

static void
_handle_com_support_ext(CSA_extension *ext)
{
	int			i;
	CSA_X_COM_support	*xcom;

	for (i = 0, xcom = ext->item_reference; i < ext->item_data; i++) {
		switch (xcom[i].item_code) {
		case CSA_X_COM_SUPPORT_EXT:
		case CSA_X_XT_APP_CONTEXT_EXT:
		case CSA_XS_DT:
		case CSA_X_DT_GET_USER_ACCESS_EXT:
			xcom[i].flags = CSA_X_COM_SUPPORTED;
			break;

		case CSA_XS_COM:
		case CSA_X_UI_ID_EXT:
		default:
			xcom[i].flags = CSA_X_COM_NOT_SUPPORTED;
			break;
		}
	}
}