mapitest man page

mapitest — OpenChange torture test utility


  [-p|--password=STRING] [--confidential] [--color] [--subunit]
  [-o|--outfile=STRING] [--mapi-calls=STRING] [--list-all] [--no-server]
  [--dump-data] [-d|--debuglevel=STRING]


mapitest is a test harness / utility used for verifying correct operation of various ExchangeRPC calls / MAPI functions provided by the OpenChange MAPI libraries.

mapitest is not normally required by users, but you may be asked to provide the output of mapitest for some kinds of bug investigations.

Note that mapitest performs a lot of transactions, including deleting folders and messages. Unless you're very familiar with mapitest, we recommend only using it with a test account.



Set the path to the profile database to use


Set the profile to use. If no profile is specified, mapitest tries to retrieve the default profile in the database. If no default profile has been set, mapitest returns MAPI_E_NOT_FOUND .




Remove any sensitive data from the report.


Use colors to indicate the results of each operation.


Produce output in subunit protocol format, instead of the normal text output. This disables colored output. Note that availability of this option depends on suitable libraries being available at build time, so check availability before relying on this.


Redirect the output of the tests to a file. The filename must be specified as the argument to this option.


Run a specific test. The name of the test must be specified as the argument to this option. See the --list-all option to obtain the name of the test. This can be specified more than once in order to run a subset of tests. This can also be used to run a "suite" of tests, by appending "-ALL" to the name of the suite.


Provide a list of all test suites and test names, along with a description of the test. No tests will be run.


Only run tests that do not require a server connection. This is the default if a connection to the server cannot be established.




Set the debug level.


Run all tests


Only run two specific tests

mapitest --mapi-calls=NOSERVER-SROWSET --mapi-calls=OXCPRPT-GET-PROPS

Run all the NSPI tests

mapitest --mapi-calls=NSPI-ALL




mapitest was written by Julien Kerihuel <j.kerihuel at openchange dot org> with contributions from other OpenChange developers.



2013-01-24 OpenChange 2.0 QUADRANT OpenChange Users' Manual