1MSGCHK(1)                   General Commands Manual                  MSGCHK(1)
2
3
4

NAME

6       msgchk - nmh's check for incoming email
7

SYNOPSIS

9       msgchk [-help] [-version] [-date | -nodate] [-notify all/mail/nomail ]
10            [-nonotify all/mail/nomail ] [-host hostname] [-user username]
11            [-sasl | -nosasl] [-saslmech mechanism] [-initialtls] [-notls]
12            [-certverify | -nocertverify] [-authservice service] [-snoop]
13            [users ... ]
14

DESCRIPTION

16       The  msgchk  program  checks  all known mail drops for mail waiting for
17       you.  For those drops which have mail for you, msgchk will indicate  if
18       it believes that you have seen the mail in question before.
19
20       The  -notify  type  switch  indicates  under  what circumstances msgchk
21       should produce a message.  The default is -notify all which  says  that
22       msgchk  should  always report the status of the users mail drop.  Other
23       values for `type' include `mail' which says that msgchk  should  report
24       the status of waiting mail; and, `nomail' which says that msgchk should
25       report the status of empty mail drops.  The -nonotify type  switch  has
26       the inverted sense, so -nonotify all directs msgchk to never report the
27       status of mail drops.  This is useful  if  the  user  wishes  to  check
28       msgchk's  exit  status.  A non-zero exit status indicates that mail was
29       not waiting for at least one of the indicated users.
30
31       If msgchk produces output, then the  -date  switch  directs  msgchk  to
32       print out the last date mail was read, if this can be determined.
33
34   Using POP
35       msgchk  will normally check all the local mail drops, but if the option
36       “pophost:” is set in the mts configuration file “mts.conf”, or  if  the
37       -host hostname switch is given, msgchk will query this POP service host
38       as to the status of mail waiting.
39
40       To specify a username for authentication with the POP server,  use  the
41       -user  username  switch.   The credentials profile entry in the mh-pro‐
42       file(5) man page describes the ways to supply a username and password.
43
44       For debugging purposes, there is also a switch -snoop, which will allow
45       you  to  watch  the  POP transaction take place between you and the POP
46       server.  If -sasl -saslmech xoauth2 is used, the  HTTP  transaction  is
47       also shown.
48
49       If  nmh  has  been  compiled  with  SASL support, the -sasl switch will
50       enable the use of SASL authentication.  Depending on the SASL mechanism
51       used, this may require an additional password prompt from the user (but
52       the netrc file can be used to store this password, as described in  the
53       mh-profile(5)  man page).  The -saslmech switch can be used to select a
54       particular SASL mechanism.
55
56       If SASL authentication is successful, msgchk will attempt to  negotiate
57       a security layer for session encryption.  Encrypted traffic is labelled
58       with `(encrypted)' and `(decrypted)' when viewing the  POP  transaction
59       with the -snoop switch; see the post man page description of -snoop for
60       its other features.
61
62       If nmh has been  compiled  with  OAuth  support,  the  -sasl  -saslmech
63       xoauth2 switch will enable OAuth authentication.  The -user switch must
64       be used, and the user-name must be an email address the  user  has  for
65       the  service,  which  must  be  specified with the -authservice service
66       switch.  Before using this, the user  must  authorize  nmh  by  running
67       mhlogin  and  grant authorization to that account.  See the mhlogin man
68       page for more details.
69
70       If nmh has been compiled with TLS support, the -initialtls switch  will
71       require  the  negotiation  of  TLS  when  connecting  to the remote POP
72       server.  The -initialtls switch will negotiate  TLS  immediately  after
73       the  connection  has  taken  place, before any POP commands are sent or
74       received.  Data encrypted  by  TLS  is  labeled  `(tls-encrypted)'  and
75       `(tls-decrypted)`  with  viewing  the  POP  transaction with the -snoop
76       switch.  The -notls switch will disable all attempts to negotiate TLS.
77
78       When using TLS the default is to verify the remote certificate and Sub‐
79       jectName against the local trusted certificate store.  This can be con‐
80       trolled by  the  -certverify  and  -nocertverify  switches.   See  your
81       OpenSSL documentation for more information on certificate verification.
82

FILES

84       $HOME/.mh_profile          The user profile
85       /etc/nmh/mts.conf          nmh mts configuration file
86       /var/mail/$USER            Location of mail drop
87

PROFILE COMPONENTS

89       None
90

SEE ALSO

92       inc(1), mh-mail(5) post(8)
93

DEFAULTS

95       `user' defaults to the current user
96       `-date'
97       `-notify all'
98

CONTEXT

100       None
101
102
103
104nmh-1.7.1                         2016-11-02                         MSGCHK(1)
Impressum