PMDF normally looks for your .forward file in your home directory. However, your PMDF system manager may have chosen to configure PMDF to look in a different location for user .forward files; check with your PMDF system manager if you have any question about where your .forward file should reside.

The format for a .forward file is one or more lines, each line containing one or more comma-separated recipient entries. A recipient entry may take the following forms.

• user@domain directs a copy of the message to the specified address.
• \your-account-name delivers a copy to you "normally" (in addition to any other forwarding specified by other entries).
• /directory/path/filename appends a copy of the message to the specified file. (The specified file must be writeable by you.)
• +/directory/path/filename appends a copy of the message to the specified file using digest-like boundary markers between the messages. (The specified file must be writeable by you.)
• |command where command is a shell command will execute that command as you, with your access and privileges, with standard input coming from the message being delivered.
• |command args where command args is a shell command with arguments will execute that command as you, with your access and privileges, with standard input coming from the message being delivered.

Lines beginning with an exclamation point character, !, are considered to be comment lines.

Note that when executing certain actions of your .forward file, PMDF becomes you. In particular, any scripts executed by your .forward file will be executed as you, with your access and privileges.

Example 2-1 shows a sample .forward file for a user jdoe who wants one copy of his messages delivered normally, one copy sent to another of his accounts, one copy sent to his pager, one copy filed in the file thismonthsmailarchive, and also wants to pipe the message through the procmail utility.

Example 2-1 Sample .forward file for user John.Doe

\jdoe, John.Doe@system2.example.com, John.Doe@pager.example.com /usr/users/jdoe/thismonthsmailarchive "|/usr/bin/procmail jdoe"