Scroll to navigation

ost(3) Library Functions Manual ost(3)

NAME

ost -

SYNOPSIS

Classes


class IPV4Validator
 
Classes derived from IPV4Address would require an specific validator to pass to the IPV4Address constructor. class IPV4MulticastValidator
 
Class for the function object that validates multicast addresses. class IPV4Cidr
 
The CIDR class is used to support routing tables and validate address policies. class IPV6Cidr
 
The CIDR class is used to support routing tables and validate address policies. class IPV4Address
 
The network name and address objects are all derived from a common IPV4Address base class. class IPV4Mask
 
Internet addresses used specifically as masking addresses (such as '
255.255.255.0') are held in the IPV4Mask derived object. " class IPV4Host
 
This object is used to hold the actual and valid internet address of a specific host machine that will be accessed through a socket. class IPV4Broadcast
 
The broadcast address object is used to store the broadcast address for a specific subnet. class IPV4Multicast
 
A specialization of IPV4Address that provides address validation for multicast addresses. class IPV6Validator
 
Classes derived from IPV6Address would require an specific validator to pass to the IPV6Address constructor. class IPV6MulticastValidator
 
Class for the function object that validates multicast addresses. class IPV6Address
 
The network name and address objects are all derived from a common IPV6Address base class. class IPV6Mask
 
Internet addresses used specifically as masking addresses (such as '
255.255.255.0') are held in the IPV6Mask derived object. " class IPV6Host
 
This object is used to hold the actual and valid internet address of a specific host machine that will be accessed through a socket. class IPV6Broadcast
 
The broadcast address object is used to store the broadcast address for a specific subnet. class IPV6Multicast
 
A specialization of IPV6Address that provides address validation for multicast addresses. class HEXdump
 
Produces a dump of a buffer in a hexdump way with its code Ascii translation and relative buffer address. class AppLog
 
Application logger is a class that implements a logger that can be used by applications to save log file somewhere on the system. class Buffer
 
The buffer class represents an IPC service that is built upon a buffer of fixed capacity that can be used to transfer objects between one or more producer and consumer threads. class FixedBuffer
 
A buffer class that holds a known capacity of fixed sized objects defined during creation. class ThreadQueue
 
Somewhat generic queue processing class to establish a producer consumer queue. class CommandOption
 
CommandOption is the base class for all command line options. class CommandOptionWithArg
 
Derived class of CommandOption for options that have a value associated with them. class CommandOptionArg
 
Class for options with an argument e.g. class CommandOptionRest
 
It only makes sense to have a single one of these set and it is exclusive with CommandOptionCollect. class CommandOptionCollect
 
It only makes sense to have a single one of these set and it is also exclusive with CommandOptionRest. class CommandOptionNoArg
 
CommandOption type for flags. class CommandOptionParse
 
This is the CommandOptionParse interface class. class Counter
 
The counter template is used for generic objects which act as automatic counters. class Digest
 
The digest base class is used for implementing and deriving one way hashing functions. class ChecksumDigest
 
A simple checksum digest function. class CRC16Digest
 
A crc16 collection/compution hash accumulator class. class CRC32Digest
 
A crc32 collection/computation hash accumulator class. class MD5Digest
 
A md5 collection/computation accululator class. class File
 
class Dir
 
A low level portable directory class. class DirTree
 
A generic class to walk a hierarchical directory structure. class RandomFile
 
The purpose of this class is to define a base class for low level random file access that is portable between Win32 and Posix systems. class ThreadFile
 
This class defines a database I/O file service that can be shared by multiple threads. class SharedFile
 
This class defines a database I/O file service that can be shared by multiple processes. class MappedFile
 
Create and map a disk file into memory. class DSO
 
The DSO dynamic loader class is used to load object files. class MIMEMultipart
 
A container class for multi-part MIME document objects which can be streamed to a std::ostream destination. class MIMEMultipartForm
 
The Multipart form is a MIME multipart document specific for the construction and delivery of form data to a web server through a post method. class MIMEItemPart
 
This is used to attach an item part to a MIME multipart document that is being streamed. class MIMEFormData
 
This is a document part type for use in submitting multipart form data to a web server. class MemPager
 
The memory pager is used to allocate cumulative memory pages for storing object specific 'persistant' data that is presumed to persist during the life of a given derived object. class StackPager
 
The StackPager provides a repository to stash and retrieve working data in last-in-first-out order. class SharedMemPager
 
The shared mempager uses a mutex to protect key access methods. class Keydata
 
Keydata objects are used to load and hold 'configuration' data for a given application. class MemPagerObject
 
This class is used to create derived classes which are constructed within a memory pager pool. class Assoc
 
This class is used to associate (object) pointers with named strings. class Runlist
 
A runlist is used to restrict concurrent exection to a limited set of concurrent sessions, much like a semaphore. class Runable
 
A container for objects that can be queued against a runlist. class NetworkDeviceInfo
 
Network device information class. class Number
 
A number manipulation class. class ZNumber
 
class Date
 
The Date class uses a julian date representation of the current year, month, and day. class Time
 
The Time class uses a integer representation of the current time. class Datetime
 
The Datetime class uses a julian date representation of the current year, month, and day and a integer representation of the current time. class DateNumber
 
A number class that manipulates a string buffer that is also a date. class objCounter
 
Generic template class for creating classes which maintain an active count of the number of instances currently in active use. class RefObject
 
A reference countable object. class RefPointer
 
Pointer to reference counted objects. class LinkedSingle
 
Self managed single linked list object chain. class LinkedDouble
 
Self managed double linked list object chain. class MapTable
 
A map table allows for entities to be mapped (hash index) onto it. class MapIndex
 
The MapIndex allows linear access into a MapTable, that otherwise could have its elements being retrieved only by key. class MapObject
 
The MapObject is a base class which can be used to make a derived class operate on a MapTable. class objList
 
Used to create and manage a single linked list of objects of a common type. class objMap
 
Used to create and manage a hash index of objects through a common type. class keyMap
 
class objSync
 
Generic template to create objects of a common base type which share a static mutex so that all instances of the class have a global lock. struct cistring_char_traits
 
class TypeManager
 
This class manages the types for generation of the persistent objects. class BaseObject
 
BaseObject. class Engine
 
Engine. class Pointer
 
Used to create and manage referece counted pointers. class Process
 
A class for containing portable process related functions that help create portable code. class Lockfile
 
This class is used to create a 'named' lock entity that can be used to control access to a resource between multiple processes. class Serial
 
The Serial class is used as the base for all serial I/O services under APE. class TTYStream
 
TTY streams are used to represent serial connections that are fully 'streamable' objects using C++ stream classes and friends. class ttystream
 
A more natural C++ 'ttystream' class for use by non-threaded applications. class TTYSession
 
The TTYSession aggragates a TTYStream and a Common C++ Thread which is assumed to be the execution context that will be used to perform actual I/O operations. class SerialPort
 
The serial port is an internal class which is attached to and then serviced by a specified SerialService thread. class SerialService
 
The SerialService is a thead service object that is meant to service attached serial ports. class Slog
 
The slog class is used to stream messages to the system's logging facility (syslogd). class Socket
 
The Socket is used as the base for all Internet protocol services under Common C++. class DCCPSocket
 
DCCP sockets are used for stream based connected sessions between two sockets. class UDPSocket
 
UDP sockets implement the TCP SOCK_DGRAM UDP protocol. class UDPBroadcast
 
Representing a UDP socket used for subnet broadcasts, this class provides an alternate binding and setPeer() capability for UDP sockets. class UDPTransmit
 
Representing half of a two-way UDP connection, the UDP transmitter can broadcast data to another selected peer host or to an entire subnet. class UDPReceive
 
Representing half of a two-way UDP connection, the UDP receiver can receive data from another peer host or subnet. class UDPDuplex
 
UDP duplex connections impliment a bi-directional point-to-point UDP session between two peer hosts. class TCPSocket
 
TCP sockets are used for stream based connected sessions between two sockets. class TCPV6Socket
 
TCPV6 sockets are used for stream based connected sessions between two ipv6 sockets. class TCPStream
 
TCP streams are used to represent TCP client connections to a server by TCP protocol servers for accepting client connections. class TCPSession
 
The TCP session is used to primarily to represent a client connection that can be managed on a separate thread. class SimpleTCPStream
 
Simple TCP Stream, to be used with Common C++ Library. class SocketPort
 
The socket port is an internal class which is attached to and then serviced by a specific SocketService 'object'. class SocketService
 
The SocketService is a thread pool object that is meant to service attached socket ports. class SSLStream
 
class String
 
This is a generic and portable string class. class SString
 
class StringObject
 
The StringObject class is used to derive subclasses that use the String managed memory pool for all space allocations by overriding new and delete operators. class Mutex
 
The Mutex class is used to protect a section of code so that at any given time only a single thread can perform the protected operation. class MutexLock
 
The MutexLock class is used to protect a section of code so that at any given time only a single thread can perform the protected operation. class ThreadLock
 
The ThreadLock class impliments a thread rwlock for optimal reader performance on systems which have rwlock support, and reverts to a simple mutex for those that do not. class ReadLock
 
The ReadLock class is used to protect a section of code through a ThreadLock for 'read' access to the member function. class WriteLock
 
The WriteLock class is used to protect a section of code through a ThreadLock for 'write' access to the member function. class MutexCounter
 
The Mutex Counter is a counter variable which can safely be incremented or decremented by multiple threads. class AtomicCounter
 
The AtomicCounter class offers thread-safe manipulation of an integer counter. class Conditional
 
A conditional variable synchcronization object for one to one and one to many signal and control events between processes. class Semaphore
 
A semaphore is generally used as a synchronization object between multiple threads or to protect a limited and finite resource such as a memory or thread pool. class SemaphoreLock
 
The SemaphoreLock class is used to protect a section of code through a semaphore so that only x instances of the member function may execute concurrently. class Event
 
The Event class implements a feature originally found in the WIN32 API; event notification. class Thread
 
Every thread of execution in an application is created by instantiating an object of a class derived from the Thread class. class Cancellation
 
A class to automatically set the thread cancellation mode of a member function. class PosixThread
 
class ThreadKey
 
This class allows the creation of a thread context unique 'pointer' that can be set and retrieved and can be used to create thread specific data areas for implementing 'thread safe' library routines. class TimerPort
 
Timer ports are used to provide synchronized timing events when managed under a 'service thread' such as SocketService. class SysTime
 
This class is used to access non-reentrant date and time functions in the standard C library. class StringTokenizer
 
Splits delimited string into tokens. class UnixSocket
 
Unix domain sockets are used for stream based connected sessions between processes on the same machine. class UnixStream
 
Unix streams are used to represent Unix domain client connections to a local server for accepting client connections. class unixstream
 
A more natural C++ 'unixstream' class for use by non-threaded applications. class UnixSession
 
The Unix domain session is used to primarily to represent a client connection that can be managed on a separate thread. class URLStream
 
A URL processing version of TCPStream. class XMLStream
 
This class impliments a basic XML stream parser that can be used to examine an XML resource thru virtual I/O methods. class XMLRPC
 
This class impliments a core XMLRPC service without the underlying transports. class IZStream
 
class OZStream
 

Typedefs


typedef unsigned short tpport_t
 
Transport Protocol Ports. typedef unsigned long pos_t
 
typedef size_t ccxx_size_t
 
typedef
 
std::string_char_traits< char > cstring_char_traits"
 
typedef std::basic_string< char > cstring
 
typedef std::basic_string
 
< char, cistring_char_traits
 
< char > > cistring"
 
typedef class BaseObject *(* NewBaseObjectFunction )(void)
 
typedef int signo_t
 

Functions


__EXPORT std::ostream & operator<< (std::ostream &os, const IPV4Address &ia)
 
struct in_addr getaddress (const IPV4Address &ia)
 
__EXPORT std::ostream & operator<< (std::ostream &os, const IPV6Address &ia)
 
struct in6_addr getaddress (const IPV6Address &ia)
 
__EXPORT AppLog & debug (AppLog &sl)
 
Manipulator for debug level. __EXPORT AppLog & warn ( AppLog &sl)
 
Manipulator for warn level. __EXPORT AppLog & error ( AppLog &sl)
 
Manipulator for error level. __EXPORT AppLog & emerg ( AppLog &sl)
 
Manipulator for emerg level. __EXPORT AppLog & alert ( AppLog &sl)
 
Manipulator for alert level. __EXPORT AppLog & critical ( AppLog &sl)
 
Manipulator for critical level. __EXPORT AppLog & notice ( AppLog &sl)
 
Manipulator for notice level. __EXPORT AppLog & info ( AppLog &sl)
 
Manipulator for info level. __EXPORT CommandOptionParse * makeCommandOptionParse (int argc, char **argv, const char *comment, CommandOption *options= defaultCommandOptionList)
 
makeCommandOptionParse will create an implementation of a CommandOptionParse object. template<typename T > const T & abs (const T &v)
 
__EXPORT void endKeydata (void)
 
__EXPORT void * memmove (char *dest, const char *source, size_t length)
 
__EXPORT char * strdup (const char *str)
 
__EXPORT int lockf (int fd, int mode, long offset)
 
char * strtok_r (char *s, const char *d, char **x)
 
__EXPORT char * lsetField (char *target, size_t size, const char *src, const char fill=0)
 
__EXPORT char * rsetField (char *target, size_t size, const char *src, const char fill=0)
 
__EXPORT char * setString (char *target, size_t size, const char *src)
 
__EXPORT char * addString (char *target, size_t size, const char *src)
 
__EXPORT char * newString (const char *src, size_t size=0)
 
__EXPORT void delString (char *str)
 
__EXPORT char * setUpper (char *string, size_t size)
 
__EXPORT char * setLower (char *string, size_t size)
 
__EXPORT char * find (const char *cs, char *str, size_t len=0)
 
__EXPORT char * rfind (const char *cs, char *str, size_t len=0)
 
__EXPORT char * ifind (const char *cs, char *str, size_t len=0)
 
__EXPORT char * strip (const char *cs, char *str, size_t len=0)
 
__EXPORT size_t strchop (const char *cs, char *str, size_t len=0)
 
__EXPORT size_t strtrim (const char *cs, char *str, size_t len=0)
 
char * dupString (const char *src, size_t size=0)
 
struct timespec * getTimeout (struct timespec *spec, timeout_t timeout)
 
void wait (signo_t signo)
 
Thread * getThread (void)
 
struct tm * localtime_r (const time_t *t, struct tm *b)
 
char * ctime_r (const time_t *t, char *buf)
 
struct tm * gmtime_r (const time_t *t, struct tm *b)
 
char * asctime_r (const struct tm *tm, char *b)
 

Variables


class __EXPORT IPV4Host
 
class __EXPORT IPV6Host
 
__EXPORT AppLog alog
 
alog global log stream definition __EXPORT CommandOption * defaultCommandOptionList
 
This defines a linked list head pointer for all the command line options that use the default list. class __EXPORT MIMEMultipart
 
class __EXPORT MIMEItemPart
 
class __EXPORT Runlist
 
class __EXPORT Runable
 
class __EXPORT MapObject
 
class __EXPORT MapIndex
 
class __EXPORT SerialPort
 
class __EXPORT SerialService
 
__EXPORT Slog slog
 
class __EXPORT SimpleTCPStream
 
class __EXPORT SocketPort
 
class __EXPORT SocketService
 
class __EXPORT Thread
 
class __EXPORT ThreadKey
 
class __EXPORT Conditional
 
class __EXPORT Event
 

Typedef Documentation

typedef size_t ost::ccxx_size_t

typedef std::basic_string<char, cistring_char_traits<char> > ost::cistring

typedef std::basic_string<char> ost::cstring

typedef std::string_char_traits<char> ost::cstring_char_traits

typedef class BaseObject*(* ost::NewBaseObjectFunction)(void)

typedef unsigned long ost::pos_t

typedef int ost::signo_t

typedef unsigned short ost::tpport_t

Transport Protocol Ports.
Examples:
SampleSocketPort.cpp.

Function Documentation

template<typename T > const T& ost::abs (const T &v) [inline]

__EXPORT char* ost::addString (char *target, size_tsize, const char *src)

__EXPORT AppLog& ost::alert (AppLog &sl) [inline]

Manipulator for alert level. Parameters:
sl application logger stream
Returns:
application logger stream
 

char* ost::asctime_r (const struct tm *tm, char *b) [inline]

__EXPORT AppLog& ost::critical (AppLog &sl) [inline]

Manipulator for critical level. Parameters:
sl application logger stream
Returns:
application logger stream
 

char* ost::ctime_r (const time_t *t, char *buf) [inline]

__EXPORT AppLog& ost::debug (AppLog &sl) [inline]

Manipulator for debug level. Parameters:
sl application logger stream
Returns:
application logger stream
 

__EXPORT void ost::delString (char *str)

char* ost::dupString (const char *src, size_tsize = 0) [inline]

References newString().

__EXPORT AppLog& ost::emerg (AppLog &sl) [inline]

Manipulator for emerg level. Parameters:
sl application logger stream
Returns:
application logger stream
 

__EXPORT void ost::endKeydata (void)

This should be used before detaching a deamon, exec(), fork(), etc.
References ost::Keydata::end().

__EXPORT AppLog& ost::error (AppLog &sl) [inline]

Manipulator for error level. Parameters:
sl application logger stream
Returns:
application logger stream
 

__EXPORT char* ost::find (const char *cs, char *str, size_tlen = 0)

struct in_addr ost::getaddress (const IPV4Address &ia) [read]

struct in6_addr ost::getaddress (const IPV6Address &ia) [read]

Thread* ost::getThread (void) [inline]

References ost::Thread::get().

struct timespec* ost::getTimeout (struct timespec *spec, timeout_ttimeout) [read]

struct tm* ost::gmtime_r (const time_t *t, struct tm *b) [read]

References ost::SysTime::getGMTTime().

__EXPORT char* ost::ifind (const char *cs, char *str, size_tlen = 0)

__EXPORT AppLog& ost::info (AppLog &sl) [inline]

Manipulator for info level. Parameters:
sl application logger stream
Returns:
application logger stream
 

struct tm* ost::localtime_r (const time_t *t, struct tm *b) [read]

References ost::SysTime::getLocalTime().

__EXPORT int ost::lockf (intfd, intmode, longoffset)

__EXPORT char* ost::lsetField (char *target, size_tsize, const char *src, const charfill = 0)

__EXPORT CommandOptionParse* ost::makeCommandOptionParse (intargc, char **argv, const char *comment, CommandOption *options = defaultCommandOptionList)

makeCommandOptionParse will create an implementation of a CommandOptionParse object. This particular implementation is a wrapper around getopt_long(3). That interface unfortunatly does not provide enough information to give the best error messages with malformed input. If the implementation changes there is a good chance that the binary interface will remain the same.
Examples:
cmdlineopt.cpp.

__EXPORT void* ost::memmove (char *dest, const char *source, size_tlength)

__EXPORT char* ost::newString (const char *src, size_tsize = 0)

Referenced by dupString().

__EXPORT AppLog& ost::notice (AppLog &sl) [inline]

Manipulator for notice level. Parameters:
sl application logger stream
Returns:
application logger stream
 

__EXPORT std::ostream& ost::operator<< (std::ostream &os, const IPV4Address &ia)

__EXPORT std::ostream& ost::operator<< (std::ostream &os, const IPV6Address &ia)

__EXPORT char* ost::rfind (const char *cs, char *str, size_tlen = 0)

__EXPORT char* ost::rsetField (char *target, size_tsize, const char *src, const charfill = 0)

__EXPORT char* ost::setLower (char *string, size_tsize)

__EXPORT char* ost::setString (char *target, size_tsize, const char *src)

__EXPORT char* ost::setUpper (char *string, size_tsize)

__EXPORT size_t ost::strchop (const char *cs, char *str, size_tlen = 0)

Referenced by ost::String::chop().

__EXPORT char* ost::strdup (const char *str)

__EXPORT char* ost::strip (const char *cs, char *str, size_tlen = 0)

char* ost::strtok_r (char *s, const char *d, char **x) [inline]

__EXPORT size_t ost::strtrim (const char *cs, char *str, size_tlen = 0)

Referenced by ost::String::trim().

void ost::wait (signo_tsigno)

Examples:
cmdlineopt.cpp.

__EXPORT AppLog& ost::warn (AppLog &sl) [inline]

Manipulator for warn level. Parameters:
sl application logger stream
Returns:
application logger stream
 

Variable Documentation

__EXPORT AppLog ost::alog

alog global log stream definition

class __EXPORT ost::Conditional

__EXPORT CommandOption* ost::defaultCommandOptionList

This defines a linked list head pointer for all the command line options that use the default list. It will most likely be used in most cases without being explicitly referenced in application code. It is a default value of various method's parameters.
Examples:
cmdlineopt.cpp.

class __EXPORT ost::Event

class __EXPORT ost::IPV4Host

class __EXPORT ost::IPV6Host

class __EXPORT ost::MapIndex

class __EXPORT ost::MapObject

class __EXPORT ost::MIMEItemPart

class __EXPORT ost::MIMEMultipart

class __EXPORT ost::Runable

class __EXPORT ost::Runlist

class __EXPORT ost::SerialPort

class __EXPORT ost::SerialService

class __EXPORT ost::SimpleTCPStream

__EXPORT Slog ost::slog

Examples:
slogTest.cpp.

class __EXPORT ost::SocketPort

Examples:
SampleSocketPort.cpp.

class __EXPORT ost::SocketService

Examples:
SampleSocketPort.cpp, and tcpservice.cpp.

class __EXPORT ost::Thread

Examples:
SampleSocketPort.cpp.

class __EXPORT ost::ThreadKey

Author

Generated automatically by Doxygen for GNU CommonC++ from the source code.
Sat Jun 23 2012 GNU CommonC++