<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>vrehash - Reorganize users directory\n"
"Renames user directories in a virtual domain to match the current\n"
"partitioning scheme</title>
<link rev="made" href="mailto:Gentoo@lorien.untroubled.org" />
</head>
<body style="background-color: white">
<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->
<!--
<ul>
<li><a href="#name">NAME</a></li>
<li><a href="#synopsis">SYNOPSIS</a></li>
<li><a href="#description">DESCRIPTION</a></li>
<li><a href="#return_value">RETURN VALUE</a></li>
<li><a href="#notes">NOTES</a></li>
<li><a href="#warnings">WARNINGS</a></li>
<li><a href="#authors">AUTHORS</a></li>
</ul>
-->
<!-- INDEX END -->
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>vrehash - Reorganize users directory\n``
''Renames user directories in a virtual domain to match the current\n``
''partitioning scheme</p>
<p>
</p>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
<p><strong>vrehash</strong></p>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<p>This program is designed to be run after the sysadmin has changed the
<code>user-dir-bits</code> or <code>user-dir-slices</code> configuration variables.
It creates a new users directory called <code>new.users</code>, where <code>users</code>
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.</p>
<p>
</p>
<hr />
<h1><a name="return_value">RETURN VALUE</a></h1>
<p>Returns 1 if any part of the process fails; 0 otherwise.</p>
<p>
</p>
<hr />
<h1><a name="notes">NOTES</a></h1>
<p>When the process is completed, a the old users directory will have
been moved to <code>backup.users</code>.
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.</p>
<p>
</p>
<hr />
<h1><a name="warnings">WARNINGS</a></h1>
<p>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 <code>users</code> and <code>new.users</code>.</p>
<p>
</p>
<hr />
<h1><a name="authors">AUTHORS</a></h1>
<p>Bruce Guenter <<a href="mailto:bruceg@em.ca">bruceg@em.ca</a>></p>
</body>
</html>