|
1 <HTML> |
|
2 <HEAD> |
|
3 <TITLE>vrehash - Reorganize users directory\n" |
|
4 "Renames user directories in a virtual domain to match the current\n" |
|
5 "partitioning scheme</TITLE> |
|
6 <LINK REV="made" HREF="mailto:root@porky.devel.redhat.com"> |
|
7 </HEAD> |
|
8 |
|
9 <BODY> |
|
10 |
|
11 <!-- INDEX BEGIN --> |
|
12 <!-- |
|
13 |
|
14 <UL> |
|
15 |
|
16 <LI><A HREF="#NAME">NAME</A> |
|
17 <LI><A HREF="#SYNOPSIS">SYNOPSIS</A> |
|
18 <LI><A HREF="#DESCRIPTION">DESCRIPTION</A> |
|
19 <LI><A HREF="#RETURN_VALUE">RETURN VALUE</A> |
|
20 <LI><A HREF="#NOTES">NOTES</A> |
|
21 <LI><A HREF="#WARNINGS">WARNINGS</A> |
|
22 <LI><A HREF="#AUTHORS">AUTHORS</A> |
|
23 </UL> |
|
24 --> |
|
25 <!-- INDEX END --> |
|
26 |
|
27 <P> |
|
28 <H1><A NAME="NAME">NAME</A></H1> |
|
29 <P> |
|
30 vrehash - Reorganize users directory\n`` ''Renames user directories in a |
|
31 virtual domain to match the current\n`` ''partitioning scheme |
|
32 |
|
33 <P> |
|
34 <HR> |
|
35 <H1><A NAME="SYNOPSIS">SYNOPSIS</A></H1> |
|
36 <P> |
|
37 <STRONG>vrehash</STRONG> |
|
38 |
|
39 |
|
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> |