*
* A server-side module for Citadel which supports address book information
* using the standard vCard format.
- *
+ *
+ * Copyright (c) 1999-2001 / released under the GNU General Public License
*/
+/*
+ * Where we keep messages containing the vCards that source our directory. It
+ * makes no sense to change this, because you'd have to change it on every
+ * system on the network. That would be stupid.
+ */
#define ADDRESS_BOOK_ROOM "Global Address Book"
+/*
+ * Format of the "Extended ID" field of the message containing a user's
+ * vCard. Doesn't matter what it really looks like as long as it's both
+ * unique and consistent (because we use it for replication checking to
+ * delete the old vCard network-wide when the user enters a new one).
+ */
+#define VCARD_EXT_FORMAT "Citadel vCard: personal card for %s at %s"
+
+
#include "sysdep.h"
#include <stdlib.h>
#include <unistd.h>
#include "policy.h"
#include "database.h"
#include "msgbase.h"
+#include "internet_addressing.h"
#include "tools.h"
#include "vcard.h"
#define VC ((struct vcard_internal_info *)CtdlGetUserData(SYM_VCARD))
+/*
+ * Extract Internet e-mail addresses from a message containing a vCard, and
+ * perform a callback for any found.
+ */
+void vcard_extract_internet_addresses(struct CtdlMessage *msg,
+ void (*callback)(char *, char *) ) {
+ struct vCard *v;
+ char *s;
+ char *addr;
+ char citadel_address[SIZ];
+ int instance = 0;
+ int found_something = 0;
+
+ if (msg->cm_fields['A'] == NULL) return;
+ if (msg->cm_fields['N'] == NULL) return;
+ sprintf(citadel_address, "%s @ %s",
+ msg->cm_fields['A'], msg->cm_fields['N']);
+
+ v = vcard_load(msg->cm_fields['M']);
+ if (v == NULL) return;
+
+ /* Go through the vCard searching for *all* instances of
+ * the "email;internet" key
+ */
+ do {
+ s = vcard_get_prop(v, "email;internet", 0, instance++);
+ if (s != NULL) {
+ addr = strdoop(s);
+ striplt(addr);
+ if (strlen(addr) > 0) {
+ if (callback != NULL) {
+ callback(addr, citadel_address);
+ }
+ }
+ phree(addr);
+ found_something = 1;
+ }
+ else {
+ found_something = 0;
+ }
+ } while(found_something);
+
+ vcard_free(v);
+}
+
+/*
+ * Back end function for cmd_igab()
+ */
+void vcard_add_to_directory(long msgnum, void *data) {
+ struct CtdlMessage *msg;
+
+ msg = CtdlFetchMessage(msgnum);
+ if (msg != NULL) {
+ vcard_extract_internet_addresses(msg, CtdlDirectoryAddUser);
+ }
+
+ CtdlFreeMessage(msg);
+}
+
+
+/*
+ * Initialize Global Adress Book
+ */
+void cmd_igab(char *argbuf) {
+ char hold_rm[ROOMNAMELEN];
+
+ if (CtdlAccessCheck(ac_aide)) return;
+
+ strcpy(hold_rm, CC->quickroom.QRname); /* save current room */
+
+ if (getroom(&CC->quickroom, ADDRESS_BOOK_ROOM) != 0) {
+ getroom(&CC->quickroom, hold_rm);
+ cprintf("%d cannot get address book room\n", ERROR);
+ return;
+ }
+
+ /* Empty the existing database first.
+ */
+ CtdlDirectoryInit();
+
+ /* We want the last (and probably only) vcard in this room */
+ CtdlForEachMessage(MSGS_ALL, 0, (-127), "text/x-vcard",
+ NULL, vcard_add_to_directory, NULL);
+
+ getroom(&CC->quickroom, hold_rm); /* return to saved room */
+ cprintf("%d Directory has been rebuilt.\n", OK);
+}
+
+
+
/*
* This handler detects whether the user is attempting to save a new
* vCard as part of his/her personal configuration, and handles the replace
char config_rm[ROOMNAMELEN];
char buf[SIZ];
-
if (!CC->logged_in) return(0); /* Only do this if logged in. */
- TRACE;
/* If this isn't the configuration room, or if this isn't a MIME
* message, don't bother. (Check for NULL room first, otherwise
* some messages will cause it to crash!!)
*/
if (msg->cm_fields['O'] == NULL) return(0);
- TRACE;
if (strcasecmp(msg->cm_fields['O'], USERCONFIGROOM)) return(0);
- TRACE;
if (msg->cm_format_type != 4) return(0);
- TRACE;
ptr = msg->cm_fields['M'];
if (ptr == NULL) return(0);
- TRACE;
while (ptr != NULL) {
linelen = strcspn(ptr, "\n");
* to make changes to another user's vCard instead of
* assuming that it's always the user saving his own.
*/
- TRACE;
MailboxName(config_rm, &CC->usersupp, USERCONFIGROOM);
- TRACE;
CtdlDeleteMessages(config_rm, 0L, "text/x-vcard");
- TRACE;
/* Set the Extended-ID to a standardized one so the
* replication always works correctly
*/
if (msg->cm_fields['E'] != NULL)
phree(msg->cm_fields['E']);
- TRACE;
- sprintf(buf,
- "Citadel vCard: personal card for %s at %s",
+ sprintf(buf, VCARD_EXT_FORMAT,
msg->cm_fields['A'], NODENAME);
msg->cm_fields['E'] = strdoop(buf);
- TRACE;
/* Now allow the save to complete. */
- TRACE;
return(0);
}
- TRACE;
ptr = strchr((char *)ptr, '\n');
- TRACE;
if (ptr != NULL) ++ptr;
}
- TRACE;
return(0);
}
int linelen;
long I;
-
if (!CC->logged_in) return(0); /* Only do this if logged in. */
/* If this isn't the configuration room, or if this isn't a MIME
* copy it to the Global Address Book room.
*/
- TRACE;
I = atol(msg->cm_fields['I']);
- TRACE;
if (I < 0L) return(0);
+ /* Put it in the Global Address Book room... */
CtdlSaveMsgPointerInRoom(ADDRESS_BOOK_ROOM, I,
(SM_VERIFY_GOODNESS | SM_DO_REPL_CHECK) );
+ /* ...and also in the directory database. */
+ vcard_add_to_directory(I, NULL);
+
return(0);
}
/*
- * old style "enter registration info" command
+ * Old style "enter registration info" command. This function simply honors
+ * the REGI protocol command, translates the entered parameters into a vCard,
+ * and enters the vCard into the user's configuration.
*/
void cmd_regi(char *argbuf) {
int a,b,c;
if (!(CC->logged_in)) {
cprintf("%d Not logged in.\n",ERROR+NOT_LOGGED_IN);
return;
- }
+ }
my_vcard = vcard_get_user(&CC->usersupp);
strcpy(tmpaddr, "");
cprintf("%d Send registration...\n", SEND_LISTING);
a=0;
while (client_gets(buf), strcmp(buf,"000")) {
- if (a==0) vcard_set_prop(my_vcard, "n", buf);
- if (a==1) strcpy(tmpaddr,buf);
- if (a==2) strcpy(tmpcity,buf);
- if (a==3) strcpy(tmpstate,buf);
+ if (a==0) vcard_set_prop(my_vcard, "n", buf, 0);
+ if (a==1) strcpy(tmpaddr, buf);
+ if (a==2) strcpy(tmpcity, buf);
+ if (a==3) strcpy(tmpstate, buf);
if (a==4) {
for (c=0; c<strlen(buf); ++c) {
- if ((buf[c]>='0')&&(buf[c]<='9')) {
- b=strlen(tmpzip);
- tmpzip[b]=buf[c];
- tmpzip[b+1]=0;
- }
+ if ((buf[c]>='0') && (buf[c]<='9')) {
+ b = strlen(tmpzip);
+ tmpzip[b] = buf[c];
+ tmpzip[b+1] = 0;
}
}
- if (a==5) vcard_set_prop(my_vcard, "tel;home", buf);
- if (a==6) vcard_set_prop(my_vcard, "email;internet", buf);
+ }
+ if (a==5) vcard_set_prop(my_vcard, "tel;home", buf, 0);
+ if (a==6) vcard_set_prop(my_vcard, "email;internet", buf, 0);
if (a==7) strcpy(tmpcountry, buf);
++a;
- }
+ }
+
sprintf(tmpaddress, ";;%s;%s;%s;%s;%s",
tmpaddr, tmpcity, tmpstate, tmpzip, tmpcountry);
- vcard_set_prop(my_vcard, "adr", tmpaddress);
+ vcard_set_prop(my_vcard, "adr", tmpaddress, 0);
vcard_write_user(&CC->usersupp, my_vcard);
vcard_free(my_vcard);
CitControl.MMflags = CitControl.MMflags | MM_VALID ;
put_control();
end_critical_section(S_CONTROL);
- }
+}
/*
- * get registration info for a user
+ * Protocol command to fetch registration info for a user
*/
void cmd_greg(char *argbuf)
{
cprintf("%d %s\n", LISTING_FOLLOWS, usbuf.fullname);
cprintf("%ld\n", usbuf.usernum);
cprintf("%s\n", usbuf.password);
- s = vcard_get_prop(v, "n", 0);
+ s = vcard_get_prop(v, "n", 0, 0);
cprintf("%s\n", s ? s : " "); /* name */
- s = vcard_get_prop(v, "adr", 0);
+ s = vcard_get_prop(v, "adr", 0, 0);
sprintf(adr, "%s", s ? s : " ");/* address... */
extract_token(buf, adr, 2, ';');
extract_token(buf, adr, 5, ';');
cprintf("%s\n", buf); /* zip */
- s = vcard_get_prop(v, "tel;home", 0);
- if (s == NULL) s = vcard_get_prop(v, "tel", 1);
+ s = vcard_get_prop(v, "tel;home", 0, 0);
+ if (s == NULL) s = vcard_get_prop(v, "tel", 1, 0);
if (s != NULL) {
cprintf("%s\n", s);
- }
+ }
else {
cprintf(" \n");
}
cprintf("%d\n", usbuf.axlevel);
- s = vcard_get_prop(v, "email;internet", 0);
+ s = vcard_get_prop(v, "email;internet", 0, 0);
cprintf("%s\n", s ? s : " ");
- s = vcard_get_prop(v, "adr", 0);
+ s = vcard_get_prop(v, "adr", 0, 0);
sprintf(adr, "%s", s ? s : " ");/* address... */
extract_token(buf, adr, 6, ';');
cprintf("%s\n", buf); /* country */
cprintf("000\n");
- }
+}
/*
msg->cm_fields['N'] = strdoop(NODENAME);
msg->cm_fields['M'] = strdoop("Purge this vCard\n");
- sprintf(buf,
- "Citadel vCard: personal card for %s at %s",
- msg->cm_fields['A'], NODENAME);
+ sprintf(buf, VCARD_EXT_FORMAT, msg->cm_fields['A'], NODENAME);
msg->cm_fields['E'] = strdoop(buf);
msg->cm_fields['S'] = strdoop("CANCEL");
CtdlSubmitMsg(msg, NULL, ADDRESS_BOOK_ROOM);
CtdlFreeMessage(msg);
}
+
+
+/*
+ * Grab vCard directory stuff out of incoming network messages
+ */
+int vcard_extract_from_network(struct CtdlMessage *msg, char *target_room) {
+ char *ptr;
+ int linelen;
+
+ if (msg == NULL) return(0);
+
+ if (strcasecmp(target_room, ADDRESS_BOOK_ROOM)) {
+ return(0);
+ }
+
+ if (msg->cm_format_type != 4) return(0);
+
+ ptr = msg->cm_fields['M'];
+ if (ptr == NULL) return(0);
+ while (ptr != NULL) {
-
+ linelen = strcspn(ptr, "\n");
+ if (linelen == 0) return(0); /* end of headers */
+
+ if (!strncasecmp(ptr, "Content-type: text/x-vcard", 26)) {
+ /* It's a vCard. Add it to the directory. */
+ vcard_extract_internet_addresses(msg,
+ CtdlDirectoryAddUser);
+ return(0);
+ }
+
+ ptr = strchr((char *)ptr, '\n');
+ if (ptr != NULL) ++ptr;
+ }
+
+ return(0);
+}
+
+
+
+/*
+ * When a vCard is being removed from the Global Address Book room, remove it
+ * from the directory as well.
+ */
+void vcard_delete_remove(char *room, long msgnum) {
+ struct CtdlMessage *msg;
+
+ if (msgnum <= 0L) return;
+
+ if (strcasecmp(room, ADDRESS_BOOK_ROOM)) {
+ return;
+ }
+
+ msg = CtdlFetchMessage(msgnum);
+ if (msg != NULL) {
+ vcard_extract_internet_addresses(msg, CtdlDirectoryDelUser);
+ }
+
+ CtdlFreeMessage(msg);
+}
+
+
/*
CtdlRegisterSessionHook(vcard_session_startup_hook, EVT_START);
CtdlRegisterMessageHook(vcard_upload_beforesave, EVT_BEFORESAVE);
CtdlRegisterMessageHook(vcard_upload_aftersave, EVT_AFTERSAVE);
+ CtdlRegisterDeleteHook(vcard_delete_remove);
CtdlRegisterProtoHook(cmd_regi, "REGI", "Enter registration info");
CtdlRegisterProtoHook(cmd_greg, "GREG", "Get registration info");
+ CtdlRegisterProtoHook(cmd_igab, "IGAB",
+ "Initialize Global Address Book");
CtdlRegisterUserHook(vcard_purge, EVT_PURGEUSER);
+ CtdlRegisterNetprocHook(vcard_extract_from_network);
create_room(ADDRESS_BOOK_ROOM, 3, "", 0, 1);
return "$Id$";
}
-
-
-