4.3BSD-UWisc/man/catl/ap.l

AP(8)               UNIX Programmer's Manual                AP(8)



NAME
     ap - parse addresses 822-style

SYNOPSIS
     /usr/misc/mh/lib/ap [-form formatfile] [-format string]
          [-normalize] [-nonormalize] [-width columns] addrs ...
          [-help]
9     _A_p is a program that parses addresses according to the ARPA
     Internet standard.  It also understands many non-standard
     formats.  It is useful for seeing how _M_H will interpret an
     address.

     The _a_p program treats each argument as one or more
     addresses, and prints those addresses out in the official
     822-format.  Hence, it is usually best to enclose each argu-
     ment in double-quotes for the shell.

     To override the output format used by _a_p, the
     `-format string' or `-format file' switches are used.  This
     permits individual fields of the address to be extracted
     with ease.  The string is simply a format stringand thefile
     is simply a format file.  See _m_h-_f_o_r_m_a_t (5) for the details.

     In addition to the standard escapes, _s_c_a_n also recognizes
     the following additional escape:
     _e_s_c_a_p_e  _s_u_b_s_t_i_t_u_t_i_o_n
     error   a diagnostic if the parse failed

     If the `-normalize' switch is given, _a_p will try to track
     down the official hostname of the address.

     Here is the default format string used by _a_p:

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

     which says that if an error was detected, print the error, a
     `:', and the address in error.  Otherwise, output the
     822-proper format of the address.

FILES
     $HOME/.mh_profile                  The user profile
     /usr/misc/mh/lib/mtstailor         tailor file

PROFILE COMPONENTS
     None

SEE ALSO
     dp(8),
     _S_t_a_n_d_a_r_d _f_o_r _t_h_e _F_o_r_m_a_t _o_f _A_R_P_A _I_n_t_e_r_n_e_t _T_e_x_t _M_e_s_s_a_g_e_s (aka
     RFC-822)

9


Printed 1/10/87                MH                               1






AP(8)               UNIX Programmer's Manual                AP(8)



DEFAULTS
     `-format' defaults as described above
     `-normalize'
     `-width' defaults to the width of the terminal

CONTEXT
     None

BUGS
     The argument to the `-format' switch must be interpreted as
     a single token by the shell that invokes _a_p.  Therefore, one
     must usually place the argument to this switch inside
     double-quotes.

     On hosts where _M_H was configured with the BERK option,
     address parsing is not enabled.







































Printed 1/10/87                MH                               2