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