doc/vmailmgr.7
changeset 0 6f7a81934006
child 2 b3afb9f1e801
equal deleted inserted replaced
-1:000000000000 0:6f7a81934006
       
     1 .rn '' }`
       
     2 ''' $RCSfile$$Revision$$Date$
       
     3 '''
       
     4 ''' $Log$
       
     5 '''
       
     6 .de Sh
       
     7 .br
       
     8 .if t .Sp
       
     9 .ne 5
       
    10 .PP
       
    11 \fB\\$1\fR
       
    12 .PP
       
    13 ..
       
    14 .de Sp
       
    15 .if t .sp .5v
       
    16 .if n .sp
       
    17 ..
       
    18 .de Ip
       
    19 .br
       
    20 .ie \\n(.$>=3 .ne \\$3
       
    21 .el .ne 3
       
    22 .IP "\\$1" \\$2
       
    23 ..
       
    24 .de Vb
       
    25 .ft CW
       
    26 .nf
       
    27 .ne \\$1
       
    28 ..
       
    29 .de Ve
       
    30 .ft R
       
    31 
       
    32 .fi
       
    33 ..
       
    34 '''
       
    35 '''
       
    36 '''     Set up \*(-- to give an unbreakable dash;
       
    37 '''     string Tr holds user defined translation string.
       
    38 '''     Bell System Logo is used as a dummy character.
       
    39 '''
       
    40 .tr \(*W-|\(bv\*(Tr
       
    41 .ie n \{\
       
    42 .ds -- \(*W-
       
    43 .ds PI pi
       
    44 .if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
       
    45 .if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
       
    46 .ds L" ""
       
    47 .ds R" ""
       
    48 '''   \*(M", \*(S", \*(N" and \*(T" are the equivalent of
       
    49 '''   \*(L" and \*(R", except that they are used on ".xx" lines,
       
    50 '''   such as .IP and .SH, which do another additional levels of
       
    51 '''   double-quote interpretation
       
    52 .ds M" """
       
    53 .ds S" """
       
    54 .ds N" """""
       
    55 .ds T" """""
       
    56 .ds L' '
       
    57 .ds R' '
       
    58 .ds M' '
       
    59 .ds S' '
       
    60 .ds N' '
       
    61 .ds T' '
       
    62 'br\}
       
    63 .el\{\
       
    64 .ds -- \(em\|
       
    65 .tr \*(Tr
       
    66 .ds L" ``
       
    67 .ds R" ''
       
    68 .ds M" ``
       
    69 .ds S" ''
       
    70 .ds N" ``
       
    71 .ds T" ''
       
    72 .ds L' `
       
    73 .ds R' '
       
    74 .ds M' `
       
    75 .ds S' '
       
    76 .ds N' `
       
    77 .ds T' '
       
    78 .ds PI \(*p
       
    79 'br\}
       
    80 .\"	If the F register is turned on, we'll generate
       
    81 .\"	index entries out stderr for the following things:
       
    82 .\"		TH	Title 
       
    83 .\"		SH	Header
       
    84 .\"		Sh	Subsection 
       
    85 .\"		Ip	Item
       
    86 .\"		X<>	Xref  (embedded
       
    87 .\"	Of course, you have to process the output yourself
       
    88 .\"	in some meaninful fashion.
       
    89 .if \nF \{
       
    90 .de IX
       
    91 .tm Index:\\$1\t\\n%\t"\\$2"
       
    92 ..
       
    93 .nr % 0
       
    94 .rr F
       
    95 .\}
       
    96 .TH vmailmgr 7 "vmailmgr 0.96.9" "2000-09-30" "VMailMgr Tools Documentation"
       
    97 .UC
       
    98 .if n .hy 0
       
    99 .if n .na
       
   100 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
       
   101 .de CQ          \" put $1 in typewriter font
       
   102 .ft CW
       
   103 'if n "\c
       
   104 'if t \\&\\$1\c
       
   105 'if n \\&\\$1\c
       
   106 'if n \&"
       
   107 \\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
       
   108 '.ft R
       
   109 ..
       
   110 .\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
       
   111 .	\" AM - accent mark definitions
       
   112 .bd B 3
       
   113 .	\" fudge factors for nroff and troff
       
   114 .if n \{\
       
   115 .	ds #H 0
       
   116 .	ds #V .8m
       
   117 .	ds #F .3m
       
   118 .	ds #[ \f1
       
   119 .	ds #] \fP
       
   120 .\}
       
   121 .if t \{\
       
   122 .	ds #H ((1u-(\\\\n(.fu%2u))*.13m)
       
   123 .	ds #V .6m
       
   124 .	ds #F 0
       
   125 .	ds #[ \&
       
   126 .	ds #] \&
       
   127 .\}
       
   128 .	\" simple accents for nroff and troff
       
   129 .if n \{\
       
   130 .	ds ' \&
       
   131 .	ds ` \&
       
   132 .	ds ^ \&
       
   133 .	ds , \&
       
   134 .	ds ~ ~
       
   135 .	ds ? ?
       
   136 .	ds ! !
       
   137 .	ds /
       
   138 .	ds q
       
   139 .\}
       
   140 .if t \{\
       
   141 .	ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
       
   142 .	ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
       
   143 .	ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
       
   144 .	ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
       
   145 .	ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
       
   146 .	ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
       
   147 .	ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
       
   148 .	ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
       
   149 .	ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
       
   150 .\}
       
   151 .	\" troff and (daisy-wheel) nroff accents
       
   152 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
       
   153 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
       
   154 .ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
       
   155 .ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
       
   156 .ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
       
   157 .ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
       
   158 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
       
   159 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
       
   160 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
       
   161 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
       
   162 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
       
   163 .ds ae a\h'-(\w'a'u*4/10)'e
       
   164 .ds Ae A\h'-(\w'A'u*4/10)'E
       
   165 .ds oe o\h'-(\w'o'u*4/10)'e
       
   166 .ds Oe O\h'-(\w'O'u*4/10)'E
       
   167 .	\" corrections for vroff
       
   168 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
       
   169 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
       
   170 .	\" for low resolution devices (crt and lpr)
       
   171 .if \n(.H>23 .if \n(.V>19 \
       
   172 \{\
       
   173 .	ds : e
       
   174 .	ds 8 ss
       
   175 .	ds v \h'-1'\o'\(aa\(ga'
       
   176 .	ds _ \h'-1'^
       
   177 .	ds . \h'-1'.
       
   178 .	ds 3 3
       
   179 .	ds o a
       
   180 .	ds d- d\h'-1'\(ga
       
   181 .	ds D- D\h'-1'\(hy
       
   182 .	ds th \o'bp'
       
   183 .	ds Th \o'LP'
       
   184 .	ds ae ae
       
   185 .	ds Ae AE
       
   186 .	ds oe oe
       
   187 .	ds Oe OE
       
   188 .\}
       
   189 .rm #[ #] #H #V #F C
       
   190 .SH "NAME"
       
   191 vmailmgr \- a package to manage virtual mailboxes and aliases
       
   192 .SH "DESCRIPTION"
       
   193 This document describes the vmailmgr package which contains, among other
       
   194 things, a virtualizing password
       
   195 checking interface for qmail-pop3d.
       
   196 It is intended as a drop-in replacement for the standard checkpassword
       
   197 utility with several significant enhancements.
       
   198 .PP
       
   199 One of the goals of building this package was to provide a usable virtual
       
   200 mail interface that was efficient and as fully integrated into qmail as
       
   201 possible.
       
   202 This means that this package attempts to use the same control files that
       
   203 qmail uses to determine if a user is logging in via a virtual host.
       
   204 It also implies that all programs should be compiled for two reasons:
       
   205 .Ip "1" 8
       
   206 Compiled code will be more efficient than code executed by an
       
   207 interpreter, such as perl or java
       
   208 .Ip "2" 8
       
   209 There is no need for an
       
   210 interpreter to reside on the system once the code is compiled, eliminating
       
   211 concerns that such an interpreter could be used as an exploit in itself.
       
   212 .SH "SEE ALSO"
       
   213 \fIcheckvpw\fR\|(8),
       
   214 \fIvaddalias\fR\|(1),
       
   215 \fIvadduser\fR\|(1),
       
   216 \fIvdelalias\fR\|(1),
       
   217 \fIvdeliver\fR\|(1),
       
   218 \fIvdeluser\fR\|(1),
       
   219 \fIvmailmgrd\fR\|(8),
       
   220 \fIvpasswd\fR\|(1),
       
   221 \fIvsetup\fR\|(1)
       
   222 .SH "AUTHOR"
       
   223 Bruce Guenter <\fIbruceg@em.ca\fR>.
       
   224 .SH "HISTORY"
       
   225 \fBvmailmgr\fR used to be called \fBcheckvpw\fR, named for the original
       
   226 \*(L"core\*(R" of the package.
       
   227 
       
   228 .rn }` ''
       
   229 .IX Title "vmailmgr 7"
       
   230 .IX Name "vmailmgr - a package to manage virtual mailboxes and aliases"
       
   231 
       
   232 .IX Header "NAME"
       
   233 
       
   234 .IX Header "DESCRIPTION"
       
   235 
       
   236 .IX Item "1"
       
   237 
       
   238 .IX Item "2"
       
   239 
       
   240 .IX Header "SEE ALSO"
       
   241 
       
   242 .IX Header "AUTHOR"
       
   243 
       
   244 .IX Header "HISTORY"
       
   245