# mbuseradd - The useradd wrapper.

###

SYNOPSIS

mbuseradd [gid] [username] [comment] [userdir]

###

DESCRIPTION

mbuseradd is the wrapper for the useradd program that should be present on most Linux systems. useradd may only be executed by root and there are some other minor things that need to be done as root to create a new Unix account that can be used with MBSE BBS. The solution for these problems is mbuseradd, this little program runs setuid root and setgid root. If it fails to do that it aborts. mbuseradd is called by mbsebbs from the newuser function. You never need to run mbuseradd by hand. If it is successfull the user will have an entry in /etc/passwd, the comment is his Fidonet name, and his shell is $MBSE_ROOT/bin/mbsebbs.

If mbuseradd created the Unix account, the user must enter a new Unix password, this is forced by mbuseradd that executes passwd [username]. The new user must then type his new Unix password twice before it is accepted.

If all this is successfull until now, the homedirectory for this user is created and the right ownership and permissions are set. In his homedirectory the empty file .hushlogin is placed to prevent check for new mail when he logs into your system. This is the Unix mailcheck that is skipped and has nothing todo with the check for new mail in the bbs.

Finally, the user is added to the file /etc/ftpusers to prevent that he can ftp into your system with his Unix account and thus can have access to important data on your system.

###

ENVIRONMENT

In order to run mbuseradd you must set the global variable $MBSE_ROOT. This variable must point to the root directory of the bbs structure. The main configuration file config.data must be present in the ~/etc directory. mbuseradd must be installed setuid root and setgid root, ls -la looks like this:

    -rws--s--x   1 root     root         6644 Jun 26 21:23 /opt/mbse/bin/mbuseradd*

###

COMMANDS

mbuseradd [gid] [name] [comment] [usersdir] for example:

    mbuseradd bbs mbroek "Michiel Broek" /opt/mbse/home

###

BUGS

If you find any bugs, mispelled documentation etc, please contact the author: Michiel Broek at 2:2801/16@Fidonet or Michiel_Broek@f16.n2801.z2.fidonet.org

Back to index Back to Main index