|
2
|
1 |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
|
2 |
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
|
3 |
<head>
|
|
|
4 |
<title>vrehash - Reorganize users directory\n"
|
|
|
5 |
"Renames user directories in a virtual domain to match the current\n"
|
|
|
6 |
"partitioning scheme</title>
|
|
|
7 |
<link rev="made" href="mailto:Gentoo@lorien.untroubled.org" />
|
|
|
8 |
</head>
|
|
0
|
9 |
|
|
2
|
10 |
<body style="background-color: white">
|
|
0
|
11 |
|
|
2
|
12 |
<p><a name="__index__"></a></p>
|
|
0
|
13 |
<!-- INDEX BEGIN -->
|
|
|
14 |
<!--
|
|
|
15 |
|
|
2
|
16 |
<ul>
|
|
0
|
17 |
|
|
2
|
18 |
<li><a href="#name">NAME</a></li>
|
|
|
19 |
<li><a href="#synopsis">SYNOPSIS</a></li>
|
|
|
20 |
<li><a href="#description">DESCRIPTION</a></li>
|
|
|
21 |
<li><a href="#return_value">RETURN VALUE</a></li>
|
|
|
22 |
<li><a href="#notes">NOTES</a></li>
|
|
|
23 |
<li><a href="#warnings">WARNINGS</a></li>
|
|
|
24 |
<li><a href="#authors">AUTHORS</a></li>
|
|
|
25 |
</ul>
|
|
0
|
26 |
-->
|
|
|
27 |
<!-- INDEX END -->
|
|
|
28 |
|
|
2
|
29 |
<p>
|
|
|
30 |
</p>
|
|
|
31 |
<h1><a name="name">NAME</a></h1>
|
|
|
32 |
<p>vrehash - Reorganize users directory\n``
|
|
|
33 |
''Renames user directories in a virtual domain to match the current\n``
|
|
|
34 |
''partitioning scheme</p>
|
|
|
35 |
<p>
|
|
|
36 |
</p>
|
|
|
37 |
<hr />
|
|
|
38 |
<h1><a name="synopsis">SYNOPSIS</a></h1>
|
|
|
39 |
<p><strong>vrehash</strong></p>
|
|
|
40 |
<p>
|
|
|
41 |
</p>
|
|
|
42 |
<hr />
|
|
|
43 |
<h1><a name="description">DESCRIPTION</a></h1>
|
|
|
44 |
<p>This program is designed to be run after the sysadmin has changed the
|
|
|
45 |
<code>user-dir-bits</code> or <code>user-dir-slices</code> configuration variables.
|
|
|
46 |
It creates a new users directory called <code>new.users</code>, where <code>users</code>
|
|
|
47 |
is the configured name of the user directory.
|
|
|
48 |
It then traverses the password table, creates a new user directory name
|
|
|
49 |
for each user, and moves the user's mail directory to the new
|
|
|
50 |
directory name, creating any necessary directories as it goes.
|
|
|
51 |
Any alias entries in the password table are copied as-is.</p>
|
|
|
52 |
<p>
|
|
|
53 |
</p>
|
|
|
54 |
<hr />
|
|
|
55 |
<h1><a name="return_value">RETURN VALUE</a></h1>
|
|
|
56 |
<p>Returns 1 if any part of the process fails; 0 otherwise.</p>
|
|
|
57 |
<p>
|
|
|
58 |
</p>
|
|
|
59 |
<hr />
|
|
|
60 |
<h1><a name="notes">NOTES</a></h1>
|
|
|
61 |
<p>When the process is completed, a the old users directory will have
|
|
|
62 |
been moved to <code>backup.users</code>.
|
|
|
63 |
If no errors occurred, you should be able to safely delete this
|
|
|
64 |
directory and all its subdirectories.
|
|
|
65 |
Check this directory first, though, to ensure that no important files
|
|
|
66 |
remain.</p>
|
|
|
67 |
<p>
|
|
|
68 |
</p>
|
|
|
69 |
<hr />
|
|
|
70 |
<h1><a name="warnings">WARNINGS</a></h1>
|
|
|
71 |
<p>This program is not particularly careful to clean up after itself if
|
|
|
72 |
an error occurs.
|
|
|
73 |
If an error occurs, you will have to check the status of the current
|
|
|
74 |
directory, the virtual password file, and all the virtual users
|
|
|
75 |
subdirectories in both <code>users</code> and <code>new.users</code>.</p>
|
|
|
76 |
<p>
|
|
|
77 |
</p>
|
|
|
78 |
<hr />
|
|
|
79 |
<h1><a name="authors">AUTHORS</a></h1>
|
|
|
80 |
<p>Bruce Guenter <<a href="mailto:bruceg@em.ca">bruceg@em.ca</a>></p>
|
|
0
|
81 |
|
|
2
|
82 |
</body>
|
|
0
|
83 |
|
|
2
|
84 |
</html>
|