pegasus/src/Pegasus/Common/System.h - diff

Return to System.h CVS log

Up to [Pegasus] / pegasus / src / Pegasus / Common

Diff for /pegasus/src/Pegasus/Common/System.h between version 1.40 and 1.67

version 1.40, 2004/06/10 21:54:40

version 1.67, 2006/11/08 20:38:30

Line 1

//%2003////////////////////////////////////////////////////////////////////////

//%2006////////////////////////////////////////////////////////////////////////

// Company, L. P., IBM Corp., The Open Group, Tivoli Systems.

// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.

// IBM Corp.; EMC Corporation, The Open Group.

// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.

// EMC Corporation; VERITAS Software Corporation; The Open Group.

// EMC Corporation; Symantec Corporation; The Open Group.

// Permission is hereby granted, free of charge, to any person obtaining a copy

// of this software and associated documentation files (the "Software"), to

Line 23

Line 29

//==============================================================================

// Author: Mike Brasher (mbrasher@bmc.com)

// Modified By:

// Nag Boranna, Hewlett-Packard Company (nagaraja_boranna@hp.com)

// Modified By: Dave Rosckes (rosckes@us.ibm.com)

//%/////////////////////////////////////////////////////////////////////////////

#ifndef Pegasus_System_h

Line 48

Line 47

#endif

#if defined (PEGASUS_OS_TYPE_UNIX) || (PEGASUS_OS_VMS)

# ifndef PEGASUS_OS_OS400

# include <unistd.h>

# endif

# include <fcntl.h> // File locking

# define PEGASUS_UID_T uid_t

# define PEGASUS_GID_T gid_t

#else

# define PEGASUS_UID_T Uint32

# define PEGASUS_GID_T Uint32

#endif

// Protocal Type

Line 55

Line 66

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.

#if !defined(PEGASUS_PLATFORM_ZOS_ZSERIES_IBM) && !defined(PEGASUS_PLATFORM_OS400_ISERIES_IBM)

typedef struct DynamicSymbolHandle_* DynamicSymbolHandle;

#else

extern "C" {typedef int (* DynamicSymbolHandle)(void);}

#endif

/** The System class defines wrappers for operating system related calls.

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

Line 92

Line 85

static void getCurrentTime(Uint32& seconds, Uint32& milliseconds);

/** Similar to getCurrentTime() above but get microseconds (rather than

milliseconds).

static void getCurrentTimeUsec(Uint32& seconds, Uint32& microseconds);

/** 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.

Line 124

Line 122

static Boolean copyFile(const char* fromPath, const char* toPath);

/** Unix issue:<br><br><b>RTLD_<bah></b> issue. Currently Pegasus uses RTLD_NOW during

loading of the library if supported by OS. Previous to 2.2, Pegasus used RTLD_GLOBAL on Linux

- that behaviour is now deprecated.

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 String getHostIP(const String &hostName);

static Uint32 _acquireIP(const char* hostname);

static Uint32 lookupPort(

const char * serviceName,

Uint32 defaultPort);

/**

Attempts to validate that the input hostName represents the same host as

the host represented by the value returned by the

getFullyQualifiedHostName() method.

@param hostName the host name to validate

@return True if the input hostName can be validated to represent the

same host;

False otherwise

static Boolean sameHost (const String & hostName);

/**

* Attempts to find the given IP address(32bit) on any of the local defined

* network interfaces

static Boolean isIpOnNetworkInterface(Uint32 inIP);

/**

* Attempts to resolve a given hostname

* this function possibly can take some as it can request information

* from the DNS

* Return: return value == true if successful, false if not successful

* the IP address that was determined resides in resolvedNameIP

static Boolean resolveHostNameAtDNS(const char* hostname, Uint32 * resolvedNameIP);

/**

* Attempts to resolve a given IP address

* this function possibly can take some as it can request information

* from the DNS

* Return: return value == true if successful, false if not successful

* the IP address that was determined resides in resolvedNameIP

static Boolean resolveIPAtDNS(Uint32 ip_addr, Uint32 * resolvedIP);

/**

* Bundling function used to determine if a given hostname or IP address

* belongs to the local host

* this function has the potential to take some time as it will possibly

* use the DNS

static Boolean isLocalHost(const String &hostName);

static String getEffectiveUserName();

/**

Line 186

Line 219

@param userName User name to be checked.

@return true if the user is a privileged user, else false

static Boolean isPrivilegedUser(const String userName);

static Boolean isPrivilegedUser(const String& userName);

/**

This function returns the privileged user name on the system.

Line 212

Line 245

static Boolean isGroupMember(const char* userName, const char* groupName);

/**

Gets the user and group IDs associated with the specified user.

@param userName User name for which to look up user and group IDs.

@param uid User ID for the specified user name.

@param gid Group ID for the specified user name.

@return True if the user and group IDs were retrieved

successfully, false otherwise.

#ifndef PEGASUS_OS_OS400

static Boolean lookupUserId(

const char* userName,

PEGASUS_UID_T& uid,

PEGASUS_GID_T& gid);

#endif

/**

Changes the process user context to the specified user and group ID.

@param uid User ID to set as the process user context.

@param gid Group ID to set as the process group context.

@return True if the user context is successfully changed,

false otherwise.

#ifndef PEGASUS_OS_OS400

static Boolean changeUserContext(

const PEGASUS_UID_T& uid,

const PEGASUS_GID_T& gid);

#endif

/**

This function is used to get the process ID of the calling process.

@return Process ID

Line 254

Line 315

static Boolean changeFilePermissions(const char* path, mode_t mode);

/** Checks whether the specified file is a regular file owned by the

effective user for the current process.

@param path Path of the file to check.

@return True if the file is owned by the effective user for the

current process, false otherwise.

static Boolean verifyFileOwnership(const char* path);

/**

Flag indicating whether shared libraries are loaded with the

BIND_VERBOSE option.

Line 262

Line 331

static Boolean bindVerbose;

/** This function is an abstraction for the openlog interface used in the Logger

/**

class. Each platform intending to use system logs should support this interface

Writes a message to the system log. This method encapsulates the

semantics of opening the system log, writing the specified message,

static void openlog(const String);

and closing the log.

/** This function is an abstraction for the syslog interface used in the Logger

@param ident An identifier to be prepended to the log messages

class. Each platform intending to use system logs should support this interface

(typically a program name).

@param severity A severity value to be associated with the message.

static void syslog(Uint32, const char *);

Severity values are defined in Logger.h.

@param message A message to be written to the system log.

static void syslog(

const String& ident,

Uint32 severity,

const char* message);

static void openlog(

const char *ident,

int logopt,

int facility);

/** This function is an abstraction for the closelog interface used in the Logger

class. Each platform intending to use system logs should support this interface

static void closelog();

// System ID constants for Logger::put and Logger::trace

Line 282

Line 359

// System ID constants for Logger::put and Logger::trace

static const String CIMLISTENER;

};

/**

The AutoFileLock class uses an advisory file lock to allow access to a

resource to be controlled.

class PEGASUS_COMMON_LINKAGE AutoFileLock

{

public:

AutoFileLock(const char* fileName);

~AutoFileLock();

private:

AutoFileLock();

AutoFileLock(const AutoFileLock&);

AutoFileLock& operator=(const AutoFileLock&);

#ifdef PEGASUS_OS_TYPE_UNIX

struct flock _fl;

int _fd;

#endif

};

PEGASUS_NAMESPACE_END

Legend:

Removed from v.1.40
changed lines
	Added in v.1.67

No CVS admin address has been configured