imta program

The imta program commands are used to manipulate the program delivery options.

These commands can be executed as root or inetmail. A change in an existing one will take effect only after the next full dirsync is performed.

Syntax

imta program -a -m method -p program [-g argument_list] [-e exec_permission]   imta program -d -m method   imta program -c -m method -p program | -g argument_list | -e exec_permission   imta program -u -m method [ -h ldaphost ]   imta program -l

The options for this command are:

-a	Add a method to the set of program delivery methods. This option cannot be used with the -d, -c, -l, or -u options.
-c	Change the arguments to a program that has already been entered.
-m method	Name given by the administrator to a particular method. This will be the name by which the method will be advertised to users. Method names must not contain spaces, tabs, or equal signs (=). The method name cannot be none or locale. This option is required with the -a, -d, -c, and -u options.
-p program	Actual name of the executable for a particular method. The executable should exist in the programs directory (/opt/SUNWmail/imta/programs) for the add to be successful. It can be a symbolic link to an executable in some other directory. This option is required with the -a option.
-g argument_list	Argument list to be used while executing the program. If this option is not specified during an add, no arguments will be used. Each argument must be separated by a space and the entire argument list must be given within double quotes. If the %s tag is used in the argument list, it will be substituted with the user's username for programs executed by the users and with username+programlabel for programs executed by the postmaster inetmail. programlabel is a unique string to identify that program. This option can be used with the -a and -c options.
-e exec_permission	exec_permission can be user or postmaster. If it is specified as user, the program is executed as the user. By default, execute permission for all programs are set to postmaster. Programs with exec_permission set to user can be accessed by users with UNIX accounts only. This option can be used with the -a and -c options.
-d	Delete a method from the list of supported program delivery methods. This option cannot be used with the -a, -c, -l, or -u options.
-u	List the users that use a particular method. This option cannot be used with the -d, -c, -l, or -a options.
-h ldaphost	Specify the directory hostname if different from localhost. This option can be used with the -u option only.
-l	List all supported program delivery methods. This option cannot be used with the -d, -c, -a, or -u options.

Examples

To add a method procmail1 that executes the program procmail with the arguments -d username and executes as the user, enter the following:

% imta program -a -m procmail1 -p procmail -g "-d %s" -e user

To list all the methods defined:

% imta program -l

To list all users executing the method procmail1:

% imta program -u -m procmail1