# variant.cif+
−
# +
−
# Copyright (c) 2010 Accenture. All rights reserved.+
−
# This component and the accompanying materials are made available+
−
# under the terms of the "Eclipse Public License v1.0"+
−
# which accompanies this distribution, and is available+
−
# at the URL "http://www.eclipse.org/legal/epl-v10.html".+
−
# +
−
# Initial Contributors:+
−
# Accenture - Initial contribution+
−
#+
−
+
−
==name variant+
−
+
−
==short-description+
−
+
−
Determines the hardware variant and whether or not that matches the variant specified via the command line.+
−
+
−
==long-description+
−
+
−
If the device matches the given command line options, KErrNone is returned. If not, KErrNotSupported is returned. Note that the command will not print any error message in the case of the variant not being supported, so that it doesn't make script output untidy. If an error message is required, use the C<--verbose> option.+
−
+
−
In addition there are some other special variant names supported, that are derived at compile time from the platform.mmh macros and similar: run the tool with no arguments to see the full list.+
−
+
−
Example usage:+
−
+
−
    variant h4 && do-something-h4-specific+
−
    variant wins && do-something-emulator-specific+
−
    variant h4 h6 && do-something-for-h4-and-h6+
−
+
−
If no arguments are specified, all the supported and understood variants are listed.+
−
+
−
==option uint u uid multiple+
−
+
−
Test whether the device matches any of the specified machine UIDs.+
−
+
−
==option bool v verbose+
−
+
−
Display verbose output.+
−
+
−
==option bool l list+
−
+
−
Has no effect, kept for compatability.+
−
+
−
==argument string variantname optional multiple+
−
+
−
A symbolic name for the hardware variant may be specified instead of having to know the machine uid. This maximises compatibility with platforms that provide a custom variant.exe and/or that need more than just the machine UID to determine the variant. Check the platform-specific documentation for what variant string is used to identify that platform's hardware. If multiple variant names are specified KErrNone is returned if any one of them matches.+
−
+
−
==copyright+
−
+
−
Copyright (c) 2008-2010 Accenture. All rights reserved.+
−
+
−
==smoke-test+
−
+
−
variant $Quiet+
−
+
−
# One of these has to be true+
−
variant wins || variant target || $Error+
−
# But they can't both be+
−
variant wins && variant target && $Error+
−