1MAPITEST(1)                OpenChange Users' Manual                MAPITEST(1)
2
3
4

NAME

6       mapitest - OpenChange torture test utility
7
8

SYNOPSIS

10       mapitest [-?|--help] [--usage] [-f|--database=STRING] [-p|--profile=STRING]
11         [-p|--password=STRING] [--confidential] [--color] [--subunit]
12         [-o|--outfile=STRING] [--mapi-calls=STRING] [--list-all] [--no-server]
13         [--dump-data] [-d|--debuglevel=STRING]
14
15

DESCRIPTION

17       mapitest  is a test harness / utility used for verifying correct opera‐
18       tion of various ExchangeRPC calls /  MAPI  functions  provided  by  the
19       OpenChange MAPI libraries.
20
21       mapitest  is  not  normally  required by users, but you may be asked to
22       provide the output of mapitest for some kinds of bug investigations.
23
24       Note that mapitest performs a lot of transactions,  including  deleting
25       folders  and  messages.  Unless  you're very familiar with mapitest, we
26       recommend only using it with a test account.
27
28

OPTIONS

30       --database
31
32       -f     Set the path to the profile database to use
33
34
35       --profile
36
37       -p     Set the profile to use. If no  profile  is  specified,  mapitest
38              tries  to  retrieve  the  default profile in the database. If no
39              default profile has been set, mapitest returns  MAPI_E_NOT_FOUND
40              .
41
42
43       --password
44
45       -P     Specify the password for the profile to use. This can be omitted
46              if the password is stored in the profile.
47
48
49       --confidential
50              Remove any sensitive data from the report.
51
52
53       --color
54              Use colors to indicate the results of each operation.
55
56
57       --subunit
58              Produce output in subunit protocol format, instead of the normal
59              text  output. This disables colored output. Note that availabil‐
60              ity of this option depends on suitable libraries being available
61              at build time, so check availability before relying on this.
62
63
64       --outfile
65
66       -o     Redirect the output of the tests to a file. The filename must be
67              specified as the argument to this option.
68
69
70       --mapi-calls
71              Run a specific test. The name of the test must be  specified  as
72              the argument to this option. See the --list-all option to obtain
73              the name of the test.  This can be specified more than  once  in
74              order  to run a subset of tests.  This can also be used to run a
75              "suite" of tests, by appending "-ALL" to the name of the suite.
76
77
78       --list-all
79              Provide a list of all test suites and test names, along  with  a
80              description of the test. No tests will be run.
81
82
83       --no-server
84              Only  run tests that do not require a server connection. This is
85              the default if a connection to the server cannot be established.
86
87
88       --dump-data
89              Dump the hex data. This is only required for debugging or educa‐
90              tional purposes.
91
92
93       --debuglevel
94
95       -d     Set the debug level.
96
97

EXAMPLES

99       Run all tests
100       mapitest
101
102       Only run two specific tests
103       mapitest --mapi-calls=NOSERVER-SROWSET --mapi-calls=OXCPRPT-GET-PROPS
104
105       Run all the NSPI tests
106       mapitest --mapi-calls=NSPI-ALL
107
108

REMARKS

110       If  you  are  using  the  default  profile database path and have set a
111       default profile (using mapiprofile --profile=profile_name -S )  you  do
112       not need to specify these parameters on the command line.
113
114

AUTHOR

116       mapitest  was  written by Julien Kerihuel <j.kerihuel at openchange dot
117       org> with contributions from other OpenChange developers.
118
119       This man page was written by Brad Hards <bradh at openchange dot org>
120
121
122
123OpenChange 2.0 QUADRANT           2013-01-24                       MAPITEST(1)