TUnixSystem

class TUnixSystem : public TSystem

    protected:

            virtual char* DynamicPathName(const char* lib, Bool_t quiet = kFALSE)
             static void* FindDynLib(const char* lib)
      virtual const char* GetLinkedLibraries() const
               static int ReadUtmpFile()
             static void* SearchUtmpEntry(int nentries, const char* tty)
            static Func_t UnixDynFindSymbol(const char* lib, const char* entry)
              static void UnixDynListLibs(const char* lib = "")
              static void UnixDynListSymbols(const char* lib, const char* re = "")
               static int UnixDynLoad(const char* lib)
              static void UnixDynUnload(const char* lib)
               static int UnixFilestat(const char* path, FileStat_t& buf)
               static int UnixFSstat(const char* path, Long_t* id, Long_t* bsize, Long_t* blocks, Long_t* bfree)
       static const char* UnixGetdirentry(void* dir) const
       static const char* UnixHomedirectory(const char* user = "0") const
              static void UnixIgnoreSignal(ESignals sig, Bool_t ignore)
               static int UnixMakedir(const char* name)
            static Long_t UnixNow()
             static void* UnixOpendir(const char* name)
               static int UnixRecv(int sock, void* buf, int len, int flag)
              static void UnixResetSignal(ESignals sig)
              static void UnixResetSignals()
               static int UnixSelect(UInt_t nfds, TFdSet* readready, TFdSet* writeready, Long_t timeout)
               static int UnixSend(int sock, const void* buf, int len, int flag)
               static int UnixSetitimer(Long_t ms)
              static void UnixSigAlarmInterruptsSyscalls(Bool_t set)
              static void UnixSignal(ESignals sig, void* h)
       static const char* UnixSigname(ESignals sig) const
               static int UnixTcpConnect(const char* hostname, int port, int tcpwindowsize)
               static int UnixTcpService(int port, Bool_t reuse, int backlog, int tcpwindowsize)
               static int UnixUnixConnect(int port)
               static int UnixUnixService(int port, int backlog)
               static int UnixWaitchild()

    public:

                              TUnixSystem()
                              TUnixSystem(const TUnixSystem&)
                      virtual ~TUnixSystem()
                 virtual void Abort(int code = 0)
                  virtual int AcceptConnection(int sock)
               virtual Bool_t AccessPathName(const char* path, EAccessMode mode = kFileExists)
                 virtual void AddFileHandler(TFileHandler* fh)
                 virtual void AddSignalHandler(TSignalHandler* sh)
                 virtual void AddTimer(TTimer* ti)
                  virtual int AnnounceTcpService(int port, Bool_t reuse, int backlog, int tcpwindowsize = -1)
                  virtual int AnnounceUnixService(int port, int backlog)
               virtual Bool_t ChangeDirectory(const char* path)
                         void CheckChilds()
                       Bool_t CheckDescriptors()
                       Bool_t CheckSignals(Bool_t sync)
                  virtual int Chmod(const char* file, UInt_t mode)
               static TClass* Class()
                 virtual void CloseConnection(int sock, Bool_t force = kFALSE)
                 virtual void Closelog()
                  virtual int ClosePipe(FILE* pipe)
                virtual char* ConcatFileName(const char* dir, const char* name)
                          int ConnectService(const char* server, int port, int tcpwindowsize)
                  virtual int CopyFile(const char* from, const char* to, Bool_t overwrite = kFALSE)
                 virtual void DispatchOneEvent(Bool_t pendingOnly = kFALSE)
                         void DispatchSignals(ESignals sig)
                       Bool_t DispatchTimers(Bool_t mode)
               virtual Func_t DynFindSymbol(const char* module, const char* entry)
                  virtual int Exec(const char* shellcmd)
                 virtual void Exit(int code, Bool_t mode = kTRUE)
               virtual Bool_t ExpandPathName(TString& patbuf)
                virtual char* ExpandPathName(const char* path)
                 virtual void FreeDirectory(void* dirp)
          virtual const char* GetDirEntry(void* dirp) const
          virtual const char* GetDynamicPath() const
                virtual Int_t GetEffectiveGid()
                virtual Int_t GetEffectiveUid()
          virtual const char* Getenv(const char* name) const
          virtual const char* GetError() const
                virtual Int_t GetFPEMask()
                  virtual int GetFsInfo(const char* path, Long_t* id, Long_t* bsize, Long_t* blocks, Long_t* bfree)
                virtual Int_t GetGid(const char* group = "0")
         virtual UserGroup_t* GetGroupInfo(Int_t gid)
         virtual UserGroup_t* GetGroupInfo(const char* group = "0")
         virtual TInetAddress GetHostByName(const char* server)
                  virtual int GetPathInfo(const char* path, FileStat_t& buf)
         virtual TInetAddress GetPeerName(int sock)
                  virtual int GetPid()
                  virtual int GetServiceByName(const char* service)
                virtual char* GetServiceByPort(int port)
         virtual TInetAddress GetSockName(int sock)
                  virtual int GetSockOpt(int sock, int option, int* val)
                virtual Int_t GetUid(const char* user = "0")
         virtual UserGroup_t* GetUserInfo(Int_t uid)
         virtual UserGroup_t* GetUserInfo(const char* user = "0")
          virtual const char* HomeDirectory(const char* userName = "0") const
          virtual const char* HostName() const
                 virtual void IgnoreSignal(ESignals sig, Bool_t ignore = kTRUE)
               virtual Bool_t Init()
              virtual TClass* IsA() const
                  virtual int Link(const char* from, const char* to)
                 virtual void ListLibraries(const char* regexp = "")
                 virtual void ListSymbols(const char* module, const char* re = "")
                  virtual int Load(const char* module, const char* entry = "", Bool_t system = kFALSE)
                  virtual int MakeDirectory(const char* name)
                virtual TTime Now()
                  virtual int OpenConnection(const char* server, int port, int tcpwindowsize = -1)
                virtual void* OpenDirectory(const char* name)
                 virtual void Openlog(const char* name, Int_t options, ELogFacility facility)
                virtual FILE* OpenPipe(const char* shellcmd, const char* mode)
                 TUnixSystem& operator=(const TUnixSystem&)
                  virtual int RecvBuf(int sock, void* buffer, int length)
                  virtual int RecvRaw(int sock, void* buffer, int length, int flag)
        virtual TFileHandler* RemoveFileHandler(TFileHandler* fh)
      virtual TSignalHandler* RemoveSignalHandler(TSignalHandler* sh)
              virtual TTimer* RemoveTimer(TTimer* ti)
                  virtual int Rename(const char* from, const char* to)
                 virtual void ResetSignal(ESignals sig, Bool_t reset = kTRUE)
                 virtual void ResetTimer(TTimer* ti)
                virtual Int_t Select(TList* active, Long_t timeout)
                virtual Int_t Select(TFileHandler* fh, Long_t timeout)
                  virtual int SendBuf(int sock, const void* buffer, int length)
                  virtual int SendRaw(int sock, const void* buffer, int length, int flag)
                 virtual void SetDisplay()
                 virtual void SetDynamicPath(const char* lib)
                 virtual void Setenv(const char* name, const char* value)
                virtual Int_t SetFPEMask(Int_t mask = kDefaultMask)
                 virtual void SetProgname(const char* name)
                  virtual int SetSockOpt(int sock, int option, int val)
                 virtual void ShowMembers(TMemberInspector& insp, char* parent)
                 virtual void SigAlarmInterruptsSyscalls(Bool_t set)
                 virtual void Sleep(UInt_t milliSec)
                 virtual void StackTrace()
                 virtual void Streamer(TBuffer& b)
                         void StreamerNVirtual(TBuffer& b)
                  virtual int Symlink(const char* from, const char* to)
                 virtual void Syslog(ELogLevel level, const char* mess)
          virtual const char* TempDirectory() const
                virtual FILE* TempFileName(TString& base, const char* dir = "0")
                  virtual int Umask(Int_t mask)
                  virtual int Unlink(const char* name)
                 virtual void Unload(const char* module)
                  virtual int Utime(const char* file, Long_t modtime, Long_t actime)
                virtual char* Which(const char* search, const char* file, EAccessMode mode = kFileExists)
          virtual const char* WorkingDirectory() const

Data Members

Class Description

                                                                      
 TUnixSystem                                                          
                                                                      
 Class providing an interface to the UNIX Operating System.           
                                                                      

 Reset to original state.

 Initialize Unix system interface.

 Set the application name (from command line, argv[0]) and copy it in
 gProgName. Copy the application pathname in gProgPath.

 Set DISPLAY environment variable based on utmp entry. Only for UNIX.

 Return system error string.

 Return the system's host name.

 Add a file handler to the list of system file handlers. Only adds
 the handler if it is not already in the list of file handlers.

 Remove a file handler from the list of file handlers. Returns
 the handler or 0 if the handler was not in the list of file handlers.

 Add a signal handler to list of system signal handlers. Only adds
 the handler if it is not already in the list of signal handlers.

 Remove a signal handler from list of signal handlers. Returns
 the handler or 0 if the handler was not in the list of signal handlers.

 If reset is true reset the signal handler for the specified signal
 to the default handler, else restore previous behaviour.

 If ignore is true ignore the specified signal, else restore previous
 behaviour.

 When the argument is true the SIGALRM signal handler is set so that
 interrupted syscalls will not be restarted by the kernel. This is
 typically used in case one wants to put a timeout on an I/O operation.
 By default interrupted syscalls will always be restarted (for all
 signals). This can be controlled for each a-synchronous TTimer via
 the method TTimer::SetInterruptSyscalls().

 Return the bitmap of conditions that trigger a floating point exception.

 Set which conditions trigger a floating point exception.
 Return the previous set of conditions.

 Dispatch a single event.

 Sleep milliSec milliseconds.

 Select on file descriptors. The timeout to is in millisec.

 Select on the file descriptor related to file handler h.
 The timeout to is in millisec.

 Handle and dispatch signals.

 Check if some signals were raised and call their Notify() member.

 Check if childs have finished.

 Check if there is activity on some file descriptors and call their
 Notify() member.

 Make a Unix file system directory. Returns 0 in case of success and
 -1 if the directory could not be created.

 Open a Unix file system directory. Returns 0 if directory does not exist.

 Close a Unix file system directory.

 Get next Unix file system directory entry. Returns 0 if no more entries.

 Change directory. Returns kTRUE in case of success, kFALSE otherwise.

 Return working directory.

 Return the user's home directory.

 Return a user configured or systemwide directory to create
 temporary files in.

 Create a secure temporary file by appending a unique
 6 letter string to base. The file will be created in
 a standard (system) directory or in the directory
 provided in dir. The full filename is returned in base
 and a filepointer is returned for safely writing to the file
 (this avoids certain security problems). Returns 0 in case
 of error.

 Concatenate a directory and a file name. Returned string must be
 deleted by user.

 Returns FALSE if one can access a file using the specified access mode.
 Mode is the same as for the Unix access(2) function.
 Attention, bizarre convention of return value!!

 Copy a file. If overwrite is true and file already exists the
 file will be overwritten. Returns 0 when successful, -1 in case
 of failure, -2 in case the file already exists and overwrite was false.

 Rename a file. Returns 0 when successful, -1 in case of failure.

 Get info about a file. Info is returned in the form of a FileStat_t
 structure (see TSystem.h).
 The function returns 0 in case of success and 1 if the file could
 not be stat'ed.

 Get info about a file system: id, bsize, bfree, blocks.
 Id      is file system type (machine dependend, see statfs())
 Bsize   is block size of file system
 Blocks  is total number of blocks in file system
 Bfree   is number of free blocks in file system
 The function returns 0 in case of success and 1 if the file system could
 not be stat'ed.

 Create a link from file1 to file2. Returns 0 when successful,
 -1 in case of failure.

 Create a symlink from file1 to file2. Returns 0 when succesfull,
 -1 in case of failure.

 Unlink, i.e. remove, a file or directory. Returns 0 when succesfull,
 -1 in case of failure.

 Expand a pathname getting rid of special shell characters like ~.$, etc.
 For Unix/Win32 compatibility use $(XXX) instead of $XXX when using
 environment variables in a pathname. If compatibility is not an issue
 you can use on Unix directly $XXX.

 Expand a pathname getting rid of special shell characters like ~.$, etc.
 For Unix/Win32 compatibility use $(XXX) instead of $XXX when using
 environment variables in a pathname. If compatibility is not an issue
 you can use on Unix directly $XXX.

 Expand a pathname getting rid of special shell characaters like ~.$, etc.
 For Unix/Win32 compatibility use $(XXX) instead of $XXX when using
 environment variables in a pathname. If compatibility is not an issue
 you can use on Unix directly $XXX. The user must delete returned string.

 Set the file permission bits. Returns -1 in case or error, 0 otherwise.

 Set the process file creation mode mask.

 Set a files modification and access times. If actime = 0 it will be
 set to the modtime. Returns 0 on success and -1 in case of error.

 Find location of file "wfil" in a search path.
 The search path is specified as a : separated list of directories.
 User must delete returned string. Returns 0 in case file is not found.

 Returns the user's id. If user = 0, returns current user's id.

 Returns the effective user id. The effective id corresponds to the
 set id bit on the file being executed.

 Returns the group's id. If group = 0, returns current user's group.

 Returns the effective group id. The effective group id corresponds
 to the set id bit on the file being executed.

 Returns all user info in the UserGroup_t structure. The returned
 structure must be deleted by the user. In case of error 0 is returned.

 Returns all user info in the UserGroup_t structure. If user = 0, returns
 current user's id info. The returned structure must be deleted by the
 user. In case of error 0 is returned.

 Returns all group info in the UserGroup_t structure. The only active
 fields in the UserGroup_t structure for this call are:
    fGid and fGroup
 The returned structure must be deleted by the user. In case of
 error 0 is returned.

 Returns all group info in the UserGroup_t structure. The only active
 fields in the UserGroup_t structure for this call are:
    fGid and fGroup
 If group = 0, returns current user's group. The returned structure
 must be deleted by the user. In case of error 0 is returned.

 Set environment variable. The string passed will be owned by
 the environment and can not be reused till a "name" is set
 again. The solution below will lose the space for the string
 in that case, but if this functions is not called thousands
 of times that should not be a problem.

 Get environment variable.

 Execute a command.

 Open a pipe.

 Close the pipe.

 Get process id.

 Exit the application.

 Abort the application.

 Print a stack trace.

 Open connection to system log daemon. For the use of the options and
 facility see the Unix openlog man page.

 Send mess to syslog daemon. Level is the logging level and mess the
 message that will be written on the log.

 Close connection to system log daemon.

 Load a shared library. Returns 0 on successful loading, 1 in
 case lib was already loaded and -1 in case lib does not exist
 or in case of error.

 Unload a shared library.

 List symbols in a shared library.

 List all loaded shared libraries.

 Get list of shared libraries loaded at the start of the executable.
 Returns 0 in case list cannot be obtained or in case of error.

 Return current time.

 Handle and dispatch timers. If mode = kTRUE dispatch synchronous
 timers else a-synchronous timers.

 Add timer to list of system timers.

 Remove timer from list of system timers.

 Reset a-sync timer.

 Get Internet Protocol (IP) address of host. Returns an TInetAddress
 object. To see if the hostname lookup was successfull call
 TInetAddress::IsValid().

 Get Internet Protocol (IP) address of host and port #.

 Get Internet Protocol (IP) address of remote host and port #.

 Get port # of internet service.

 Get name of internet service.

 Connect to service servicename on server servername.

 Open a connection to a service on a server. Returns -1 in case
 connection cannot be opened.
 Use tcpwindowsize to specify the size of the receive buffer, it has
 to be specified here to make sure the window scale option is set (for
 tcpwindowsize > 65KB and for platforms supporting window scaling).
 Is called via the TSocket constructor.

 Announce TCP/IP service.
 Open a socket, bind to it and start listening for TCP/IP connections
 on the port. If reuse is true reuse the address, backlog specifies
 how many sockets can be waiting to be accepted.
 Use tcpwindowsize to specify the size of the receive buffer, it has
 to be specified here to make sure the window scale option is set (for
 tcpwindowsize > 65KB and for platforms supporting window scaling).
 Returns socket fd or -1 if socket() failed, -2 if bind() failed
 or -3 if listen() failed.

 Announce unix domain service.

 Accept a connection. In case of an error return -1. In case
 non-blocking I/O is enabled and no connections are available
 return -2.

 Close socket.

 Receive a buffer headed by a length indicator. Lenght is the size of
 the buffer. Returns the number of bytes received in buf or -1 in
 case of error.

 Send a buffer headed by a length indicator. Returns length of sent buffer
 or -1 in case of error.

 Receive exactly length bytes into buffer. Use opt to receive out-of-band
 data or to have a peek at what is in the buffer (see TSocket). Buffer
 must be able to store at least length bytes. Returns the number of
 bytes received (can be 0 if other side of connection was closed) or -1
 in case of error, -2 in case of MSG_OOB and errno == EWOULDBLOCK, -3
 in case of MSG_OOB and errno == EINVAL and -4 in case of kNoBlock and
 errno == EWOULDBLOCK. Returns -5 if pipe broken or reset by peer
 (EPIPE || ECONNRESET).

 Send exactly length bytes from buffer. Use opt to send out-of-band
 data (see TSocket). Returns the number of bytes sent or -1 in case of
 error. Returns -4 in case of kNoBlock and errno == EWOULDBLOCK.
 Returns -5 if pipe broken or reset by peer (EPIPE || ECONNRESET).

 Set socket option.

 Get socket option.

 Set a signal handler for a signal.

 If ignore is true ignore the specified signal, else restore previous
 behaviour.

 When the argument is true the SIGALRM signal handler is set so that
 interrupted syscalls will not be restarted by the kernel. This is
 typically used in case one wants to put a timeout on an I/O operation.
 By default interrupted syscalls will always be restarted (for all
 signals). This can be controlled for each a-synchronous TTimer via
 the method TTimer::SetInterruptSyscalls().

 Return the signal name associated with a signal.

 Restore old signal handler for specified signal.

 Restore old signal handlers.

 Get current time in milliseconds since 0:00 Jan 1 1995.

 Set interval timer to time-out in ms milliseconds.

 Wait for events on the file descriptors specified in the readready and
 writeready masks or for timeout (in milliseconds) to occur.

 Returns the user's home directory.

 Make a Unix file system directory. Returns 0 in case of success and
 -1 if the directory could not be created (either already exists or
 illegal path name).

 Open a directory.

 Returns the next directory entry.

 Get info about a file. Info is returned in the form of a FileStat_t
 structure (see TSystem.h).
 The function returns 0 in case of success and 1 if the file could
 not be stat'ed.

 Get info about a file system: id, bsize, bfree, blocks.
 Id      is file system type (machine dependend, see statfs())
 Bsize   is block size of file system
 Blocks  is total number of blocks in file system
 Bfree   is number of free blocks in file system
 The function returns 0 in case of success and 1 if the file system could
 not be stat'ed.

 Wait till child is finished.

 Open a TCP/IP connection to server and connect to a service (i.e. port).
 Use tcpwindowsize to specify the size of the receive buffer, it has
 to be specified here to make sure the window scale option is set (for
 tcpwindowsize > 65KB and for platforms supporting window scaling).
 Is called via the TSocket constructor.

 Connect to a Unix domain socket.

 Open a socket, bind to it and start listening for TCP/IP connections
 on the port. If reuse is true reuse the address, backlog specifies
 how many sockets can be waiting to be accepted. If port is 0 a port
 scan will be done to find a free port. This option is mutual exlusive
 with the reuse option.
 Use tcpwindowsize to specify the size of the receive buffer, it has
 to be specified here to make sure the window scale option is set (for
 tcpwindowsize > 65KB and for platforms supporting window scaling).
 Returns socket fd or -1 if socket() failed, -2 if bind() failed
 or -3 if listen() failed.

 Open a socket, bind to it and start listening for Unix domain connections
 to it. Returns socket fd or -1.

 Receive exactly length bytes into buffer. Returns number of bytes
 received. Returns -1 in case of error, -2 in case of MSG_OOB
 and errno == EWOULDBLOCK, -3 in case of MSG_OOB and errno == EINVAL
 and -4 in case of kNoBlock and errno == EWOULDBLOCK.
 Returns -5 if pipe broken or reset by peer (EPIPE || ECONNRESET).

 Send exactly length bytes from buffer. Returns -1 in case of error,
 otherwise number of sent bytes. Returns -4 in case of kNoBlock and
 errno == EWOULDBLOCK. Returns -5 if pipe broken or reset by peer
 (EPIPE || ECONNRESET).

 Return the dynamic path (used to find shared libraries).

 Set the dynamic path to a new value.
 If the value of 'path' is zero, the dynamic path is reset to its
 default value.

 Returns the path of a shared library (searches for library in the
 shared library search path). If no file name extension is provided
 it first tries .so, .sl, .dl and then .a (for AIX). The returned string
 must be deleted.

 Returns the handle to a loaded shared library. Returns 0 when library
 not loaded.

 Load a shared library. Returns 0 on successful loading, 1 in
 case lib was already loaded and -1 in case lib does not exist
 or in case of error.

 Finds and returns a function pointer to a symbol in the shared library.
 Returns 0 when symbol not found.

 List symbols in a shared library. One can use wildcards to list only
 the interesting symbols.

 List all loaded shared libraries.

 Unload a shared library.

 Read utmp file. Returns number of entries in utmp file.

 Look for utmp entry which is connected to terminal tty.

Inline Functions

             TClass* Class()
             TClass* IsA() const
                void ShowMembers(TMemberInspector& insp, char* parent)
                void Streamer(TBuffer& b)
                void StreamerNVirtual(TBuffer& b)
         TUnixSystem TUnixSystem(const TUnixSystem&)
        TUnixSystem& operator=(const TUnixSystem&)