citadel/modules/ctdlproto/serv_user.c

   1 /*
   2  * Server functions which perform operations on user objects.
   3  *
   4  * Copyright (c) 1987-2017 by the citadel.org team
   5  *
   6  * This program is open source software; you can redistribute it and/or
   7  * modify it under the terms of the GNU General Public License, version 3.
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  */
  14
  15
  16 #include "support.h"
  17 #include "control.h"
  18 #include "ctdl_module.h"
  19 #include "citserver.h"
  20 #include "config.h"
  21 #include "user_ops.h"
  22 #include "internet_addressing.h"
  23
  24
  25 /*
  26  * USER cmd
  27  */
  28 void cmd_user(char *cmdbuf)
  29 {
  30         char username[256];
  31         int a;
  32
  33         extract_token(username, cmdbuf, 0, '|', sizeof username);
  34         striplt(username);
  35         syslog(LOG_DEBUG, "user_ops: cmd_user(%s)", username);
  36
  37         a = CtdlLoginExistingUser(NULL, username);
  38         switch (a) {
  39         case login_already_logged_in:
  40                 cprintf("%d Already logged in.\n", ERROR + ALREADY_LOGGED_IN);
  41                 return;
  42         case login_too_many_users:
  43                 cprintf("%d %s: "
  44                         "Too many users are already online "
  45                         "(maximum is %d)\n",
  46                         ERROR + MAX_SESSIONS_EXCEEDED,
  47                         CtdlGetConfigStr("c_nodename"), CtdlGetConfigInt("c_maxsessions"));
  48                 return;
  49         case login_ok:
  50                 cprintf("%d Password required for %s\n",
  51                         MORE_DATA, CC->curr_user);
  52                 return;
  53         case login_not_found:
  54                 cprintf("%d %s not found.\n", ERROR + NO_SUCH_USER, username);
  55                 return;
  56         default:
  57                 cprintf("%d Internal error\n", ERROR + INTERNAL_ERROR);
  58         }
  59 }
  60
  61
  62 void cmd_pass(char *buf)
  63 {
  64         char password[SIZ];
  65         int a;
  66         long len;
  67
  68         memset(password, 0, sizeof(password));
  69         len = extract_token(password, buf, 0, '|', sizeof password);
  70         a = CtdlTryPassword(password, len);
  71
  72         switch (a) {
  73         case pass_already_logged_in:
  74                 cprintf("%d Already logged in.\n", ERROR + ALREADY_LOGGED_IN);
  75                 return;
  76         case pass_no_user:
  77                 cprintf("%d You must send a name with USER first.\n",
  78                         ERROR + USERNAME_REQUIRED);
  79                 return;
  80         case pass_wrong_password:
  81                 cprintf("%d Wrong password.\n", ERROR + PASSWORD_REQUIRED);
  82                 return;
  83         case pass_ok:
  84                 logged_in_response();
  85                 return;
  86         }
  87 }
  88
  89
  90 /*
  91  * cmd_newu()  -  create a new user account and log in as that user
  92  */
  93 void cmd_newu(char *cmdbuf)
  94 {
  95         int a;
  96         long len;
  97         char username[SIZ];
  98
  99         if (CtdlGetConfigInt("c_auth_mode") != AUTHMODE_NATIVE) {
 100                 cprintf("%d This system does not use native mode authentication.\n",
 101                         ERROR + NOT_HERE);
 102                 return;
 103         }
 104
 105         if (CtdlGetConfigInt("c_disable_newu")) {
 106                 cprintf("%d Self-service user account creation "
 107                         "is disabled on this system.\n", ERROR + NOT_HERE);
 108                 return;
 109         }
 110
 111         if (CC->logged_in) {
 112                 cprintf("%d Already logged in.\n", ERROR + ALREADY_LOGGED_IN);
 113                 return;
 114         }
 115         if (CC->nologin) {
 116                 cprintf("%d %s: Too many users are already online (maximum is %d)\n",
 117                         ERROR + MAX_SESSIONS_EXCEEDED,
 118                         CtdlGetConfigStr("c_nodename"), CtdlGetConfigInt("c_maxsessions"));
 119                 return;
 120         }
 121         extract_token(username, cmdbuf, 0, '|', sizeof username);
 122         strproc(username);
 123         len = cutuserkey(username);
 124
 125         if (IsEmptyStr(username)) {
 126                 cprintf("%d You must supply a user name.\n", ERROR + USERNAME_REQUIRED);
 127                 return;
 128         }
 129
 130         if ((!strcasecmp(username, "bbs")) ||
 131             (!strcasecmp(username, "new")) ||
 132             (!strcasecmp(username, "."))) {
 133                 cprintf("%d '%s' is an invalid login name.\n", ERROR + ILLEGAL_VALUE, username);
 134                 return;
 135         }
 136
 137         a = create_user(username, len, 1);
 138
 139         if (a == 0) {
 140                 logged_in_response();
 141         } else if (a == ERROR + ALREADY_EXISTS) {
 142                 cprintf("%d '%s' already exists.\n",
 143                         ERROR + ALREADY_EXISTS, username);
 144                 return;
 145         } else if (a == ERROR + INTERNAL_ERROR) {
 146                 cprintf("%d Internal error - user record disappeared?\n",
 147                         ERROR + INTERNAL_ERROR);
 148                 return;
 149         } else {
 150                 cprintf("%d unknown error\n", ERROR + INTERNAL_ERROR);
 151         }
 152 }
 153
 154
 155 /*
 156  * set password - citadel protocol implementation
 157  */
 158 void cmd_setp(char *new_pw)
 159 {
 160         if (CtdlAccessCheck(ac_logged_in)) {
 161                 return;
 162         }
 163         if ( (CC->user.uid != CTDLUID) && (CC->user.uid != (-1)) ) {
 164                 cprintf("%d Not allowed.  Use the 'passwd' command.\n", ERROR + NOT_HERE);
 165                 return;
 166         }
 167         if (CC->is_master) {
 168                 cprintf("%d The master prefix password cannot be changed with this command.\n",
 169                         ERROR + NOT_HERE);
 170                 return;
 171         }
 172
 173         if (!strcasecmp(new_pw, "GENERATE_RANDOM_PASSWORD")) {
 174                 char random_password[17];
 175                 snprintf(random_password, sizeof random_password, "%08lx%08lx", random(), random());
 176                 CtdlSetPassword(random_password);
 177                 cprintf("%d %s\n", CIT_OK, random_password);
 178         }
 179         else {
 180                 strproc(new_pw);
 181                 if (IsEmptyStr(new_pw)) {
 182                         cprintf("%d Password unchanged.\n", CIT_OK);
 183                         return;
 184                 }
 185                 CtdlSetPassword(new_pw);
 186                 cprintf("%d Password changed.\n", CIT_OK);
 187         }
 188 }
 189
 190
 191 /*
 192  * cmd_creu() - administratively create a new user account (do not log in to it)
 193  */
 194 void cmd_creu(char *cmdbuf)
 195 {
 196         int a;
 197         long len;
 198         char username[SIZ];
 199         char password[SIZ];
 200         struct ctdluser tmp;
 201
 202         if (CtdlAccessCheck(ac_aide)) {
 203                 return;
 204         }
 205
 206         extract_token(username, cmdbuf, 0, '|', sizeof username);
 207         strproc(username);
 208         strproc(password);
 209         if (IsEmptyStr(username)) {
 210                 cprintf("%d You must supply a user name.\n", ERROR + USERNAME_REQUIRED);
 211                 return;
 212         }
 213         len = cutuserkey(username);
 214
 215
 216         extract_token(password, cmdbuf, 1, '|', sizeof password);
 217
 218         a = create_user(username, len, 0);
 219
 220         if (a == 0) {
 221                 if (!IsEmptyStr(password)) {
 222                         CtdlGetUserLock(&tmp, username);
 223                         safestrncpy(tmp.password, password, sizeof(tmp.password));
 224                         CtdlPutUserLock(&tmp);
 225                 }
 226                 cprintf("%d User '%s' created %s.\n", CIT_OK, username, (!IsEmptyStr(password)) ? "and password set" : "with no password");
 227                 return;
 228         } else if (a == ERROR + ALREADY_EXISTS) {
 229                 cprintf("%d '%s' already exists.\n", ERROR + ALREADY_EXISTS, username);
 230                 return;
 231         } else if ( (CtdlGetConfigInt("c_auth_mode") != AUTHMODE_NATIVE) && (a == ERROR + NO_SUCH_USER) ) {
 232                 cprintf("%d User accounts are not created within Citadel in host authentication mode.\n", ERROR + NO_SUCH_USER);
 233                 return;
 234         } else {
 235                 cprintf("%d An error occurred creating the user account.\n", ERROR + INTERNAL_ERROR);
 236         }
 237 }
 238
 239
 240 /*
 241  * get user parameters
 242  */
 243 void cmd_getu(char *cmdbuf)
 244 {
 245         if (CtdlAccessCheck(ac_logged_in))
 246                 return;
 247
 248         CtdlGetUser(&CC->user, CC->curr_user);
 249         cprintf("%d 80|24|%d|\n", CIT_OK, (CC->user.flags & US_USER_SET));
 250 }
 251
 252
 253 /*
 254  * set user parameters
 255  */
 256 void cmd_setu(char *new_parms)
 257 {
 258         if (CtdlAccessCheck(ac_logged_in))
 259                 return;
 260
 261         if (num_parms(new_parms) < 3) {
 262                 cprintf("%d Usage error.\n", ERROR + ILLEGAL_VALUE);
 263                 return;
 264         }
 265         CtdlLockGetCurrentUser();
 266         CC->user.flags = CC->user.flags & (~US_USER_SET);
 267         CC->user.flags = CC->user.flags | (extract_int(new_parms, 2) & US_USER_SET);
 268         CtdlPutCurrentUserLock();
 269         cprintf("%d Ok\n", CIT_OK);
 270 }
 271
 272
 273 /*
 274  * set last read pointer
 275  */
 276 void cmd_slrp(char *new_ptr)
 277 {
 278         long newlr;
 279         visit vbuf;
 280         visit original_vbuf;
 281
 282         if (CtdlAccessCheck(ac_logged_in)) {
 283                 return;
 284         }
 285
 286         if (!strncasecmp(new_ptr, "highest", 7)) {
 287                 newlr = CC->room.QRhighest;
 288         } else {
 289                 newlr = atol(new_ptr);
 290         }
 291
 292         CtdlLockGetCurrentUser();
 293
 294         CtdlGetRelationship(&vbuf, &CC->user, &CC->room);
 295         memcpy(&original_vbuf, &vbuf, sizeof(visit));
 296         vbuf.v_lastseen = newlr;
 297         snprintf(vbuf.v_seen, sizeof vbuf.v_seen, "*:%ld", newlr);
 298
 299         /* Only rewrite the record if it changed */
 300         if ( (vbuf.v_lastseen != original_vbuf.v_lastseen)
 301            || (strcmp(vbuf.v_seen, original_vbuf.v_seen)) ) {
 302                 CtdlSetRelationship(&vbuf, &CC->user, &CC->room);
 303         }
 304
 305         CtdlPutCurrentUserLock();
 306         cprintf("%d %ld\n", CIT_OK, newlr);
 307 }
 308
 309
 310 void cmd_seen(char *argbuf) {
 311         long target_msgnum = 0L;
 312         int target_setting = 0;
 313
 314         if (CtdlAccessCheck(ac_logged_in)) {
 315                 return;
 316         }
 317
 318         if (num_parms(argbuf) != 2) {
 319                 cprintf("%d Invalid parameters\n", ERROR + ILLEGAL_VALUE);
 320                 return;
 321         }
 322
 323         target_msgnum = extract_long(argbuf, 0);
 324         target_setting = extract_int(argbuf, 1);
 325
 326         CtdlSetSeen(&target_msgnum, 1, target_setting,
 327                         ctdlsetseen_seen, NULL, NULL);
 328         cprintf("%d OK\n", CIT_OK);
 329 }
 330
 331
 332 void cmd_gtsn(char *argbuf) {
 333         visit vbuf;
 334
 335         if (CtdlAccessCheck(ac_logged_in)) {
 336                 return;
 337         }
 338
 339         /* Learn about the user and room in question */
 340         CtdlGetRelationship(&vbuf, &CC->user, &CC->room);
 341
 342         cprintf("%d ", CIT_OK);
 343         client_write(vbuf.v_seen, strlen(vbuf.v_seen));
 344         client_write(HKEY("\n"));
 345 }
 346
 347
 348 /*
 349  * INVT and KICK commands
 350  */
 351 void cmd_invt_kick(char *iuser, int op) {
 352
 353         /*
 354          * These commands are only allowed by admins, room admins,
 355          * and room namespace owners
 356          */
 357         if (is_room_aide()) {
 358                 /* access granted */
 359         } else if ( ((atol(CC->room.QRname) == CC->user.usernum) ) && (CC->user.usernum != 0) ) {
 360                 /* access granted */
 361         } else {
 362                 /* access denied */
 363                 cprintf("%d Higher access or room ownership required.\n", ERROR + HIGHER_ACCESS_REQUIRED);
 364                 return;
 365         }
 366
 367         if (!strncasecmp(CC->room.QRname, CtdlGetConfigStr("c_baseroom"),
 368                          ROOMNAMELEN)) {
 369                 cprintf("%d Can't add/remove users from this room.\n", ERROR + NOT_HERE);
 370                 return;
 371         }
 372
 373         if (CtdlInvtKick(iuser, op) != 0) {
 374                 cprintf("%d No such user.\n", ERROR + NO_SUCH_USER);
 375                 return;
 376         }
 377
 378         cprintf("%d %s %s %s.\n",
 379                 CIT_OK, iuser,
 380                 ((op == 1) ? "invited to" : "kicked out of"),
 381                 CC->room.QRname);
 382         return;
 383 }
 384
 385
 386 void cmd_invt(char *iuser) {
 387         cmd_invt_kick(iuser, 1);
 388 }
 389
 390
 391 void cmd_kick(char *iuser) {
 392         cmd_invt_kick(iuser, 0);
 393 }
 394
 395
 396 /*
 397  * forget (Zap) the current room
 398  */
 399 void cmd_forg(char *argbuf)
 400 {
 401
 402         if (CtdlAccessCheck(ac_logged_in)) {
 403                 return;
 404         }
 405
 406         if (CtdlForgetThisRoom() == 0) {
 407                 cprintf("%d Ok\n", CIT_OK);
 408         }
 409         else {
 410                 cprintf("%d You may not forget this room.\n", ERROR + NOT_HERE);
 411         }
 412 }
 413
 414
 415 /*
 416  * Get Next Unregistered User
 417  */
 418 void cmd_gnur(char *argbuf)
 419 {
 420         struct cdbdata *cdbus;
 421         struct ctdluser usbuf;
 422
 423         if (CtdlAccessCheck(ac_aide)) {
 424                 return;
 425         }
 426
 427         if ((CtdlGetConfigInt("MMflags") & MM_VALID) == 0) {
 428                 cprintf("%d There are no unvalidated users.\n", CIT_OK);
 429                 return;
 430         }
 431
 432         /* There are unvalidated users.  Traverse the user database,
 433          * and return the first user we find that needs validation.
 434          */
 435         cdb_rewind(CDB_USERS);
 436         while (cdbus = cdb_next_item(CDB_USERS), cdbus != NULL) {
 437                 memset(&usbuf, 0, sizeof(struct ctdluser));
 438                 memcpy(&usbuf, cdbus->ptr, ((cdbus->len > sizeof(struct ctdluser)) ?  sizeof(struct ctdluser) : cdbus->len));
 439                 cdb_free(cdbus);
 440                 if ((usbuf.flags & US_NEEDVALID) && (usbuf.axlevel > AxDeleted)) {
 441                         cprintf("%d %s\n", MORE_DATA, usbuf.fullname);
 442                         cdb_close_cursor(CDB_USERS);
 443                         return;
 444                 }
 445         }
 446
 447         /* If we get to this point, there are no more unvalidated users.
 448          * Therefore we clear the "users need validation" flag.
 449          */
 450
 451         begin_critical_section(S_CONTROL);
 452         int flags;
 453         flags = CtdlGetConfigInt("MMflags");
 454         flags = flags & (~MM_VALID);
 455         CtdlSetConfigInt("MMflags", flags);
 456         end_critical_section(S_CONTROL);
 457         cprintf("%d *** End of registration.\n", CIT_OK);
 458 }
 459
 460
 461 /*
 462  * validate a user
 463  */
 464 void cmd_vali(char *v_args)
 465 {
 466         char user[128];
 467         int newax;
 468         struct ctdluser userbuf;
 469
 470         extract_token(user, v_args, 0, '|', sizeof user);
 471         newax = extract_int(v_args, 1);
 472
 473         if (CtdlAccessCheck(ac_aide) || (newax > AxAideU) || (newax < AxDeleted)) {
 474                 return;
 475         }
 476
 477         if (CtdlGetUserLock(&userbuf, user) != 0) {
 478                 cprintf("%d '%s' not found.\n", ERROR + NO_SUCH_USER, user);
 479                 return;
 480         }
 481
 482         userbuf.axlevel = newax;
 483         userbuf.flags = (userbuf.flags & ~US_NEEDVALID);
 484
 485         CtdlPutUserLock(&userbuf);
 486
 487         /* If the access level was set to zero, delete the user */
 488         if (newax == 0) {
 489                 if (purge_user(user) == 0) {
 490                         cprintf("%d %s Deleted.\n", CIT_OK, userbuf.fullname);
 491                         return;
 492                 }
 493         }
 494         cprintf("%d User '%s' validated.\n", CIT_OK, userbuf.fullname);
 495 }
 496
 497 /*
 498  *  List users (searchstring may be empty to list all users)
 499  */
 500 void cmd_list(char *cmdbuf)
 501 {
 502         char searchstring[256];
 503         extract_token(searchstring, cmdbuf, 0, '|', sizeof searchstring);
 504         striplt(searchstring);
 505         cprintf("%d \n", LISTING_FOLLOWS);
 506         ForEachUser(ListThisUser, (void *)searchstring );
 507         cprintf("000\n");
 508 }
 509
 510
 511 /*
 512  * assorted info we need to check at login
 513  */
 514 void cmd_chek(char *argbuf)
 515 {
 516         int mail = 0;
 517         int regis = 0;
 518         int vali = 0;
 519
 520         if (CtdlAccessCheck(ac_logged_in)) {
 521                 return;
 522         }
 523
 524         CtdlGetUser(&CC->user, CC->curr_user);  // no lock is needed here
 525         if ((REGISCALL != 0) && ((CC->user.flags & US_REGIS) == 0)) {
 526                 regis = 1;
 527         }
 528
 529         if (CC->user.axlevel >= AxAideU) {
 530                 if (CtdlGetConfigInt("MMflags") & MM_VALID) {
 531                         vali = 1;
 532                 }
 533         }
 534
 535         mail = InitialMailCheck();              // check for mail
 536
 537         cprintf("%d %d|%d|%d|%s|\n", CIT_OK, mail, regis, vali, CC->cs_inet_email);
 538 }
 539
 540
 541 /*
 542  * check to see if a user exists
 543  */
 544 void cmd_qusr(char *who)
 545 {
 546         struct ctdluser usbuf;
 547
 548         if (CtdlGetUser(&usbuf, who) == 0) {
 549                 cprintf("%d %s\n", CIT_OK, usbuf.fullname);
 550         } else {
 551                 cprintf("%d No such user.\n", ERROR + NO_SUCH_USER);
 552         }
 553 }
 554
 555
 556 /*
 557  * Administrative Get User Parameters
 558  */
 559 void cmd_agup(char *cmdbuf)
 560 {
 561         struct ctdluser usbuf;
 562         char requested_user[128];
 563
 564         if (CtdlAccessCheck(ac_aide)) {
 565                 return;
 566         }
 567
 568         extract_token(requested_user, cmdbuf, 0, '|', sizeof requested_user);
 569         if (CtdlGetUser(&usbuf, requested_user) != 0) {
 570                 cprintf("%d No such user.\n", ERROR + NO_SUCH_USER);
 571                 return;
 572         }
 573         cprintf("%d %s|%s|%u|%ld|%ld|%d|%ld|%ld|%d\n",
 574                 CIT_OK,
 575                 usbuf.fullname,
 576                 usbuf.password,
 577                 usbuf.flags,
 578                 usbuf.timescalled,
 579                 usbuf.posted,
 580                 (int) usbuf.axlevel,
 581                 usbuf.usernum,
 582                 (long)usbuf.lastcall,
 583                 usbuf.USuserpurge);
 584 }
 585
 586
 587 /*
 588  * Administrative Set User Parameters
 589  */
 590 void cmd_asup(char *cmdbuf)
 591 {
 592         struct ctdluser usbuf;
 593         char requested_user[128];
 594         char notify[SIZ];
 595         int np;
 596         int newax;
 597         int deleted = 0;
 598
 599         if (CtdlAccessCheck(ac_aide))
 600                 return;
 601
 602         extract_token(requested_user, cmdbuf, 0, '|', sizeof requested_user);
 603         if (CtdlGetUserLock(&usbuf, requested_user) != 0) {
 604                 cprintf("%d No such user.\n", ERROR + NO_SUCH_USER);
 605                 return;
 606         }
 607         np = num_parms(cmdbuf);
 608         if (np > 1)
 609                 extract_token(usbuf.password, cmdbuf, 1, '|', sizeof usbuf.password);
 610         if (np > 2)
 611                 usbuf.flags = extract_int(cmdbuf, 2);
 612         if (np > 3)
 613                 usbuf.timescalled = extract_int(cmdbuf, 3);
 614         if (np > 4)
 615                 usbuf.posted = extract_int(cmdbuf, 4);
 616         if (np > 5) {
 617                 newax = extract_int(cmdbuf, 5);
 618                 if ((newax >= AxDeleted) && (newax <= AxAideU)) {
 619                         usbuf.axlevel = newax;
 620                 }
 621         }
 622         if (np > 7) {
 623                 usbuf.lastcall = extract_long(cmdbuf, 7);
 624         }
 625         if (np > 8) {
 626                 usbuf.USuserpurge = extract_int(cmdbuf, 8);
 627         }
 628         CtdlPutUserLock(&usbuf);
 629         if (usbuf.axlevel == AxDeleted) {
 630                 if (purge_user(requested_user) == 0) {
 631                         deleted = 1;
 632                 }
 633         }
 634
 635         if (deleted) {
 636                 snprintf(notify, SIZ,
 637                         "User \"%s\" has been deleted by %s.\n",
 638                         usbuf.fullname, (CC->logged_in ? CC->user.fullname : "an administrator")
 639                 );
 640                 CtdlAideMessage(notify, "User Deletion Message");
 641         }
 642
 643         cprintf("%d Ok", CIT_OK);
 644         if (deleted) {
 645                 cprintf(" (%s deleted)", requested_user);
 646         }
 647         cprintf("\n");
 648 }
 649
 650
 651 /*
 652  * Citadel protocol command to do the same
 653  */
 654 void cmd_isme(char *argbuf) {
 655         char addr[256];
 656
 657         if (CtdlAccessCheck(ac_logged_in)) return;
 658         extract_token(addr, argbuf, 0, '|', sizeof addr);
 659
 660         if (CtdlIsMe(addr, sizeof addr)) {
 661                 cprintf("%d %s\n", CIT_OK, addr);
 662         }
 663         else {
 664                 cprintf("%d Not you.\n", ERROR + ILLEGAL_VALUE);
 665         }
 666
 667 }
 668
 669
 670 /*
 671  * Set the preferred view for the current user/room combination
 672  */
 673 void cmd_view(char *cmdbuf) {
 674         int requested_view;
 675         visit vbuf;
 676
 677         if (CtdlAccessCheck(ac_logged_in)) {
 678                 return;
 679         }
 680
 681         requested_view = extract_int(cmdbuf, 0);
 682
 683         CtdlGetRelationship(&vbuf, &CC->user, &CC->room);
 684         vbuf.v_view = requested_view;
 685         CtdlSetRelationship(&vbuf, &CC->user, &CC->room);
 686
 687         cprintf("%d ok\n", CIT_OK);
 688 }
 689
 690
 691 /*
 692  * Rename a user
 693  */
 694 void cmd_renu(char *cmdbuf)
 695 {
 696         int retcode;
 697         char oldname[USERNAME_SIZE];
 698         char newname[USERNAME_SIZE];
 699
 700         if (CtdlAccessCheck(ac_aide)) {
 701                 return;
 702         }
 703
 704         extract_token(oldname, cmdbuf, 0, '|', sizeof oldname);
 705         extract_token(newname, cmdbuf, 1, '|', sizeof newname);
 706
 707         retcode = rename_user(oldname, newname);
 708         switch(retcode) {
 709                 case RENAMEUSER_OK:
 710                         cprintf("%d '%s' has been renamed to '%s'.\n", CIT_OK, oldname, newname);
 711                         return;
 712                 case RENAMEUSER_LOGGED_IN:
 713                         cprintf("%d '%s' is currently logged in and cannot be renamed.\n",
 714                                 ERROR + ALREADY_LOGGED_IN , oldname
 715                         );
 716                         return;
 717                 case RENAMEUSER_NOT_FOUND:
 718                         cprintf("%d '%s' does not exist.\n", ERROR + NO_SUCH_USER, oldname);
 719                         return;
 720                 case RENAMEUSER_ALREADY_EXISTS:
 721                         cprintf("%d A user named '%s' already exists.\n", ERROR + ALREADY_EXISTS, newname);
 722                         return;
 723         }
 724
 725         cprintf("%d An unknown error occurred.\n", ERROR);
 726 }
 727
 728
 729 void cmd_quit(char *argbuf)
 730 {
 731         cprintf("%d Goodbye.\n", CIT_OK);
 732         CC->kill_me = KILLME_CLIENT_LOGGED_OUT;
 733 }
 734
 735
 736 void cmd_lout(char *argbuf)
 737 {
 738         if (CC->logged_in)
 739                 CtdlUserLogout();
 740         cprintf("%d logged out.\n", CIT_OK);
 741 }
 742
 743
 744 /*****************************************************************************/
 745 /*                      MODULE INITIALIZATION STUFF                          */
 746 /*****************************************************************************/
 747
 748
 749 CTDL_MODULE_INIT(serv_user)
 750 {
 751         if (!threading) {
 752                 CtdlRegisterProtoHook(cmd_user, "USER", "Submit username for login");
 753                 CtdlRegisterProtoHook(cmd_pass, "PASS", "Complete login by submitting a password");
 754                 CtdlRegisterProtoHook(cmd_quit, "QUIT", "log out and disconnect from server");
 755                 CtdlRegisterProtoHook(cmd_lout, "LOUT", "log out but do not disconnect from server");
 756                 CtdlRegisterProtoHook(cmd_creu, "CREU", "Create User");
 757                 CtdlRegisterProtoHook(cmd_setp, "SETP", "Set the password for an account");
 758                 CtdlRegisterProtoHook(cmd_getu, "GETU", "Get User parameters");
 759                 CtdlRegisterProtoHook(cmd_setu, "SETU", "Set User parameters");
 760                 CtdlRegisterProtoHook(cmd_slrp, "SLRP", "Set Last Read Pointer");
 761                 CtdlRegisterProtoHook(cmd_invt, "INVT", "Invite a user to a room");
 762                 CtdlRegisterProtoHook(cmd_kick, "KICK", "Kick a user out of a room");
 763                 CtdlRegisterProtoHook(cmd_forg, "FORG", "Forget a room");
 764                 CtdlRegisterProtoHook(cmd_gnur, "GNUR", "Get Next Unregistered User");
 765                 CtdlRegisterProtoHook(cmd_vali, "VALI", "Validate new users");
 766                 CtdlRegisterProtoHook(cmd_list, "LIST", "List users");
 767                 CtdlRegisterProtoHook(cmd_chek, "CHEK", "assorted info we need to check at login");
 768                 CtdlRegisterProtoHook(cmd_qusr, "QUSR", "check to see if a user exists");
 769                 CtdlRegisterProtoHook(cmd_agup, "AGUP", "Administratively Get User Parameters");
 770                 CtdlRegisterProtoHook(cmd_asup, "ASUP", "Administratively Set User Parameters");
 771                 CtdlRegisterProtoHook(cmd_seen, "SEEN", "Manipulate seen/unread message flags");
 772                 CtdlRegisterProtoHook(cmd_gtsn, "GTSN", "Fetch seen/unread message flags");
 773                 CtdlRegisterProtoHook(cmd_view, "VIEW", "Set preferred view for user/room combination");
 774                 CtdlRegisterProtoHook(cmd_renu, "RENU", "Rename a user");
 775                 CtdlRegisterProtoHook(cmd_newu, "NEWU", "Log in as a new user");
 776                 CtdlRegisterProtoHook(cmd_isme, "ISME", "Determine whether an email address belongs to a user");
 777         }
 778         /* return our Subversion id for the Log */
 779         return "user";
 780 }