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.1 and 1.68.4.2

version 1.1, 2001/04/11 00:23:44

version 1.68.4.2, 2007/07/03 21:50:04

Line 1

//BEGIN_LICENSE

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

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

// 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 SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

// THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN

// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

// ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED

// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL

// "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT

// THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

// LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR

// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING

// PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT

// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER

// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN

// DEALINGS IN THE SOFTWARE.

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

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

//BEGIN_HISTORY

// Author: Michael E. Brasher

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

// $Log$

// Revision 1.1 2001/04/11 00:23:44 mike

// new files

//END_HISTORY

#ifndef Pegasus_System_h

#define Pegasus_System_h

#include <Pegasus/Common/Config.h>

#include <Pegasus/Common/String.h>

#include <Pegasus/Common/Linkage.h>

#include <Pegasus/Common/Logger.h>

#include <sys/stat.h>

#if defined(PEGASUS_OS_TYPE_WINDOWS)

#ifndef mode_t

typedef unsigned long mode_t;

#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

#define TCP "tcp"

PEGASUS_NAMESPACE_BEGIN

Line 44

Line 74

class PEGASUS_COMMON_LINKAGE System

{

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);

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

static String getCurrentASCIITime();

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 String getHostName();

static String getFullyQualifiedHostName ();

static String getSystemCreationClassName ();

// Gets IP address assosiated with hostName. af indicates the

// type of address (ipv4 or ipv6) returned.

static Boolean getHostIP(const String &hostName, int *af, String &hostIP);

// Gets IP address in binary form. af indicates the type of

// address (ipv4 or ipv6) returned. Address will be copied to dst.

static Boolean _acquireIP(const char* hostname, int *af, void *dst);

static Uint32 lookupPort(

const char * serviceName,

Uint32 defaultPort);

/**

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

@param resolvedNameIP On successful hostname resolution, this output

parameter contains the IP address that was determined.

@return true if successful, false if not successful.

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

@param resolvedIP On successful hostname resolution, this output

parameter contains the IP address that was determined.

@return true if successful, false if not successful.

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);

/**

Checks binIPAddress represented by address family and returns true

if binary representation matches with loopback ip address. binIPAddress

must be in host-byte order.

static Boolean isLoopBack(int af, void *binIPAddress);

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(const 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 verify whether the specified user is a member

of the specified user group.

@param userName User name to be verified.

@param groupName User group name.

@return true if the user is a member of the user group, false otherwise.

@throw InternalSystemError - If there is an error accessing the

specified user or group information.

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.

IMPORTANT: This method uses non-reentrant functions and should only

be called in a single-threaded program.

@param userName User name to set as the process user context.

@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_SingleThreaded(

const char* userName,

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

static Uint32 getPID();

static Boolean truncateFile(const char* path, size_t newSize);

/** Compare two strings but ignore any case differences.

This method is provided only because some platforms lack a strcasecmp

function in the standard library.

static Sint32 strcasecmp(const char* s1, const char* s2);

/** Return just the file or directory name from the path into basename.

This method returns a file or directory name at the end of a path.

The path can be relative or absolute. If the path is the root,

then empty string is returned.

static char *extract_file_name(const char *fullpath, char *basename);

/** Return just the pathname into dirname. The fullpath can be relative

or absolute. This method returns a path minus the file or

directory name at the end of a supplied path (fullpath).

If the fullpath is the root, then fullpath is returned.

The resulting path will contain a trailing slash unless fullpath is

a file or directory name, in which case, just the file or directory

name is returned.

static char *extract_file_path(const char *fullpath, char *dirname);

// Is absolute path?

static Boolean is_absolute_path(const char *path);

/** Changes file permissions on the given file.

@param path path of the file.

@param mode the bit-wise inclusive OR of the values for the desired

permissions.

@return true on success, false on error and errno is set appropriately.

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.

THIS FLAG IS USED ON HP-UX ONLY.

static Boolean bindVerbose;

/**

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

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

and closing the log.

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

(typically a program name).

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

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);

static void closelog();

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

static const String CIMSERVER;

// 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.1
changed lines
	Added in v.1.68.4.2

No CVS admin address has been configured