diff -r 675a964f4eb5 -r 35751d3474b7 securityanddataprivacytools/securitytools/certapp/api/certapp-api.h --- a/securityanddataprivacytools/securitytools/certapp/api/certapp-api.h Tue Jul 21 01:04:32 2009 +0100 +++ b/securityanddataprivacytools/securitytools/certapp/api/certapp-api.h Thu Sep 10 14:01:51 2009 +0300 @@ -1,74 +1,72 @@ -#ifndef __CERTAPP_API_H__ -#define __CERTAPP_API_H__/* -* Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies). -* All rights reserved. -* This component and the accompanying materials are made available -* under the terms of the License "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: -* Nokia Corporation - initial contribution. -* -* Contributors: -* -* Description: -* -*/ - - - - -/** - @file - @publishedAll - @released -*/ - -#ifdef __cplusplus -extern "C" { -#endif -/** - RunCertApp - -This API will run certapp as separate process and returns the -result. This approach is taken so that the caller is protected from -any possible certapp failure. Even if certapp crashes, RunCertApp will -return without crashing the caller. - -Certapp guarantees to return a non-zero status if it fails, which -means you don't need to parse its output to deduce if it worked or -not. - -The certapp executable must be in the current search path. - -The caller will be blocked whilst certapp runs. - -There are two logging arguments, aProgress and aErrors. These may be -set to either a filename to write the output to or to "-" which means -standard output. If both logging arguments are identical, then the -output will be merged to a single location. - -Progress and warning messages are written to aProgress. - -Fatal errors will be logged to aErrors, and RunCertApp will return a -non-zero number. An error code of -1 means the certapp executable -failed or was not found, other error codes indicate problems launching -the executable. - -The argc argument should be set to the count of the argv arguments. - -The argv argument should be set to an array of const char * ptrs to -the remaining arguments. - -The argv arguments maybe any of the arguments accepted by the certapp -executable, run "certapp -h" for further information. -*/ -int RunCertApp(const char *aProgress, const char *aErrors, - int argc, char **argv); - -#ifdef __cplusplus -} -#endif - -#endif +#ifndef __CERTAPP_API_H__ +#define __CERTAPP_API_H__/* +* Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of the License "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: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: +* +*/ + + +/** + @file + @publishedAll + @released +*/ + +#ifdef __cplusplus +extern "C" { +#endif +/** + RunCertApp + +This API will run certapp as separate process and returns the +result. This approach is taken so that the caller is protected from +any possible certapp failure. Even if certapp crashes, RunCertApp will +return without crashing the caller. + +Certapp guarantees to return a non-zero status if it fails, which +means you don't need to parse its output to deduce if it worked or +not. + +The certapp executable must be in the current search path. + +The caller will be blocked whilst certapp runs. + +There are two logging arguments, aProgress and aErrors. These may be +set to either a filename to write the output to or to "-" which means +standard output. If both logging arguments are identical, then the +output will be merged to a single location. + +Progress and warning messages are written to aProgress. + +Fatal errors will be logged to aErrors, and RunCertApp will return a +non-zero number. An error code of -1 means the certapp executable +failed or was not found, other error codes indicate problems launching +the executable. + +The argc argument should be set to the count of the argv arguments. + +The argv argument should be set to an array of const char * ptrs to +the remaining arguments. + +The argv arguments maybe any of the arguments accepted by the certapp +executable, run "certapp -h" for further information. +*/ +int RunCertApp(const char *aProgress, const char *aErrors, + int argc, char **argv); + +#ifdef __cplusplus +} +#endif + +#endif