crypto/heimdal-0.6.3/appl/popper/popper.8

   1 .\" Copyright (c) 2001 - 2003 Kungliga Tekniska Högskolan
   2 .\" (Royal Institute of Technology, Stockholm, Sweden).
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\"
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\"
  12 .\" 2. Redistributions in binary form must reproduce the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer in the
  14 .\"    documentation and/or other materials provided with the distribution.
  15 .\"
  16 .\" 3. Neither the name of the Institute nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\" $Id: popper.8,v 1.10 2003/04/16 20:49:54 lha Exp $
  33 .\"
  34 .Dd April 16, 2003
  35 .Dt POPPER 8
  36 .Os HEIMDAL
  37 .Sh NAME
  38 .Nm popper
  39 .Nd
  40 POP3 server
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Op Fl k
  44 .Op Fl a Ar none Ns \*(Ba Ns otp
  45 .Op Fl t Ar file
  46 .Op Fl T Ar seconds
  47 .Op Fl d
  48 .Op Fl i
  49 .Op Fl p Ar port
  50 .Op Fl -address-log= Ns Pa file
  51 .Sh DESCRIPTION
  52 .Nm
  53 serves mail via the Post Office Protocol.  Supported options include:
  54 .Bl -tag -width Ds
  55 .It Xo
  56 .Fl a Ar none Ns \*(Ba Ns otp ,
  57 .Fl -auth-mode= Ns Ar none Ns \*(Ba Ns otp
  58 .Xc
  59 tells
  60 .Nm
  61 what authentication modes are acceptable, passing
  62 .Ar otp
  63 disables clear text passwords. Otp doesn't disable Kerberos
  64 authentication, only cleartext passwords.
  65 .It Xo
  66 .Fl -address-log= Ns Pa file
  67 .Xc
  68 logs the addresses of all clients to the specified file
  69 .It Xo
  70 .Fl d ,
  71 .Fl -debug
  72 .Xc
  73 enables more verbose log messages
  74 .It Xo
  75 .Fl i ,
  76 .Fl -interactive
  77 .Xc
  78 when not started by inetd, this flag tells
  79 .Nm
  80 that it has to create a socket by itself
  81 .It Xo
  82 .Fl k ,
  83 .Fl -kerberos
  84 .Xc
  85 tells
  86 .Nm
  87 to use the Kerberos for authentication.
  88 .It Xo
  89 .Fl p Ar port ,
  90 .Fl -port= Ns Ar port
  91 .Xc
  92 port to listen to, in combination with
  93 .Fl i
  94 .It Xo
  95 .Fl t Ar file ,
  96 .Fl -trace-file= Ns Ar file
  97 .Xc
  98 trace all commands to file
  99 .It Xo
 100 .Fl T Ar seconds ,
 101 .Fl -timeout= Ns Ar seconds
 102 .Xc
 103 set timeout to something other than the default of 120 seconds
 104 .El
 105 .\".Sh ENVIRONMENT
 106 .\".Sh FILES
 107 .\".Sh EXAMPLES
 108 .\".Sh DIAGNOSTICS
 109 .Sh SEE ALSO
 110 .Xr push 8 ,
 111 .Xr movemail 8
 112 .Sh STANDARDS
 113 RFC1939 (Post Office Protocol - Version 3)
 114 .\" RFC2449 (POP3 Extension Mechanism)
 115 .\".Sh HISTORY
 116 .Sh AUTHORS
 117 The server was initially developed at the University of California,
 118 Berkeley.
 119 .Pp
 120 Many changes have been made as part of the KTH Kerberos distributions.
 121 .\".Sh BUGS