diff -r 30113bfbe723 -r b3afb9f1e801 commands/vrehash.html --- a/commands/vrehash.html Sun Jan 20 00:12:17 2008 +0100 +++ b/commands/vrehash.html Sun Jan 20 00:22:09 2008 +0100 @@ -1,85 +1,84 @@ - - -vrehash - Reorganize users directory\n" -"Renames user directories in a virtual domain to match the current\n" -"partitioning scheme - - + + + +vrehash - Reorganize users directory\n" +"Renames user directories in a virtual domain to match the current\n" +"partitioning scheme + + - + +

-

-

NAME

-

-vrehash - Reorganize users directory\n`` ''Renames user directories in a -virtual domain to match the current\n`` ''partitioning scheme - -

-


-

SYNOPSIS

-

-vrehash - - - -

-


-

DESCRIPTION

-

-This program is designed to be run after the sysadmin has changed the -user-dir-bits or user-dir-slices configuration variables. It creates a new users directory called new.users, where users -is the configured name of the user directory. It then traverses the -password table, creates a new user directory name for each user, and moves -the user's mail directory to the new directory name, creating any necessary -directories as it goes. Any alias entries in the password table are copied -as-is. +

+

+

NAME

+

vrehash - Reorganize users directory\n`` +''Renames user directories in a virtual domain to match the current\n`` +''partitioning scheme

+

+

+
+

SYNOPSIS

+

vrehash

+

+

+
+

DESCRIPTION

+

This program is designed to be run after the sysadmin has changed the +user-dir-bits or user-dir-slices configuration variables. +It creates a new users directory called new.users, where users +is the configured name of the user directory. +It then traverses the password table, creates a new user directory name +for each user, and moves the user's mail directory to the new +directory name, creating any necessary directories as it goes. +Any alias entries in the password table are copied as-is.

+

+

+
+

RETURN VALUE

+

Returns 1 if any part of the process fails; 0 otherwise.

+

+

+
+

NOTES

+

When the process is completed, a the old users directory will have +been moved to backup.users. +If no errors occurred, you should be able to safely delete this +directory and all its subdirectories. +Check this directory first, though, to ensure that no important files +remain.

+

+

+
+

WARNINGS

+

This program is not particularly careful to clean up after itself if +an error occurs. +If an error occurs, you will have to check the status of the current +directory, the virtual password file, and all the virtual users +subdirectories in both users and new.users.

+

+

+
+

AUTHORS

+

Bruce Guenter <bruceg@em.ca>

-

-


-

RETURN VALUE

-

-Returns 1 if any part of the process fails; 0 otherwise. - -

-


-

NOTES

-

-When the process is completed, a the old users directory will have been -moved to backup.users. If no errors occurred, you should be able to safely delete this directory -and all its subdirectories. Check this directory first, though, to ensure -that no important files remain. + -

-


-

WARNINGS

-

-This program is not particularly careful to clean up after itself if an -error occurs. If an error occurs, you will have to check the status of the -current directory, the virtual password file, and all the virtual users -subdirectories in both users and new.users. - -

-


-

AUTHORS

-

-Bruce Guenter <bruceg@em.ca> - - - - +