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