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.69 and 1.86.4.1

version 1.69, 2007/05/30 20:41:28

version 1.86.4.1, 2009/10/20 13:21:19

Line 1

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

//%LICENSE////////////////////////////////////////////////////////////////

// Licensed to The Open Group (TOG) under one or more contributor license

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

// agreements. Refer to the OpenPegasusNOTICE.txt file distributed with

// this work for additional information regarding copyright ownership.

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

// Each contributor licenses this file to you under the OpenPegasus Open

// Source License; you may not use this file except in compliance with the

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

// License.

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

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

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

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

// deal in the Software without restriction, including without limitation the

// to deal in the Software without restriction, including without limitation

// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or

// the rights to use, copy, modify, merge, publish, distribute, sublicense,

// sell copies of the Software, and to permit persons to whom the Software is

// and/or sell copies of the Software, and to permit persons to whom the

// furnished to do so, subject to the following conditions:

// Software is furnished to do so, subject to the following conditions:

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

// The above copyright notice and this permission notice shall be included

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

// in all copies or substantial portions of the Software.

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

//////////////////////////////////////////////////////////////////////////

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

Line 36

Line 34

#include <Pegasus/Common/Config.h>

#include <Pegasus/Common/String.h>

#include <Pegasus/Common/Array.h>

#include <Pegasus/Common/Linkage.h>

#include <Pegasus/Common/Logger.h>

#include <Pegasus/Common/Network.h>

#include <sys/stat.h>

Line 45

#ifndef mode_t

typedef unsigned long mode_t;

#endif

#include <windows.h>

#endif

#if defined (PEGASUS_OS_TYPE_UNIX) || (PEGASUS_OS_VMS)

#if defined (PEGASUS_OS_TYPE_UNIX) || \

# ifndef PEGASUS_OS_OS400

defined (PEGASUS_OS_VMS)

# include <unistd.h>

# endif

# include <fcntl.h> // File locking

# define PEGASUS_UID_T uid_t

# define PEGASUS_GID_T gid_t

Line 59

# define PEGASUS_GID_T Uint32

#endif

#if defined(PEGASUS_OS_TYPE_WINDOWS)

# define PEGASUS_SYSTEM_ERRORMSG_NLS \

System::getErrorMSG_NLS(GetLastError(),0)

# define PEGASUS_SYSTEM_NETWORK_ERRORMSG_NLS \

System::getErrorMSG_NLS(WSAGetLastError(),0)

# define PEGASUS_SYSTEM_ERRORMSG \

System::getErrorMSG(GetLastError(),0)

# define PEGASUS_SYSTEM_NETWORK_ERRORMSG \

System::getErrorMSG(WSAGetLastError(),0)

#elif defined(PEGASUS_OS_ZOS)

# define PEGASUS_SYSTEM_ERRORMSG_NLS \

System::getErrorMSG_NLS(errno,__errno2())

# define PEGASUS_SYSTEM_NETWORK_ERRORMSG_NLS \

System::getErrorMSG_NLS(errno,__errno2())

# define PEGASUS_SYSTEM_ERRORMSG \

System::getErrorMSG(errno,__errno2())

# define PEGASUS_SYSTEM_NETWORK_ERRORMSG \

System::getErrorMSG(errno,__errno2())

#else

# define PEGASUS_SYSTEM_ERRORMSG_NLS \

System::getErrorMSG_NLS(errno,0)

# define PEGASUS_SYSTEM_NETWORK_ERRORMSG_NLS \

System::getErrorMSG_NLS(errno,0)

# define PEGASUS_SYSTEM_ERRORMSG \

System::getErrorMSG(errno,0)

# define PEGASUS_SYSTEM_NETWORK_ERRORMSG \

System::getErrorMSG(errno,0)

#endif

// Protocal Type

Line 74

Line 103

class PEGASUS_COMMON_LINKAGE System

{

public:

/* Creates a String object containing the system message

from the errno and if supported from a second level error

number. The _NLS Method is looking up an internationalized version of

the message.

@param errorCode The system errno.

@param errorCode2 The secondary error number like errno2 on z/OS

static String getErrorMSG_NLS(int errorCode,int errorCode2);

static String getErrorMSG(int errorCode,int errorCode2);

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

Line 118

Line 158

static Boolean removeFile(const char* path);

/**

Renames a file. If the new name refers to an existing file, it is

removed and replaced with the renamed file. The rename operation is

performed atomically.

@param oldPath A character string containing the name of the file to

rename.

@param newPath A character string containing the name to which to

rename the file.

@return A Boolean indicating whether the rename operation was

successful.

static Boolean renameFile(const char* oldPath, const char* newPath);

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

Line 125

Line 176

static String getHostName();

static String getFullyQualifiedHostName ();

static String getSystemCreationClassName ();

static String getHostIP(const String &hostName);

static Uint32 _acquireIP(const char* hostname);

static Uint32 lookupPort(

// The following 2 methods are wrappers around system functions

const char * serviceName,

// gethostbyname/gethostbyaddr or gethostbyname_r/gethostbyaddr_r.

Uint32 defaultPort);

// In addition to calling corresponding system functions, these

// methods introduce re-tries when errno is set to TRY_AGAIN.

// Optional parameters are required to cover systems which use '_r'

// versions of the system functions.

static struct hostent* getHostByName(

const char* name,

struct hostent* he = 0,

char* buf = 0,

size_t len = 0);

static struct hostent* getHostByAddr(

const char *addr,

int len,

int type,

struct hostent* he = 0,

char* buf = 0,

size_t buflen = 0);

#if defined(PEGASUS_OS_ZOS) || \

defined(PEGASUS_OS_VMS) || \

defined(PEGASUS_ENABLE_IPV6)

// The following 2 methods are wrappers around system functions

// getaddrinfo/getnameinfo.

// In addition to calling corresponding system functions, these

// methods introduce re-tries on EAI_AGAIN error returns.

static int getAddrInfo(

const char *hostname,

const char *servname,

const struct addrinfo *hints,

struct addrinfo **res);

static int getNameInfo(

const struct sockaddr *sa,

size_t salen,

char *host,

size_t hostlen,

char *serv,

size_t servlen,

int flags);

/**

#endif

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

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

/**

Returns true if IPv6 stack is active by checking return code from

Socket::createSocket() and getSocketError() calls.

ATTN: We return true if some error other than

PEGASUS_INVALID_ADDRESS_FAMILY is returned while creating the socket

because we will not be sure whether the IPv6 stack is active or not

from the returned error code. Return value of "true" from this method

should not be trusted absolutely.

#ifdef PEGASUS_ENABLE_IPV6

static Boolean isIPv6StackActive();

#endif

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

/**

same host;

Returns all interface addresses. Both ip4 and ip6 interface addresses

False otherwise

will be returned.

static Boolean sameHost (const String & hostName);

static Array<String> getInterfaceAddrs();

static Uint32 lookupPort(

const char * serviceName,

Uint32 defaultPort);

/**

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

Line 183

Line 289

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

/**

Line 252

Line 365

@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

IMPORTANT: This method is not reentrant and not async signal safe.

be called in a single-threaded program.

It 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.

Line 285

Line 394

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

This method is provided only because some platforms lack a fast enough

function in the standard library.

strcasecmp function in the standard library.

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

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

This method should only be used if length of both strings is

known already. If not, please use System::strcasecmp()

static bool strncasecmp(

const char* s1,

size_t s1_l,

const char* s2,

size_t s2_l);

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

Line 386

Line 505

struct flock _fl;

int _fd;

#endif

#ifdef PEGASUS_OS_TYPE_WINDOWS

HANDLE _hFile;

#endif

};

PEGASUS_NAMESPACE_END

Legend:

Removed from v.1.69
changed lines
	Added in v.1.86.4.1

No CVS admin address has been configured