* Set all version numbers to 7.41 for upcoming beta.

[citadel.git] / citadel / user_ops.c

/* 
 * $Id$
 *
 * Server functions which perform operations on user objects.
 *
 */

#include "sysdep.h"
#include <errno.h>
#include <stdlib.h>
#include <unistd.h>
#include <stdio.h>
#include <fcntl.h>
#include <signal.h>
#include <pwd.h>
#include <ctype.h>
#include <sys/types.h>
#include <sys/wait.h>
#ifdef HAVE_SYS_STAT_H
#include <sys/stat.h>
#endif

#if TIME_WITH_SYS_TIME
# include <sys/time.h>
# include <time.h>
#else
# if HAVE_SYS_TIME_H
#  include <sys/time.h>
# else
#  include <time.h>
# endif
#endif

#include <string.h>
#include <limits.h>
#include <libcitadel.h>
#include "auth.h"
#include "citadel.h"
#include "server.h"
#include "database.h"
#include "user_ops.h"
#include "sysdep_decls.h"
#include "support.h"
#include "room_ops.h"
#include "file_ops.h"
#include "control.h"
#include "msgbase.h"
#include "config.h"
#include "citserver.h"
#include "citadel_dirs.h"
#include "genstamp.h"
#include "threads.h"

/* These pipes are used to talk to the chkpwd daemon, which is forked during startup */
int chkpwd_write_pipe[2];
int chkpwd_read_pipe[2];

/*
 * makeuserkey() - convert a username into the format used as a database key
 *               (it's just the username converted into lower case)
 */
INLINE void makeuserkey(char *key, char *username) {
        int i, len;

        len = strlen(username);
        if (len >= USERNAME_SIZE)
        {
                CtdlLogPrintf (CTDL_EMERG, "Username to long: %s", username);
                cit_backtrace ();
                len = USERNAME_SIZE - 1; 
                username[USERNAME_SIZE - 1]='\0';
        }
        for (i=0; i<=len; ++i) {
                key[i] = tolower(username[i]);
        }
}


/*
 * getuser()  -  retrieve named user into supplied buffer.
 *             returns 0 on success
 */
int getuser(struct ctdluser *usbuf, char name[])
{

        char usernamekey[USERNAME_SIZE];
        struct cdbdata *cdbus;

        if (usbuf != NULL) {
                memset(usbuf, 0, sizeof(struct ctdluser));
        }

        makeuserkey(usernamekey, name);
        cdbus = cdb_fetch(CDB_USERS, usernamekey, strlen(usernamekey));

        if (cdbus == NULL) {    /* user not found */
                return(1);
        }
        if (usbuf != NULL) {
                memcpy(usbuf, cdbus->ptr,
                        ((cdbus->len > sizeof(struct ctdluser)) ?
                         sizeof(struct ctdluser) : cdbus->len));
        }
        cdb_free(cdbus);

        return (0);
}


/*
 * lgetuser()  -  same as getuser() but locks the record
 */
int lgetuser(struct ctdluser *usbuf, char *name)
{
        int retcode;

        retcode = getuser(usbuf, name);
        if (retcode == 0) {
                begin_critical_section(S_USERS);
        }
        return (retcode);
}


/*
 * putuser()  -  write user buffer into the correct place on disk
 */
void putuser(struct ctdluser *usbuf)
{
        char usernamekey[USERNAME_SIZE];

        makeuserkey(usernamekey, usbuf->fullname);

        usbuf->version = REV_LEVEL;
        cdb_store(CDB_USERS,
                  usernamekey, strlen(usernamekey),
                  usbuf, sizeof(struct ctdluser));

}


/*
 * lputuser()  -  same as putuser() but locks the record
 */
void lputuser(struct ctdluser *usbuf)
{
        putuser(usbuf);
        end_critical_section(S_USERS);
}


/*
 * rename_user()  -  this is tricky because the user's display name is the database key
 *
 * Returns 0 on success or nonzero if there was an error...
 *
 */
int rename_user(char *oldname, char *newname) {
        struct CitContext *cptr;
        int retcode = RENAMEUSER_OK;
        struct ctdluser usbuf;

        char oldnamekey[USERNAME_SIZE];
        char newnamekey[USERNAME_SIZE];

        /* We cannot rename a user who is currently logged in */
        for (cptr = ContextList; cptr != NULL; cptr = cptr->next) {
                if (!strcasecmp(cptr->user.fullname, oldname)) {
                        return(RENAMEUSER_LOGGED_IN);
                }
        }

        /* Create the database keys... */
        makeuserkey(oldnamekey, oldname);
        makeuserkey(newnamekey, newname);

        /* Lock up and get going */
        begin_critical_section(S_USERS);

        if (getuser(&usbuf, newname) == 0) {
                retcode = RENAMEUSER_ALREADY_EXISTS;
        }
        else {

                if (getuser(&usbuf, oldname) != 0) {
                        retcode = RENAMEUSER_NOT_FOUND;
                }

                else {          /* Sanity checks succeeded.  Now rename the user. */
                        if (usbuf.usernum == 0)
                        {
                                CtdlLogPrintf (CTDL_DEBUG, "Can not rename user \"Citadel\".\n");
                                retcode = RENAMEUSER_NOT_FOUND;
                        } else {
                                CtdlLogPrintf(CTDL_DEBUG, "Renaming <%s> to <%s>\n", oldname, newname);
                                cdb_delete(CDB_USERS, oldnamekey, strlen(oldnamekey));
                                safestrncpy(usbuf.fullname, newname, sizeof usbuf.fullname);
                                putuser(&usbuf);
                                cdb_store(CDB_USERSBYNUMBER, &usbuf.usernum, sizeof(long),
                                        usbuf.fullname, strlen(usbuf.fullname)+1 );

                                retcode = RENAMEUSER_OK;
                        }
                }
        
        }

        end_critical_section(S_USERS);
        return(retcode);
}



/*
 * Index-generating function used by Ctdl[Get|Set]Relationship
 */
int GenerateRelationshipIndex(char *IndexBuf,
                              long RoomID,
                              long RoomGen,
                              long UserID)
{

        struct {
                long iRoomID;
                long iRoomGen;
                long iUserID;
        } TheIndex;

        TheIndex.iRoomID = RoomID;
        TheIndex.iRoomGen = RoomGen;
        TheIndex.iUserID = UserID;

        memcpy(IndexBuf, &TheIndex, sizeof(TheIndex));
        return (sizeof(TheIndex));
}



/*
 * Back end for CtdlSetRelationship()
 */
void put_visit(struct visit *newvisit)
{
        char IndexBuf[32];
        int IndexLen = 0;

        memset (IndexBuf, 0, sizeof (IndexBuf));
        /* Generate an index */
        IndexLen = GenerateRelationshipIndex(IndexBuf,
                                             newvisit->v_roomnum,
                                             newvisit->v_roomgen,
                                             newvisit->v_usernum);

        /* Store the record */
        cdb_store(CDB_VISIT, IndexBuf, IndexLen,
                  newvisit, sizeof(struct visit)
        );
}




/*
 * Define a relationship between a user and a room
 */
void CtdlSetRelationship(struct visit *newvisit,
                         struct ctdluser *rel_user,
                         struct ctdlroom *rel_room)
{


        /* We don't use these in Citadel because they're implicit by the
         * index, but they must be present if the database is exported.
         */
        newvisit->v_roomnum = rel_room->QRnumber;
        newvisit->v_roomgen = rel_room->QRgen;
        newvisit->v_usernum = rel_user->usernum;

        put_visit(newvisit);
}

/*
 * Locate a relationship between a user and a room
 */
void CtdlGetRelationship(struct visit *vbuf,
                         struct ctdluser *rel_user,
                         struct ctdlroom *rel_room)
{

        char IndexBuf[32];
        int IndexLen;
        struct cdbdata *cdbvisit;

        /* Generate an index */
        IndexLen = GenerateRelationshipIndex(IndexBuf,
                                             rel_room->QRnumber,
                                             rel_room->QRgen,
                                             rel_user->usernum);

        /* Clear out the buffer */
        memset(vbuf, 0, sizeof(struct visit));

        cdbvisit = cdb_fetch(CDB_VISIT, IndexBuf, IndexLen);
        if (cdbvisit != NULL) {
                memcpy(vbuf, cdbvisit->ptr,
                       ((cdbvisit->len > sizeof(struct visit)) ?
                        sizeof(struct visit) : cdbvisit->len));
                cdb_free(cdbvisit);
        }
        else {
                /* If this is the first time the user has seen this room,
                 * set the view to be the default for the room.
                 */
                vbuf->v_view = rel_room->QRdefaultview;
        }

        /* Set v_seen if necessary */
        if (vbuf->v_seen[0] == 0) {
                snprintf(vbuf->v_seen, sizeof vbuf->v_seen, "*:%ld", vbuf->v_lastseen);
        }
}


void MailboxName(char *buf, size_t n, const struct ctdluser *who, const char *prefix)
{
        snprintf(buf, n, "%010ld.%s", who->usernum, prefix);
}


/*
 * Is the user currently logged in an Aide?
 */
int is_aide(void)
{
        if (CC->user.axlevel >= 6)
                return (1);
        else
                return (0);
}


/*
 * Is the user currently logged in an Aide *or* the room aide for this room?
 */
int is_room_aide(void)
{

        if (!CC->logged_in) {
                return (0);
        }

        if ((CC->user.axlevel >= 6)
            || (CC->room.QRroomaide == CC->user.usernum)) {
                return (1);
        } else {
                return (0);
        }
}

/*
 * getuserbynumber() -  get user by number
 *                      returns 0 if user was found
 *
 * Note: fetching a user this way requires one additional database operation.
 */
int getuserbynumber(struct ctdluser *usbuf, long number)
{
        struct cdbdata *cdbun;
        int r;

        cdbun = cdb_fetch(CDB_USERSBYNUMBER, &number, sizeof(long));
        if (cdbun == NULL) {
                CtdlLogPrintf(CTDL_INFO, "User %ld not found\n", number);
                return(-1);
        }

        CtdlLogPrintf(CTDL_INFO, "User %ld maps to %s\n", number, cdbun->ptr);
        r = getuser(usbuf, cdbun->ptr);
        cdb_free(cdbun);
        return(r);
}



/*
 * Helper function for rebuild_usersbynumber()
 */
void rebuild_ubn_for_user(struct ctdluser *usbuf, void *data) {

        struct ubnlist {
                struct ubnlist *next;
                char username[USERNAME_SIZE];
                long usernum;
        };

        static struct ubnlist *u = NULL;
        struct ubnlist *ptr = NULL;

        /* Lazy programming here.  Call this function as a ForEachUser backend
         * in order to queue up the room names, or call it with a null user
         * to make it do the processing.
         */
        if (usbuf != NULL) {
                ptr = (struct ubnlist *) malloc(sizeof (struct ubnlist));
                if (ptr == NULL) return;

                ptr->usernum = usbuf->usernum;
                safestrncpy(ptr->username, usbuf->fullname, sizeof ptr->username);
                ptr->next = u;
                u = ptr;
                return;
        }

        while (u != NULL) {
                CtdlLogPrintf(CTDL_DEBUG, "Rebuilding usersbynumber index %10ld : %s\n",
                        u->usernum, u->username);
                cdb_store(CDB_USERSBYNUMBER, &u->usernum, sizeof(long), u->username, strlen(u->username)+1);

                ptr = u;
                u = u->next;
                free(ptr);
        }
}



/*
 * Rebuild the users-by-number index
 */
void rebuild_usersbynumber(void) {
        cdb_trunc(CDB_USERSBYNUMBER);                   /* delete the old indices */
        ForEachUser(rebuild_ubn_for_user, NULL);        /* enumerate the users */
        rebuild_ubn_for_user(NULL, NULL);               /* and index them */
}



/*
 * getuserbyuid()  -     get user by system uid (for PAM mode authentication)
 *                     returns 0 if user was found
 *
 * WARNING: don't use this function unless you absolutely have to.  It does
 *        a sequential search and therefore is computationally expensive.
 */
int getuserbyuid(struct ctdluser *usbuf, uid_t number)
{
        struct cdbdata *cdbus;

        cdb_rewind(CDB_USERS);

        while (cdbus = cdb_next_item(CDB_USERS), cdbus != NULL) {
                memset(usbuf, 0, sizeof(struct ctdluser));
                memcpy(usbuf, cdbus->ptr,
                       ((cdbus->len > sizeof(struct ctdluser)) ?
                        sizeof(struct ctdluser) : cdbus->len));
                cdb_free(cdbus);
                if (usbuf->uid == number) {
                        cdb_close_cursor(CDB_USERS);
                        return (0);
                }
        }
        return (-1);
}

/*
 * Back end for cmd_user() and its ilk
 *
 * NOTE: "authname" should only be used if we are attempting to use the "master user" feature
 */
int CtdlLoginExistingUser(char *authname, char *trythisname)
{
        char username[SIZ];
        int found_user;

        CtdlLogPrintf(9, "CtdlLoginExistingUser(%s, %s)\n", authname, trythisname);

        if ((CC->logged_in)) {
                return login_already_logged_in;
        }

        if (trythisname == NULL) return login_not_found;
        
        if (!strncasecmp(trythisname, "SYS_", 4))
        {
                CtdlLogPrintf(CTDL_DEBUG, "System user \"%s\" is not allowed to log in.\n", trythisname);
                return login_not_found;
        }

        /* If a "master user" is defined, handle its authentication if specified */
        CC->is_master = 0;
        if (strlen(config.c_master_user) > 0) if (strlen(config.c_master_pass) > 0) if (authname) {
                if (!strcasecmp(authname, config.c_master_user)) {
                        CC->is_master = 1;
                }
        }

        /* Continue attempting user validation... */
        safestrncpy(username, trythisname, USERNAME_SIZE);
        striplt(username);

        if (IsEmptyStr(username)) {
                return login_not_found;
        }

        if (config.c_auth_mode == AUTHMODE_HOST) {

                /* host auth mode */

                struct passwd pd;
                struct passwd *tempPwdPtr;
                char pwdbuffer[256];
        
                CtdlLogPrintf(CTDL_DEBUG, "asking host about <%s>\n", username);
#ifdef HAVE_GETPWNAM_R
#ifdef SOLARIS_GETPWUID
                CtdlLogPrintf(CTDL_DEBUG, "Calling getpwnam_r()\n");
                tempPwdPtr = getpwnam_r(username, &pd, pwdbuffer, sizeof pwdbuffer);
#else // SOLARIS_GETPWUID
                CtdlLogPrintf(CTDL_DEBUG, "Calling getpwnam_r()\n");
                getpwnam_r(username, &pd, pwdbuffer, sizeof pwdbuffer, &tempPwdPtr);
#endif // SOLARIS_GETPWUID
#else // HAVE_GETPWNAM_R
                CtdlLogPrintf(CTDL_DEBUG, "SHOULD NEVER GET HERE!!!\n");
                tempPwdPtr = NULL;
#endif // HAVE_GETPWNAM_R
                if (tempPwdPtr == NULL) {
                        CtdlLogPrintf(CTDL_DEBUG, "no such user <%s>\n", username);
                        return login_not_found;
                }
        
                /* Locate the associated Citadel account.
                 * If not found, make one attempt to create it.
                 */
                found_user = getuserbyuid(&CC->user, pd.pw_uid);
                CtdlLogPrintf(CTDL_DEBUG, "found it: uid=%ld, gecos=%s here: %d\n",
                        (long)pd.pw_uid, pd.pw_gecos, found_user);
                if (found_user != 0) {
                        create_user(username, 0);
                        found_user = getuserbyuid(&CC->user, pd.pw_uid);
                }

        }

        else {
                /* native auth mode */

                struct recptypes *valid = NULL;
        
                /* First, try to log in as if the supplied name is a display name */
                found_user = getuser(&CC->user, username);
        
                /* If that didn't work, try to log in as if the supplied name
                * is an e-mail address
                */
                if (found_user != 0) {
                        valid = validate_recipients(username, NULL, 0);
                        if (valid != NULL) {
                                if (valid->num_local == 1) {
                                        found_user = getuser(&CC->user, valid->recp_local);
                                }
                                free_recipients(valid);
                        }
                }
        }

        /* Did we find something? */
        if (found_user == 0) {
                if (((CC->nologin)) && (CC->user.axlevel < 6)) {
                        return login_too_many_users;
                } else {
                        safestrncpy(CC->curr_user, CC->user.fullname,
                                        sizeof CC->curr_user);
                        return login_ok;
                }
        }
        return login_not_found;
}



/*
 * USER cmd
 */
void cmd_user(char *cmdbuf)
{
        char username[256];
        int a;

        extract_token(username, cmdbuf, 0, '|', sizeof username);
        striplt(username);

        a = CtdlLoginExistingUser(NULL, username);
        switch (a) {
        case login_already_logged_in:
                cprintf("%d Already logged in.\n", ERROR + ALREADY_LOGGED_IN);
                return;
        case login_too_many_users:
                cprintf("%d %s: "
                        "Too many users are already online "
                        "(maximum is %d)\n",
                        ERROR + MAX_SESSIONS_EXCEEDED,
                        config.c_nodename, config.c_maxsessions);
                return;
        case login_ok:
                cprintf("%d Password required for %s\n",
                        MORE_DATA, CC->curr_user);
                return;
        case login_not_found:
                cprintf("%d %s not found.\n", ERROR + NO_SUCH_USER, username);
                return;
        default:
                cprintf("%d Internal error\n", ERROR + INTERNAL_ERROR);
        }
}



/*
 * session startup code which is common to both cmd_pass() and cmd_newu()
 */
void do_login(void)
{
        CC->logged_in = 1;
        CtdlLogPrintf(CTDL_NOTICE, "<%s> logged in\n", CC->curr_user);

        lgetuser(&CC->user, CC->curr_user);
        ++(CC->user.timescalled);
        CC->previous_login = CC->user.lastcall;
        time(&CC->user.lastcall);

        /* If this user's name is the name of the system administrator
         * (as specified in setup), automatically assign access level 6.
         */
        if (!strcasecmp(CC->user.fullname, config.c_sysadm)) {
                CC->user.axlevel = 6;
        }

        /* If we're authenticating off the host system, automatically give
         * root the highest level of access.
         */
        if (config.c_auth_mode == AUTHMODE_HOST) {
                if (CC->user.uid == 0) {
                        CC->user.axlevel = 6;
                }
        }

        lputuser(&CC->user);

        /*
         * Populate CC->cs_inet_email with a default address.  This will be
         * overwritten with the user's directory address, if one exists, when
         * the vCard module's login hook runs.
         */
        snprintf(CC->cs_inet_email, sizeof CC->cs_inet_email, "%s@%s",
                CC->user.fullname, config.c_fqdn);
        convert_spaces_to_underscores(CC->cs_inet_email);

        /* Create any personal rooms required by the system.
         * (Technically, MAILROOM should be there already, but just in case...)
         */
        create_room(MAILROOM, 4, "", 0, 1, 0, VIEW_MAILBOX);
        create_room(SENTITEMS, 4, "", 0, 1, 0, VIEW_MAILBOX);
        create_room(USERTRASHROOM, 4, "", 0, 1, 0, VIEW_MAILBOX);

        /* Run any startup routines registered by loadable modules */
        PerformSessionHooks(EVT_LOGIN);

        /* Enter the lobby */
        usergoto(config.c_baseroom, 0, 0, NULL, NULL);
}


void logged_in_response(void)
{
        cprintf("%d %s|%d|%ld|%ld|%u|%ld|%ld\n",
                CIT_OK, CC->user.fullname, CC->user.axlevel,
                CC->user.timescalled, CC->user.posted,
                CC->user.flags, CC->user.usernum,
                CC->previous_login);
}



/* 
 * misc things to be taken care of when a user is logged out
 */
void logout(void)
{
        struct CitContext *CCC = CC;    /* CachedCitContext - performance boost */
        /*
         * If there is a download in progress, abort it.
         */
        if (CCC->download_fp != NULL) {
                fclose(CCC->download_fp);
                CCC->download_fp = NULL;
        }

        /*
         * If there is an upload in progress, abort it.
         */
        if (CCC->upload_fp != NULL) {
                abort_upl(CCC);
        }

        /*
         * If we were talking to a network node, we're not anymore...
         */
        if (!IsEmptyStr(CCC->net_node)) {
                network_talking_to(CCC->net_node, NTT_REMOVE);
        }

        /* Run any hooks registered by modules... */
        PerformSessionHooks(EVT_LOGOUT);
        
        /*
         * Clear out some session data.  Most likely, the CitContext for this
         * session is about to get nuked when the session disconnects, but
         * since it's possible to log in again without reconnecting, we cannot
         * make that assumption.
         */
        strcpy(CCC->fake_username, "");
        strcpy(CCC->fake_hostname, "");
        strcpy(CCC->fake_roomname, "");
        CCC->logged_in = 0;

        /* Check to see if the user was deleted whilst logged in and purge them if necessary */
        if ((CCC->user.axlevel == 0) && (CCC->user.usernum))
                purge_user(CCC->user.fullname);

        /* Free any output buffers */
        if (CCC->output_buffer != NULL) {
                unbuffer_output();
        }
}

/*
 * Validate a password on the host unix system by talking to the chkpwd daemon
 */
static int validpw(uid_t uid, const char *pass)
{
        char buf[256];

        if (IsEmptyStr(pass)) {
                CtdlLogPrintf(CTDL_DEBUG, "refusing to check empty password for uid=%d using chkpwd...\n", uid);
                return 0;
        }

        CtdlLogPrintf(CTDL_DEBUG, "Validating password for uid=%d using chkpwd...\n", uid);

        begin_critical_section(S_CHKPWD);
        write(chkpwd_write_pipe[1], &uid, sizeof(uid_t));
        write(chkpwd_write_pipe[1], pass, 256);
        read(chkpwd_read_pipe[0], buf, 4);
        end_critical_section(S_CHKPWD);

        if (!strncmp(buf, "PASS", 4)) {
                CtdlLogPrintf(CTDL_DEBUG, "...pass\n");
                return(1);
        }

        CtdlLogPrintf(CTDL_DEBUG, "...fail\n");
        return 0;
}

/* 
 * Start up the chkpwd daemon so validpw() has something to talk to
 */
void start_chkpwd_daemon(void) {
        pid_t chkpwd_pid;
        struct stat filestats;
        int i;

        CtdlLogPrintf(CTDL_DEBUG, "Starting chkpwd daemon for host authentication mode\n");

        if ((stat(file_chkpwd, &filestats)==-1) ||
            (filestats.st_size==0)){
                printf("didn't find chkpwd daemon in %s: %s\n", file_chkpwd, strerror(errno));
                abort();
        }
        if (pipe(chkpwd_write_pipe) != 0) {
                CtdlLogPrintf(CTDL_EMERG, "Unable to create pipe for chkpwd daemon: %s\n", strerror(errno));
                abort();
        }
        if (pipe(chkpwd_read_pipe) != 0) {
                CtdlLogPrintf(CTDL_EMERG, "Unable to create pipe for chkpwd daemon: %s\n", strerror(errno));
                abort();
        }

        chkpwd_pid = fork();
        if (chkpwd_pid < 0) {
                CtdlLogPrintf(CTDL_EMERG, "Unable to fork chkpwd daemon: %s\n", strerror(errno));
                abort();
        }
        if (chkpwd_pid == 0) {
                CtdlLogPrintf(CTDL_DEBUG, "Now calling dup2() write\n");
                dup2(chkpwd_write_pipe[0], 0);
                CtdlLogPrintf(CTDL_DEBUG, "Now calling dup2() write\n");
                dup2(chkpwd_read_pipe[1], 1);
                CtdlLogPrintf(CTDL_DEBUG, "Now closing stuff\n");
                for (i=2; i<256; ++i) close(i);
                CtdlLogPrintf(CTDL_DEBUG, "Now calling execl(%s)\n", file_chkpwd);
                execl(file_chkpwd, file_chkpwd, NULL);
                CtdlLogPrintf(CTDL_EMERG, "Unable to exec chkpwd daemon: %s\n", strerror(errno));
                abort();
                exit(errno);
        }
}


int CtdlTryPassword(char *password)
{
        int code;

        if ((CC->logged_in)) {
                CtdlLogPrintf(CTDL_WARNING, "CtdlTryPassword: already logged in\n");
                return pass_already_logged_in;
        }
        if (!strcmp(CC->curr_user, NLI)) {
                CtdlLogPrintf(CTDL_WARNING, "CtdlTryPassword: no user selected\n");
                return pass_no_user;
        }
        if (getuser(&CC->user, CC->curr_user)) {
                CtdlLogPrintf(CTDL_ERR, "CtdlTryPassword: internal error\n");
                return pass_internal_error;
        }
        if (password == NULL) {
                CtdlLogPrintf(CTDL_INFO, "CtdlTryPassword: NULL password string supplied\n");
                return pass_wrong_password;
        }
        code = (-1);

        if (CC->is_master) {
                code = strcmp(password, config.c_master_pass);
        }

        else if (config.c_auth_mode == AUTHMODE_HOST) {

                /* host auth mode */

                if (validpw(CC->user.uid, password)) {
                        code = 0;

                        /*
                         * sooper-seekrit hack: populate the password field in the
                         * citadel database with the password that the user typed,
                         * if it's correct.  This allows most sites to convert from
                         * host auth to native auth if they want to.  If you think
                         * this is a security hazard, comment it out.
                         */

                        lgetuser(&CC->user, CC->curr_user);
                        safestrncpy(CC->user.password, password, sizeof CC->user.password);
                        lputuser(&CC->user);

                        /*
                         * (sooper-seekrit hack ends here)
                         */

                }
                else {
                        code = (-1);
                }
        }

        else {

                /* native auth mode */

                strproc(password);
                strproc(CC->user.password);
                code = strcasecmp(CC->user.password, password);
                strproc(password);
                strproc(CC->user.password);
                code = strcasecmp(CC->user.password, password);
        }

        if (!code) {
                do_login();
                return pass_ok;
        } else {
                CtdlLogPrintf(CTDL_WARNING, "Bad password specified for <%s>\n", CC->curr_user);
                return pass_wrong_password;
        }
}


void cmd_pass(char *buf)
{
        char password[256];
        int a;

        extract_token(password, buf, 0, '|', sizeof password);
        a = CtdlTryPassword(password);

        switch (a) {
        case pass_already_logged_in:
                cprintf("%d Already logged in.\n", ERROR + ALREADY_LOGGED_IN);
                return;
        case pass_no_user:
                cprintf("%d You must send a name with USER first.\n",
                        ERROR + USERNAME_REQUIRED);
                return;
        case pass_wrong_password:
                cprintf("%d Wrong password.\n", ERROR + PASSWORD_REQUIRED);
                return;
        case pass_ok:
                logged_in_response();
                return;
        }
}



/*
 * Delete a user record *and* all of its related resources.
 */
int purge_user(char pname[])
{
        char filename[64];
        struct ctdluser usbuf;
        char usernamekey[USERNAME_SIZE];
        struct CitContext *ccptr;
        int user_is_logged_in = 0;

        makeuserkey(usernamekey, pname);

        /* If the name is empty we can't find them in the DB any way so just return */
        if (IsEmptyStr(pname))
                return (ERROR + NO_SUCH_USER);

        if (getuser(&usbuf, pname) != 0) {
                CtdlLogPrintf(CTDL_ERR, "Cannot purge user <%s> - not found\n", pname);
                return (ERROR + NO_SUCH_USER);
        }
        /* Don't delete a user who is currently logged in.  Instead, just
         * set the access level to 0, and let the account get swept up
         * during the next purge.
         */
        user_is_logged_in = 0;
        begin_critical_section(S_SESSION_TABLE);
        for (ccptr = ContextList; ccptr != NULL; ccptr = ccptr->next) {
                if (ccptr->user.usernum == usbuf.usernum) {
                        user_is_logged_in = 1;
                }
        }
        end_critical_section(S_SESSION_TABLE);
        if (user_is_logged_in == 1) {
                CtdlLogPrintf(CTDL_WARNING, "User <%s> is logged in; not deleting.\n", pname);
                usbuf.axlevel = 0;
                putuser(&usbuf);
                return (1);
        }
        CtdlLogPrintf(CTDL_NOTICE, "Deleting user <%s>\n", pname);

        /* Perform any purge functions registered by server extensions */
        PerformUserHooks(&usbuf, EVT_PURGEUSER);

        /* delete any existing user/room relationships */
        cdb_delete(CDB_VISIT, &usbuf.usernum, sizeof(long));

        /* delete the users-by-number index record */
        cdb_delete(CDB_USERSBYNUMBER, &usbuf.usernum, sizeof(long));

        /* delete the userlog entry */
        cdb_delete(CDB_USERS, usernamekey, strlen(usernamekey));

        /* remove the user's bio file */
        snprintf(filename, 
                         sizeof filename, 
                         "%s/%ld",
                         ctdl_bio_dir,
                         usbuf.usernum);
        unlink(filename);

        /* remove the user's picture */
        snprintf(filename, 
                         sizeof filename, 
                         "%s/%ld.gif",
                         ctdl_image_dir,
                         usbuf.usernum);
        unlink(filename);

        return (0);
}


int internal_create_user (char *username, struct ctdluser *usbuf, uid_t uid)
{
        if (!getuser(usbuf, username)) {
                return (ERROR + ALREADY_EXISTS);
        }

        /* Go ahead and initialize a new user record */
        memset(usbuf, 0, sizeof(struct ctdluser));
        safestrncpy(usbuf->fullname, username, sizeof usbuf->fullname);
        strcpy(usbuf->password, "");
        usbuf->uid = uid;

        /* These are the default flags on new accounts */
        usbuf->flags = US_LASTOLD | US_DISAPPEAR | US_PAGINATOR | US_FLOORS;

        usbuf->timescalled = 0;
        usbuf->posted = 0;
        usbuf->axlevel = config.c_initax;
        usbuf->USscreenwidth = 80;
        usbuf->USscreenheight = 24;
        usbuf->lastcall = time(NULL);

        /* fetch a new user number */
        usbuf->usernum = get_new_user_number();

        /* add user to the database */
        putuser(usbuf);
        cdb_store(CDB_USERSBYNUMBER, &usbuf->usernum, sizeof(long), usbuf->fullname, strlen(usbuf->fullname)+1);

        return 0;
}



/*
 * create_user()  -  back end processing to create a new user
 *
 * Set 'newusername' to the desired account name.
 * Set 'become_user' to nonzero if this is self-service account creation and we want
 * to actually log in as the user we just created, otherwise set it to 0.
 */
int create_user(char *newusername, int become_user)
{
        struct ctdluser usbuf;
        struct ctdlroom qrbuf;
        char username[256];
        char mailboxname[ROOMNAMELEN];
        char buf[SIZ];
        int retval;
        uid_t uid = (-1);
        

        safestrncpy(username, newusername, sizeof username);
        strproc(username);

        
        if (config.c_auth_mode == AUTHMODE_HOST) {

                /* host auth mode */

                struct passwd pd;
                struct passwd *tempPwdPtr;
                char pwdbuffer[256];
        
#ifdef HAVE_GETPWNAM_R
#ifdef SOLARIS_GETPWUID
                tempPwdPtr = getpwnam_r(username, &pd, pwdbuffer, sizeof(pwdbuffer));
#else // SOLARIS_GETPWUID
                getpwnam_r(username, &pd, pwdbuffer, sizeof pwdbuffer, &tempPwdPtr);
#endif // SOLARIS_GETPWUID
#else // HAVE_GETPWNAM_R
                tempPwdPtr = NULL;
#endif // HAVE_GETPWNAM_R
                if (tempPwdPtr != NULL) {
                        extract_token(username, pd.pw_gecos, 0, ',', sizeof username);
                        uid = pd.pw_uid;
                        if (IsEmptyStr (username))
                        {
                                safestrncpy(username, pd.pw_name, sizeof username);
                        }
                }
                else {
                        return (ERROR + NO_SUCH_USER);
                }
        }
        
        if ((retval = internal_create_user(username, &usbuf, uid)) != 0)
                return retval;
        
        /*
         * Give the user a private mailbox and a configuration room.
         * Make the latter an invisible system room.
         */
        MailboxName(mailboxname, sizeof mailboxname, &usbuf, MAILROOM);
        create_room(mailboxname, 5, "", 0, 1, 1, VIEW_MAILBOX);

        MailboxName(mailboxname, sizeof mailboxname, &usbuf, USERCONFIGROOM);
        create_room(mailboxname, 5, "", 0, 1, 1, VIEW_BBS);
        if (lgetroom(&qrbuf, mailboxname) == 0) {
                qrbuf.QRflags2 |= QR2_SYSTEM;
                lputroom(&qrbuf);
        }

        /* Perform any create functions registered by server extensions */
        PerformUserHooks(&usbuf, EVT_NEWUSER);

        /* Everything below this line can be bypassed if administratively
         * creating a user, instead of doing self-service account creation
         */

        if (become_user) {
                /* Now become the user we just created */
                memcpy(&CC->user, &usbuf, sizeof(struct ctdluser));
                safestrncpy(CC->curr_user, username, sizeof CC->curr_user);
                do_login();
        
                /* Check to make sure we're still who we think we are */
                if (getuser(&CC->user, CC->curr_user)) {
                        return (ERROR + INTERNAL_ERROR);
                }
        }
        
        snprintf(buf, SIZ, 
                "New user account <%s> has been created, from host %s [%s].\n",
                username,
                CC->cs_host,
                CC->cs_addr
        );
        aide_message(buf, "User Creation Notice");
        CtdlLogPrintf(CTDL_NOTICE, "New user <%s> created\n", username);
        return (0);
}



/*
 * cmd_newu()  -  create a new user account and log in as that user
 */
void cmd_newu(char *cmdbuf)
{
        int a;
        char username[26];

        if (config.c_auth_mode != AUTHMODE_NATIVE) {
                cprintf("%d This system does not use native mode authentication.\n",
                        ERROR + NOT_HERE);
                return;
        }

        if (config.c_disable_newu) {
                cprintf("%d Self-service user account creation "
                        "is disabled on this system.\n", ERROR + NOT_HERE);
                return;
        }

        if (CC->logged_in) {
                cprintf("%d Already logged in.\n", ERROR + ALREADY_LOGGED_IN);
                return;
        }
        if (CC->nologin) {
                cprintf("%d %s: Too many users are already online (maximum is %d)\n",
                        ERROR + MAX_SESSIONS_EXCEEDED,
                        config.c_nodename, config.c_maxsessions);
        }
        extract_token(username, cmdbuf, 0, '|', sizeof username);
        username[25] = 0;
        strproc(username);

        if (IsEmptyStr(username)) {
                cprintf("%d You must supply a user name.\n", ERROR + USERNAME_REQUIRED);
                return;
        }

        if ((!strcasecmp(username, "bbs")) ||
            (!strcasecmp(username, "new")) ||
            (!strcasecmp(username, "."))) {
                cprintf("%d '%s' is an invalid login name.\n", ERROR + ILLEGAL_VALUE, username);
                return;
        }

        a = create_user(username, 1);

        if (a == 0) {
                logged_in_response();
        } else if (a == ERROR + ALREADY_EXISTS) {
                cprintf("%d '%s' already exists.\n",
                        ERROR + ALREADY_EXISTS, username);
                return;
        } else if (a == ERROR + INTERNAL_ERROR) {
                cprintf("%d Internal error - user record disappeared?\n",
                        ERROR + INTERNAL_ERROR);
                return;
        } else {
                cprintf("%d unknown error\n", ERROR + INTERNAL_ERROR);
        }
}


/*
 * set password - back end api code
 */
void CtdlSetPassword(char *new_pw)
{
        lgetuser(&CC->user, CC->curr_user);
        safestrncpy(CC->user.password, new_pw, sizeof(CC->user.password));
        lputuser(&CC->user);
        CtdlLogPrintf(CTDL_INFO, "Password changed for user <%s>\n", CC->curr_user);
        PerformSessionHooks(EVT_SETPASS);
}


/*
 * set password - citadel protocol implementation
 */
void cmd_setp(char *new_pw)
{
        int generate_random_password = 0;

        if (CtdlAccessCheck(ac_logged_in)) {
                return;
        }
        if ( (CC->user.uid != CTDLUID) && (CC->user.uid != (-1)) ) {
                cprintf("%d Not allowed.  Use the 'passwd' command.\n", ERROR + NOT_HERE);
                return;
        }
        if (CC->is_master) {
                cprintf("%d The master prefix password cannot be changed with this command.\n",
                        ERROR + NOT_HERE);
                return;
        }

        if (!strcasecmp(new_pw, "GENERATE_RANDOM_PASSWORD")) {
                char random_password[17];
                generate_random_password = 1;
                snprintf(random_password, sizeof random_password, "%08lx%08lx", random(), random());
                CtdlSetPassword(random_password);
                cprintf("%d %s\n", CIT_OK, random_password);
        }
        else {
                strproc(new_pw);
                if (IsEmptyStr(new_pw)) {
                        cprintf("%d Password unchanged.\n", CIT_OK);
                        return;
                }
                CtdlSetPassword(new_pw);
                cprintf("%d Password changed.\n", CIT_OK);
        }
}


/*
 * cmd_creu() - administratively create a new user account (do not log in to it)
 */
void cmd_creu(char *cmdbuf)
{
        int a;
        char username[26];
        char password[32];
        struct ctdluser tmp;

        if (CtdlAccessCheck(ac_aide)) {
                return;
        }

        extract_token(username, cmdbuf, 0, '|', sizeof username);
        extract_token(password, cmdbuf, 1, '|', sizeof password);
        username[25] = 0;
        password[31] = 0;
        strproc(username);
        strproc(password);

        if (IsEmptyStr(username)) {
                cprintf("%d You must supply a user name.\n", ERROR + USERNAME_REQUIRED);
                return;
        }

        a = create_user(username, 0);

        if (a == 0) {
                if (!IsEmptyStr(password)) {
                        lgetuser(&tmp, username);
                        safestrncpy(tmp.password, password, sizeof(tmp.password));
                        lputuser(&tmp);
                }
                cprintf("%d User '%s' created %s.\n", CIT_OK, username,
                                (!IsEmptyStr(password)) ? "and password set" :
                                "with no password");
                return;
        } else if (a == ERROR + ALREADY_EXISTS) {
                cprintf("%d '%s' already exists.\n", ERROR + ALREADY_EXISTS, username);
                return;
        } else if ( (config.c_auth_mode != AUTHMODE_NATIVE) && (a == ERROR + NO_SUCH_USER) ) {
                cprintf("%d User accounts are not created within Citadel in host authentication mode.\n",
                        ERROR + NO_SUCH_USER);
                return;
        } else {
                cprintf("%d An error occurred creating the user account.\n", ERROR + INTERNAL_ERROR);
        }
}



/*
 * get user parameters
 */
void cmd_getu(void)
{

        if (CtdlAccessCheck(ac_logged_in))
                return;

        getuser(&CC->user, CC->curr_user);
        cprintf("%d %d|%d|%d|\n",
                CIT_OK,
                CC->user.USscreenwidth,
                CC->user.USscreenheight,
                (CC->user.flags & US_USER_SET)
            );
}

/*
 * set user parameters
 */
void cmd_setu(char *new_parms)
{
        if (CtdlAccessCheck(ac_logged_in))
                return;

        if (num_parms(new_parms) < 3) {
                cprintf("%d Usage error.\n", ERROR + ILLEGAL_VALUE);
                return;
        }
        lgetuser(&CC->user, CC->curr_user);
        CC->user.USscreenwidth = extract_int(new_parms, 0);
        CC->user.USscreenheight = extract_int(new_parms, 1);
        CC->user.flags = CC->user.flags & (~US_USER_SET);
        CC->user.flags = CC->user.flags |
            (extract_int(new_parms, 2) & US_USER_SET);

        lputuser(&CC->user);
        cprintf("%d Ok\n", CIT_OK);
}

/*
 * set last read pointer
 */
void cmd_slrp(char *new_ptr)
{
        long newlr;
        struct visit vbuf;
        struct visit original_vbuf;

        if (CtdlAccessCheck(ac_logged_in)) {
                return;
        }

        if (!strncasecmp(new_ptr, "highest", 7)) {
                newlr = CC->room.QRhighest;
        } else {
                newlr = atol(new_ptr);
        }

        lgetuser(&CC->user, CC->curr_user);

        CtdlGetRelationship(&vbuf, &CC->user, &CC->room);
        memcpy(&original_vbuf, &vbuf, sizeof(struct visit));
        vbuf.v_lastseen = newlr;
        snprintf(vbuf.v_seen, sizeof vbuf.v_seen, "*:%ld", newlr);

        /* Only rewrite the record if it changed */
        if ( (vbuf.v_lastseen != original_vbuf.v_lastseen)
           || (strcmp(vbuf.v_seen, original_vbuf.v_seen)) ) {
                CtdlSetRelationship(&vbuf, &CC->user, &CC->room);
        }

        lputuser(&CC->user);
        cprintf("%d %ld\n", CIT_OK, newlr);
}


void cmd_seen(char *argbuf) {
        long target_msgnum = 0L;
        int target_setting = 0;

        if (CtdlAccessCheck(ac_logged_in)) {
                return;
        }

        if (num_parms(argbuf) != 2) {
                cprintf("%d Invalid parameters\n", ERROR + ILLEGAL_VALUE);
                return;
        }

        target_msgnum = extract_long(argbuf, 0);
        target_setting = extract_int(argbuf, 1);

        CtdlSetSeen(&target_msgnum, 1, target_setting,
                        ctdlsetseen_seen, NULL, NULL);
        cprintf("%d OK\n", CIT_OK);
}


void cmd_gtsn(char *argbuf) {
        char buf[SIZ];

        if (CtdlAccessCheck(ac_logged_in)) {
                return;
        }

        CtdlGetSeen(buf, ctdlsetseen_seen);
        cprintf("%d %s\n", CIT_OK, buf);
}


/*
 * API function for cmd_invt_kick() and anything else that needs to
 * invite or kick out a user to/from a room.
 * 
 * Set iuser to the name of the user, and op to 1=invite or 0=kick
 */
int CtdlInvtKick(char *iuser, int op) {
        struct ctdluser USscratch;
        struct visit vbuf;
        char bbb[SIZ];

        if (getuser(&USscratch, iuser) != 0) {
                return(1);
        }

        CtdlGetRelationship(&vbuf, &USscratch, &CC->room);
        if (op == 1) {
                vbuf.v_flags = vbuf.v_flags & ~V_FORGET & ~V_LOCKOUT;
                vbuf.v_flags = vbuf.v_flags | V_ACCESS;
        }
        if (op == 0) {
                vbuf.v_flags = vbuf.v_flags & ~V_ACCESS;
                vbuf.v_flags = vbuf.v_flags | V_FORGET | V_LOCKOUT;
        }
        CtdlSetRelationship(&vbuf, &USscratch, &CC->room);

        /* post a message in Aide> saying what we just did */
        snprintf(bbb, sizeof bbb, "%s has been %s \"%s\" by %s.\n",
                iuser,
                ((op == 1) ? "invited to" : "kicked out of"),
                CC->room.QRname,
                CC->user.fullname);
        aide_message(bbb,"User Admin Message");

        return(0);
}


/*
 * INVT and KICK commands
 */
void cmd_invt_kick(char *iuser, int op) {

        /*
         * These commands are only allowed by aides, room aides,
         * and room namespace owners
         */
        if (is_room_aide()
           || (atol(CC->room.QRname) == CC->user.usernum) ) {
                /* access granted */
        } else {
                /* access denied */
                cprintf("%d Higher access or room ownership required.\n",
                        ERROR + HIGHER_ACCESS_REQUIRED);
                return;
        }

        if (!strncasecmp(CC->room.QRname, config.c_baseroom,
                         ROOMNAMELEN)) {
                cprintf("%d Can't add/remove users from this room.\n",
                        ERROR + NOT_HERE);
                return;
        }

        if (CtdlInvtKick(iuser, op) != 0) {
                cprintf("%d No such user.\n", ERROR + NO_SUCH_USER);
                return;
        }

        cprintf("%d %s %s %s.\n",
                CIT_OK, iuser,
                ((op == 1) ? "invited to" : "kicked out of"),
                CC->room.QRname);
        return;
}


/*
 * Forget (Zap) the current room (API call)
 * Returns 0 on success
 */
int CtdlForgetThisRoom(void) {
        struct visit vbuf;

        /* On some systems, Aides are not allowed to forget rooms */
        if (is_aide() && (config.c_aide_zap == 0)
           && ((CC->room.QRflags & QR_MAILBOX) == 0)  ) {
                return(1);
        }

        lgetuser(&CC->user, CC->curr_user);
        CtdlGetRelationship(&vbuf, &CC->user, &CC->room);

        vbuf.v_flags = vbuf.v_flags | V_FORGET;
        vbuf.v_flags = vbuf.v_flags & ~V_ACCESS;

        CtdlSetRelationship(&vbuf, &CC->user, &CC->room);
        lputuser(&CC->user);

        /* Return to the Lobby, so we don't end up in an undefined room */
        usergoto(config.c_baseroom, 0, 0, NULL, NULL);
        return(0);

}


/*
 * forget (Zap) the current room
 */
void cmd_forg(void)
{

        if (CtdlAccessCheck(ac_logged_in)) {
                return;
        }

        if (CtdlForgetThisRoom() == 0) {
                cprintf("%d Ok\n", CIT_OK);
        }
        else {
                cprintf("%d You may not forget this room.\n", ERROR + NOT_HERE);
        }
}

/*
 * Get Next Unregistered User
 */
void cmd_gnur(void)
{
        struct cdbdata *cdbus;
        struct ctdluser usbuf;

        if (CtdlAccessCheck(ac_aide)) {
                return;
        }

        if ((CitControl.MMflags & MM_VALID) == 0) {
                cprintf("%d There are no unvalidated users.\n", CIT_OK);
                return;
        }

        /* There are unvalidated users.  Traverse the user database,
         * and return the first user we find that needs validation.
         */
        cdb_rewind(CDB_USERS);
        while (cdbus = cdb_next_item(CDB_USERS), cdbus != NULL) {
                memset(&usbuf, 0, sizeof(struct ctdluser));
                memcpy(&usbuf, cdbus->ptr,
                       ((cdbus->len > sizeof(struct ctdluser)) ?
                        sizeof(struct ctdluser) : cdbus->len));
                cdb_free(cdbus);
                if ((usbuf.flags & US_NEEDVALID)
                    && (usbuf.axlevel > 0)) {
                        cprintf("%d %s\n", MORE_DATA, usbuf.fullname);
                        cdb_close_cursor(CDB_USERS);
                        return;
                }
        }

        /* If we get to this point, there are no more unvalidated users.
         * Therefore we clear the "users need validation" flag.
         */

        begin_critical_section(S_CONTROL);
        get_control();
        CitControl.MMflags = CitControl.MMflags & (~MM_VALID);
        put_control();
        end_critical_section(S_CONTROL);
        cprintf("%d *** End of registration.\n", CIT_OK);


}


/*
 * validate a user
 */
void cmd_vali(char *v_args)
{
        char user[128];
        int newax;
        struct ctdluser userbuf;

        extract_token(user, v_args, 0, '|', sizeof user);
        newax = extract_int(v_args, 1);

        if (CtdlAccessCheck(ac_aide)) {
                return;
        }

        if (lgetuser(&userbuf, user) != 0) {
                cprintf("%d '%s' not found.\n", ERROR + NO_SUCH_USER, user);
                return;
        }

        userbuf.axlevel = newax;
        userbuf.flags = (userbuf.flags & ~US_NEEDVALID);

        lputuser(&userbuf);

        /* If the access level was set to zero, delete the user */
        if (newax == 0) {
                if (purge_user(user) == 0) {
                        cprintf("%d %s Deleted.\n", CIT_OK, userbuf.fullname);
                        return;
                }
        }
        cprintf("%d User '%s' validated.\n", CIT_OK, userbuf.fullname);
}



/* 
 *  Traverse the user file...
 */
void ForEachUser(void (*CallBack) (struct ctdluser * EachUser, void *out_data),
                 void *in_data)
{
        struct ctdluser usbuf;
        struct cdbdata *cdbus;

        cdb_rewind(CDB_USERS);

        while (cdbus = cdb_next_item(CDB_USERS), cdbus != NULL) {
                memset(&usbuf, 0, sizeof(struct ctdluser));
                memcpy(&usbuf, cdbus->ptr,
                       ((cdbus->len > sizeof(struct ctdluser)) ?
                        sizeof(struct ctdluser) : cdbus->len));
                cdb_free(cdbus);
                (*CallBack) (&usbuf, in_data);
        }
}


/*
 * List one user (this works with cmd_list)
 */
void ListThisUser(struct ctdluser *usbuf, void *data)
{
        char *searchstring;

        searchstring = (char *)data;
        if (bmstrcasestr(usbuf->fullname, searchstring) == NULL) {
                return;
        }

        if (usbuf->axlevel > 0) {
                if ((CC->user.axlevel >= 6)
                    || ((usbuf->flags & US_UNLISTED) == 0)
                    || ((CC->internal_pgm))) {
                        cprintf("%s|%d|%ld|%ld|%ld|%ld||\n",
                                usbuf->fullname,
                                usbuf->axlevel,
                                usbuf->usernum,
                                (long)usbuf->lastcall,
                                usbuf->timescalled,
                                usbuf->posted);
                }
        }
}

/* 
 *  List users (searchstring may be empty to list all users)
 */
void cmd_list(char *cmdbuf)
{
        char searchstring[256];
        extract_token(searchstring, cmdbuf, 0, '|', sizeof searchstring);
        striplt(searchstring);
        cprintf("%d \n", LISTING_FOLLOWS);
        ForEachUser(ListThisUser, (void *)searchstring );
        cprintf("000\n");
}




/*
 * assorted info we need to check at login
 */
void cmd_chek(void)
{
        int mail = 0;
        int regis = 0;
        int vali = 0;

        if (CtdlAccessCheck(ac_logged_in)) {
                return;
        }

        getuser(&CC->user, CC->curr_user);      /* no lock is needed here */
        if ((REGISCALL != 0) && ((CC->user.flags & US_REGIS) == 0))
                regis = 1;

        if (CC->user.axlevel >= 6) {
                get_control();
                if (CitControl.MMflags & MM_VALID)
                        vali = 1;
        }

        /* check for mail */
        mail = InitialMailCheck();

        cprintf("%d %d|%d|%d|%s|\n", CIT_OK, mail, regis, vali, CC->cs_inet_email);
}


/*
 * check to see if a user exists
 */
void cmd_qusr(char *who)
{
        struct ctdluser usbuf;

        if (getuser(&usbuf, who) == 0) {
                cprintf("%d %s\n", CIT_OK, usbuf.fullname);
        } else {
                cprintf("%d No such user.\n", ERROR + NO_SUCH_USER);
        }
}


/*
 * Administrative Get User Parameters
 */
void cmd_agup(char *cmdbuf)
{
        struct ctdluser usbuf;
        char requested_user[128];

        if (CtdlAccessCheck(ac_aide)) {
                return;
        }

        extract_token(requested_user, cmdbuf, 0, '|', sizeof requested_user);
        if (getuser(&usbuf, requested_user) != 0) {
                cprintf("%d No such user.\n", ERROR + NO_SUCH_USER);
                return;
        }
        cprintf("%d %s|%s|%u|%ld|%ld|%d|%ld|%ld|%d\n",
                CIT_OK,
                usbuf.fullname,
                usbuf.password,
                usbuf.flags,
                usbuf.timescalled,
                usbuf.posted,
                (int) usbuf.axlevel,
                usbuf.usernum,
                (long)usbuf.lastcall,
                usbuf.USuserpurge);
}



/*
 * Administrative Set User Parameters
 */
void cmd_asup(char *cmdbuf)
{
        struct ctdluser usbuf;
        char requested_user[128];
        char notify[SIZ];
        int np;
        int newax;
        int deleted = 0;

        if (CtdlAccessCheck(ac_aide))
                return;

        extract_token(requested_user, cmdbuf, 0, '|', sizeof requested_user);
        if (lgetuser(&usbuf, requested_user) != 0) {
                cprintf("%d No such user.\n", ERROR + NO_SUCH_USER);
                return;
        }
        np = num_parms(cmdbuf);
        if (np > 1)
                extract_token(usbuf.password, cmdbuf, 1, '|', sizeof usbuf.password);
        if (np > 2)
                usbuf.flags = extract_int(cmdbuf, 2);
        if (np > 3)
                usbuf.timescalled = extract_int(cmdbuf, 3);
        if (np > 4)
                usbuf.posted = extract_int(cmdbuf, 4);
        if (np > 5) {
                newax = extract_int(cmdbuf, 5);
                if ((newax >= 0) && (newax <= 6)) {
                        usbuf.axlevel = extract_int(cmdbuf, 5);
                }
        }
        if (np > 7) {
                usbuf.lastcall = extract_long(cmdbuf, 7);
        }
        if (np > 8) {
                usbuf.USuserpurge = extract_int(cmdbuf, 8);
        }
        lputuser(&usbuf);
        if (usbuf.axlevel == 0) {
                if (purge_user(requested_user) == 0) {
                        deleted = 1;
                }
        }

        if (deleted) {
                snprintf(notify, SIZ, 
                         "User \"%s\" has been deleted by %s.\n",
                         usbuf.fullname, CC->user.fullname);
                aide_message(notify, "User Deletion Message");
        }

        cprintf("%d Ok", CIT_OK);
        if (deleted)
                cprintf(" (%s deleted)", requested_user);
        cprintf("\n");
}



/*
 * Check to see if the user who we just sent mail to is logged in.  If yes,
 * bump the 'new mail' counter for their session.  That enables them to
 * receive a new mail notification without having to hit the database.
 */
void BumpNewMailCounter(long which_user) {
        struct CitContext *ptr;

        begin_critical_section(S_SESSION_TABLE);

        for (ptr = ContextList; ptr != NULL; ptr = ptr->next) {
                if (ptr->user.usernum == which_user) {
                        ptr->newmail += 1;
                }
        }

        end_critical_section(S_SESSION_TABLE);
}


/*
 * Count the number of new mail messages the user has
 */
int NewMailCount()
{
        int num_newmsgs = 0;

        num_newmsgs = CC->newmail;
        CC->newmail = 0;

        return (num_newmsgs);
}


/*
 * Count the number of new mail messages the user has
 */
int InitialMailCheck()
{
        int num_newmsgs = 0;
        int a;
        char mailboxname[ROOMNAMELEN];
        struct ctdlroom mailbox;
        struct visit vbuf;
        struct cdbdata *cdbfr;
        long *msglist = NULL;
        int num_msgs = 0;

        MailboxName(mailboxname, sizeof mailboxname, &CC->user, MAILROOM);
        if (getroom(&mailbox, mailboxname) != 0)
                return (0);
        CtdlGetRelationship(&vbuf, &CC->user, &mailbox);

        cdbfr = cdb_fetch(CDB_MSGLISTS, &mailbox.QRnumber, sizeof(long));

        if (cdbfr != NULL) {
                msglist = malloc(cdbfr->len);
                memcpy(msglist, cdbfr->ptr, cdbfr->len);
                num_msgs = cdbfr->len / sizeof(long);
                cdb_free(cdbfr);
        }
        if (num_msgs > 0)
                for (a = 0; a < num_msgs; ++a) {
                        if (msglist[a] > 0L) {
                                if (msglist[a] > vbuf.v_lastseen) {
                                        ++num_newmsgs;
                                }
                        }
                }
        if (msglist != NULL)
                free(msglist);

        return (num_newmsgs);
}



/*
 * Set the preferred view for the current user/room combination
 */
void cmd_view(char *cmdbuf) {
        int requested_view;
        struct visit vbuf;

        if (CtdlAccessCheck(ac_logged_in)) {
                return;
        }

        requested_view = extract_int(cmdbuf, 0);

        CtdlGetRelationship(&vbuf, &CC->user, &CC->room);
        vbuf.v_view = requested_view;
        CtdlSetRelationship(&vbuf, &CC->user, &CC->room);
        
        cprintf("%d ok\n", CIT_OK);
}


/*
 * Rename a user
 */
void cmd_renu(char *cmdbuf)
{
        int retcode;
        char oldname[USERNAME_SIZE];
        char newname[USERNAME_SIZE];

        if (CtdlAccessCheck(ac_aide)) {
                return;
        }

        extract_token(oldname, cmdbuf, 0, '|', sizeof oldname);
        extract_token(newname, cmdbuf, 1, '|', sizeof newname);

        retcode = rename_user(oldname, newname);
        switch(retcode) {
                case RENAMEUSER_OK:
                        cprintf("%d '%s' has been renamed to '%s'.\n", CIT_OK, oldname, newname);
                        return;
                case RENAMEUSER_LOGGED_IN:
                        cprintf("%d '%s' is currently logged in and cannot be renamed.\n",
                                ERROR + ALREADY_LOGGED_IN , oldname);
                        return;
                case RENAMEUSER_NOT_FOUND:
                        cprintf("%d '%s' does not exist.\n", ERROR + NO_SUCH_USER, oldname);
                        return;
                case RENAMEUSER_ALREADY_EXISTS:
                        cprintf("%d A user named '%s' already exists.\n", ERROR + ALREADY_EXISTS, newname);
                        return;
        }

        cprintf("%d An unknown error occurred.\n", ERROR);
}