mkuser

Package: WA2L/edrc 1.5.57
Section: Library Commands (3)
Updated: 08 April 2006
Index Return to Main Contents

NAME

mkuser - Initialize User's Home Directory

SYNOPSIS

mkuser -u uid -g gid -d directory [ -c class ] [ -m umask ] [ -s server ] [ -f ]

AVAILABILITY

WA2L/edrc

DESCRIPTION

Used to initialize a user's home directory according to predefined classes. mkuser will not overwrite an existing directory, unless -f is given, The user' home directory is created, standard files, directories and symbolic links are copied, and the permissions are set. More than one user may be created, but all must be of the same class.

OPTIONS

-u uid

The user id of the desired user. If this is specified as a number, the creation will succeed, even if the user has not yet been created in the passwd map.

-g gid

The group id of the desired user. If this is specified as a number, the creation will succeed, even if the user has not yet been created in the passwd map.

-d directory

The physical path of the directory to be created. This is probably not the entry placed in the home directory field of the passwd entry, because the user's home directory will usually be mounted with automounter. Before it can be auto-mounted, it must physically exist.

-s server

Specify the server on which the homedir shall be created. It must be possible to reference the server via /net/server, and the parent directory must be exported with root permissions so that the directory may be created and ownership may be set.

-c class

If present, this option specifies the initialization "class" (or template) for the user. If specified, then files (.login, etc.) and directories are recursively copied from ~sfitools/classes/<class> or from $CLASSES_DIR/classes/<class> if the environment variable $CLASSES_DIR is set. Otherwise, the directory is created and the ownership is set, but no other initialization takes place.

-f

Force initialization. Copies the standard configuration (according to -c option, if present) and sets permissions even if directory already exists. Useful if a user has deleted his "dot-files". If mkuser must overwrite a file, it will use the command sav -D mkuser file to backup the original version of file. It does not overwrite files which match the pattern .my*.

-m umask

Set the umask for use when creating the directory. (Note: this is not applied to the users profile - this must be set in the corresponding initialization class).

ENVIRONMENT

$CLASSES_DIR

If this environment variable is set mkuser uses the classes files located in this directory for the initialization of the $HOME of new users. See also section FILES.

EXIT STATUS

0

no error.

4

usage displayed.

EXAMPLES

FILES

~sfitools/classes/*

Files for initializing $HOME of new users, may include subdirectories, which will be created.

$CLASSES_DIR/classes/*

Files for initializing $HOME of new users, may include subdirectories, which will be created.

~sfitools/defaults

SFI standard dot-files include the corresponding files from this subdirectory.

NOTES

Parts of this manpage were extracted from the documentation of the SFI-Director and modified to fit to the WA2L/edrc package. See http://sfidirector.sourceforge.net for more information about the SFI-Director.

BUGS

AUTHOR

mkuser was developed by Peter Stevens and integrated into WA2L/edrc by Christian Walther. Send suggestions and bug reports to wa2l@users.sourceforge.net .

COPYRIGHT

This is free software; see edrc/doc/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

This document was created by man2html using the manual pages.
Time: 00:14:14 GMT, March 08, 2025