=head1 NAME

vcheckquota - vmailmgr quota enforcement program

=head1 SYNOPSIS

B<vcheckquota>
[B<-a UINT>]
[B<--soft-maxsize=UINT>]
[B<-m STR>]
[B<--soft-message=STR>]


=head1 DESCRIPTION

F<vcheckquota> ensures that the hard and soft quotas are enforced,
that message counts and sizes are appropriately limited.
The limits are set by the vadduser or vchattr command.

The following rules are applied:

=over 8

=item 1

If the message is larger than the message size limit, it is rejected.

=item 2

If the user has too many messages in their mailbox,
further messages are rejected.

=item 3

If the user is over their hard quota, all further messages are rejected
and no warning messages are linked in.

=item 4

If the user is over their soft quota, and the message is small
(as defined by I<soft-maxsize>), the message is accepted, otherwise
it is rejected.  If I<soft-message> is defined, a warning message
is linked into the mailbox in either case.

=back



Warning: the soft-message is linked into the users maildir once for each
message that is received while the account is over its soft quota.  This may
result in multiple warning messages.


=head1 OPTIONS

=over 8

=item B<-a UINT>, B<--soft-maxsize=UINT>

The maximum message size after soft quota is reached. Defaults to 4096.

=item B<-m STR>, B<--soft-message=STR>

The path to the soft quota warning message. Defaults to no message.

=back

=head1 SEE ALSO


vadduser(1), vchattr(1)



=head1 AUTHORS

Bruce Guenter <bruceg@em.ca>