ap(8) - f39

1AP(8)                       System Manager's Manual                      AP(8)
2
3
4

NAME

6       ap - nmh parser of RFC 822-style addresses
7

SYNOPSIS

9       /usr/libexec/nmh/ap [-help] [-version] [-form formatfile] [-format
10            string] [-width columns] addrs ...
11

DESCRIPTION

13       ap is a program that parses addresses according to  the  ARPA  Internet
14       standard.  It also understands many non-standard formats.  It is useful
15       for seeing how nmh will interpret an address.
16
17       The ap program treats each argument  as  one  or  more  addresses,  and
18       prints  those  addresses out in the official RFC 822 format.  Hence, it
19       is usually best to enclose each argument in quotes for the shell.
20
21       To override the output format used by ap, the -format string or -format
22       file  switches are used.  This permits individual fields of the address
23       to be extracted with ease.  The string is simply a format  string,  and
24       the file is simply a format file.  See mh-format(5) for the details.
25
26       In  addition  to the standard escapes, ap also recognizes the following
27       additional escape:
28
29            Escape  Returns  Description
30            error   string   A diagnostic if the parse failed
31
32       Here is the default format string used by ap:
33
34            %<{error}%{error}: %{text}%|%(putstr(proper{text}))%>
35
36       which says that if an error was detected, print the error, a  `:',  and
37       the  address  in error.  Otherwise, output the RFC 822-proper format of
38       the address.
39

FILES

41       $HOME/.mh_profile   The user's profile.
42       /etc/nmh/mts.conf   The mts configuration file.
43

PROFILE COMPONENTS

45       None
46

DEFAULTS

53       -format             As described above.
54       -width              The width of the terminal.
55

CONTEXT

57       None
58
59
60
61nmh-1.8                           2013-12-05                             AP(8)