| 1 | .\" $Id: dspam_merge.1,v 1.11 2011/06/28 00:13:48 sbajic Exp $ |
|---|
| 2 | .\" -*- nroff -*- |
|---|
| 3 | .\" |
|---|
| 4 | .\" dspam_merge3.9 |
|---|
| 5 | .\" |
|---|
| 6 | .\" Authors: Jonathan A. Zdziarski <jonathan@nuclearelephant.com> |
|---|
| 7 | .\" Stevan Bajic <stevan@bajic.ch> |
|---|
| 8 | .\" |
|---|
| 9 | .\" Copyright (C) 2002-2012 DSPAM Project |
|---|
| 10 | .\" All rights reserved |
|---|
| 11 | .\" |
|---|
| 12 | .TH dspam_merge 1 "Apr 17, 2010" "DSPAM" "DSPAM" |
|---|
| 13 | |
|---|
| 14 | .SH NAME |
|---|
| 15 | dspam_merge \- merge several users' metadata into a composite |
|---|
| 16 | |
|---|
| 17 | .SH SYNOPSIS |
|---|
| 18 | .na |
|---|
| 19 | .B dspam_merge |
|---|
| 20 | [\c |
|---|
| 21 | .BI \--profile= \PROFILE\c |
|---|
| 22 | ] |
|---|
| 23 | .BI \ user1\ user2\ ...\ userN\c |
|---|
| 24 | .BI \ \-o \ username\fR\c |
|---|
| 25 | |
|---|
| 26 | .ad |
|---|
| 27 | .SH DESCRIPTION |
|---|
| 28 | .LP |
|---|
| 29 | .B dspam_merge |
|---|
| 30 | merges several users' metadata into a single user's dictionary. This tool |
|---|
| 31 | is designed to create global users and seeded data. The hit sounds for each |
|---|
| 32 | token and per\-user totals are added together to produce a single composite |
|---|
| 33 | dataset. After creating a composite user, |
|---|
| 34 | .B dspam_clean |
|---|
| 35 | should be run with the \-p option to clean up extraneous data. |
|---|
| 36 | |
|---|
| 37 | .B NOTE |
|---|
| 38 | : Merges may take a considerable amount of time. This could potentially increase |
|---|
| 39 | the load on the server or even slow down the delivery of email. A merge should |
|---|
| 40 | only be performed when the system is fairly acquiesce. |
|---|
| 41 | |
|---|
| 42 | .SH OPTIONS |
|---|
| 43 | .LP |
|---|
| 44 | |
|---|
| 45 | .ne 3 |
|---|
| 46 | .TP |
|---|
| 47 | .BI \ \--profile= \PROFILE\c |
|---|
| 48 | Specify a storage profile from dspam.conf. The storage profile selected will be used |
|---|
| 49 | for all database connectivity. See dspam.conf for more information. |
|---|
| 50 | |
|---|
| 51 | .ne 3 |
|---|
| 52 | .TP |
|---|
| 53 | .BI \ user1\ user2\ ...\ userN\c |
|---|
| 54 | A list of users to merge together. |
|---|
| 55 | |
|---|
| 56 | .ne 3 |
|---|
| 57 | .TP |
|---|
| 58 | .BI \ \-o \ username\c |
|---|
| 59 | The target user which will be created (if necessary). This user will contain |
|---|
| 60 | the composite generated by the merge. |
|---|
| 61 | |
|---|
| 62 | .SH EXAMPLES |
|---|
| 63 | .B dspam_merge dick jane spot \-o ralph |
|---|
| 64 | |
|---|
| 65 | Merges the metadata dictionaries of dick, jane, and spot into a single |
|---|
| 66 | composite under the user |
|---|
| 67 | .B ralph |
|---|
| 68 | . |
|---|
| 69 | |
|---|
| 70 | .SH EXIT VALUE |
|---|
| 71 | .LP |
|---|
| 72 | .ne 3 |
|---|
| 73 | .PD 0 |
|---|
| 74 | .TP |
|---|
| 75 | .B 0 |
|---|
| 76 | Operation was successful. |
|---|
| 77 | .ne 3 |
|---|
| 78 | .TP |
|---|
| 79 | .B other |
|---|
| 80 | Operation resulted in an error. |
|---|
| 81 | .PD |
|---|
| 82 | |
|---|
| 83 | .SH COPYRIGHT |
|---|
| 84 | Copyright \(co 2002\-2012 DSPAM Project |
|---|
| 85 | .br |
|---|
| 86 | All rights reserved. |
|---|
| 87 | .br |
|---|
| 88 | |
|---|
| 89 | For more information, see http://dspam.sourceforge.net. |
|---|
| 90 | |
|---|
| 91 | .SH SEE ALSO |
|---|
| 92 | .BR dspam (1), |
|---|
| 93 | .BR dspam_admin (1), |
|---|
| 94 | .BR dspam_clean (1), |
|---|
| 95 | .BR dspam_crc (1), |
|---|
| 96 | .BR dspam_dump (1), |
|---|
| 97 | .BR dspam_logrotate (1), |
|---|
| 98 | .BR dspam_stats (1), |
|---|
| 99 | .BR dspam_train (1) |
|---|
