imta cache

The IMTA maintains a disk cache of all the messages currently stored in its queues. This cache is called the queue cache. The purpose of the queue cache is to make dequeue operations perform more by relieving master programs from having to open every message file to find out which message to dequeue and in which order.

The queue cache consists of the indexed files contained in the directory pointed at by the IMTA_QUEUE_CACHE_DATABASE option in the IMTA tailor file, /etc/opt/SUNWmail/imta/imta_tailor. Normally, the queue cache directory is called /etc/opt/SUNWmail/imta/queue_cache. This directory and the files it contains should be protected against world and group access and have the same uid as the directories /var/opt/SUNWmail/imta/queue and /var/opt/SUNWmail/imta/log.

imta cache -sync

The imta cache -sync command updates the active queue cache database by updating it to reflect all non-held message files currently present in the /var/opt/SUNWmail/imta/queue/* subdirectories. The imta cache -close command does not need to be issued in conjunction with the imta cache -sync command.

Note that the imta cache -sync utility does not remove any entry from the queue cache. The queue cache entries not corresponding to an actual queued message are silently discarded by master programs. They can also be removed using the imta cache -rebuild utility.

Syntax

imta cache -sync

Example

To synchronize the queue cache, for example, after renaming a message file, type the command:

# imta cache -sync

imta cache -rebuild

The imta cache -rebuild command creates a new, synchronized queue cache. Although the new database inherits the ownership and file protections of the queue cache, it is a good idea to check afterwards that the new queue cache directory and files have the same uid as the queue and log directories and that the queue cache database directory and files are protected against group and world access.

Syntax

imta cache -rebuild

Example

To build a new queue cache database, issue the commands:

% imta cache -rebuild   % imta cache -close

Next, the queue cache needs to be synchronized. To do this, enter the following:

% imta cache -sync

imta cache -close

The imta cache -close command forces IMTA processes to close any open I/O channels to the queue cache database. This is generally done for two reasons: to close all channels to the files in the database so that the database can be modified, and to force processes to reopen the queue cache database files, to begin using any new version of that database.

Syntax

imta cache -close

Example

After a new queue cache database is built with imta cache -rebuild, issue an imta cache -close command to force any detached processes to begin using the new database:

# imta cache -rebuild   # imta cache -close

imta cache -view

The imta cache -view command shows the current non-held entries in the IMTA cache database for a channel.

Syntax

imta cache -view channel-name

The option for this command is:

channel-name

Name of the channel for which to show entries

Example

To view entries in the queue cache database for the tcp_local channel, execute the command:

% imta cache -view tcp_local