mapitest(1) [centos man page]
MAPITEST(1) OpenChange Users' Manual MAPITEST(1) 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> OpenChange 2.0 QUADRANT 2013-01-24 MAPITEST(1)
Check Out this Related Man Page
MAPIPROFILE(1) OpenChange Users' Manual MAPIPROFILE(1) NAME
mapiprofile - administer OpenChange MAPI Profiles databases SYNOPSIS
mapiprofile [-?GSnEcrlV] [-?|--help] [--usage] [-L|--ldif=PATH] [-G|--getdefault] [-S|--default] [-n|--newdb] [-f|--database=PATH] [-P|--profile=PROFILE] [-I|--address=xxx.xxx.xxx.xxx] [-M|--workstation=WORKSTATION_NAME] [-D|--domain=DOMAIN] [-R|--realm=REALM] [-E|--encrypt] [-v|--exchange-version=2000] [-u|--username=USERNAME] [-C|--language=LANGUAGE] [-s|--pattern=USERNAME] [-p|--password=PASSWORD] [--nopass] [-c|--create] [-r|--delete] [-R|--rename=STRING] [-l|--list] [--listlangs] [--dump] [-a|--attr=VALUE] [--dump-data] [-d|--debuglevel=LEVEL] [--getfqdn] [-k|--kerberos={yes|no}] [-V|--version] DESCRIPTION
mapiprofile is a command line tool designed to provide administrative support for OpenChange MAPI profiles. A profile in this context rep- resents a single user's connection to a server. It can be thought of as a user's account information stored on the client side. Most Open- Change utilities make use of the profile information stored in the local profile database, often by referring to the name of the profile. In addition, because most users only have a single account, it is possible to designate one profile as the default profile. If a profile is not specified, other utilities will use the default profile (if any) to establish a connection. mapiprofile is designed so it also provides sample code for developers interested in adding OpenChange MAPI profile support to their appli- cations. COMMANDS
--newdb -n Create a new database. --create -c Create a new profile in the database. --delete -r Delete a profile from the database. --rename PROFILE -R Rename a profile in the database --default -S Set the default profile in the database. --getdefault -G Get the default profile name from the database. --dump Display information about a specific profile from information stored in the database. --list -l List existing profiles in the database. --listlangs List the available languages. These can be used to specify the language name (--language) when creating a profile. OPTIONS
--database DATABASE -f Path to the profile database. If no path database is specified then the default one will be used $HOME/.openchange/profiles.ldb --ldif LDIF -L Path to the LDIF files. If no LDIF directory is specified then the default one set at compilation time will be used. This option is only used when creating a new profile database. --profile PROFILE -p Set the profile name to use (e.g. the profile to create or delete, or to dump information about). --address IP_ADDR|FQDN -I Set the Exchange server IP address or fully qualified domain name. --workstation WORKSTATION -M Sets the local computer name. --domain DOMAIN -D Set the Windows domain name. --encrypt -E Require the connection to be encrypted. This is normally required only on Exchange 2010 (and will presumably also be required on future versions), but may be used on Exchange 2003 and Exchange 2007. --exchange-version -v Specify which version of the protocol to use. The reasonable options are 2000, 2003/2007 and 2010. 2000 means use EcDoConnect (0x0) / EcDoRpc (0x2) RPC calls, 2003 or 2007 means use EcDoConnectEx (0xA) / EcDoRpcExt2 (0xB) RPC calls, and 2010 means use EcDoCon- nectEx (0xA) / EcDoRpcExt2 (0xB) RPC calls over a sealed pipe. --kerberos -k Specify whether to force Kerberos (set to yes), not use Kerberos (set to no). If you omit this option, Kerberos will be used where practical. --realm REALM -R Set the Windows realm --username -u Set the username to use to log on the Exchange server. --password -p Set the password corresponding to the username described above. --language -C Specify the language to use with the account. When specifying the name, you use the name of the language returned within the list --listlangs option displays. See the --listlangs option for how to obtain the full list of languages. The default language code is the system one stored within the LC_CTYPE environment variable. --pattern -s Set a username string pattern mapiprofile should use rather than the default username. This option is used during mapi profile cre- ation. --nopass Do not save password in the profile. --attr VALUE -a Print an attribute value. --dump-data Dump the hex data. --debuglevel LEVEL -d Set the debug level. --getfqdn Returns the DNS fully qualified domain name of the NSPI server matching the legacyDN. EXAMPLES
Create a blank MAPI profile database: mapiprofile --database=/tmp/profiles2.ldb --ldif=/usr/local/samba/share/setup --newdb Create a new profile using NTLMSSP authentication: mapiprofile --database=/tmp/profiles.ldb --profile=jkerihuel --username=jkerihuel --password=secret --language=French (France) --address=192.168.194.22 --workstation=LOCALHOST --domain=OPENCHANGE --create Profile jkerihuel completed and added to database /tmp/profiles.ldb. Note that this account will use French. Create a new profile using Kerberos authentication: mapiprofile --database=/tmp/profiles.ldb --profile=jkerihuel --username=jkerihuel --password=secret --language=French (France) --address=exchange.openchange.local --domain=OPENCHANGE --realm=OPENCHANGE.LOCAL --create Delete a profile: mapiprofile --database=/tmp/profiles.ldb --profile=jkerihuel --delete Profile jkerihuel deleted from database /tmp/profiles.ldb List profiles: mapiprofile --database=/tmp/profiles.ldb --list We have 2 profiles in the database: Profile = exchange-2000 Profile = jkerihuel Dump a profile: mapiprofile --database=/tmp/profiles.ldb --profile=jkerihuel --dump Profile: jkerihuel username == jkerihuel password == secret mailbox == /o=First Organization/ou=First Administrative Group/cn=Recipients/cn=jkerihuel workstation == LOCALHOST domain == OPENCHANGE server == exchange.openchange.local Dump profile attribute: mapiprofile --database=/tmp/profiles.ldb --profile=jkerihuel --attr=HomeMDB Profile jkerihuel: HomeMDB = /o=First Organization/ou=First Administrative Group/cn=Configuration/cn=Servers/cn=EXCHANGE2000 AUTHOR
Julien Kerihuel <j.kerihuel at openchange dot org> Brad Hards <bradh at openchange dot org> SEE ALSO
The codes for various languages can be found in many places, including the Windows Language Code Identifier (LCID) Reference. OpenChange 2.0 QUADRANT 2013-01-24 MAPIPROFILE(1)