.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "qar-bufo 1"
.TH qar-bufo 1 "2008-01-07" "1.3.1" "qar-bufo user guide"
.SH "NAME"
qar\-bufo \- Generate assign and recipient files for QMail.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
qar-bufo [\fB\-a\fR assign file] [\fB\-b\fR recipient file] [\fB\-b\fR virtualdomains files]
[\fB\-d\fR domains files] [\fB\-g\fR groups] [\fB\-e\fR]
.SH "OPTIONS"
.IX Header "OPTIONS"
.RE
.IP "\fB\-a\fR assign output file"
.IX Item "-a assign output file"
This should be the file you wish to dump the QMail assign out to. The
default is /var/qmail/users/assign.
.RE
.IP "\fB\-r\fR recipients output file"
.IX Item "-r recipients output file"
This should be the file you wish to dump the QMail recipient list out to. The
default is /var/qmail/users/recipients.
.RE
.IP "\fB\-v\fR virtualdomains files"
.IX Item "-v virtualdomains files"
This should be a comma seperated list of files to pull the virtual domains from.
The defualt is  /var/qmail/control/virtualdomains.
.RE
.IP "\fB\-d\fR domains files"
.IX Item "-d domains files"
This should be a comma seperated list of files to pull the domains from. The
defaults are /var/qmail/control/me, /var/qmail/control/locals, /var/qmail/control/rcpthosts,
and /var/qmail/control/defaultdomain.
.RE
.IP "\fB\-g\fR groups"
.IX Item "-g groups"
This should be a comma seperated list of groups. The defaults are SMTPaccess and SMTPrecieveonly.
.RE
.IP "\fB\-e\fR"
.IX Item "-e"
Tells it to look for extension address for each user. By default it does not do this.
.SH "TODO"
.IX Header "TODO"
.RE
.IP "Finish writing the pod."
.IX Item "Finish writing the pod."
.SH "NOTES"
.IX Header "NOTES"
Was originally planned to be named \s-1MWCQARGUGAU\s0. This stood for 
MidWest Connection's Qmail Assign & Recipients Generator Using
Groups And Users, but that was to bulky and awkward. QAR-Bufo
sounded so much nicer and much cooler.
.SH "AUTHOR"
.IX Header "AUTHOR"
Copyright (c) 2006, Midwest Connections Inc.
.PP
All rights reserved.
.PP
Redistribution and use in source and binary forms, with or without 
modification, are permitted provided that the following conditions are met:
.PP
.Vb 8
\&    * Redistributions of source code must retain the above copyright notice,
\&     this list of conditions and the following disclaimer.
\&    * Redistributions in binary form must reproduce the above copyright
\&     notice, this list of conditions and the following disclaimer in the
\&     documentation and/or other materials provided with the distribution.
\&    * Neither the name of the Midwest Connections Inc. nor the names of its
\&     contributors may be used to endorse or promote products derived from
\&     this software without specific prior written permission.
.Ve
.PP
\&\s-1THIS\s0 \s-1SOFTWARE\s0 \s-1IS\s0 \s-1PROVIDED\s0 \s-1BY\s0 \s-1THE\s0 \s-1COPYRIGHT\s0 \s-1HOLDERS\s0 \s-1AND\s0 \s-1CONTRIBUTORS\s0 \*(L"\s-1AS\s0 \s-1IS\s0\*(R"
\&\s-1AND\s0 \s-1ANY\s0 \s-1EXPRESS\s0 \s-1OR\s0 \s-1IMPLIED\s0 \s-1WARRANTIES\s0, \s-1INCLUDING\s0, \s-1BUT\s0 \s-1NOT\s0 \s-1LIMITED\s0 \s-1TO\s0, \s-1THE\s0
\&\s-1IMPLIED\s0 \s-1WARRANTIES\s0 \s-1OF\s0 \s-1MERCHANTABILITY\s0 \s-1AND\s0 \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0
\&\s-1ARE\s0 \s-1DISCLAIMED\s0. \s-1IN\s0 \s-1NO\s0 \s-1EVENT\s0 \s-1SHALL\s0 \s-1THE\s0 \s-1COPYRIGHT\s0 \s-1OWNER\s0 \s-1OR\s0 \s-1CONTRIBUTORS\s0 \s-1BE\s0 \s-1LIABLE\s0
\&\s-1FOR\s0 \s-1ANY\s0 \s-1DIRECT\s0, \s-1INDIRECT\s0, \s-1INCIDENTAL\s0, \s-1SPECIAL\s0, \s-1EXEMPLARY\s0, \s-1OR\s0 \s-1CONSEQUENTIAL\s0
\&\s-1DAMAGES\s0 (\s-1INCLUDING\s0, \s-1BUT\s0 \s-1NOT\s0 \s-1LIMITED\s0 \s-1TO\s0, \s-1PROCUREMENT\s0 \s-1OF\s0 \s-1SUBSTITUTE\s0 \s-1GOODS\s0 \s-1OR\s0
\&\s-1SERVICES\s0; \s-1LOSS\s0 \s-1OF\s0 \s-1USE\s0, \s-1DATA\s0, \s-1OR\s0 \s-1PROFITS\s0; \s-1OR\s0 \s-1BUSINESS\s0 \s-1INTERRUPTION\s0) \s-1HOWEVER\s0
\&\s-1CAUSED\s0 \s-1AND\s0 \s-1ON\s0 \s-1ANY\s0 \s-1THEORY\s0 \s-1OF\s0 \s-1LIABILITY\s0, \s-1WHETHER\s0 \s-1IN\s0 \s-1CONTRACT\s0, \s-1STRICT\s0 \s-1LIABILITY\s0,
\&\s-1OR\s0 \s-1TORT\s0 (\s-1INCLUDING\s0 \s-1NEGLIGENCE\s0 \s-1OR\s0 \s-1OTHERWISE\s0) \s-1ARISING\s0 \s-1IN\s0 \s-1ANY\s0 \s-1WAY\s0 \s-1OUT\s0 \s-1OF\s0 \s-1THE\s0 \s-1USE\s0 \s-1OF\s0
\&\s-1THIS\s0 \s-1SOFTWARE\s0, \s-1EVEN\s0 \s-1IF\s0 \s-1ADVISED\s0 \s-1OF\s0 \s-1THE\s0 \s-1POSSIBILITY\s0 \s-1OF\s0 \s-1SUCH\s0 \s-1DAMAGE\s0.
.PP
written by Zane C. Bowers <zanecb@midwest\-connections.com>
.SH "SCRIPT CATEGORIES"
.IX Header "SCRIPT CATEGORIES"
Unix/System_administration
.SH "OSNAMES"
.IX Header "OSNAMES"
any
.SH "README"
.IX Header "README"
qar-bufo generates the Qmail assign and recipients file based on unix groups.
.SH "CHANGELOG"
.IX Header "CHANGELOG"
.RE
.IP "2006\-09\-12 1.3.1"
.IX Item "2006-09-12 1.3.1"
Fixed a problem with it skipping over some domian names for when generating the recipient list.
.RE
.IP "2006\-09\-11 1.3.0"
.IX Item "2006-09-11 1.3.0"
Run qmail-newu and qmail\-recipients.
.RE
.IP "2006\-09\-11 1.2.0"
.IX Item "2006-09-11 1.2.0"
Fixed a problem with it not putting . on the end of the assign and fixed the recipient gen so it does not put every one in every virtual domain.
.RE
.IP "2006\-09\-08 1.1.0"
.IX Item "2006-09-08 1.1.0"
Updated the \s-1POD\s0.