git.marmaro.de Git - mmh/blob - man/whom.man

   1 .\"
   2 .\" %nmhwarning%
   3 .\"
   4 .TH WHOM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
   5 .SH NAME
   6 whom \- report to whom a message would go
   7 .SH SYNOPSIS
   8 .HP 5
   9 .na
  10 .B whom
  11 .RB [ \-alias
  12 .IR aliasfile ]
  13 .RB [ \-check " | " \-nocheck ]
  14 .RB [ \-draftfolder
  15 .IR +folder ]
  16 .RB [ \-draftmessage
  17 .IR msg ]
  18 .RB [ \-nodraftfolder ]
  19 .RB [ \-mts
  20 .IR smtp " | " sendmail/smtp " | " sendmail/pipe ]
  21 .RB [ \-server
  22 .IR servername ]
  23 .RB [ \-port
  24 .IR port-name/number ]
  25 .RB [ \-sasl ]
  26 .RB [ \-saslmech
  27 .IR mechanism ]
  28 .RB [ \-snoop ]
  29 .RB [ \-user
  30 .IR username ]
  31 .RB [ \-tls ]
  32 .RB [ \-notls ]
  33 .RI [ file ]
  34 .RB [ \-draft ]
  35 .RB [ \-version ]
  36 .RB [ \-help ]
  37 .ad
  38 .SH DESCRIPTION
  39 .B Whom
  40 is used to expand the headers of a message into a set of
  41 addresses and optionally verify that those addresses are deliverable at
  42 that time (if
  43 .B \-check
  44 is given).
  45 .PP
  46 The
  47 .B \-draftfolder
  48 .I +folder
  49 and
  50 .B \-draftmessage
  51 .I msg
  52 switches invoke
  53 the
  54 .B nmh
  55 draft folder facility.  This is an advanced (and highly
  56 useful) feature.  Consult the
  57 .BR mh-draft (5)
  58 man page for more information.
  59 .PP
  60 The mail transport system default is provided in
  61 .I %etcdir%/mts.conf
  62 but can be overriiden here with the
  63 .B \-mts
  64 switch.
  65 .PP
  66 If nmh is using the SMTP MTA, the
  67 .B \-server
  68 and the
  69 .B \-port
  70 switches can be used to override the default mail server (defined by the
  71 .I %etcdir%/mts.conf
  72 .RI servers
  73 entry).  The
  74 .B \-snoop
  75 switch can be used to view the SMTP transaction.  (Beware that the
  76 SMTP transaction may contain authentication information either in
  77 plaintext or easily decoded base64.)
  78 .PP
  79 If
  80 .B nmh
  81 has been compiled with SASL support, the
  82 .B \-sasl
  83 switch will enable
  84 the use of SASL authentication with the SMTP MTA.  Depending on the
  85 SASL mechanism used, this may require an additional password prompt from the
  86 user (but the
  87 .RI \*(lq \&.netrc \*(rq
  88 file can be used to store this password).
  89 .B \-saslmech
  90 switch can be used to select a particular SASL mechanism,
  91 and the the
  92 .B \-user
  93 switch can be used to select a authorization userid
  94 to provide to SASL other than the default.
  95 .PP
  96 If SASL authentication is successful,
  97 .BR nmh
  98 will attempt to negotiate a security layer for session encryption.
  99 Encrypted data is labelled with `(encrypted)' and `(decrypted)' when
 100 viewing the SMTP transaction with the
 101 .B \-snoop
 102 switch.  The
 103 .B \-saslmaxssf
 104 switch can be used to select the maximum value of the Security Strength Factor.
 105 This is an integer value and the exact meaning of this value depends on the
 106 underlying SASL mechanism.  A value of 0 disables encryption.
 107 .PP
 108 If
 109 .B nmh
 110 has been compiled with TLS support, the
 111 .B \-tls
 112 and
 113 .B \-notls
 114 switches will require and disable the negotiation of TLS support when connecting to the
 115 SMTP MTA.  Encrypted data is labelled with `(tls-encrypted)' and
 116 `(tls-decrypted)' when viewing the SMTP transction with the
 117 .B \-snoop
 118 switch.
 119 .PP
 120 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
 121 additional alias files given by the
 122 .B \-alias
 123 .I aliasfile
 124 switch will be
 125 read (more than one file, each preceded by
 126 .BR \-alias ,
 127 can be named). See
 128 .BR mh\-alias (5)
 129 for more information.
 130
 131 .SH FILES
 132 .fc ^ ~
 133 .nf
 134 .ta \w'%etcdir%/ExtraBigFileName  'u
 135 ^$HOME/\&.mh\(ruprofile~^The user profile
 136 .fi
 137
 138 .SH "PROFILE COMPONENTS"
 139 .fc ^ ~
 140 .nf
 141 .ta 2.4i
 142 .ta \w'ExtraBigProfileName  'u
 143 ^Path:~^To determine the user's nmh directory
 144 ^Draft\-Folder:~^To find the default draft\-folder
 145 ^Aliasfile:~^For a default alias file
 146 ^postproc:~^Program to post the message
 147 .fi
 148
 149 .SH "SEE ALSO"
 150 mh\-alias(5), post(8)
 151
 152 .SH DEFAULTS
 153 .nf
 154 .RB ` file "' defaults to <mh\-dir>/draft"
 155 .RB ` \-nocheck '
 156 .RB ` \-alias "' defaults to  %etcdir%/MailAliases"
 157 .fi
 158
 159 .SH CONTEXT
 160 None
 161
 162 .SH BUGS
 163 With the
 164 .B \-check
 165 option,
 166 .B whom
 167 makes no guarantees that the
 168 addresses listed as being ok are really deliverable, rather, an address
 169 being listed as ok means that at the time that
 170 .B whom
 171 was run
 172 the address was thought to be deliverable by the transport service.
 173 For local addresses, this is absolute; for network addresses, it means
 174 that the host is known; for uucp addresses, it (often) means that the
 175 .B UUCP
 176 network is available for use.