inc.man

早期freebsd实现

INC(1)                 BSD Reference Manual                INC(1)


NNAAMMEE
       inc - incorporate new mail

SSYYNNOOPPSSIISS
       inc  [+folder] [-audit audit-file] [-noaudit] [-changecur]
            [-nochangecur]  [-form formatfile]   [-format string]
            [-file name]    [-silent]   [-nosilent]   [-truncate]
            [-notruncate]      [-width columns]      [-host host]
            [-user user]   [-apop]  [-noapop]  [-rpop]  [-norpop]
            [-pack file] [-nopack] [-help]

DDEESSCCRRIIPPTTIIOONN
       _I_n_c incorporates mail from the user's incoming  mail  drop
       into an _M_H folder.  If `+folder' isn't specified, a folder
       in the user's _M_H directory will be used, either that spec-
       ified  by the "Inbox:" entry in the user's profile, or the
       folder named "inbox".  The new messages being incorporated
       are assigned numbers starting with the next highest number
       in the folder.   If  the  specified  (or  default)  folder
       doesn't  exist, the user will be queried prior to its cre-
       ation.  As the messages are processed, a _s_c_a_n  listing  of
       the new mail is produced.

       If the user's profile contains a "Msg-Protect: nnn" entry,
       it will be used as the protection  on  the  newly  created
       messages,  otherwise  the _M_H default of 0644 will be used.
       During all operations on messages, this initially assigned
       protection will be preserved for each message, so _c_h_m_o_d(1)
       may be used to set a protection on an individual  message,
       and its protection will be preserved thereafter.

       If the switch `-audit audit-file' is specified (usually as
       a default switch in the profile), then _i_n_c will  append  a
       header line and a line per message to the end of the spec-
       ified audit-file with the format:

          inc date
               <scan line for first message>
               <scan line for second message>
                         <etc.>

       This is useful for keeping track of volume and  source  of
       incoming mail.  Eventually, _r_e_p_l, _f_o_r_w, _c_o_m_p, and _d_i_s_t may
       also produce audits to this  (or  another)  file,  perhaps
       with "Message-Id:" information to keep an exact correspon-
       dence history.  "Audit-file" will  be  in  the  user's  MH
       directory unless a full path is specified.

       _I_n_c  will  incorporate  even improperly formatted messages
       into the user's MH folder, inserting a blank line prior to
       the offending component and printing a comment identifying



[mh.6]                        MH.6.8                            1








INC(1)                 BSD Reference Manual                INC(1)


       the bad message.

       In all cases, the user's mail drop will be zeroed,  unless
       the `-notruncate' switch is given.

       If  the  profile  entry  "Unseen-Sequence"  is present and
       non-empty, then _i_n_c will add each of  the  newly  incorpo-
       rated  messages  to  each  sequence  named  by the profile
       entry.  This is similar to the "Previous-Sequence" profile
       entry  supported  by  all _M_H commands which take `msgs' or
       `msg'  arguments.   Note  that  _i_n_c  will  not  zero  each
       sequence prior to adding messages.

       The     interpretation    of    the    `-form formatfile',
       `-format string', and  `-width columns'  switches  is  the
       same as in _s_c_a_n (1).

       By  using  the  `-file name' switch, one can direct _i_n_c to
       incorporate messages from a file  other  than  the  user's
       maildrop.   Note  that  the  name file will NOT be zeroed,
       unless the `-truncate' switch is given.

       If the envariable $$MMAAIILLDDRROOPP is set, then _i_n_c  uses  it  as
       the location of the user's maildrop instead of the default
       (the `-file name' switch still overrides  this,  however).
       If  this  envariable is not set, then _i_n_c will consult the
       profile entry "MailDrop" for  this  information.   If  the
       value  found is not absolute, then it is interpreted rela-
       tive to the user's _M_H directory.   If  the  value  is  not
       found,  then _i_n_c will look in the standard system location
       for the user's maildrop.

       The `-silent' switch directs _i_n_c to be quiet and  not  ask
       any  questions  at all.  This is useful for putting _i_n_c in
       the background and going on to other things.

       If the local host is configured as a POP client, or if the
       `-host host'  switch is given, then _i_n_c will query the POP
       service host as to the status of  mail  waiting.   If  the
       `-user user'  switch  is not given, then the current user-
       name is used.  Normally, _i_n_c will prompt for a password to
       use.   However,  if  the `-apop' switch is given, _i_n_c will
       generate authentication credentials to provide for  origin
       authentication  and  replay  protection,  but which do not
       involve sending a password in the clear over the  network.
       Otherwise,  if  the `-rpop' switch is given, then _i_n_c will
       try  to  use  a  "trusted"  connection  (ala  the  BSD  r-
       commands).

       If  _i_n_c  uses POP, then the `-pack file' switch is consid-
       ered.  If given, then _i_n_c simply uses the POP to _p_a_c_k_f (1)



[mh.6]                        MH.6.8                            2








INC(1)                 BSD Reference Manual                INC(1)


       the user's maildrop from the POP service host to the named
       file.  This switch is provided for those users who  prefer
       to use _m_s_h to read their maildrops.

FFIILLEESS
       $HOME/.mh_profile                         The user profile
       /usr/contrib/mh-6.8/lib/mtstailor         tailor file
       /var/mail/$USER                           Location of mail drop

PPRROOFFIILLEE CCOOMMPPOONNEENNTTSS
       Path:                To determine the user's MH directory
       Alternate-Mailboxes: To determine the user's mailboxes
       Inbox:               To determine the inbox, default "inbox"
       Folder-Protect:      To set mode when creating a new folder
       Msg-Protect:         To set mode when creating a new message and audit-file
       Unseen-Sequence:     To name sequences denoting unseen messages

SSEEEE AALLSSOO
       _P_o_s_t _O_f_f_i_c_e _P_r_o_t_o_c_o_l _- _v_e_r_s_i_o_n _3 (aka RFC-1081),
       mhmail(1), scan(1), mh-mail(5), post(8)

DDEEFFAAUULLTTSS
       `+folder' defaulted by "Inbox" above
       `-noaudit'
       `-changecur'
       `-format' defaulted as described above
       `-nosilent'
       `-truncate' if `-file name' not given, `-notruncate' otherwise
       `-width' defaulted to the width of the terminal
       `-nopack'
       `-rpop'

CCOONNTTEEXXTT
       The folder into which messages are being incorporated will
       become the current folder.  The first message incorporated
       will become the current message, unless the `-nochangecur'
       option is specified.  This leaves the context ready for  a
       _s_h_o_w of the first new message.

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










[mh.6]                        MH.6.8                            3