Sun Internet Mail Server 3.5 Reference Manual: 2

`imta dirsync`

The imta dirsync utility recreates or updates the IMTA directory cache.

Note - You must be logged in as root to use this utility.

Syntax

imta dirsync [ -d domain_name1, domain_name2,... ] [ -v ] \
[ -l localhost_name1, localhost_name2,... ] [ -F ] [ -L ] [ -b base-dn ]\
[ -h ldaphost1, ldaphost2, ... ] [ -p ldapport ] [ -t ]

The options for this command are:

-v

Runs this command in verbose mode. A trace file is created in the log directory.

-F

Performs a full synchronization. By default, the imta dirsync command performs an incremental synchronization of the directory cache, which means that only entries that have been added or modified in the directory since the last synchronization are updated. The -F option causes the directory cache to be completely regenerated, thus creating a faithful image of the directory. The MTA is restarted after a full synchronization.

-L

This option causes the synchronization program to cache only local entries, that is addressees whose mail server is this MTA. A directory cache is built according to the MTA role. By default, the cache holds information about all addressees in the domains specified in the admin server configuration or with the -d option.

-d domain_name1, domain_name2,...

Specifies the fully qualified domain names containing addressees the MTA has to know in order to route messages. If two or more domain names are given, they are separated by commas. If none is specified, the mail server's domain name stored by the admin server is used.

-l localhost_name1, localhost_name2,...

Specifies the fully-qualified host names of this MTA. If more than one host name is given, they are separated by commas. If none is specified, the official hostname defined in the MTA configuration is used.

-b base_dn

Normally, the domain name given by the -d option is sufficient to determine the base distinguished name (DN) under which all the entries searched are located. This option lets you manually specify this base domain.

-h ldaphost1,
ldapthost2, ...

Specifies the directory hostname. The program connects to the first ldaphost it can connect to successfully.

-p ldapport

Specifies the LDAP port number.

-t

Execute imta dirsync in the test mode. Searches the directory and prints out the details on invalid entries, if there are any. No changes are made to the cache itself. For details on all entries, test also in verbose mode (run both the -t and -v options).

Example

To perform a full directory cache synchronization of mail.domain.com, which is a router MTA in the domain domain.com, execute the following command:
# imta dirsync -F -d domain.com
The following entries are synchronized only when performing a full synchronization:

Deleted users

Deleted distributions lists

`-v`	Runs this command in verbose mode. A trace file is created in the log directory.
-F	Performs a full synchronization. By default, the imta dirsync command performs an incremental synchronization of the directory cache, which means that only entries that have been added or modified in the directory since the last synchronization are updated. The -F option causes the directory cache to be completely regenerated, thus creating a faithful image of the directory. The MTA is restarted after a full synchronization.
-L	This option causes the synchronization program to cache only local entries, that is addressees whose mail server is this MTA. A directory cache is built according to the MTA role. By default, the cache holds information about all addressees in the domains specified in the admin server configuration or with the -d option.
-d domain_name1, domain_name2,...	Specifies the fully qualified domain names containing addressees the MTA has to know in order to route messages. If two or more domain names are given, they are separated by commas. If none is specified, the mail server's domain name stored by the admin server is used.
`-l` localhost_name1`,` localhost_name2`,...`	Specifies the fully-qualified host names of this MTA. If more than one host name is given, they are separated by commas. If none is specified, the official hostname defined in the MTA configuration is used.
`-b` base_dn	Normally, the domain name given by the -d option is sufficient to determine the base distinguished name (DN) under which all the entries searched are located. This option lets you manually specify this base domain.
`-h` ldaphost1, ldapthost2, ...	Specifies the directory hostname. The program connects to the first ldaphost it can connect to successfully.
`-p` ldapport	Specifies the LDAP port number.
`-t`	Execute `imta dirsync` in the test mode. Searches the directory and prints out the details on invalid entries, if there are any. No changes are made to the cache itself. For details on all entries, test also in verbose mode (run both the `-t` and -v options).

imta dirsync

Syntax imta dirsync [ -d domain_name1, domain_name2,... ] [ -v ] \ [ -l localhost_name1, localhost_name2,... ] [ -F ] [ -L ] [ -b base-dn ]\ [ -h ldaphost1, ldaphost2, ... ] [ -p ldapport ] [ -t ]

Example

`imta dirsync`

Syntax

imta dirsync [ -d domain_name1, domain_name2,... ] [ -v ] \
[ -l localhost_name1, localhost_name2,... ] [ -F ] [ -L ] [ -b base-dn ]\
[ -h ldaphost1, ldaphost2, ... ] [ -p ldapport ] [ -t ]