=======                                              DISview[803]
popmail
=======

-----------------------------------------------------------------
popmail addserver <host> [<seconds>] [hh:mm-hh:mm] <protocol>
                                <mailbox> <username> [<password>]
-----------------------------------------------------------------
     Add host as a pop server. When seconds is given, a timer is
     started to query the host mailserver with that interval for
     mail. If not specified *no* querying to the pop host will be
     started. You have to do that manually with a kick.  When 
     hh:mm is given then only in that exact timeframe are queries
     to the host made (allowed).
     Protocol is POP3.

     Mailbox is the mailbox name on the local host where mail is
     to be stored.
     
     Username and password are the remote system's validation
     parameters for the host.  If the password is omitted, it is
     obtained from the console.
     The username can take two forms; user@hostname and hostname,
     but both deliver into the specified mailbox. In most cases,
     at least two "users" need to be serviced ( incl postmaster).
     If you don't split your mail into separate mailboxes the
     second form is safer since it will collect all the mail for
     your host. If you do split, the first form is the easier to 
     manage, but remember to issue addserver commands for *all*
     users. You could, of course, run the second form and use a 
     util to sort the mail into mailboxes.

     Note: On entering this command the host name is looked up
     on the DNS. If nonexistent, an error message is displayed.

>> Example:
popmail addserver pop3.demon.co.uk 120 pop3 den den@mace q1w2e3r4

-----------------------------------------------------------------
popmail delete <username> [<on|off>] 		      default: on
-----------------------------------------------------------------
	
     Displays/sets a toggle to control the deletion of delivered
     mail from the server. Normally, mail will be deleted once it
     has been delivered, but if delete is turned off it will
     remain on the server after delivery.

     The response will be a message showing the status of the 
     delete switch for the specified user, if an addserver for
     that user has been entered. If no addserver for the user has
     been entered, the username will not be found and a message
     to that effect will be returned.

>> Examples: popmail delete you@yoursit
   Response:  Mail user you@yoursit not found.

             popmail delete you@yoursite
              Delete is ON for mail user you@yoursite         

             popmail delete you@yoursite off
              Delete is OFF for mail user you@yoursite	  

-----------------------------------------------------------------
popmail dropserver <host> [<username>]
-----------------------------------------------------------------

     Drops ALL enabled servers using <host> from the list of pop
     servers to be queried.  All references to the entry are
     deleted from the current system.
     The <username> makes the command specific to the "server"
     for that username. The username must be identical to the one
     used in the adddserver command.

>> Examples:
            popmail dropserver pop3.demon.co.uk    
                   drops ALL pop3.demon.co.uk "servers"
            popmail dropserver pop3.demon.co.uk you@yoursite
                   drops only the "server" on pop3.demon.co.uk
                   serving you@yoursite. The other "servers" are
                   unaffected.  

-----------------------------------------------------------------
popmail kick <host> [<username>]
-----------------------------------------------------------------

     Starts a pop session for ALL enabled "servers" using <host>
     to retrieve mail.  This command is needed  when no interval
     is specified with the popmail addserver command and will, by
     default, kick all "servers".
     The <username> makes the command specific to the "server"
     for that username. The username must be identical to the one
     used in the adddserver command.

>> Examples:
            popmail kick pop3.demon.co.uk
	           kicks *all* pop3.demon.co.uk "servers"
            popmail kick pop3.demon.co.uk me@mysite
                   kicks only the "server" on pop3.demon.co.uk
                   serving me@mysite. The other "servers" are 
                   unaffected.    

-----------------------------------------------------------------
popmail list
-----------------------------------------------------------------

     Lists the current popmail server table, with the timer count
     and the number of seconds to the next poll.

>> Example:  popmail list
	     
-----------------------------------------------------------------
popmail quiet <yes|no>                               Default: no
-----------------------------------------------------------------

     Enables or disables the inclusion of a beep in the message
     that new mail arrived at this system via pop.  See 'popmail
     trace' below, to enable the printing of a new-mail-arrived
     message.

>> Example:  popmail quiet yes

-----------------------------------------------------------------
popmail trace <level>				       Default: 1
-----------------------------------------------------------------

     Displays or sets the trace level of pop sessions. Current
     trace levels are:
     
      0 - No tracing
      1 - Serious errors reported
      2 - Transient errors reported
      3 - session progress reported
     
     Note that tracing only goes to the log file, and that a
     non-zero trace value also causes a "new mail arrived"
     message to be displayed on the console.

>> Example:  popmail trace 0

-----------------------------------------------------------------
popmail verbose <level>			     	      Default:  1
-----------------------------------------------------------------
	
     Displays or sets the verbose level for POP3 sessions. 
     Current verbose levels are:
     0 - Off.
     1 - Mail poll message only.
     2 - Mail delivery only.
     3 - Mail delivery, server poll results and responses from
         Kick and Drop to indicate their action.

     The delivery complete message is always provided.

>> Example:  popmail verbose 2
