Page MenuHomePhorge
Files F120836466

mboxevent.h
No OneTemporary
Actions

Authored By
Unknown
Size
9 KB
Referenced Files
None
Subscribers
None

mboxevent.h
View Options

/* mboxevent.h -- interface for message store event notifications
*
* Copyright (c) 1994-2012 Carnegie Mellon University. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The name "Carnegie Mellon University" must not be used to
* endorse or promote products derived from this software without
* prior written permission. For permission or any legal
* details, please contact
* Carnegie Mellon University
* Center for Technology Transfer and Enterprise Creation
* 4615 Forbes Avenue
* Suite 302
* Pittsburgh, PA 15213
* (412) 268-7393, fax: (412) 268-7395
* innovation@andrew.cmu.edu
*
* 4. Redistributions of any form whatsoever must retain the following
* acknowledgment:
* "This product includes software developed by Computing Services
* at Carnegie Mellon University (http://www.cmu.edu/computing/)."
*
* CARNEGIE MELLON UNIVERSITY DISCLAIMS ALL WARRANTIES WITH REGARD TO
* THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
* AND FITNESS, IN NO EVENT SHALL CARNEGIE MELLON UNIVERSITY BE LIABLE
* FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
* AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
* OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*
* Author: Sébastien Michel from Atos Worldline
*/
#ifndef _MBOXEVENT_H
#define _MBOXEVENT_H
#include "strarray.h"
#include "mailbox.h"
#include "mboxname.h"
/*
* event types defined in RFC 5423 - Internet Message Store Events
*/
enum event_type {
EVENT_CANCELLED = (0),
/* Message Addition and Deletion */
EVENT_MESSAGE_APPEND = (1<<0),
EVENT_MESSAGE_EXPIRE = (1<<1),
EVENT_MESSAGE_EXPUNGE = (1<<2),
EVENT_MESSAGE_NEW = (1<<3),
EVENT_MESSAGE_COPY = (1<<4), /* additional event type to notify IMAP COPY */
EVENT_MESSAGE_MOVE = (1<<5), /* additional event type to notify IMAP MOVE */
EVENT_QUOTA_EXCEED = (1<<6),
EVENT_QUOTA_WITHIN = (1<<7),
EVENT_QUOTA_CHANGE = (1<<8),
/* Message Flags */
EVENT_MESSAGE_READ = (1<<9),
EVENT_MESSAGE_TRASH = (1<<10),
EVENT_FLAGS_SET = (1<<11),
EVENT_FLAGS_CLEAR = (1<<12),
/* Access Accounting */
EVENT_LOGIN = (1<<13),
EVENT_LOGOUT = (1<<14),
/* Mailbox Management */
EVENT_MAILBOX_CREATE = (1<<15),
EVENT_MAILBOX_DELETE = (1<<16),
EVENT_MAILBOX_RENAME = (1<<17),
EVENT_MAILBOX_SUBSCRIBE = (1<<18),
EVENT_MAILBOX_UNSUBSCRIBE = (1<<19),
EVENT_ACL_CHANGE = (1<<20)
};
/* The number representing the last available position in
* event_param, which should always be messageContent.
*/
#define MAX_PARAM 26
/*
* event parameters defined in RFC 5423 - Internet Message Store Events
*
* ordered to optimize the parsing of the notification message
*
* NOTE that the order here needs to be the exact same as the order in
* mboxevent.c's event_template mboxevent struct
*/
enum event_param {
/* 0 */ EVENT_TIMESTAMP,
/* 1 */ EVENT_SERVICE,
/* 2 */ EVENT_SERVER_ADDRESS, /* gather serverDomain and serverPort together */
/* 3 */ EVENT_CLIENT_ADDRESS, /* gather clientIP and clientPort together */
/* 4 */ EVENT_OLD_MAILBOX_ID,
/* 5 */ EVENT_OLD_UIDSET,
/* 6 */ EVENT_MAILBOX_ID,
/* 7 */ EVENT_URI,
/* 8 */ EVENT_MODSEQ,
/* 9 */ EVENT_DISK_QUOTA,
/* 10 */ EVENT_DISK_USED,
/* 11 */ EVENT_MAX_MESSAGES,
/* 12 */ EVENT_MESSAGES,
/* 13 */ EVENT_UNSEEN_MESSAGES,
/* 14 */ EVENT_UIDNEXT,
/* 15 */ EVENT_UIDSET,
/* 16 */ EVENT_MIDSET,
/* 17 */ EVENT_FLAG_NAMES,
/* 18 */ EVENT_PID,
/* 19 */ EVENT_ACL_SUBJECT,
/* 20 */ EVENT_ACL_RIGHTS,
/* 21 */ EVENT_USER,
/* 22 */ EVENT_MESSAGE_SIZE,
/* 23 */ EVENT_ENVELOPE,
/* 24 */ EVENT_SESSIONID,
/* 25 */ EVENT_BODYSTRUCTURE,
/* 26 */ EVENT_MESSAGE_CONTENT
};
enum event_param_type {
EVENT_PARAM_INT,
EVENT_PARAM_STRING,
EVENT_PARAM_ARRAY
};
struct event_parameter {
enum event_param id;
const char *name;
enum event_param_type type;
uint64_t value;
int filled;
};
struct mboxevent {
enum event_type type; /* event type */
/* array of event parameters */
struct event_parameter params[MAX_PARAM+1];
strarray_t flagnames;
struct timeval timestamp;
struct seqset *uidset;
strarray_t midset;
struct seqset *olduidset;
struct mboxevent *prev;
struct mboxevent *next;
};
/*
* Call this initializer once only at start
*/
void mboxevent_init();
/*
* Set the namespace to translate internal mailbox name to external name
*/
void mboxevent_setnamespace(struct namespace *n);
/*
* Create a new mboxevent structure for the given event type.
* Allocate resources for configured extra parameters.
*
* return the initialized event state or NULL if notification is disabled
*/
struct mboxevent *mboxevent_new(enum event_type type);
/*
* Create a new mboxevent structure for the given event type.
* Append this new structure at end of the given mboxevent list.
* Allocate resources for configured extra parameters.
*
* return the initialized event state or NULL if notification is disabled
*/
struct mboxevent *mboxevent_enqueue(enum event_type type,
struct mboxevent **events);
/*
* Send the queue of event notifications
*/
void mboxevent_notify(struct mboxevent *mboxevents);
/*
* Release any allocated resources of this given event
*/
void mboxevent_free(struct mboxevent **event);
/*
* Release any allocated resources of this given list of events
*/
void mboxevent_freequeue(struct mboxevent **event);
/*
* Add this set of system flags and user flags to flagNames parameter.
* Exclude flags present in event_exclude_flags setting.
*/
void mboxevent_add_flags(struct mboxevent *event, char *flagnames[MAX_USER_FLAGS],
bit32 system_flags, bit32 user_flags[MAX_USER_FLAGS/32]);
/*
* Add the given flag to flagNames parameter.
* event_exclude_flags doesn't apply here
*/
void mboxevent_add_flag(struct mboxevent *event, const char *flag);
/*
* Extract data related to message store access accounting
*/
void mboxevent_set_access(struct mboxevent *event,
const char *serveraddr, const char *clientaddr,
const char *userid, const char *mailboxname);
/*
* Shortcut to setting event notification parameters
*/
void mboxevent_set_acl(struct mboxevent *event, const char *identifier,
const char *rights);
/*
* Extract data from the given record to fill these event parameters :
* - uidset from UID
* - vnd.cmu.midset from Message-Id in ENVELOPE structure
* - messageSize
* - bodyStructure
*
* Called once per message and always before mboxevent_extract_mailbox
*/
void mboxevent_extract_record(struct mboxevent *event,
struct mailbox *mailbox,
struct index_record *record);
/*
* Fill event parameter about the copied message.
* Called once per message and always before mboxevent_extract_mailbox
*/
void mboxevent_extract_copied_record(struct mboxevent *event,
const struct mailbox *mailbox, uint32_t uid);
/*
* Extract message content to include to event notification
*/
void mboxevent_extract_content(struct mboxevent *event,
const struct index_record *record, FILE* content);
/*
* Extract quota limit, quota usage and quota root to include to event
* notification
*/
void mboxevent_extract_quota(struct mboxevent *event, const struct quota *quota,
enum quota_resource res);
/*
* Set the given number of unseen message if positive or scan the entire mailbox
* to count it.
*/
void mboxevent_set_numunseen(struct mboxevent *event, struct mailbox *mailbox,
int numunseen);
/*
* Extract meta-data from the given mailbox to fill mailboxID event parameter and
* optionally these ones depending the type of the event:
* - messages
* - uidnext
* - vnd.cmu.unseenMessages
*
* Must be called once per event or the notification will failed (Except for
* Login and Logout events)
* Mailbox must be locked to count the number of \Seen flags
*
* It is necessary to call this function after all changes on mailbox to get the
* right values of messages, uidnext and vnd.cmu.unseenMessages event parameters
*/
void mboxevent_extract_mailbox(struct mboxevent *event, struct mailbox *mailbox);
/*
* Extract meta-data from the given mailbox to fill oldMailboxID event parameter
*/
void mboxevent_extract_old_mailbox(struct mboxevent *event,
const struct mailbox *mailbox);
#endif /* _MBOXEVENT_H */

File Metadata

Mime Type
text/x-c
Expires
Fri, Apr 24, 1:30 PM (16 h, 11 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
18846094
Default Alt Text
mboxevent.h (9 KB)

Event Timeline