SMTPLD

Synopsis

SMTPLD [/?] [/WAITFOR string] [/IFCLEANPOST string] [/TRIGGER string] [/TIMEOUT number] [/FOREVER[+|-]] default-domain IMAP-root-directory

Description

SMTPLD reads a queue of pending mail to be delivered locally, that is produced by the SMTP Posting Office Sorting dæmon and attempts delivery to local mailboxes. The queue directory is taken to be the working directory of the dæmon.

SMTPLD communicates with the other servers in the SMTP message handling system via three semaphores. The SMTP Posting Office Sorting dæmon triggers SMTPLD's semaphore whenever it has routed new mail for local delivery, and SMTPLD in turn triggers the SMTP Cleanup dæmon's and the SMTP Posting Office Sorting dæmon's semaphores, respectively when it has delivered local mail to all target mailboxes and when it has generated a bounce message. Thus the semaphore names supplied on the command line should match the semaphore names supplied to the other dæmons.

The default-domain specifies the default (local) domain name to use for envelope recipients that have no domain part.

The IMAP-root-directory specifies the root of the directory tree where the IMAP mailboxes are stored. SMTPLD expects mailboxes to be stored in the standard directory format. SMTPLD uses the mailbox names that are used by the IMAP dæmon. For an envelope recipient (with default domain appended) <user@domain>, SMTPLD will use IMAP-root/domain/user/INBOX as the name of the mailbox directory.

Example RUN files

SMTPLD can be managed as a service under RUNSVC, the Service Manager in the OS/2 Command Line Utilities version 2.2, A run file for such a service typically would look similar to:

  chdir %MAILQUEUEDIR%
  program %APPS%\JdeBP\IU\bin\SMTPLD.exe
  argument SMTPLD
  argument /WAITFOR:\SEM32\IU\SMTP\LD
  argument /TRIGGER:\SEM32\IU\SMTP\PD
  argument /IFCLEANPOST:\SEM32\IU\SMTP\CD
  argument localhost.
  argument %IMAPROOT%\Personal\

Example command-line invocation

  [c:\]smtpld /WAITFOR:\SEM32\IU\SMTP\LD /TRIGGER:\SEM32\IU\SMTP\PD /IFCLEANPOST:\SEM32\IU\SMTP\CD localhost. %IMAPROOT%\Personal\

Command-specific options

/WAITFOR
Specify the semaphore to wait for.
/IFCLEANPOST
Specify the semaphore to signal whenever message cleanup is needed.
/TRIGGER
Specify the semaphore to signal whenever a bounce message has been generated.
/TIMEOUT
Specify the semaphore wait timeout.
/FOREVER
Specify that the dæmon should wait forever for the semaphore.

The Internet Utilities are © Copyright Jonathan de Boyne Pollard. "Moral" rights are asserted.