NAME¶

mapitest - OpenChange torture test utility

SYNOPSIS¶

mapitest [-?|--help] [--usage] [-f|--database=STRING] [-p|--profile=STRING]


  [-p|--password=STRING] [--confidential] [--color] [--subunit]


  [-o|--outfile=STRING] [--mapi-calls=STRING] [--list-all] [--no-server]


  [--dump-data] [-d|--debuglevel=STRING]

DESCRIPTION¶

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.

OPTIONS¶

--database

-f

Set the path to the profile database to use

--profile

-p

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 .

--password

-P

Specify the password for the profile to use. This can be omitted if the password is stored in the profile.

--confidential

Remove any sensitive data from the report.

--color

Use colors to indicate the results of each operation.

--subunit

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.

--outfile

-o

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

--mapi-calls

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.

--list-all

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

--no-server

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

--dump-data

Dump the hex data. This is only required for debugging or educational purposes.

--debuglevel

-d

Set the debug level.

EXAMPLES¶

Run all tests

mapitest

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

REMARKS¶

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

AUTHOR¶

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

This man page was written by Brad Hards <bradh at openchange dot org>