version 1.1, 2001/04/11 00:23:44
|
version 1.26, 2002/07/26 20:01:19
|
|
|
//BEGIN_LICENSE |
//%///////////////////////////////////////////////////////////////////////////// |
// | // |
// Copyright (c) 2000 The Open Group, BMC Software, Tivoli Systems, IBM |
// Copyright (c) 2000, 2001, 2002 BMC Software, Hewlett-Packard Company, IBM, |
|
// The Open Group, Tivoli Systems |
// | // |
// Permission is hereby granted, free of charge, to any person obtaining a |
// Permission is hereby granted, free of charge, to any person obtaining a copy |
// copy of this software and associated documentation files (the "Software"), |
// of this software and associated documentation files (the "Software"), to |
// to deal in the Software without restriction, including without limitation |
// deal in the Software without restriction, including without limitation the |
// the rights to use, copy, modify, merge, publish, distribute, sublicense, |
// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or |
// and/or sell copies of the Software, and to permit persons to whom the |
// sell copies of the Software, and to permit persons to whom the Software is |
// Software is furnished to do so, subject to the following conditions: |
// furnished to do so, subject to the following conditions: |
|
// |
|
// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN |
|
// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED |
|
// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT |
|
// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR |
|
// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT |
|
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN |
|
// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION |
|
// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. |
// | // |
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
//============================================================================== |
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
|
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
|
// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER |
|
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
|
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER |
|
// DEALINGS IN THE SOFTWARE. |
|
// | // |
//END_LICENSE |
// Author: Mike Brasher (mbrasher@bmc.com) |
//BEGIN_HISTORY |
|
// | // |
// Author: Michael E. Brasher |
// Modified By: |
|
// Nag Boranna, Hewlett-Packard Company (nagaraja_boranna@hp.com) |
// | // |
// $Log$ |
//%///////////////////////////////////////////////////////////////////////////// |
// Revision 1.1 2001/04/11 00:23:44 mike |
|
// new files |
|
// |
|
// |
|
//END_HISTORY |
|
| |
#ifndef Pegasus_System_h | #ifndef Pegasus_System_h |
#define Pegasus_System_h | #define Pegasus_System_h |
| |
#include <Pegasus/Common/Config.h> | #include <Pegasus/Common/Config.h> |
|
#include <Pegasus/Common/String.h> |
|
#include <Pegasus/Common/Linkage.h> |
|
|
|
// |
|
// Protocal Type |
|
// |
|
#define TCP "tcp" |
| |
PEGASUS_NAMESPACE_BEGIN | PEGASUS_NAMESPACE_BEGIN |
| |
|
|
|
/** This is an opaque type which is used to represent dynamic library |
|
handles returned by the System::loadDynamicLibrary() method and |
|
accepted by the System::loadDynamicProcedure() method. |
|
*/ |
|
typedef struct DynamicLibraryHandle_* DynamicLibraryHandle; |
|
|
|
/** This is an opaque type which is returned by System::loadDynamicSymbol(). |
|
Values of this type may be casted to the appropriate target type. |
|
*/ |
|
#ifndef PEGASUS_PLATFORM_ZOS_ZSERIES_IBM |
|
typedef struct DynamicSymbolHandle_* DynamicSymbolHandle; |
|
#else |
|
extern "C" {typedef int (* DynamicSymbolHandle)(void);} |
|
#endif |
|
|
|
|
/** The System class defines wrappers for operating system related calls. | /** The System class defines wrappers for operating system related calls. |
These are only placed here if they are extremely light. These are | These are only placed here if they are extremely light. These are |
usually just direct wrappers which map more or less one to one to the | usually just direct wrappers which map more or less one to one to the |
|
|
class PEGASUS_COMMON_LINKAGE System | class PEGASUS_COMMON_LINKAGE System |
{ | { |
public: | public: |
|
/** getCurrentTime - Gets the current time as seconds and milliseconds |
|
into the provided variables using system functions. |
|
@param seconds Return for the seconds component of the time. |
|
@param milliseconds Return for the milliseconds component of the time. |
|
@return The value is returned in the parameters. |
|
The time returned is as defined in number of seconds and milliseconds |
|
since 00:00 Coordinated Universal Time (UTC), January 1, 1970, |
| |
|
*/ |
static void getCurrentTime(Uint32& seconds, Uint32& milliseconds); | static void getCurrentTime(Uint32& seconds, Uint32& milliseconds); |
| |
|
/** getCurrentASCIITime Gets time/date in a fixed format. The format is |
|
YY MM DD-HH:MM:SS |
|
@return Returns String with the ASCII time date. |
|
*/ |
|
static String getCurrentASCIITime(); |
|
|
static void sleep(Uint32 seconds); | static void sleep(Uint32 seconds); |
|
|
|
static Boolean exists(const char* path); |
|
|
|
static Boolean canRead(const char* path); |
|
|
|
static Boolean canWrite(const char* path); |
|
|
|
static Boolean getCurrentDirectory(char* path, Uint32 size); |
|
|
|
static Boolean isDirectory(const char* path); |
|
|
|
static Boolean changeDirectory(const char* path); |
|
|
|
static Boolean makeDirectory(const char* path); |
|
|
|
static Boolean getFileSize(const char* path, Uint32& size); |
|
|
|
static Boolean removeDirectory(const char* path); |
|
|
|
static Boolean removeFile(const char* path); |
|
|
|
static Boolean renameFile(const char* oldPath, const char* newPath); |
|
|
|
static Boolean copyFile(const char* fromPath, const char* toPath); |
|
|
|
static DynamicLibraryHandle loadDynamicLibrary(const char* fileName); |
|
|
|
static void unloadDynamicLibrary(DynamicLibraryHandle libraryHandle); |
|
|
|
static String dynamicLoadError(void); |
|
|
|
static DynamicSymbolHandle loadDynamicSymbol( |
|
DynamicLibraryHandle libraryHandle, |
|
const char* symbolName); |
|
|
|
static String getHostName(); |
|
static String getFullyQualifiedHostName (); |
|
static String getSystemCreationClassName (); |
|
|
|
static Uint32 lookupPort( |
|
const char * serviceName, |
|
Uint32 defaultPort); |
|
|
|
static String getEffectiveUserName(); |
|
|
|
/** |
|
This function is used to input a password with echo disabled. |
|
The function reads up to a newline and returns a password of at most |
|
8 characters. |
|
|
|
@param prompt String containing the message prompt to be displayed |
|
@return password obtained from the user |
|
*/ |
|
static String getPassword(const char* prompt); |
|
|
|
/** |
|
This function is used to encrypt the user's password. |
|
The encryption is compatible with Apache's password file (generated using |
|
the htpasswd command ) |
|
|
|
@param password Password to be encrypted. |
|
@param salt Two character string chosen from the set [a-zA-Z0-9./]. |
|
|
|
@return Encrypted password. |
|
*/ |
|
static String encryptPassword(const char* password, const char* salt); |
|
|
|
/** |
|
This function is used to verify whether specified user is a user |
|
on the local system. |
|
|
|
@param userName User name to be verified. |
|
|
|
@return true if the username is valid, else false |
|
*/ |
|
static Boolean isSystemUser(char* userName); |
|
|
|
/** |
|
Checks whether the given user is a privileged user. |
|
|
|
@param userName User name to be checked. |
|
@return true if the user is a privileged user, else false |
|
*/ |
|
static Boolean isPrivilegedUser(const String userName); |
|
|
|
/** |
|
This function returns the privileged user name on the system. |
|
|
|
@return the privileged user name |
|
*/ |
|
static String getPrivilegedUserName(); |
|
|
|
/** |
|
This function is used to get the process ID of the calling process. |
|
|
|
@return Process ID |
|
*/ |
|
static Uint32 getPID(); |
|
|
|
static Boolean truncateFile(const char* path, size_t newSize); |
|
|
|
#if defined(PEGASUS_OS_HPUX) |
|
static Boolean bindVerbose; |
|
#endif |
}; | }; |
| |
PEGASUS_NAMESPACE_END | PEGASUS_NAMESPACE_END |