external-software/github_OpenIdentityPlatform_OpenDJ.git

			@@ -6,17 +6,16 @@
			* (the "License"). You may not use this file except in compliance
			* with the License.
			*
			* You can obtain a copy of the license at
			* trunk/opendj3/legal-notices/CDDLv1_0.txt
			* You can obtain a copy of the license at legal-notices/CDDLv1_0.txt
			* or http://forgerock.org/license/CDDLv1.0.html.
			* See the License for the specific language governing permissions
			* and limitations under the License.
			*
			* When distributing Covered Code, include this CDDL HEADER in each
			* file and include the License file at
			* trunk/opendj3/legal-notices/CDDLv1_0.txt. If applicable,
			* add the following below this CDDL HEADER, with the fields enclosed
			* by brackets "[]" replaced with your own identifying information:
			* file and include the License file at legal-notices/CDDLv1_0.txt.
			* If applicable, add the following below this CDDL HEADER, with the
			* fields enclosed by brackets "[]" replaced with your own identifying
			* information:
			* Portions Copyright [yyyy] [name of copyright owner]
			*
			* CDDL HEADER END
			@@ -28,19 +27,27 @@

			package com.forgerock.opendj.ldap.tools;



			import static com.forgerock.opendj.ldap.tools.ToolsMessages.*;
			import static com.forgerock.opendj.ldap.tools.ToolConstants.*;
			import static com.forgerock.opendj.ldap.tools.ToolsMessages.*;
			import static com.forgerock.opendj.ldap.tools.Utils.filterExitCode;
			import static org.forgerock.opendj.ldap.ErrorResultException.newErrorResult;

			import java.io.*;
			import java.io.BufferedReader;
			import java.io.FileNotFoundException;
			import java.io.FileReader;
			import java.io.IOException;
			import java.io.InputStreamReader;
			import java.util.ArrayList;

			import org.forgerock.i18n.LocalizableMessage;
			import org.forgerock.i18n.LocalizedIllegalArgumentException;
			import org.forgerock.opendj.ldap.*;
			import org.forgerock.opendj.ldap.ByteString;
			import org.forgerock.opendj.ldap.Connection;
			import org.forgerock.opendj.ldap.ConnectionFactory;
			import org.forgerock.opendj.ldap.DecodeException;
			import org.forgerock.opendj.ldap.ErrorResultException;
			import org.forgerock.opendj.ldap.Filter;
			import org.forgerock.opendj.ldap.ResultCode;
			import org.forgerock.opendj.ldap.controls.AssertionRequestControl;
			import org.forgerock.opendj.ldap.controls.Control;
			import org.forgerock.opendj.ldap.controls.ProxiedAuthV2RequestControl;
			@@ -50,496 +57,388 @@

			import com.forgerock.opendj.util.Base64;



			/**
			* A tool that can be used to issue Compare requests to the Directory Server.
			*/
			public final class LDAPCompare extends ConsoleApplication
			{
			/**
			* The main method for LDAPModify tool.
			*
			* @param args
			* The command-line arguments provided to this program.
			*/
			public final class LDAPCompare extends ConsoleApplication {
			/**
			* The main method for LDAPModify tool.
			*
			* @param args
			* The command-line arguments provided to this program.
			*/

			public static void main(final String[] args)
			{
			final int retCode = new LDAPCompare().run(args);
			System.exit(filterExitCode(retCode));
			}



			private BooleanArgument verbose;



			private LDAPCompare()
			{
			// Nothing to do.
			}



			/**
			* {@inheritDoc}
			*/
			@Override
			public boolean isVerbose()
			{
			return verbose.isPresent();
			}



			private int executeCompare(final CompareRequest request,
			final Connection connection)
			{
			println(INFO_PROCESSING_COMPARE_OPERATION.get(request
			.getAttributeDescription().toString(), request
			.getAssertionValueAsString(), request.getName().toString()));
			if (connection != null)
			{
			try
			{
			Result result;
			try
			{
			result = connection.compare(request);
			}
			catch (final InterruptedException e)
			{
			// This shouldn't happen because there are no other threads to
			// interrupt this one.
			throw newErrorResult(ResultCode.CLIENT_SIDE_USER_CANCELLED,
			e.getLocalizedMessage(), e);
			}

			if (result.getResultCode() == ResultCode.COMPARE_FALSE)
			{
			println(INFO_COMPARE_OPERATION_RESULT_FALSE.get(request.getName()
			.toString()));
			}
			else
			{

			println(INFO_COMPARE_OPERATION_RESULT_TRUE.get(request.getName()
			.toString()));
			}
			}
			catch (final ErrorResultException ere)
			{
			final LocalizableMessage msg = INFO_OPERATION_FAILED.get("COMPARE");
			println(msg);
			final Result r = ere.getResult();
			println(ERR_TOOL_RESULT_CODE.get(r.getResultCode().intValue(), r
			.getResultCode().toString()));
			if ((r.getDiagnosticMessage() != null)
			&& (r.getDiagnosticMessage().length() > 0))
			{
			println(LocalizableMessage.raw(r.getDiagnosticMessage()));
			}
			if (r.getMatchedDN() != null && r.getMatchedDN().length() > 0)
			{
			println(ERR_TOOL_MATCHED_DN.get(r.getMatchedDN()));
			}
			return r.getResultCode().intValue();
			}
			}
			return ResultCode.SUCCESS.intValue();
			}



			private int run(final String[] args)
			{
			// Create the command-line argument parser for use with this
			// program.
			final LocalizableMessage toolDescription = INFO_LDAPCOMPARE_TOOL_DESCRIPTION
			.get();
			final ArgumentParser argParser = new ArgumentParser(LDAPCompare.class
			.getName(), toolDescription, false, true, 1, 0,
			"attribute:value [DN ...]");
			ConnectionFactoryProvider connectionFactoryProvider;
			ConnectionFactory connectionFactory;

			BooleanArgument continueOnError;
			BooleanArgument noop;
			BooleanArgument showUsage;
			IntegerArgument version;
			StringArgument assertionFilter;
			StringArgument controlStr;
			StringArgument encodingStr;
			StringArgument filename;
			StringArgument proxyAuthzID;
			StringArgument propertiesFileArgument;
			BooleanArgument noPropertiesFileArgument;

			try
			{
			connectionFactoryProvider =
			new ConnectionFactoryProvider(argParser, this);
			propertiesFileArgument = new StringArgument("propertiesFilePath", null,
			OPTION_LONG_PROP_FILE_PATH, false, false, true,
			INFO_PROP_FILE_PATH_PLACEHOLDER.get(), null, null,
			INFO_DESCRIPTION_PROP_FILE_PATH.get());
			argParser.addArgument(propertiesFileArgument);
			argParser.setFilePropertiesArgument(propertiesFileArgument);

			noPropertiesFileArgument = new BooleanArgument(
			"noPropertiesFileArgument", null, OPTION_LONG_NO_PROP_FILE,
			INFO_DESCRIPTION_NO_PROP_FILE.get());
			argParser.addArgument(noPropertiesFileArgument);
			argParser.setNoPropertiesFileArgument(noPropertiesFileArgument);

			filename = new StringArgument("filename", OPTION_SHORT_FILENAME,
			OPTION_LONG_FILENAME, false, false, true,
			INFO_FILE_PLACEHOLDER.get(), null, null,
			INFO_LDAPMODIFY_DESCRIPTION_FILENAME.get());
			filename.setPropertyName(OPTION_LONG_FILENAME);
			argParser.addArgument(filename);

			proxyAuthzID = new StringArgument("proxy_authzid",
			OPTION_SHORT_PROXYAUTHID, OPTION_LONG_PROXYAUTHID, false, false,
			true, INFO_PROXYAUTHID_PLACEHOLDER.get(), null, null,
			INFO_DESCRIPTION_PROXY_AUTHZID.get());
			proxyAuthzID.setPropertyName(OPTION_LONG_PROXYAUTHID);
			argParser.addArgument(proxyAuthzID);

			assertionFilter = new StringArgument("assertionfilter", null,
			OPTION_LONG_ASSERTION_FILE, false, false, true,
			INFO_ASSERTION_FILTER_PLACEHOLDER.get(), null, null,
			INFO_DESCRIPTION_ASSERTION_FILTER.get());
			assertionFilter.setPropertyName(OPTION_LONG_ASSERTION_FILE);
			argParser.addArgument(assertionFilter);

			controlStr = new StringArgument("control", 'J', "control", false, true,
			true, INFO_LDAP_CONTROL_PLACEHOLDER.get(), null, null,
			INFO_DESCRIPTION_CONTROLS.get());
			controlStr.setPropertyName("control");
			argParser.addArgument(controlStr);

			version = new IntegerArgument("version", OPTION_SHORT_PROTOCOL_VERSION,
			OPTION_LONG_PROTOCOL_VERSION, false, false, true,
			INFO_PROTOCOL_VERSION_PLACEHOLDER.get(), 3, null,
			INFO_DESCRIPTION_VERSION.get());
			version.setPropertyName(OPTION_LONG_PROTOCOL_VERSION);
			argParser.addArgument(version);

			encodingStr = new StringArgument("encoding", 'i', "encoding", false,
			false, true, INFO_ENCODING_PLACEHOLDER.get(), null, null,
			INFO_DESCRIPTION_ENCODING.get());
			encodingStr.setPropertyName("encoding");
			argParser.addArgument(encodingStr);

			continueOnError = new BooleanArgument("continueOnError", 'c',
			"continueOnError", INFO_DESCRIPTION_CONTINUE_ON_ERROR.get());
			continueOnError.setPropertyName("continueOnError");
			argParser.addArgument(continueOnError);

			noop = new BooleanArgument("no-op", OPTION_SHORT_DRYRUN,
			OPTION_LONG_DRYRUN, INFO_DESCRIPTION_NOOP.get());
			noop.setPropertyName(OPTION_LONG_DRYRUN);
			argParser.addArgument(noop);

			verbose = new BooleanArgument("verbose", 'v', "verbose",
			INFO_DESCRIPTION_VERBOSE.get());
			verbose.setPropertyName("verbose");
			argParser.addArgument(verbose);

			showUsage = new BooleanArgument("showUsage", OPTION_SHORT_HELP,
			OPTION_LONG_HELP, INFO_DESCRIPTION_SHOWUSAGE.get());
			argParser.addArgument(showUsage);
			argParser.setUsageArgument(showUsage, getOutputStream());
			}
			catch (final ArgumentException ae)
			{
			final LocalizableMessage message = ERR_CANNOT_INITIALIZE_ARGS.get(ae
			.getMessage());
			println(message);
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			public static void main(final String[] args) {
			final int retCode = new LDAPCompare().run(args);
			System.exit(filterExitCode(retCode));
			}

			// Parse the command-line arguments provided to this program.
			try
			{
			argParser.parseArguments(args);
			private BooleanArgument verbose;

			// If we should just display usage or version information,
			// then print it and exit.
			if (argParser.usageOrVersionDisplayed())
			{
			return 0;
			}

			connectionFactory =
			connectionFactoryProvider.getAuthenticatedConnectionFactory();
			}
			catch (final ArgumentException ae)
			{
			final LocalizableMessage message = ERR_ERROR_PARSING_ARGS.get(ae
			.getMessage());
			println(message);
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			private LDAPCompare() {
			// Nothing to do.
			}

			try
			{
			final int versionNumber = version.getIntValue();
			if (versionNumber != 2 && versionNumber != 3)
			{
			println(ERR_DESCRIPTION_INVALID_VERSION.get(String
			.valueOf(versionNumber)));
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			}
			catch (final ArgumentException ae)
			{
			println(ERR_DESCRIPTION_INVALID_VERSION.get(String.valueOf(version
			.getValue())));
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			/**
			* {@inheritDoc}
			*/
			@Override
			public boolean isVerbose() {
			return verbose.isPresent();
			}

			final ArrayList<String> dnStrings = new ArrayList<String>();
			final ArrayList<String> attrAndDNStrings = argParser.getTrailingArguments();
			private int executeCompare(final CompareRequest request, final Connection connection) {
			println(INFO_PROCESSING_COMPARE_OPERATION.get(request.getAttributeDescription().toString(),
			request.getAssertionValueAsString(), request.getName().toString()));
			if (connection != null) {
			try {
			Result result;
			try {
			result = connection.compare(request);
			} catch (final InterruptedException e) {
			// This shouldn't happen because there are no other threads
			// to
			// interrupt this one.
			throw newErrorResult(ResultCode.CLIENT_SIDE_USER_CANCELLED, e
			.getLocalizedMessage(), e);
			}

			if (attrAndDNStrings.isEmpty())
			{
			final LocalizableMessage message = ERR_LDAPCOMPARE_NO_ATTR.get();
			println(message);
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			if (result.getResultCode() == ResultCode.COMPARE_FALSE) {
			println(INFO_COMPARE_OPERATION_RESULT_FALSE.get(request.getName().toString()));
			} else {

			// First element should be an attribute string.
			final String attributeString = attrAndDNStrings.remove(0);

			// Rest are DN strings
			for (final String s : attrAndDNStrings)
			{
			dnStrings.add(s);
			}

			// If no DNs were provided, then exit with an error.
			if (dnStrings.isEmpty() && (!filename.isPresent()))
			{
			println(ERR_LDAPCOMPARE_NO_DNS.get());
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}

			// If trailing DNs were provided and the filename argument was also
			// provided, exit with an error.
			if (!dnStrings.isEmpty() && filename.isPresent())
			{
			println(ERR_LDAPCOMPARE_FILENAME_AND_DNS.get());
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}

			// parse the attribute string
			final int idx = attributeString.indexOf(":");
			if (idx == -1)
			{
			final LocalizableMessage message = ERR_LDAPCOMPARE_INVALID_ATTR_STRING
			.get(attributeString);
			println(message);
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			final String attributeType = attributeString.substring(0, idx);
			ByteString attributeVal;
			final String remainder = attributeString.substring(idx + 1, attributeString
			.length());
			if (remainder.length() > 0)
			{
			final char nextChar = remainder.charAt(0);
			if (nextChar == ':')
			{
			final String base64 = remainder.substring(1, remainder.length());
			try
			{
			attributeVal = Base64.decode(base64);
			}
			catch (final LocalizedIllegalArgumentException e)
			{
			println(INFO_COMPARE_CANNOT_BASE64_DECODE_ASSERTION_VALUE.get());
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			}
			else if (nextChar == '<')
			{
			try
			{
			final String filePath = remainder.substring(1, remainder.length());
			attributeVal = ByteString.wrap(Utils.readBytesFromFile(filePath));
			}
			catch (final Exception e)
			{
			println(INFO_COMPARE_CANNOT_READ_ASSERTION_VALUE_FROM_FILE.get(String
			.valueOf(e)));
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			}
			else
			{
			attributeVal = ByteString.valueOf(remainder);
			}
			}
			else
			{
			attributeVal = ByteString.valueOf(remainder);
			}

			final CompareRequest compare = Requests.newCompareRequest("",
			attributeType, attributeVal);

			if (controlStr.isPresent())
			{
			for (final String ctrlString : controlStr.getValues())
			{
			try
			{
			final Control ctrl = Utils.getControl(ctrlString);
			compare.addControl(ctrl);
			}
			catch (final DecodeException de)
			{
			final LocalizableMessage message = ERR_TOOL_INVALID_CONTROL_STRING
			.get(ctrlString);
			println(message);
			ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			}
			}

			if (proxyAuthzID.isPresent())
			{
			final Control proxyControl = ProxiedAuthV2RequestControl
			.newControl(proxyAuthzID.getValue());
			compare.addControl(proxyControl);
			}

			if (assertionFilter.isPresent())
			{
			final String filterString = assertionFilter.getValue();
			Filter filter;
			try
			{
			filter = Filter.valueOf(filterString);

			// FIXME -- Change this to the correct OID when the official one
			// is assigned.
			final Control assertionControl = AssertionRequestControl.newControl(
			true, filter);
			compare.addControl(assertionControl);
			}
			catch (final LocalizedIllegalArgumentException le)
			{
			final LocalizableMessage message = ERR_LDAP_ASSERTION_INVALID_FILTER
			.get(le.getMessage());
			println(message);
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			}

			BufferedReader rdr = null;
			if (!filename.isPresent() && dnStrings.isEmpty())
			{
			// Read from stdin.
			rdr = new BufferedReader(new InputStreamReader(System.in));
			}
			else if (filename.isPresent())
			{
			try
			{
			rdr = new BufferedReader(new FileReader(filename.getValue()));
			}
			catch (final FileNotFoundException t)
			{
			println(ERR_LDAPCOMPARE_ERROR_READING_FILE.get(filename.getValue(), t
			.toString()));
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			}

			Connection connection = null;
			if (!noop.isPresent())
			{
			try
			{
			connection = connectionFactory.getConnection();
			}
			catch (final ErrorResultException ere)
			{
			println(LocalizableMessage.raw(ere.getMessage()));
			return ere.getResult().getResultCode().intValue();
			}
			catch (final InterruptedException e)
			{
			// This shouldn't happen because there are no other threads to
			// interrupt this one.
			println(LocalizableMessage.raw(e.getLocalizedMessage()));
			return ResultCode.CLIENT_SIDE_USER_CANCELLED.intValue();
			}
			}

			try
			{
			int result;
			if (rdr == null)
			{
			for (final String dn : dnStrings)
			{
			compare.setName(dn);
			result = executeCompare(compare, connection);
			if (result != 0 && !continueOnError.isPresent())
			{
			return result;
			}
			}
			}
			else
			{
			String dn;
			try
			{
			while ((dn = rdr.readLine()) != null)
			{
			compare.setName(dn);
			result = executeCompare(compare, connection);
			if (result != 0 && !continueOnError.isPresent())
			{
			return result;
			println(INFO_COMPARE_OPERATION_RESULT_TRUE.get(request.getName().toString()));
			}
			} catch (final ErrorResultException ere) {
			final LocalizableMessage msg = INFO_OPERATION_FAILED.get("COMPARE");
			println(msg);
			final Result r = ere.getResult();
			println(ERR_TOOL_RESULT_CODE.get(r.getResultCode().intValue(), r.getResultCode()
			.toString()));
			if ((r.getDiagnosticMessage() != null) && (r.getDiagnosticMessage().length() > 0)) {
			println(LocalizableMessage.raw(r.getDiagnosticMessage()));
			}
			if (r.getMatchedDN() != null && r.getMatchedDN().length() > 0) {
			println(ERR_TOOL_MATCHED_DN.get(r.getMatchedDN()));
			}
			return r.getResultCode().intValue();
			}
			}
			}
			catch (final IOException ioe)
			{
			println(ERR_LDAPCOMPARE_ERROR_READING_FILE.get(filename.getValue(),
			ioe.toString()));
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			}
			}
			finally
			{
			if (connection != null)
			{
			connection.close();
			}
			if (rdr != null)
			{
			try
			{
			rdr.close();
			}
			catch (final IOException ioe)
			{
			// Just ignore
			}
			}
			return ResultCode.SUCCESS.intValue();
			}

			return 0;
			}
			private int run(final String[] args) {
			// Create the command-line argument parser for use with this
			// program.
			final LocalizableMessage toolDescription = INFO_LDAPCOMPARE_TOOL_DESCRIPTION.get();
			final ArgumentParser argParser =
			new ArgumentParser(LDAPCompare.class.getName(), toolDescription, false, true, 1, 0,
			"attribute:value [DN ...]");
			ConnectionFactoryProvider connectionFactoryProvider;
			ConnectionFactory connectionFactory;

			BooleanArgument continueOnError;
			BooleanArgument noop;
			BooleanArgument showUsage;
			IntegerArgument version;
			StringArgument assertionFilter;
			StringArgument controlStr;
			StringArgument encodingStr;
			StringArgument filename;
			StringArgument proxyAuthzID;
			StringArgument propertiesFileArgument;
			BooleanArgument noPropertiesFileArgument;

			try {
			connectionFactoryProvider = new ConnectionFactoryProvider(argParser, this);
			propertiesFileArgument =
			new StringArgument("propertiesFilePath", null, OPTION_LONG_PROP_FILE_PATH,
			false, false, true, INFO_PROP_FILE_PATH_PLACEHOLDER.get(), null, null,
			INFO_DESCRIPTION_PROP_FILE_PATH.get());
			argParser.addArgument(propertiesFileArgument);
			argParser.setFilePropertiesArgument(propertiesFileArgument);

			noPropertiesFileArgument =
			new BooleanArgument("noPropertiesFileArgument", null, OPTION_LONG_NO_PROP_FILE,
			INFO_DESCRIPTION_NO_PROP_FILE.get());
			argParser.addArgument(noPropertiesFileArgument);
			argParser.setNoPropertiesFileArgument(noPropertiesFileArgument);

			filename =
			new StringArgument("filename", OPTION_SHORT_FILENAME, OPTION_LONG_FILENAME,
			false, false, true, INFO_FILE_PLACEHOLDER.get(), null, null,
			INFO_LDAPMODIFY_DESCRIPTION_FILENAME.get());
			filename.setPropertyName(OPTION_LONG_FILENAME);
			argParser.addArgument(filename);

			proxyAuthzID =
			new StringArgument("proxy_authzid", OPTION_SHORT_PROXYAUTHID,
			OPTION_LONG_PROXYAUTHID, false, false, true,
			INFO_PROXYAUTHID_PLACEHOLDER.get(), null, null,
			INFO_DESCRIPTION_PROXY_AUTHZID.get());
			proxyAuthzID.setPropertyName(OPTION_LONG_PROXYAUTHID);
			argParser.addArgument(proxyAuthzID);

			assertionFilter =
			new StringArgument("assertionfilter", null, OPTION_LONG_ASSERTION_FILE, false,
			false, true, INFO_ASSERTION_FILTER_PLACEHOLDER.get(), null, null,
			INFO_DESCRIPTION_ASSERTION_FILTER.get());
			assertionFilter.setPropertyName(OPTION_LONG_ASSERTION_FILE);
			argParser.addArgument(assertionFilter);

			controlStr =
			new StringArgument("control", 'J', "control", false, true, true,
			INFO_LDAP_CONTROL_PLACEHOLDER.get(), null, null,
			INFO_DESCRIPTION_CONTROLS.get());
			controlStr.setPropertyName("control");
			argParser.addArgument(controlStr);

			version =
			new IntegerArgument("version", OPTION_SHORT_PROTOCOL_VERSION,
			OPTION_LONG_PROTOCOL_VERSION, false, false, true,
			INFO_PROTOCOL_VERSION_PLACEHOLDER.get(), 3, null,
			INFO_DESCRIPTION_VERSION.get());
			version.setPropertyName(OPTION_LONG_PROTOCOL_VERSION);
			argParser.addArgument(version);

			encodingStr =
			new StringArgument("encoding", 'i', "encoding", false, false, true,
			INFO_ENCODING_PLACEHOLDER.get(), null, null, INFO_DESCRIPTION_ENCODING
			.get());
			encodingStr.setPropertyName("encoding");
			argParser.addArgument(encodingStr);

			continueOnError =
			new BooleanArgument("continueOnError", 'c', "continueOnError",
			INFO_DESCRIPTION_CONTINUE_ON_ERROR.get());
			continueOnError.setPropertyName("continueOnError");
			argParser.addArgument(continueOnError);

			noop =
			new BooleanArgument("no-op", OPTION_SHORT_DRYRUN, OPTION_LONG_DRYRUN,
			INFO_DESCRIPTION_NOOP.get());
			noop.setPropertyName(OPTION_LONG_DRYRUN);
			argParser.addArgument(noop);

			verbose =
			new BooleanArgument("verbose", 'v', "verbose", INFO_DESCRIPTION_VERBOSE.get());
			verbose.setPropertyName("verbose");
			argParser.addArgument(verbose);

			showUsage =
			new BooleanArgument("showUsage", OPTION_SHORT_HELP, OPTION_LONG_HELP,
			INFO_DESCRIPTION_SHOWUSAGE.get());
			argParser.addArgument(showUsage);
			argParser.setUsageArgument(showUsage, getOutputStream());
			} catch (final ArgumentException ae) {
			final LocalizableMessage message = ERR_CANNOT_INITIALIZE_ARGS.get(ae.getMessage());
			println(message);
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}

			// Parse the command-line arguments provided to this program.
			try {
			argParser.parseArguments(args);

			// If we should just display usage or version information,
			// then print it and exit.
			if (argParser.usageOrVersionDisplayed()) {
			return 0;
			}

			connectionFactory = connectionFactoryProvider.getAuthenticatedConnectionFactory();
			} catch (final ArgumentException ae) {
			final LocalizableMessage message = ERR_ERROR_PARSING_ARGS.get(ae.getMessage());
			println(message);
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}

			try {
			final int versionNumber = version.getIntValue();
			if (versionNumber != 2 && versionNumber != 3) {
			println(ERR_DESCRIPTION_INVALID_VERSION.get(String.valueOf(versionNumber)));
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			} catch (final ArgumentException ae) {
			println(ERR_DESCRIPTION_INVALID_VERSION.get(String.valueOf(version.getValue())));
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}

			final ArrayList<String> dnStrings = new ArrayList<String>();
			final ArrayList<String> attrAndDNStrings = argParser.getTrailingArguments();

			if (attrAndDNStrings.isEmpty()) {
			final LocalizableMessage message = ERR_LDAPCOMPARE_NO_ATTR.get();
			println(message);
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}

			// First element should be an attribute string.
			final String attributeString = attrAndDNStrings.remove(0);

			// Rest are DN strings
			for (final String s : attrAndDNStrings) {
			dnStrings.add(s);
			}

			// If no DNs were provided, then exit with an error.
			if (dnStrings.isEmpty() && (!filename.isPresent())) {
			println(ERR_LDAPCOMPARE_NO_DNS.get());
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}

			// If trailing DNs were provided and the filename argument was also
			// provided, exit with an error.
			if (!dnStrings.isEmpty() && filename.isPresent()) {
			println(ERR_LDAPCOMPARE_FILENAME_AND_DNS.get());
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}

			// parse the attribute string
			final int idx = attributeString.indexOf(":");
			if (idx == -1) {
			final LocalizableMessage message =
			ERR_LDAPCOMPARE_INVALID_ATTR_STRING.get(attributeString);
			println(message);
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			final String attributeType = attributeString.substring(0, idx);
			ByteString attributeVal;
			final String remainder = attributeString.substring(idx + 1, attributeString.length());
			if (remainder.length() > 0) {
			final char nextChar = remainder.charAt(0);
			if (nextChar == ':') {
			final String base64 = remainder.substring(1, remainder.length());
			try {
			attributeVal = Base64.decode(base64);
			} catch (final LocalizedIllegalArgumentException e) {
			println(INFO_COMPARE_CANNOT_BASE64_DECODE_ASSERTION_VALUE.get());
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			} else if (nextChar == '<') {
			try {
			final String filePath = remainder.substring(1, remainder.length());
			attributeVal = ByteString.wrap(Utils.readBytesFromFile(filePath));
			} catch (final Exception e) {
			println(INFO_COMPARE_CANNOT_READ_ASSERTION_VALUE_FROM_FILE.get(String
			.valueOf(e)));
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			} else {
			attributeVal = ByteString.valueOf(remainder);
			}
			} else {
			attributeVal = ByteString.valueOf(remainder);
			}

			final CompareRequest compare = Requests.newCompareRequest("", attributeType, attributeVal);

			if (controlStr.isPresent()) {
			for (final String ctrlString : controlStr.getValues()) {
			try {
			final Control ctrl = Utils.getControl(ctrlString);
			compare.addControl(ctrl);
			} catch (final DecodeException de) {
			final LocalizableMessage message =
			ERR_TOOL_INVALID_CONTROL_STRING.get(ctrlString);
			println(message);
			ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			}
			}

			if (proxyAuthzID.isPresent()) {
			final Control proxyControl =
			ProxiedAuthV2RequestControl.newControl(proxyAuthzID.getValue());
			compare.addControl(proxyControl);
			}

			if (assertionFilter.isPresent()) {
			final String filterString = assertionFilter.getValue();
			Filter filter;
			try {
			filter = Filter.valueOf(filterString);

			// FIXME -- Change this to the correct OID when the official one
			// is assigned.
			final Control assertionControl = AssertionRequestControl.newControl(true, filter);
			compare.addControl(assertionControl);
			} catch (final LocalizedIllegalArgumentException le) {
			final LocalizableMessage message =
			ERR_LDAP_ASSERTION_INVALID_FILTER.get(le.getMessage());
			println(message);
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			}

			BufferedReader rdr = null;
			if (!filename.isPresent() && dnStrings.isEmpty()) {
			// Read from stdin.
			rdr = new BufferedReader(new InputStreamReader(System.in));
			} else if (filename.isPresent()) {
			try {
			rdr = new BufferedReader(new FileReader(filename.getValue()));
			} catch (final FileNotFoundException t) {
			println(ERR_LDAPCOMPARE_ERROR_READING_FILE.get(filename.getValue(), t.toString()));
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			}

			Connection connection = null;
			if (!noop.isPresent()) {
			try {
			connection = connectionFactory.getConnection();
			} catch (final ErrorResultException ere) {
			println(LocalizableMessage.raw(ere.getMessage()));
			return ere.getResult().getResultCode().intValue();
			} catch (final InterruptedException e) {
			// This shouldn't happen because there are no other threads to
			// interrupt this one.
			println(LocalizableMessage.raw(e.getLocalizedMessage()));
			return ResultCode.CLIENT_SIDE_USER_CANCELLED.intValue();
			}
			}

			try {
			int result;
			if (rdr == null) {
			for (final String dn : dnStrings) {
			compare.setName(dn);
			result = executeCompare(compare, connection);
			if (result != 0 && !continueOnError.isPresent()) {
			return result;
			}
			}
			} else {
			String dn;
			try {
			while ((dn = rdr.readLine()) != null) {
			compare.setName(dn);
			result = executeCompare(compare, connection);
			if (result != 0 && !continueOnError.isPresent()) {
			return result;
			}
			}
			} catch (final IOException ioe) {
			println(ERR_LDAPCOMPARE_ERROR_READING_FILE.get(filename.getValue(), ioe
			.toString()));
			return ResultCode.CLIENT_SIDE_PARAM_ERROR.intValue();
			}
			}
			} finally {
			if (connection != null) {
			connection.close();
			}
			if (rdr != null) {
			try {
			rdr.close();
			} catch (final IOException ioe) {
			// Just ignore
			}
			}
			}

			return 0;
			}

			}