Name

maildrop — mail delivery filter/agent

Synopsis

maildrop [option...] [-d user] [arg...]

maildrop [option...] [filename] [arg...]

DESCRIPTION

maildrop is a replacement local mail delivery agent that includes a mail filtering language. The system administrator can either replace the existing mail delivery agent with maildrop, or users may run maildrop using the 'forward to program' mechanism of the existing mail delivery agent.

maildrop first reads the E-mail message on standard input. Trailing carriage return characters are automatically stripped. An E-mail message consists of header lines, followed by a blank line, followed by the contents of the message. The message may contain an mbox-style 3stribution information. -->

Name

maildirquota — voluntary Maildir quotas

Synopsis

maildirmake {-q} {10000000S} {./Maildir}

DESCRIPTION

maildrop has an experimental quota enforcement implementation. This is an option that is set at configuration time, and may be disabled.

Filesystem-based quotas should be used whenever possible. However filesystem-based quotas cannot be used in some situations, such as virtual mailboxes. If this experimental feature is enabled, approximate quota enforcement can be implemented by maildrop or deliverquota to whatever extent it's possible to do so. Quotas are enabled by the -q option to maildirmake. Both maildrop and deliverquota will observe any maildirmake-requested quota.

LIMITATIONS

This quota mechanism will only work as long as maildrop (or deliverquota) are the only applications that deliver messages to the maildir, or as long as other applications implement the same quota enforcement mechanism. The quota enforcement mechanism is described separately in the README.maildirquota.html file in the source code distribution.

Quota enforcement will still work, to some extent, if there are other applications that deliver or modify messages in the maildir. However, quota enforcement may not kick in immediately when the maildir goes over quota, in fact the maildir can go over quota by a noticeable amount. But eventually, as long as maildrop or deliverquota are responsible for delivering the majority of messages, quota enforcement will kick in. Also, other sources of messages may also result in noticeable performance degradation, because quote recalculation will become noticeably more expensive.

Also keep in mind that this quota mechanism is generally useless if mail recipients have direct access to their maildirs.

Finally even under the best conditions this quota enforcement does have a small chance of a race condition where a maildir will go over quota by some amount. maildirs are designed for speed, and this quota implementation was designed to have as little additional overhead as possible, compared to regular maildirs. To enforce an exact quota you would have to use some kind of a locking facility, which will impose a drastic performance degradation on the overall maildir performance. A decision has been made to avoid locking, with the only negative side effect being a possibility of going over quota in very low probability situations.

A way to minimize the risk of going over quota is to set reasonable quotas, in relation to maximum message sizes supported by your mail server. If you set your maildir quota to five megabytes, for example, it makes very little sense to configure your mail server to accept messages up to three megabytes long. Your maildir quota should be chosen so that it makes sense when compared to the maximum message size allowed by your mail server.

FOLDERS

This quota implementation is compatible with a popular extension to maildir which defines individual mail folders within a single maildir. However, in order to create a compatible folder, you MUST use the maildirmake command that comes with maildrop, and you MUST use the -f option to maildirmake, giving the name of the folder. Do not use maildirmake and specify the directory name of the maildir folder. Quota enforcement will not work if you do that.

./usr/share/doc/maildrop/html/maildrop.html0000644000000000000000000007470711330360534017656 0ustar rootroot maildrop

Name

maildrop — mail delivery filter/agent

Synopsis

maildrop [option...] [-d user] [arg...]

maildrop [option...] [filename] [arg...]

DESCRIPTION

maildrop is a replacement local mail delivery agent that includes a mail filtering language. The system administrator can either replace the existing mail delivery agent with maildrop, or users may run maildrop using the 'forward to program' mechanism of the existing mail delivery agent.

maildrop first reads the E-mail message on standard input. Trailing carriage return characters are automatically stripped. An E-mail message consists of header lines, followed by a blank line, followed by the contents of the message. The message may contain an mbox-style 3stribution information. -->

Name

maildirquota — voluntary Maildir quotas

Synopsis

maildirmake {-q} {10000000S} {./Maildir}

DESCRIPTION

maildrop has an experimental quota enforcement implementation. This is an option that is set at configuration time, and may be disabled.

Filesystem-based quotas should be used whenever possible. However filesystem-based quotas cannot be used in some situations, such as virtual mailboxes. If this experimental feature is enabled, approximate quota enforcement can be implemented by maildrop or deliverquota to whatever extent it's possible to do so. Quotas are enabled by the -q option to maildirmake. Both maildrop and deliverquota will observe any maildirmake-requested quota.

LIMITATIONS

This quota mechanism will only work as long as maildrop (or deliverquota) are the only applications that deliver messages to the maildir, or as long as other applications implement the same quota enforcement mechanism. The quota enforcement mechanism is described separately in the README.maildirquota.html file in the source code distribution.

Quota enforcement will still work, to some extent, if there are other applications that deliver or modify messages in the maildir. However, quota enforcement may not kick in immediately when the maildir goes over quota, in fact the maildir can go over quota by a noticeable amount. But eventually, as long as maildrop or deliverquota are responsible for delivering the majority of messages, quota enforcement will kick in. Also, other sources of messages may also result in noticeable performance degradation, because quote recalculation will become noticeably more expensive.

Also keep in mind that this quota mechanism is generally useless if mail recipients have direct access to their maildirs.

Finally even under the best conditions this quota enforcement does have a small chance of a race condition where a maildir will go over quota by some amount. maildirs are designed for speed, and this quota implementation was designed to have as little additional overhead as possible, compared to regular maildirs. To enforce an exact quota you would have to use some kind of a locking facility, which will impose a drastic performance degradation on the overall maildir performance. A decision has been made to avoid locking, with the only negative side effect being a possibility of going over quota in very low probability situations.

A way to minimize the risk of going over quota is to set reasonable quotas, in relation to maximum message sizes supported by your mail server. If you set your maildir quota to five megabytes, for example, it makes very little sense to configure your mail server to accept messages up to three megabytes long. Your maildir quota should be chosen so that it makes sense when compared to the maximum message size allowed by your mail server.

FOLDERS

This quota implementation is compatible with a popular extension to maildir which defines individual mail folders within a single maildir. However, in order to create a compatible folder, you MUST use the maildirmake command that comes with maildrop, and you MUST use the -f option to maildirmake, giving the name of the folder. Do not use maildirmake and specify the directory name of the maildir folder. Quota enforcement will not work if you do that.

./usr/share/doc/maildrop/html/maildrop.html0000644000000000000000000007470711330360534017656 0ustar rootroot maildrop

Name

maildrop — mail delivery filter/agent

Synopsis

maildrop [option...] [-d user] [arg...]

maildrop [option...] [filename] [arg...]

DESCRIPTION

maildrop is a replacement local mail delivery agent that includes a mail filtering language. The system administrator can either replace the existing mail delivery agent with maildrop, or users may run maildrop using the 'forward to program' mechanism of the existing mail delivery agent.

maildrop first reads the E-mail message on standard input. Trailing carriage return characters are automatically stripped. An E-mail message consists of header lines, followed by a blank line, followed by the contents of the message. The message may contain an mbox-style 3stribution information. -->

Name

maildirquota — voluntary Maildir quotas

Synopsis

maildirmake {-q} {10000000S} {./Maildir}

DESCRIPTION

maildrop has an experimental quota enforcement implementation. This is an option that is set at configuration time, and may be disabled.

Filesystem-based quotas should be used whenever possible. However filesystem-based quotas cannot be used in some situations, such as virtual mailboxes. If this experimental feature is enabled, approximate quota enforcement can be implemented by maildrop or deliverquota to whatever extent it's possible to do so. Quotas are enabled by the -q option to maildirmake. Both maildrop and deliverquota will observe any maildirmake-requested quota.

LIMITATIONS

This quota mechanism will only work as long as maildrop (or deliverquota) are the only applications that deliver messages to the maildir, or as long as other applications implement the same quota enforcement mechanism. The quota enforcement mechanism is described separately in the README.maildirquota.html file in the source code distribution.

Quota enforcement will still work, to some extent, if there are other applications that deliver or modify messages in the maildir. However, quota enforcement may not kick in immediately when the maildir goes over quota, in fact the maildir can go over quota by a noticeable amount. But eventually, as long as maildrop or deliverquota are responsible for delivering the majority of messages, quota enforcement will kick in. Also, other sources of messages may also result in noticeable performance degradation, because quote recalculation will become noticeably more expensive.

Also keep in mind that this quota mechanism is generally useless if mail recipients have direct access to their maildirs.

Finally even under the best conditions this quota enforcement does have a small chance of a race condition where a maildir will go over quota by some amount. maildirs are designed for speed, and this quota implementation was designed to have as little additional overhead as possible, compared to regular maildirs. To enforce an exact quota you would have to use some kind of a locking facility, which will impose a drastic performance degradation on the overall maildir performance. A decision has been made to avoid locking, with the only negative side effect being a possibility of going over quota in very low probability situations.

A way to minimize the risk of going over quota is to set reasonable quotas, in relation to maximum message sizes supported by your mail server. If you set your maildir quota to five megabytes, for example, it makes very little sense to configure your mail server to accept messages up to three megabytes long. Your maildir quota should be chosen so that it makes sense when compared to the maximum message size allowed by your mail server.

FOLDERS

This quota implementation is compatible with a popular extension to maildir which defines individual mail folders within a single maildir. However, in order to create a compatible folder, you MUST use the maildirmake command that comes with maildrop, and you MUST use the -f option to maildirmake, giving the name of the folder. Do not use maildirmake and specify the directory name of the maildir folder. Quota enforcement will not work if you do that.

./usr/share/doc/maildrop/html/maildrop.html0000644000000000000000000007470711330360534017656 0ustar rootroot maildrop

Name

maildrop — mail delivery filter/agent

Synopsis

maildrop [option...] [-d user] [arg...]

maildrop [option...] [filename] [arg...]

DESCRIPTION

maildrop is a replacement local mail delivery agent that includes a mail filtering language. The system administrator can either replace the existing mail delivery agent with maildrop, or users may run maildrop using the 'forward to program' mechanism of the existing mail delivery agent.

maildrop first reads the E-mail message on standard input. Trailing carriage return characters are automatically stripped. An E-mail message consists of header lines, followed by a blank line, followed by the contents of the message. The message may contain an mbox-style 3stribution information. -->

Name

maildirquota — voluntary Maildir quotas

Synopsis

maildirmake {-q} {10000000S} {./Maildir}

DESCRIPTION

maildrop has an experimental quota enforcement implementation. This is an option that is set at configuration time, and may be disabled.

Filesystem-based quotas should be used whenever possible. However filesystem-based quotas cannot be used in some situations, such as virtual mailboxes. If this experimental feature is enabled, approximate quota enforcement can be implemented by maildrop or deliverquota to whatever extent it's possible to do so. Quotas are enabled by the -q option to maildirmake. Both maildrop and deliverquota will observe any maildirmake-requested quota.

LIMITATIONS

This quota mechanism will only work as long as maildrop (or deliverquota) are the only applications that deliver messages to the maildir, or as long as other applications implement the same quota enforcement mechanism. The quota enforcement mechanism is described separately in the README.maildirquota.html file in the source code distribution.

Quota enforcement will still work, to some extent, if there are other applications that deliver or modify messages in the maildir. However, quota enforcement may not kick in immediately when the maildir goes over quota, in fact the maildir can go over quota by a noticeable amount. But eventually, as long as maildrop or deliverquota are responsible for delivering the majority of messages, quota enforcement will kick in. Also, other sources of messages may also result in noticeable performance degradation, because quote recalculation will become noticeably more expensive.

Also keep in mind that this quota mechanism is generally useless if mail recipients have direct access to their maildirs.

Finally even under the best conditions this quota enforcement does have a small chance of a race condition where a maildir will go over quota by some amount. maildirs are designed for speed, and this quota implementation was designed to have as little additional overhead as possible, compared to regular maildirs. To enforce an exact quota you would have to use some kind of a locking facility, which will impose a drastic performance degradation on the overall maildir performance. A decision has been made to avoid locking, with the only negative side effect being a possibility of going over quota in very low probability situations.

A way to minimize the risk of going over quota is to set reasonable quotas, in relation to maximum message sizes supported by your mail server. If you set your maildir quota to five megabytes, for example, it makes very little sense to configure your mail server to accept messages up to three megabytes long. Your maildir quota should be chosen so that it makes sense when compared to the maximum message size allowed by your mail server.

FOLDERS

This quota implementation is compatible with a popular extension to maildir which defines individual mail folders within a single maildir. However, in order to create a compatible folder, you MUST use the maildirmake command that comes with maildrop, and you MUST use the -f option to