diff -r 000000000000 -r 6f7a81934006 commands/vchattr.pod
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/commands/vchattr.pod	Wed Jan 16 22:39:43 2008 +0100
@@ -0,0 +1,100 @@
+=head1 NAME
+
+vchattr - Changes the attributes on one or more virtual users
+
+=head1 SYNOPSIS
+
+B<vchattr>
+[B<-c>]
+[B<--msgcount>]
+[B<-e>]
+[B<--expiry>]
+[B<-E>]
+[B<--enabled>]
+[B<-p>]
+[B<--personal>]
+[B<-q>]
+[B<--softquota>]
+[B<-Q>]
+[B<--hardquota>]
+[B<--quiet>]
+[B<-z>]
+[B<--msgsize>]
+I<VALUE USERNAME ...>
+
+=head1 DESCRIPTION
+
+This program changes the value of one attribute on a set of virtual
+users.  It cannot be used to change the user's password or forwarding
+addresses -- use B<vpasswd> and B<vchforwards> to accomplish those
+tasks.
+
+
+=head1 OPTIONS
+
+=over 8
+
+=item B<-c>, B<--msgcount>
+
+Set the user's message count limit.
+
+=item B<-e>, B<--expiry>
+
+Set the account's expiry time (in seconds).
+
+=item B<-E>, B<--enabled>
+
+Enable (C<1>) or disable (C<0>) delivery to the virtual user's mailbox directory.  This does not delete the mailbox or any of the messages contained in or, nor prevent the user from logging in.
+
+=item B<-p>, B<--personal>
+
+Set the user's personal information.
+
+=item B<-q>, B<--softquota>
+
+Set the user's soft quota (in bytes).
+
+=item B<-Q>, B<--hardquota>
+
+Set the user's hard quota (in bytes).
+
+=item B<--quiet>
+
+Suppress all status messages.
+
+=item B<-z>, B<--msgsize>
+
+Set the user's message size limit (in bytes).
+
+=back
+
+=head1 RETURN VALUE
+
+
+0 if the given attribute was successfully changed for all users,
+non-zero otherwise.
+If any of the steps fail, a diagnostic message is printed.
+
+
+
+=head1 SEE ALSO
+
+
+vadduser(1)
+
+
+
+=head1 NOTES
+
+
+This program expects the environment variable C<HOME> to be set, and
+executes a change directory to the contents of it before starting.  It
+is also required that you change user to the domain owner before using
+these utilities.
+
+
+
+=head1 AUTHORS
+
+Bruce Guenter <bruceg@em.ca>
+