.\" $Id: dspam_merge.1,v 1.5 2006/05/14 15:37:30 jonz Exp $
.\"  -*- nroff -*-
.\"
.\" dspam_merge3.2
.\"
.\" Authors:    Jonathan A. Zdziarski <jonathan@nuclearelephant.com>
.\"
.\" Copyright (c) 2002-2006 Jonathan A. Zdziarski
.\" All rights reserved
.\"
.TH dspam_merge 1  "May 31, 2004" "DSPAM" "DSPAM"

.SH NAME
dspam_merge - merge several users' metadata into a composite

.SH SYNOPSIS
.na
.B dspam_merge
[\c
.BI \ user1\ user2\ ...\ userN \fR
]
[\c
.BI \ -o \ username \fR
]

.ad
.SH DESCRIPTION 
.LP
.B dspam_merge
merges several users' metadata into a single user's dictionary. This tool
is designed to create global users and seeded data. The hit sounds for each
token and per-user totals are added together to produce a single composite
dataset. After creating a composite user,
.B dspam_clean
should be run with the -p option to clean up extraneous data.

.B NOTE
: Merges may take a considerable amount of time. This could potentially increase
the load on the server or even slow down the delivery of email. A merge should
only be performed when the system is fairly acquiesce.

.SH OPTIONS
.LP
.ne 3
.TP
.BI \ user1\ user2\ ...\ userN \fR\c
A list of users to merge together.
 
.n3
.TP
.BI \ -o \ username \fR\c
The target user which will be created (if necessary). This user will contain
the composite generated by the merge.

.SH EXAMPLES
.B dspam_merge dick jane spot -o ralph

Merges the metadata dictionaries of dick, jane, and spot into a single
composite under the user 
.B ralph
.

.SH EXIT VALUE
.LP
.ne 3
.PD 0
.TP
.B 0
Operation was successful.
.ne 3
.TP
.B other
Operation resulted in an error. 
.PD

.SH AUTHORS
.LP

Jonathan A. Zdziarski

For more information, see http://www.nuclearelephant.com.

.SH SEE ALSO
.BR dspam (1),
.BR dspam_dump (1),
.BR dspam_stats (1),
.BR dspam_train (1),
.BR dspam_clean (1)