dataset_util

Version 1.20 07jun05

Introduction

This package provides utility classes used by the dataset system.

The dataset system is described at http://www.usatlas.bnl.gov/~dladams/dataset

Although, the components in this package were written to support the dataset system, they are generic and could have application in other realms.

Dependencies

Dependencies are described in the CMT requirements file.

Status

Version.
Change log.

Components

The components here are listed in dependency order. Each component depends only on those listed above it. The test associated with each component is a main program that returns zero if the component is working properly.

FileStatus (header, source, test) - Provides access to the POSIX status of a file including existence, type and permissions. Interace will be extended as needed.

getcwd (header, source, test) - Function to return the current working directory as a string.

FileName (header, source, test) - Class for extracting information from a file name.

mkdir (header, source, test) - Function to create a directory with all permission bits set and then masked by umask. Equivalent to mkdir command.

ssystem (header, source, test) - Like C system(char*) but with string argument.

copy_file (header, source, test) - Function to copy a file.

FileDirectory (header, source, test) - Provides access the the names of the files in a directories and to the list of subdirectories.

FileFinder (header, source, test) - Searches for files in a file system.

XmlElement (header, source, test) - XmlElement provides a simple description of an XML element which is a partial implementation of the XML standard. An element can hold attributes including ID and IDREF and can hold other elements. Package dataset_xml provides a parser based on xerces to fill and write these elements from and to XML files.

Text (header, source, test) - Class Text holds a block of text and provides methods to read from and write to a text file and XML.

MemoryUsage (header, source, test) - Class to fetch the amount of memory allocated to a process.

memsize (header, source, test) - Functions that estimate the amoung meory associated with various types of data objects including strings, vectors and sets.

Path (header, source, test) - Class for fetching and setting environmental paths (PATH, LD_LIBRARY_PATH, ...).

Environment (header, source, test) - Class Environment is a map which holds the description of a collection of unix environmental variables.

get_hostname (header, source, test) - Returns the hostname.

CommandLine (header, source, test) - Holds a command name (file name) and list of arguments. Can be converted to or from a C-string array.

DtdRegistry (header, source, test) - Collects DTD's and combines them to create a DTD file.

dataset_util_DTD (source, test) - Registers the DTD's for this package.

PThreadMutex (header, source, test) - Class to hold a pthread mutex.

PThreadMutexLocker (header, source, test) - Class to aid in the management of mutexes.

PThreadCondition (header, source, test) - Class to hold an integer pthread condition varialble.

PThreadConditionLocker (header, source, test) - Class to aid in the management ofpthread conditons.

Time (header, source, test) - Classes to hold and format times and time intervals.

ThreadCredential (header, source, test) - ThreadCredential provides access to the credentil name associated with a thread and allows GssCredentialManager to set these names.

Url (header) Class to describe a URL.

dladams@bnl.gov