citadel/utils/ctdldump.c

   1 // Don't run this.  It doesn't work and if you try to run it you will immediately die.
   2 //
   3 // Copyright (c) 2023 by Art Cancro citadel.org
   4 //
   5 // This program is open source software.  Use, duplication, or disclosure
   6 // is subject to the terms of the GNU General Public License, version 3.
   7
   8 #include <stdlib.h>
   9 #include <unistd.h>
  10 #include <ctype.h>
  11 #include <stdio.h>
  12 #include <signal.h>
  13 #include <sys/types.h>
  14 #include <sys/socket.h>
  15 #include <sys/un.h>
  16 #include <netdb.h>
  17 #include <string.h>
  18 #include <pwd.h>
  19 #include <errno.h>
  20 #include <stdarg.h>
  21 #include <limits.h>
  22 #include <libcitadel.h>
  23 #include <zlib.h>
  24 #include <db.h>
  25 #include "../server/sysdep.h"
  26 #include "../server/citadel_defs.h"
  27 #include "../server/server.h"
  28 #include "../server/citadel_dirs.h"
  29
  30
  31 // Wrapper for realloc() that crashes and burns if the call fails.
  32 void *reallok(void *ptr, size_t size) {
  33         void *p = realloc(ptr, size);
  34         if (!p) {
  35                 fprintf(stderr, "realloc() failed to resize %p to %ld bytes, error: %m\n", ptr, size);
  36                 exit(1);
  37         }
  38         return p;
  39 }
  40 #define realloc reallok
  41
  42
  43 // convert a binary blob to hex (non-reentrant!!!)
  44 char *hexout(void *data, size_t len) {
  45         static char *outbuf = NULL;
  46         static size_t outlen = 0;
  47         int i;
  48         char ch;
  49
  50         if ((outbuf == NULL) || (outlen < (len * 2))) {
  51                 outbuf = reallok(outbuf, (len * 2));
  52                 outlen = len * 2;
  53         }
  54
  55         for (i=0; i<len; ++i) {
  56                 ch = 0;
  57                 memcpy(&ch, data+i, 1);
  58                 sprintf((outbuf + (i * 2)), "%02X", (int) ch);
  59         }
  60
  61         return(outbuf);
  62 }
  63
  64
  65 // Open a database environment
  66 DB_ENV *open_dbenv(char *dirname) {
  67
  68         DB_ENV *dbenv = NULL;
  69
  70         int ret;
  71         int i;
  72         u_int32_t flags = 0;
  73         int dbversion_major, dbversion_minor, dbversion_patch;
  74
  75         fprintf(stderr,
  76                 "db: open_dbenv() starting\n"
  77                 "db:    Linked zlib: %s\n"
  78                 "db: Compiled libdb: %s\n"
  79                 "db:   Linked libdb: %s\n",
  80                 zlibVersion(),
  81                 DB_VERSION_STRING,
  82                 db_version(&dbversion_major, &dbversion_minor, &dbversion_patch)
  83         );
  84
  85         // Create synthetic integer version numbers and compare them.
  86         // Never run with a libdb older than the one with which it was compiled.
  87         int compiled_db_version = ( (DB_VERSION_MAJOR * 1000000) + (DB_VERSION_MINOR * 1000) + (DB_VERSION_PATCH) );
  88         int linked_db_version = ( (dbversion_major * 1000000) + (dbversion_minor * 1000) + (dbversion_patch) );
  89         if (compiled_db_version > linked_db_version) {
  90                 fprintf(stderr, "db: ctdldump is running with a version of libdb older than the one with which it was compiled.\n"
  91                         "db: This is an invalid configuration.  ctdldump will now exit to prevent data loss.");
  92                 exit(CTDLEXIT_DB);
  93         }
  94
  95         fprintf(stderr, "db: Setting up DB environment\n");
  96         ret = db_env_create(&dbenv, 0);
  97         if (ret) {
  98                 fprintf(stderr, "db: db_env_create: %s\n", db_strerror(ret));
  99                 fprintf(stderr, "db: exit code %d\n", ret);
 100                 exit(CTDLEXIT_DB);
 101         }
 102
 103         // We want to specify the shared memory buffer pool cachesize, but everything else is the default.
 104         ret = dbenv->set_cachesize(dbenv, 0, 64 * 1024, 0);
 105         if (ret) {
 106                 fprintf(stderr, "db: set_cachesize: %s\n", db_strerror(ret));
 107                 dbenv->close(dbenv, 0);
 108                 fprintf(stderr, "db: exit code %d\n", ret);
 109                 exit(CTDLEXIT_DB);
 110         }
 111
 112         if ((ret = dbenv->set_lk_detect(dbenv, DB_LOCK_DEFAULT))) {
 113                 fprintf(stderr, "db: set_lk_detect: %s\n", db_strerror(ret));
 114                 dbenv->close(dbenv, 0);
 115                 fprintf(stderr, "db: exit code %d\n", ret);
 116                 exit(CTDLEXIT_DB);
 117         }
 118
 119         flags = DB_CREATE | DB_INIT_MPOOL | DB_PRIVATE | DB_INIT_LOG;
 120         fprintf(stderr, "db: dbenv open(dir=%s, flags=%d)\n", dirname, flags);
 121         ret = dbenv->open(dbenv, dirname, flags, 0);
 122         if (ret) {
 123                 fprintf(stderr, "db: dbenv->open: %s\n", db_strerror(ret));
 124                 dbenv->close(dbenv, 0);
 125                 fprintf(stderr, "db: exit code %d\n", ret);
 126                 exit(CTDLEXIT_DB);
 127         }
 128
 129         return(dbenv);
 130 }
 131
 132
 133 void close_dbenv(DB_ENV *dbenv) {
 134         int ret = dbenv->close(dbenv, 0);
 135         if (ret) {
 136                 fprintf(stderr, "db: dbenv->close: %s\n", db_strerror(ret));
 137         }
 138 }
 139
 140
 141 // export function for a message in msgmain
 142 void export_msgmain(int which_cdb, DBT *in_key, DBT *in_data) {
 143         long in_msgnum;
 144
 145         if (in_key->size != sizeof(long)) {
 146                 fprintf(stderr, "\033[31m\033[1m *** BAD DATA *** ABORTING *** \033[0m\n");
 147                 abort();
 148         }
 149
 150         memcpy(&in_msgnum, in_key->data, sizeof(in_msgnum));
 151
 152         // If the msgnum is negative, we are looking at METADATA
 153         if (in_msgnum < 0) {
 154                 struct MetaData *meta = (struct MetaData *)in_data->data;
 155                 printf("msgmeta|%ld|%d|%s|%ld\n",
 156                         meta->meta_msgnum,
 157                         meta->meta_refcount,
 158                         meta->meta_content_type,
 159                         meta->meta_rfc822_length
 160                 );
 161         }
 162
 163         // If the msgnum is positive, we are looking at a MESSAGE
 164         else if (in_msgnum > 0) {
 165                 printf("msgtext|%s\n", hexout(in_data->data, in_data->size));
 166         }
 167
 168         // If the msgnum is 0 it's probably not a valid record.
 169 }
 170
 171
 172 // export function for a user record
 173 void export_user(int which_cdb, DBT *in_key, DBT *in_data) {
 174
 175         struct ctdluser *user = (struct ctdluser *)in_data->data;
 176
 177         printf("user|%d|%d|%s|%u|%d|%ld|%ld|%d|%s|%ld|%ld|%s|%ld|%ld\n",
 178                 user->version,
 179                 user->uid,
 180                 user->password,
 181                 user->flags,
 182                 user->axlevel,
 183                 user->usernum,
 184                 user->lastcall,
 185                 user->USuserpurge,
 186                 user->fullname,
 187                 user->msgnum_bio,
 188                 user->msgnum_pic,
 189                 hexout(user->emailaddrs, strlen(user->emailaddrs)),
 190                 user->msgnum_inboxrules,
 191                 user->lastproc_inboxrules
 192         );
 193 }
 194
 195
 196 // export function for a room record
 197 void export_room(int which_cdb, DBT *in_key, DBT *in_data) {
 198
 199         struct ctdlroom *room = (struct ctdlroom *)in_data->data;
 200
 201         printf("room|%s|%s|%ld|%ld|%ld|%u|%s|%ld|%d|%ld|%d|%d|%ld|%d|%u|%d|%ld\n",
 202                 room->QRname,
 203                 room->QRpasswd,
 204                 room->QRroomaide,
 205                 room->QRhighest,
 206                 room->QRgen,
 207                 room->QRflags,
 208                 room->QRdirname,
 209                 room->msgnum_info,
 210                 room->QRfloor,
 211                 room->QRmtime,
 212                 room->QRep.expire_mode,
 213                 room->QRep.expire_value,
 214                 room->QRnumber,
 215                 room->QRorder,
 216                 room->QRflags2,
 217                 room->QRdefaultview,
 218                 room->msgnum_pic
 219         );
 220 }
 221
 222
 223 // export function for a floor record
 224 void export_floor(int which_cdb, DBT *in_key, DBT *in_data) {
 225
 226         int floor_num;
 227         memcpy(&floor_num, in_key->data, sizeof(int));
 228
 229         struct floor *floor = (struct floor *)in_data->data;
 230
 231         printf("floor|%d|%u|%s|%d|%d|%d\n",
 232                 floor_num,
 233                 floor->f_flags,
 234                 floor->f_name,
 235                 floor->f_ref_count,
 236                 floor->f_ep.expire_mode,
 237                 floor->f_ep.expire_value
 238         );
 239 }
 240
 241
 242 // export function for a msglist or a fulltext index record
 243 // (both are indexed by a long and the data is arrays of longs)
 244 void export_msglist(int which_cdb, DBT *in_key, DBT *in_data) {
 245         int i;
 246         int num_msgs;
 247         long msg;
 248
 249         // records are indexed by a single "long" and contains an array of zero or more "long"s
 250         long roomnum;
 251         memcpy(&roomnum, in_key->data, sizeof(long));
 252
 253         printf("msglist|%ld|", roomnum);
 254
 255         if (in_data->size > 0) {
 256                 num_msgs = in_data->size / sizeof(long);
 257                 for (i=0; i<num_msgs; ++i) {
 258                         memcpy(&msg, (in_data->data + (i * sizeof(long))), sizeof(long));
 259                         if (i != 0) {
 260                                 printf(",");
 261                         }
 262                         printf("%ld", msg);
 263                 }
 264         }
 265         printf("\n");
 266 }
 267
 268
 269 // export function for a visit record
 270 void export_visit(int which_cdb, DBT *in_key, DBT *in_data) {
 271         struct visit *visit = (struct visit *)in_data->data;
 272         printf("visit|%ld|%ld|%ld|%ld|%u|%s|%s|%d\n",
 273                 visit->v_roomnum,
 274                 visit->v_roomgen,
 275                 visit->v_usernum,
 276                 visit->v_lastseen,
 277                 visit->v_flags,
 278                 visit->v_seen,
 279                 visit->v_answered,
 280                 visit->v_view
 281         );
 282 }
 283
 284
 285 // export function for a directory record
 286 // (This is a secondary index -- should we just regenerate the data after import?)
 287 void export_dir(int which_cdb, DBT *in_key, DBT *in_data) {
 288         printf("dir|");
 289         fwrite(in_key->data, in_key->size, 1, stdout);
 290         printf("|");
 291         fwrite(in_data->data, in_data->size, 1, stdout);
 292         printf("\n");
 293 }
 294
 295
 296 // export function for a use table record
 297 void export_usetable(int which_cdb, DBT *in_key, DBT *in_data) {
 298         struct UseTable *u = (struct UseTable *)in_data->data;
 299         printf("use|%d|%ld\n", u->hash, u->timestamp);
 300 }
 301
 302
 303 #if 0
 304 // export function for large message texts
 305 void export_bigmsgs(int which_cdb, DBT *in_key, DBT *in_data, DBT *out_key, DBT *out_data) {
 306
 307         // The key is a packed long
 308         int32_t in_msgnum;
 309         long out_msgnum;
 310         memcpy(&in_msgnum, in_key->data, sizeof(in_msgnum));
 311         out_msgnum = (long)in_msgnum;
 312
 313         if (in_key->size != 4) {
 314                 fprintf(stderr, "\033[31m\033[1m *** SOURCE DATABASE IS NOT 32-BIT *** ABORTING *** \033[0m\n");
 315                 abort();
 316         }
 317
 318         out_key->size = sizeof(long);
 319         out_key->data = realloc(out_key->data, out_key->size);
 320         memcpy(out_key->data, &out_msgnum, sizeof(long));
 321
 322         // the data is binary-ish but has no packed integers
 323         out_data->size = in_data->size;
 324         out_data->data = realloc(out_data->data, out_data->size);
 325         memcpy(out_data->data, in_data->data, in_data->size);
 326
 327         // printf("\033[32m\033[1mBigmsg %ld , length %d\033[0m\n", out_msgnum, out_data->size);
 328 }
 329 #endif
 330
 331
 332 #if 0
 333 // export function for EUID Index records
 334 void export_euidindex(int which_cdb, DBT *in_key, DBT *in_data, DBT *out_key, DBT *out_data) {
 335
 336         // The structure of an euidindex record *key* is:
 337         // |----room_number----|----------EUID-------------|
 338         //    (sizeof long)       (actual length of euid)
 339
 340         // The structure of an euidindex record *value* is:
 341         // |-----msg_number----|----room_number----|----------EUID-------------|
 342         //    (sizeof long)       (sizeof long)       (actual length of euid)
 343
 344         int32_t in_msgnum = 0;
 345         int32_t in_roomnum = 0;
 346         char euid[SIZ];
 347         long out_msgnum = 0;
 348         long out_roomnum = 0;
 349
 350         memcpy(&in_msgnum, in_data->data, sizeof(in_msgnum));
 351         memcpy(&in_roomnum, in_data->data+sizeof(int32_t), sizeof(in_msgnum));
 352         strcpy(euid, in_data->data+(sizeof(int32_t)*2));
 353
 354         out_msgnum = (long) in_msgnum;
 355         out_roomnum = (long) in_roomnum;
 356         // printf("euidindex: msgnum=%ld, roomnum=%ld, euid=\"%s\"\n", out_msgnum, out_roomnum, euid);
 357
 358         out_key->size = sizeof(long) + strlen(euid) + 1;
 359         out_key->data = realloc(out_key->data, out_key->size);
 360         memcpy(out_key->data, &out_roomnum, sizeof(out_roomnum));
 361         strcpy(out_key->data+sizeof(out_roomnum), euid);
 362
 363         out_data->size = sizeof(long) + sizeof(long) + strlen(euid) + 1;
 364         out_data->data = realloc(out_data->data, out_data->size);
 365         memcpy(out_data->data, &out_msgnum, sizeof(out_msgnum));
 366         memcpy(out_data->data+sizeof(out_msgnum), &out_roomnum, sizeof(out_roomnum));
 367         strcpy(out_data->data+sizeof(out_msgnum)+sizeof(out_roomnum), euid);
 368 }
 369 #endif
 370
 371
 372 #if 0
 373 // export users-by-number records
 374 // (This is a secondary index -- should we just regenerate the data after import?)
 375 void export_usersbynumber(int which_cdb, DBT *in_key, DBT *in_data, DBT *out_key, DBT *out_data) {
 376
 377         // key is a long
 378         // and remember ... "long" is int32_t on the source system
 379         int32_t in_usernum;
 380         long out_usernum;
 381         memcpy(&in_usernum, in_key->data, sizeof(in_usernum));
 382         out_usernum = (long) in_usernum;
 383
 384         if (in_key->size != 4) {
 385                 fprintf(stderr, "\033[31m\033[1m *** SOURCE DATABASE IS NOT 32-BIT *** ABORTING *** \033[0m\n");
 386                 abort();
 387         }
 388
 389         out_key->size = sizeof(out_usernum);
 390         out_key->data = realloc(out_key->data, out_key->size);
 391         memcpy(out_key->data, &out_usernum, sizeof(out_usernum));
 392
 393         // value is a string
 394         out_data->size = in_data->size;
 395         out_data->data = realloc(out_data->data, out_data->size);
 396         memcpy(out_data->data, in_data->data, in_data->size);
 397
 398         // printf("usersbynumber: %ld --> %s\n", out_usernum, (char *)out_data->data);
 399 }
 400 #endif
 401
 402
 403 #if 0
 404 // export function for a config record
 405 void export_config(int which_cdb, DBT *in_key, DBT *in_data, DBT *out_key, DBT *out_data) {
 406
 407         // the key is a string
 408         out_key->size = in_key->size;
 409         out_key->data = realloc(out_key->data, out_key->size + 1);
 410         memcpy(out_key->data, in_key->data, in_key->size);
 411         char *k = (char *)out_key->data;
 412         k[out_key->size] = 0;
 413
 414         // the data is a pair of strings
 415         out_data->size = in_data->size;
 416         out_data->data = realloc(out_data->data, out_data->size + 1);
 417         memcpy(out_data->data, in_data->data, in_data->size);
 418         char *d = (char *)out_data->data;
 419         d[out_data->size] = 0;
 420
 421         // please excuse my friend, he isn't null terminated
 422         // printf("\033[32m\033[1mConfig entry: %s -> %s\033[0m\n", (char *)out_key->data, (char *)out_data->data+strlen(out_data->data)+1);
 423 }
 424 #endif
 425
 426
 427 // For obsolete databases, zero all the output
 428 void zero_function(int which_cdb, DBT *in_key, DBT *in_data) {
 429         // do nothing
 430 }
 431
 432
 433 void (*export_functions[])(int which_cdb, DBT *in_key, DBT *in_data) = {
 434         export_msgmain,         // CDB_MSGMAIN
 435         export_user,            // CDB_USERS
 436         export_room,            // CDB_ROOMS
 437         export_floor,           // CDB_FLOORTAB
 438         export_msglist,         // CDB_MSGLISTS
 439         export_visit,           // CDB_VISIT
 440         export_dir,             // CDB_DIRECTORY
 441         export_usetable,        // CDB_USETABLE
 442         zero_function,          // CDB_BIGMSGS
 443         zero_function,          // CDB_FULLTEXT
 444         zero_function,          // CDB_EUIDINDEX
 445         zero_function,          // CDB_USERSBYNUMBER
 446         zero_function,          // CDB_UNUSED1 (obsolete)
 447         zero_function           // CDB_CONFIG
 448 };
 449
 450
 451 void export_table(int which_cdb, DB_ENV *src_dbenv) {
 452         int ret;
 453         int compressed;
 454         char dbfilename[32];
 455         uLongf destLen = 0;
 456
 457         // shamelessly swiped from https://docs.oracle.com/database/bdb181/html/programmer_reference/am_cursor.html
 458         DB *src_dbp;
 459         DBC *src_dbcp;
 460         DBT in_key, in_data, uncomp_data;
 461         int num_good_rows = 0;
 462         int num_bad_rows = 0;
 463
 464         snprintf(dbfilename, sizeof dbfilename, "cdb.%02x", which_cdb);
 465
 466         // create a database handle for the source table
 467         ret = db_create(&src_dbp, src_dbenv, 0);
 468         if (ret) {
 469                 fprintf(stderr, "db: db_create: %s\n", db_strerror(ret));
 470                 fprintf(stderr, "db: exit code %d\n", ret);
 471                 exit(CTDLEXIT_DB);
 472         }
 473
 474         // open the file containing the source table
 475         ret = src_dbp->open(src_dbp, NULL, dbfilename, NULL, DB_BTREE, 0, 0600);
 476         if (ret) {
 477                 fprintf(stderr, "db: db_open: %s\n", db_strerror(ret));
 478                 fprintf(stderr, "db: exit code %d\n", ret);
 479                 exit(CTDLEXIT_DB);
 480         }
 481
 482         // Acquire a cursor to read the source table
 483         if ((ret = src_dbp->cursor(src_dbp, NULL, &src_dbcp, 0)) != 0) {
 484                 fprintf(stderr, "db: db_cursor: %s\n", db_strerror(ret));
 485                 fprintf(stderr, "db: exit code %d\n", ret);
 486                 exit(CTDLEXIT_DB);
 487         }
 488
 489         // Zero out these database keys
 490         memset(&in_key,         0, sizeof(DBT));        // input
 491         memset(&in_data,        0, sizeof(DBT));
 492         memset(&uncomp_data,    0, sizeof(DBT));        // decompressed input (the key doesn't change)
 493
 494         // Walk through the database, calling export functions as we go and clearing buffers before each call.
 495         while (ret = src_dbcp->get(src_dbcp, &in_key, &in_data, DB_NEXT) == 0) {
 496
 497                 // If either the key or data are zero length, skip this record
 498                 if ((in_key.size == 0) || (in_data.size == 0)) {
 499                         ++num_bad_rows;
 500                 }
 501
 502                 else {  // Both key and data are >0 length so we're good to go
 503
 504                         // Do we need to decompress?
 505                         static int32_t magic = COMPRESS_MAGIC;
 506                         compressed = 0;
 507                         if ((in_data.size >= sizeof(struct CtdlCompressHeader)) && (!memcmp(in_data.data, &magic, sizeof(magic)))) {
 508
 509                                 // yes, we need to decompress
 510                                 compressed = 1;
 511                                 struct CtdlCompressHeader comp;
 512                                 memcpy(&comp, in_data.data, sizeof(struct CtdlCompressHeader));
 513                                 uncomp_data.size = comp.uncompressed_len;
 514                                 uncomp_data.data = realloc(uncomp_data.data, uncomp_data.size);
 515                                 destLen = (uLongf)comp.uncompressed_len;
 516
 517                                 ret = uncompress((Bytef *)uncomp_data.data, (uLongf *)&destLen,
 518                                                 (const Bytef *)in_data.data+sizeof(struct CtdlCompressHeader),
 519                                                 (uLong)comp.compressed_len);
 520                                 if (ret != Z_OK) {
 521                                         fprintf(stderr, "db: uncompress() error %d\n", ret);
 522                                         exit(CTDLEXIT_DB);
 523                                 }
 524                         }
 525
 526                         // Call the export function registered to this table
 527                         export_functions[which_cdb](which_cdb, &in_key, (compressed ? &uncomp_data : &in_data));
 528
 529                         // Knowing the total number of rows isn't critical to the program.  It's just for the user to know.
 530                         fflush(stdout);
 531                 }
 532         }
 533
 534         // free any leftover out_data pointers
 535         free(uncomp_data.data);
 536
 537         // ...and close the database (table)
 538         ret = src_dbp->close(src_dbp, 0);
 539         if (ret) {
 540                 fprintf(stderr, "db: db_close: %s\n", db_strerror(ret));
 541         }
 542
 543
 544 }
 545
 546
 547 int main(int argc, char **argv) {
 548         int i = 0;
 549         char *src_dir = NULL;
 550         char *dst_dir = NULL;
 551         int confirmed = 0;
 552         static DB_ENV *src_dbenv;               // Source DB environment (global)
 553
 554         // Parse command line
 555         int a;
 556         while ((a = getopt(argc, argv, "h:d:y")) != EOF) {
 557                 switch (a) {
 558                 case 'h':
 559                         src_dir = optarg;
 560                         break;
 561                 case 'd':
 562                         dst_dir = optarg;
 563                         break;
 564                 case 'y':
 565                         confirmed = 1;
 566                         break;
 567                 default:
 568                         fprintf(stderr, "%s: usage: %s -s source_dir -d dest_dir\n", argv[0], argv[0]);
 569                         exit(2);
 570                 }
 571         }
 572
 573         // Warn the user
 574         fprintf(stderr, "------------------------------------------------------------------------\n");
 575         fprintf(stderr, "This utility must be run while the server is NOT RUNNING.               \n");
 576         fprintf(stderr, "We \033[1mguarantee\033[0m data corruption if you do not                              \n");
 577         fprintf(stderr, "observe this warning!  The source [-s] directory should contain a copy  \n");
 578         fprintf(stderr, "of the database from your source system.  The dump [-d] directory       \n");
 579         fprintf(stderr, "should be empty and will receive your dump file.                        \n");
 580         fprintf(stderr, "------------------------------------------------------------------------\n");
 581         fprintf(stderr, " Source (database) directory: %s\n", src_dir);
 582         fprintf(stderr, "------------------------------------------------------------------------\n");
 583
 584         if (confirmed == 1) {
 585                 fprintf(stderr, "You have specified the [-y] flag, so processing will continue.\n");
 586         }
 587         else {
 588                 fprintf(stderr, "Please read [ https://www.citadel.org/ctdldump.html ] to learn how to proceed.\n");
 589                 exit(0);
 590         }
 591
 592         src_dbenv = open_dbenv(src_dir);
 593         for (i = 0; i < MAXCDB; ++i) {
 594                 export_table(i, src_dbenv);
 595         }
 596         close_dbenv(src_dbenv);
 597
 598         exit(0);
 599 }