xmlsec-shim 1.2.18.1

data/vendor/xmlsec1-1.2.18/win32/README.txt

@@ -0,0 +1,168 @@
-------------
-------------
------
-------------
-------------
------
-------------
-------------
------
-------------
-------------
------
+
+                             Windows port
+                             ------------
+
+This directory contains the files required to build this software on the
+native Windows platform.
+
+As a rule of thumb, the root of this directory contains files needed
+to build the library using the command-line tools, while various
+subdirectories contain project files for various IDEs.
+
+
+  1. Building the library
+  =================================
+
+Building from command line is the easiest, preferred and the only 
+currently supported method. 
+
+In order to build from the command-line you need to make sure that
+your compiler works from the command line. This is not always the
+case, often the required environment variables are missing. If you are
+not sure, test if this works first. If it doesn't, you will first have
+to configure your compiler suite to run from the command-line - please
+refer to your compiler's documentation regarding that.
+
+The first thing you want to do is configure the source. You can have
+the configuration script do this automatically for you. The
+configuration script is written in JScript, a Microsoft's
+implementation of the ECMA scripting language. Almost every Windows
+machine can execute this through the Windows Scripting Host. If your
+system lacks the ability to execute JScript for some reason, you must
+perform the configuration manually.
+
+The second step is compiling the source and, optionally, installing it
+to the location of your choosing.
+
+
+  1.1 Configuring the source automatically
+  ----------------------------------------
+
+The configuration script accepts numerous options. Some of these
+affect features which will be available in the compiled software,
+others affect the way the software is built and installed. To see a
+full list of options supported by the configuration script, run
+
+  cscript configure.js help
+
+from the win32 subdirectory. The configuration script will present you
+the options it accepts and give a biref explanation of these. In every
+case you will have two sets of options. The first set is specific to
+the software you are building and the second one is specific to the
+Windows port.
+
+Once you have decided which options suit you, run the script with that
+options. Here is an example:
+
+  cscript configure.js prefix=c:\opt include=c:\opt\include 
+    lib=c:\opt\lib debug=yes
+
+The previous example will configure the process to install the library
+in c:\opt, use c:\opt\include and c:\opt\lib as additional search
+paths for the compiler and the linker and build executables with debug
+symbols.
+
+Note: Please do not use path names which contain spaces. This will
+fail. Allowing this would require me to put almost everything in the
+Makefile in quotas and that looks quite ugly with my
+syntax-highlighting engine. If you absolutely must use spaces in paths
+send me an email and tell me why. If there are enough of you out there
+who need this, or if a single one has a very good reason, I will
+modify the Makefile to allow spaces in paths.
+
+
+  1.2 (Not) Configuring the source manually
+  -----------------------------------------
+
+The manual configuration is pretty straightforward, but I would
+suggest rather to get a JScript engine and let the configure script do
+it for you. This process involves editing the apropriate Makefile to
+suit your needs, as well as manually generating certain *.h files from
+their *.h.in sources.
+
+If you really have no idea what I am talking about and ask yourself
+what in Gods name do I mean with '*.h files and their *.h.in sources',
+then you really should do an automatic configuration. Which files must
+be generated and what needs to be done with their sources in order to
+generate them is something people who have built this software before
+allready know. You will not find any explanations for that
+here. Please configure the source manually only if you allready know
+what you must do. Otherwise, you have the choice of either getting a
+precompiled binary distribution, or performing the automatic
+configuration.
+
+  1.3 Compiling
+  -------------
+
+After the configuration stage has been completed, you want to build
+the software. To do that, type
+
+  nmake
+
+in the win32 subdirectory.When the building completes, you will find
+the executable files in win32\binaries directory.
+ 
+You can install the software into the directory you specified to the
+configure script during the configure stage by typing
+
+  nmake install
+
+That would be it, enjoy.
+
+  2. Building your appliation
+  =================================
+
+On Windows there is no easy way to automatically configure compilation
+options or paths. You have to do everything manualy. Start up your
+favorite IDE or text editor and read on.
+    
+  2.1 Global Defines.
+  -------------
+
+If you want to use automatic crypto library configuration (xmlsec/crypto.h file)
+you need to add one of the following global defines:
+
+    #define XMLSEC_CRYPTO_OPENSSL
+    #define XMLSEC_CRYPTO_GNUTLS
+    #define XMLSEC_CRYPTO_NSS
+
+Also you'll need to define all configuration parameters used during XML Security
+Library compilation (XMLSEC_OPENSSL_096, XMLSEC_NO_AES, XMLSEC_NO_X509,...).
+
+  2.1 Additional Global Defines for static linking.
+  -------------
+
+Also if you (*and only if*) are linking libraries staticaly, you'll need to add following
+global defines:
+
+  2.2 Setting include and library paths.
+  -------------
+
+As usual, you need to have correct include and library paths to xmlsec, libxml,
+libxslt, iconv, openssl or any other library used in your application.
+
+  2.3 Selecting correct Windows runtime libraries.
+  -------------
+
+Windows basically has 6 different C runtimes. The first one is called libc.lib 
+and can only be linked to statically and used only in single-threaded mode.
+The second one is also can only be linked staticaly and used in multi-threaded
+mode. The third one is called msvcrt.dll and can only be linked to dynamically. 
+These three then live in their debug and release incarnations, which results in 
+six C runtimes. The rule is simple: exactly the same runtime must be used 
+throughout the application. Client code *MUST* use the same runtime as XMLSec, 
+LibXML, LibXSLT, OpenSSL or any other library used.
+
+If you downloaded XMLSec, LibXML, LibXSLT and OpenSSL binaries from Igor's 
+page then all libraries are all linked to msvcrt.dll ("Multithreaded DLL" 
+(NOT DEBUG!); /MD compiler switch). The click-next click-finish wizardry 
+from Visual Studio chooses the single-threaded libc.lib as the default 
+when you create a new project. And this causes great problems because 
+you program crashes on first IO operation, first malloc/free from different 
+runtimes or something even more trivial.
+
+Do not forget that if you need a different runtime for some reason, then 
+you MUST recompile not only XMLSec, but LibXML, LibXSLT and OpenSSL as well.
+
+
+March 2002, Igor Zlatkovic <igor@stud.fh-frankfurt.de>

data/vendor/xmlsec1-1.2.18/win32/configure.js

@@ -0,0 +1,395 @@
+/* Configure script for xmlsec, specific for Windows with Scripting Host.
+ * 
+ * This script will configure the libxmlsec build process and create necessary files.
+ * Run it with an 'help', or an invalid option and it will tell you what options
+ * it accepts.
+ *
+ * March 2002, Igor Zlatkovic <igor@stud.fh-frankfurt.de>
+ *	Created for LibXML and LibXSLT
+ * April 2002, Aleksey Sanin <aleksey@aleksey.com>
+ *	Modified for XMLSec Libary
+ */
+
+/* The source directory, relative to the one where this file resides. */
+var baseDir = "..";
+var srcDir = baseDir + "\\src";
+var srcDirApps = baseDir + "\\apps";
+/* The directory where we put the binaries after compilation. */
+var binDir = "binaries";
+/* Base name of what we are building. */
+var baseName = "libxmlsec";
+
+/* Configure file which contains the version and the output file where
+   we can store our build configuration. */
+var configFile = baseDir + "\\configure.in";
+var versionFile = ".\\configure.txt";
+
+/* Input and output files regarding the lib(e)xml features. The second
+   output file is there for the compatibility reasons, otherwise it
+   is identical to the first. */
+var optsFileIn = baseDir + "\\config.h.in";
+var optsFile = baseDir + "\\config.h";
+
+/* Version strings for the binary distribution. Will be filled later 
+   in the code. */
+var verMajorXmlSec;
+var verMinorXmlSec;
+var verMicroXmlSec;
+
+/* Libxmlsec features. */
+var withCrypto = "openssl";
+var withDefaultCrypto = "openssl";
+var withOpenSSL = 0;
+var withOpenSSLVersion = "";
+var withNss = 0;
+var withMSCrypto = 0;
+var withLibXSLT = 1;
+var withIconv = 1;
+var withNT4 = 1;
+
+/* Win32 build options. */
+var buildUnicode = 1;
+var buildDebug = 0;
+var buildStatic = 1;
+var buildWithDLSupport = 1;
+var buildPrefix = ".";
+var buildBinPrefix = "$(PREFIX)\\bin";
+var buildIncPrefix = "$(PREFIX)\\include";
+var buildLibPrefix = "$(PREFIX)\\lib";
+var buildSoPrefix = "$(PREFIX)\\lib";
+var buildInclude = ".";
+var buildLib = ".";
+/* Local stuff */
+var error = 0;
+
+/* Helper function, transforms the option variable into the 'Enabled'
+   or 'Disabled' string. */
+function boolToStr(opt)
+{
+	if (opt == false)
+		return "Disabled";
+	else if (opt == true)
+		return "Enabled";
+	error = 1;
+	return "Undefined";
+}
+
+/* Helper function, transforms the argument string into the boolean
+   value. */
+function strToBool(opt)
+{
+	if (opt == "0" || opt == "no")
+		return false;
+	else if (opt == "1" || opt == "yes")
+		return true;
+	error = 1;
+	return false;
+}
+
+/* Displays the details about how to use this script. */
+function usage()
+{
+	var txt;
+	txt = "Usage:\n";
+	txt += "  cscript " + WScript.ScriptName + " <options>\n";
+	txt += "  cscript " + WScript.ScriptName + " help\n\n";
+	txt += "Options can be specified in the form <option>=<value>, where the value is\n";
+	txt += "either 'yes' or 'no'.\n\n";
+	txt += "XmlSec Library options, default value given in parentheses:\n\n";
+	txt += "  crypto:     Crypto engines list, first is default: \"openssl\",\n";
+	txt += "              \"openssl=096\", \"openssl=097\", \"openssl=098\", \n";
+	txt += "              \"nss\", \"mscrypto\" (\"" + withCrypto + "\");\n"
+ 	txt += "  xslt:       LibXSLT is used (" + (withLibXSLT? "yes" : "no")  + ")\n";	
+ 	txt += "  iconv:      Use the iconv library (" + (withIconv? "yes" : "no")  + ")\n";	
+ 	txt += "  nt4:        Enable NT 4.0 support (" + (withNT4? "yes" : "no")  + ")\n";	
+	txt += "\nWin32 build options, default value given in parentheses:\n\n";
+	txt += "  unicode:    Build Unicode version (" + (buildUnicode? "yes" : "no")  + ")\n";
+	txt += "  debug:      Build unoptimised debug executables (" + (buildDebug? "yes" : "no")  + ")\n";
+	txt += "  static:     Link libxmlsec statically to xmlsec (" + (buildStatic? "yes" : "no")  + ")\n";
+	txt += "  with-dl:    Enable dynamic loading of xmlsec-crypto libraries (" + (buildWithDLSupport? "yes" : "no")  + ")\n";
+	txt += "  prefix:     Base directory for the installation (" + buildPrefix + ")\n";
+	txt += "  bindir:     Directory where xmlsec and friends should be installed\n";
+	txt += "              (" + buildBinPrefix + ")\n";
+	txt += "  incdir:     Directory where headers should be installed\n";
+	txt += "              (" + buildIncPrefix + ")\n";
+	txt += "  libdir:     Directory where static and import libraries should be\n";
+	txt += "              installed (" + buildLibPrefix + ")\n";
+	txt += "  sodir:      Directory where shared libraries should be installed\n"; 
+	txt += "              (" + buildSoPrefix + ")\n";
+	txt += "  include:    Additional search path for the compiler, particularily\n";
+	txt += "              where libxml headers can be found (" + buildInclude + ")\n";
+	txt += "  lib:        Additional search path for the linker, particularily\n";
+	txt += "              where libxml library can be found (" + buildLib + ")\n";
+	WScript.Echo(txt);
+}
+
+/* Discovers the version we are working with by reading the apropriate
+   configuration file. Despite its name, this also writes the configuration
+   file included by our makefile. */
+function discoverVersion()
+{
+	var fso, cf, vf, ln, s;
+
+	fso = new ActiveXObject("Scripting.FileSystemObject");
+	cf = fso.OpenTextFile(configFile, 1);
+	vf = fso.CreateTextFile(versionFile, true);
+	vf.WriteLine("# " + versionFile);
+	vf.WriteLine("# This file is generated automatically by " + WScript.ScriptName + ".");
+	vf.WriteBlankLines(1);
+	while (cf.AtEndOfStream != true) {
+		ln = cf.ReadLine();
+		s = new String(ln);
+		if (s.search(/^XMLSEC_VERSION_MAJOR/) != -1) {
+			WScript.Echo(verMajorXmlSec);
+			vf.WriteLine(s);
+			verMajorXmlSec = s.substring(s.indexOf("=") + 1, s.length)
+		} else if(s.search(/^XMLSEC_VERSION_MINOR/) != -1) {
+			vf.WriteLine(s);
+			verMinorXmlSec = s.substring(s.indexOf("=") + 1, s.length)
+		} else if(s.search(/^XMLSEC_VERSION_SUBMINOR/) != -1) {
+			vf.WriteLine(s);
+			verMicroXmlSec = s.substring(s.indexOf("=") + 1, s.length)
+		}		
+	}
+	cf.Close();
+	vf.WriteLine("BASEDIR=" + baseDir);
+	vf.WriteLine("XMLSEC_SRCDIR=" + srcDir);
+	vf.WriteLine("APPS_SRCDIR=" + srcDirApps);
+	vf.WriteLine("BINDIR=" + binDir);
+	vf.WriteLine("WITH_CRYPTO=" + withCrypto);	
+	vf.WriteLine("WITH_DEFAULT_CRYPTO=" + withDefaultCrypto);	
+	vf.WriteLine("WITH_OPENSSL=" + withOpenSSL);	
+	vf.WriteLine("WITH_OPENSSL_VERSION=XMLSEC_OPENSSL_" + withOpenSSLVersion);	
+	vf.WriteLine("WITH_NSS=" + withNss);	
+	vf.WriteLine("WITH_MSCRYPTO=" + withMSCrypto);	
+	vf.WriteLine("WITH_LIBXSLT=" + (withLibXSLT ? "1" : "0"));
+	vf.WriteLine("WITH_ICONV=" + (withIconv ? "1" : "0"));
+	vf.WriteLine("WITH_NT4=" + (withNT4 ? "1" : "0"));
+	vf.WriteLine("UNICODE=" + (buildUnicode? "1" : "0"));
+	vf.WriteLine("DEBUG=" + (buildDebug? "1" : "0"));
+	vf.WriteLine("STATIC=" + (buildStatic? "1" : "0"));
+	vf.WriteLine("WITH_DL=" + (buildWithDLSupport ? "1" : "0"));
+	vf.WriteLine("PREFIX=" + buildPrefix);
+	vf.WriteLine("BINPREFIX=" + buildBinPrefix);
+	vf.WriteLine("INCPREFIX=" + buildIncPrefix);
+	vf.WriteLine("LIBPREFIX=" + buildLibPrefix);
+	vf.WriteLine("SOPREFIX=" + buildSoPrefix);
+	vf.WriteLine("INCLUDE=$(INCLUDE);" + buildInclude);
+	vf.WriteLine("LIB=$(LIB);" + buildLib);
+	vf.Close();
+}
+
+/* Configures xmlsec. This one will generate config.h from config.h.in
+   taking what the user passed on the command line into account. */
+function configureXmlSec()
+{
+	var fso, ofi, of, ln, s;
+	fso = new ActiveXObject("Scripting.FileSystemObject");
+	ofi = fso.OpenTextFile(optsFileIn, 1);
+	of = fso.CreateTextFile(optsFile, true);
+	while (ofi.AtEndOfStream != true) {
+		ln = ofi.ReadLine();
+		s = new String(ln);
+		if (s.search(/\@VERSION\@/) != -1) {
+			of.WriteLine(s.replace(/\@VERSION\@/, 
+				verMajorXmlSec + "." + verMinorXmlSec + "." + verMicroXmlSec));
+		} else if (s.search(/\@XMLSECVERSION_NUMBER\@/) != -1) {
+			of.WriteLine(s.replace(/\@XMLSECVERSION_NUMBER\@/, 
+				verMajorXmlSec*10000 + verMinorXmlSec*100 + verMicroXmlSec*1));
+		} else
+			of.WriteLine(ln);
+	}
+	ofi.Close();
+	of.Close();
+}
+
+/* Creates the readme file for the binary distribution of 'bname', for the
+   version 'ver' in the file 'file'. This one is called from the Makefile when
+   generating a binary distribution. The parameters are passed by make. */
+function genReadme(bname, ver, file)
+{
+	var fso, f;
+	fso = new ActiveXObject("Scripting.FileSystemObject");
+	f = fso.CreateTextFile(file, true);
+	f.WriteLine("  " + bname + " " + ver);
+	f.WriteLine("  --------------");
+	f.WriteBlankLines(1);
+	f.WriteLine("  This is " + bname + ", version " + ver + ", binary package for the native Win32/IA32");
+	f.WriteLine("platform.");
+	f.WriteBlankLines(1);
+	f.WriteLine("  The files in this package do not require any special installation");
+	f.WriteLine("steps. Extract the contents of the archive whereever you wish and");
+	f.WriteLine("make sure that your tools which use " + bname + " can find it.");
+	f.WriteBlankLines(1);
+	f.WriteLine("  For example, if you want to run the supplied utilities from the command");
+	f.WriteLine("line, you can, if you wish, add the 'bin' subdirectory to the PATH");
+	f.WriteLine("environment variable.");
+	f.WriteLine("  If you want to make programmes in C which use " + bname + ", you'll");
+	f.WriteLine("likely know how to use the contents of this package. If you don't, please");
+	f.WriteLine("refer to your compiler's documentation."); 
+	f.WriteBlankLines(1);
+	f.WriteLine("  If there is something you cannot keep for yourself, such as a problem,");
+	f.WriteLine("a cheer of joy, a comment or a suggestion, feel free to contact me using");
+	f.WriteLine("the address below.");
+	f.WriteBlankLines(1);
+	f.WriteLine("Igor Zlatkovic (igor@zlatkovic.com)");
+	f.Close();
+}
+
+/*
+ * main(),
+ * Execution begins here.
+ */
+
+/* Parse the command-line arguments. */
+for (i = 0; (i < WScript.Arguments.length) && (error == 0); i++) {
+	var arg, opt;
+	arg = WScript.Arguments(i);
+	opt = arg.substring(0, arg.indexOf("="));
+	if (opt.length == 0)
+		opt = arg.substring(0, arg.indexOf(":"));
+	if (opt.length > 0) {
+		if (opt == "crypto")
+			withCrypto = arg.substring(opt.length + 1, arg.length);
+		else if (opt == "xslt")
+			withLibXSLT = strToBool(arg.substring(opt.length + 1, arg.length));
+		else if (opt == "iconv")
+			withIconv = strToBool(arg.substring(opt.length + 1, arg.length));
+		else if (opt == "nt4")
+			withNT4 = strToBool(arg.substring(opt.length + 1, arg.length));
+		else if (opt == "unicode")
+			buildUnicode = strToBool(arg.substring(opt.length + 1, arg.length));
+		else if (opt == "debug")
+			buildDebug = strToBool(arg.substring(opt.length + 1, arg.length));
+		else if (opt == "static")
+			buildStatic = strToBool(arg.substring(opt.length + 1, arg.length));
+		else if (opt == "with-dl")
+			buildWithDLSupport = strToBool(arg.substring(opt.length + 1, arg.length));
+		else if (opt == "prefix")
+			buildPrefix = arg.substring(opt.length + 1, arg.length);
+		else if (opt == "incdir")
+			buildIncPrefix = arg.substring(opt.length + 1, arg.length);
+		else if (opt == "bindir")
+			buildBinPrefix = arg.substring(opt.length + 1, arg.length);
+		else if (opt == "libdir")
+			buildLibPrefix = arg.substring(opt.length + 1, arg.length);
+		else if (opt == "sodir")
+			buildSoPrefix = arg.substring(opt.length + 1, arg.length);
+		else if (opt == "incdir")
+			buildIncPrefix = arg.substring(opt.length + 1, arg.length);
+		else if (opt == "include")
+			buildInclude = arg.substring(opt.length + 1, arg.length);
+		else if (opt == "lib")
+			buildLib = arg.substring(opt.length + 1, arg.length);
+		else
+			error = 1;
+	} else if (i == 0) {
+		if (arg == "genreadme") {
+			// This command comes from the Makefile and will not be checked
+			// for errors, because Makefile will always supply right parameters.
+			genReadme(WScript.Arguments(1), WScript.Arguments(2), WScript.Arguments(3));
+			WScript.Quit(0);
+		} else if (arg == "help") {
+			usage();
+			WScript.Quit(0);
+		}
+	} else
+		error = 1;
+}
+// If we have an error here, it is because the user supplied bad parameters.
+if (error != 0) {
+	usage();
+	WScript.Quit(error);
+}
+
+// Discover crypto support
+var crlist, j, curcrypto;
+crlist = withCrypto.split(",");			
+withCrypto = "";
+withDefaultCrypto = "";
+for (j = 0; j < crlist.length; j++) {		
+	if (crlist[j] == "openssl") {
+		curcrypto="openssl";
+		withOpenSSL = 1;
+		withOpenSSLVersion = "098"; /* default */
+	} else if (crlist[j] == "openssl=096") {
+		curcrypto="openssl";
+		withOpenSSL = 1;
+		withOpenSSLVersion = "096";
+	} else if (crlist[j] == "openssl=097") {
+		curcrypto="openssl";
+		withOpenSSL = 1;
+		withOpenSSLVersion = "097";
+	} else if (crlist[j] == "openssl=098") {
+		curcrypto="openssl";
+		withOpenSSL = 1;
+		withOpenSSLVersion = "098";
+	} else if (crlist[j] == "nss") {
+		curcrypto="nss";
+		withNss = 1;
+	} else if (crlist[j] == "mscrypto") {
+		curcrypto="mscrypto";
+		withMSCrypto = 1;
+	} else {
+		WScript.Echo("Unknown crypto engine \"" + crlist[j] + "\" is found. Aborting.");
+		WScript.Quit(error);
+	}
+	if (j == 0) {
+		withDefaultCrypto = curcrypto;
+		withCrypto = curcrypto;
+	} else {
+		withCrypto = withCrypto + " " + curcrypto;
+	}
+}
+
+// Discover the version.
+discoverVersion();
+if (error != 0) {
+	WScript.Echo("Version discovery failed, aborting.");
+	WScript.Quit(error);
+}
+WScript.Echo(baseName + " version: " + verMajorXmlSec + "." + verMinorXmlSec + "." + verMicroXmlSec);
+
+
+// Configure libxmlsec.
+configureXmlSec();
+if (error != 0) {
+	WScript.Echo("Configuration failed, aborting.");
+	WScript.Quit(error);
+}
+
+
+// Create the Makefile.
+var fso = new ActiveXObject("Scripting.FileSystemObject");
+fso.CopyFile(".\\Makefile.msvc", ".\\Makefile", true);
+WScript.Echo("Created Makefile.");
+
+// Display the final configuration.
+var txtOut = "\nXMLSEC configuration\n";
+txtOut += "----------------------------\n";
+txtOut += "         Use Crypto: " + withCrypto + "\n";
+txtOut += " Use Default Crypto: " + withDefaultCrypto + "\n";
+txtOut += "        Use OpenSSL: " + boolToStr(withOpenSSL) + "\n";
+txtOut += "Use OpenSSL Version: " + withOpenSSLVersion + "\n";
+txtOut += "            Use NSS: " + boolToStr(withNss) + "\n";
+txtOut += "       Use MSCrypto: " + boolToStr(withMSCrypto) + "\n";
+txtOut += "        Use LibXSLT: " + boolToStr(withLibXSLT) + "\n";
+txtOut += "          Use iconv: " + boolToStr(withIconv) + "\n";
+txtOut += "     NT 4.0 support: " + boolToStr(withNT4) + "\n";
+txtOut += "\n";
+txtOut += "Win32 build configuration\n";
+txtOut += "-------------------------\n";
+txtOut += "           Unicode: " + boolToStr(buildUnicode) + "\n";
+txtOut += "     Debug symbols: " + boolToStr(buildDebug) + "\n";
+txtOut += "     Static xmlsec: " + boolToStr(buildStatic) + "\n";
+txtOut += "  Enable DL suport: " + boolToStr(buildWithDLSupport) + "\n";
+txtOut += "    Install prefix: " + buildPrefix + "\n";
+txtOut += "      Put tools in: " + buildBinPrefix + "\n";
+txtOut += "    Put headers in: " + buildIncPrefix + "\n";
+txtOut += "Put static libs in: " + buildLibPrefix + "\n";
+txtOut += "Put shared libs in: " + buildSoPrefix + "\n";
+txtOut += "      Include path: " + buildInclude + "\n";
+txtOut += "          Lib path: " + buildLib + "\n";
+WScript.Echo(txtOut);
+
+// Done.