=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>