---
name: "expirer"
section: "8"
platform: "linux"
package: "zmailer"
version: "2.99.55-3"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/expirer"
---

# expirer(8)

zmailer forced queue expiration utility

## NAME

expirer - zmailer forced queue expiration utility

## SYNOPSIS

**expirer** \[ **-c** *channel* \] \[ **-h** *hostname* \] \[ **-m** *message string* \] \[ **-l** *logfile* \] \[ **-Vs** \]

## DESCRIPTION

*expirer* is a ZMailer transport agent which is used to expire selected recipients from the queue before their normal expiration time with (possibly) a customized message. The *expirer* program must be run with root privileges and invoked with the same current directory as the *scheduler*, namely *POSTOFFICE***/transport**.

## OPTIONS

- \-c *channel*

  Message recipient selector "channel" (optional)

- \-h *"hostname"*

  Message recipient selector "host" (optional)

- \-m *"message string"*

  An alternate report string.

- \-s

  Silent mode. Message expiration occurs without any report to anywhere.

- \-V

  prints a version message and exits.

- \-l *logfile*

  specifies a logfile.

## INTERFACE

This program reads in processable file names relative to the current working directory of the scheduler (namely: *$POSTIOFFICE/transport/*). Optionally on the same line the scheduler may tell which host is to be looked for from the recipients of the message.

*relative-spool-path* \[ \<TAB\> *hostname* \]

This program produces diagnostic output on the standard output. Normal diagnostic output is of the form:

*id*/*offset*\<TAB\>*notify-data*\<TAB\>*status* *message*

where  *id* is the inode number of the message file, *offset* is a byte offset within its control file where the address being reported on is kept, *status* is one of **ok**, **error**, or **deferred**, and the *message* is descriptive text associated with the report.  The text is terminated by a linefeed.  Any other format (as might be produced by subprocesses) is passed to standard output for logging in the **scheduler** log.

The exit status is a code from **\<sysexits.h\>**.

## FILES

*/etc/zmailer.conf*\
 */var/spool/postoffice (POSTOFFICE)*

## SEE ALSO

[scheduler(8)](/scheduler/8.md), [manual-expirer(8)](/manual-expirer/8.md)

## AUTHOR

This script is authored and copyright by: Matti Aarnio \<mea@nic.funet.fi\>