ap(8mh)

Name

ap − parse addresses RFC 822-style

Syntax

/usr/new/lib/mh/ap [−form formatfile] [−format string] [−normalize] [−nonormalize] [−width columns] addrs ... [−help]

Description

The ap program parses addresses according to the ARPA Internet standard. It also understands many non-standard formats. It is useful for seeing how MH will interpret an address.

The ap program treats each argument as one or more addresses, and prints those addresses in the official RFC 822-format. Hence, it is usually best to enclose each argument in quotation marks (" ") for the shell.

Options

To override the output format used by ap, you use the −format string or −format file options. This permits individual fields of the address to be extracted easily. The string argument is a format string; the file argument is the name of a format file. See mh−format() for the details.

In addition to the standard escapes, scan also recognizes the following additional escape: error, which is a diagnostic that is returned if the parse failed.

If the −normalize option is given, ap tries to track down the official hostname of the address.

Here is the default format string used by ap:

%<{error}%{error}: %{text}%|%(proper{text})%>

The previous example says if an error was detected, print the error, a colon (:), and the address in error. Otherwise, output the RFC 822-proper format of the address.

The argument to the −format option must be interpreted as a single token by the shell that invokes ap. Therefore, you should usually place the argument to this option inside quotation marks (" ").

Defaults

−format Defaults as described previously.

−normalize

−width Defaults to the width of the terminal.

Restrictions

On systems where MH was configured with the BERK option, address parsing is not enabled. The version of MH that is supplied with ULTRIX Mail Connection layered product has the BERK option enabled.

Files

$HOME/.mh_profile
User profile

/usr/new/lib/mh/mtstailor
Tailor file

Museum

Related Articles