Logo ROOT  
Reference Guide
TUnixSystem.h
Go to the documentation of this file.
1// @(#)root/unix:$Id$
2// Author: Fons Rademakers 15/09/95
3
4/*************************************************************************
5 * Copyright (C) 1995-2000, Rene Brun and Fons Rademakers. *
6 * All rights reserved. *
7 * *
8 * For the licensing terms see $ROOTSYS/LICENSE. *
9 * For the list of contributors see $ROOTSYS/README/CREDITS. *
10 *************************************************************************/
11
12#ifndef ROOT_TUnixSystem
13#define ROOT_TUnixSystem
14
15
16//////////////////////////////////////////////////////////////////////////
17// //
18// TUnixSystem //
19// //
20// Class providing an interface to the UNIX Operating System. //
21// //
22//////////////////////////////////////////////////////////////////////////
23
24#include "TSystem.h"
25#include "TSysEvtHandler.h"
26#include "TTimer.h"
27#include <string>
28
30
31
32class TUnixSystem : public TSystem {
33
34private:
35 void FillWithCwd(char *cwd) const;
36
37protected:
38 const char *GetLinkedLibraries() override;
39
40 // static functions providing semi-low level interface to raw Unix
41 static int UnixMakedir(const char *name);
42 static void *UnixOpendir(const char *name);
43 static const char *UnixGetdirentry(void *dir);
44 static const char *UnixHomedirectory(const char *user = nullptr);
45 static const char *UnixHomedirectory(const char *user, char *path, char *mydir);
46 static Long64_t UnixNow();
47 static int UnixWaitchild();
48 static int UnixSetitimer(Long_t ms);
49 static int UnixSelect(Int_t nfds, TFdSet *readready, TFdSet *writeready,
50 Long_t timeout);
51 static void UnixSignal(ESignals sig, SigHandler_t h);
52 static const char *UnixSigname(ESignals sig);
54 static void UnixResetSignal(ESignals sig);
55 static void UnixResetSignals();
56 static void UnixIgnoreSignal(ESignals sig, Bool_t ignore);
57 static int UnixFilestat(const char *path, FileStat_t &buf);
58 static int UnixFSstat(const char *path, Long_t *id, Long_t *bsize,
59 Long_t *blocks, Long_t *bfree);
60 static int UnixTcpConnect(const char *hostname, int port, int tcpwindowsize);
61 static int UnixUdpConnect(const char *hostname, int port);
62 static int UnixUnixConnect(int port);
63 static int UnixUnixConnect(const char *path);
64 static int UnixTcpService(int port, Bool_t reuse, int backlog,
65 int tcpwindowsize);
66 static int UnixUdpService(int port, int backlog);
67 static int UnixUnixService(int port, int backlog);
68 static int UnixUnixService(const char *sockpath, int backlog);
69 static int UnixRecv(int sock, void *buf, int len, int flag);
70 static int UnixSend(int sock, const void *buf, int len, int flag);
71
72public:
74 virtual ~TUnixSystem();
75
76 //---- Misc -------------------------------------------------
77 Bool_t Init() override;
78 void SetProgname(const char *name) override;
79 void SetDisplay() override;
80 const char *GetError() override;
81 const char *HostName() override;
82
83 //---- EventLoop --------------------------------------------
84 void DispatchOneEvent(Bool_t pendingOnly = kFALSE) override;
85 Int_t Select(TList *active, Long_t timeout) override;
86 Int_t Select(TFileHandler *fh, Long_t timeout) override;
87
88 //---- Handling of system events ----------------------------
89 void CheckChilds();
92 void DispatchSignals(ESignals sig);
93 void AddSignalHandler(TSignalHandler *sh) override;
95 void ResetSignal(ESignals sig, Bool_t reset = kTRUE) override;
96 void ResetSignals() override;
97 void IgnoreSignal(ESignals sig, Bool_t ignore = kTRUE) override;
98 void SigAlarmInterruptsSyscalls(Bool_t set) override;
99 void AddFileHandler(TFileHandler *fh) override;
101
102 //---- Floating Point Exceptions Control --------------------
103 Int_t GetFPEMask() override;
104 Int_t SetFPEMask(Int_t mask = kDefaultMask) override;
105
106 //---- Time & Date ------------------------------------------
107 TTime Now() override;
108 void AddTimer(TTimer *ti) override;
109 TTimer *RemoveTimer(TTimer *ti) override;
110 void ResetTimer(TTimer *ti) override;
112 void Sleep(UInt_t milliSec) override;
113
114 //---- Processes --------------------------------------------
115 Int_t Exec(const char *shellcmd) override;
116 FILE *OpenPipe(const char *shellcmd, const char *mode) override;
117 int ClosePipe(FILE *pipe) override;
118 void Exit(int code, Bool_t mode = kTRUE) override;
119 void Abort(int code = 0) override;
120 int GetPid() override;
121 void StackTrace() override;
122
123 //---- Directories ------------------------------------------
124 int MakeDirectory(const char *name) override;
125 void *OpenDirectory(const char *name) override;
126 void FreeDirectory(void *dirp) override;
127 const char *GetDirEntry(void *dirp) override;
128 Bool_t ChangeDirectory(const char *path) override;
129 const char *WorkingDirectory() override;
130 std::string GetWorkingDirectory() const override;
131 const char *HomeDirectory(const char *userName = nullptr) override;
132 std::string GetHomeDirectory(const char *userName = nullptr) const override;
133 const char *TempDirectory() const override;
134 FILE *TempFileName(TString &base, const char *dir = nullptr) override;
135
136 //---- Paths & Files ----------------------------------------
137 const char *PrependPathName(const char *dir, TString& name) override;
138 Bool_t ExpandPathName(TString &patbuf) override;
139 char *ExpandPathName(const char *path) override;
140 Bool_t AccessPathName(const char *path, EAccessMode mode = kFileExists) override;
141 Bool_t IsPathLocal(const char *path) override;
142 int CopyFile(const char *from, const char *to, Bool_t overwrite = kFALSE) override;
143 int Rename(const char *from, const char *to) override;
144 int Link(const char *from, const char *to) override;
145 int Symlink(const char *from, const char *to) override;
146 int Unlink(const char *name) override;
147 int GetPathInfo(const char *path, FileStat_t &buf) override;
148 int GetFsInfo(const char *path, Long_t *id, Long_t *bsize,
149 Long_t *blocks, Long_t *bfree) override;
150 int Chmod(const char *file, UInt_t mode) override;
151 int Umask(Int_t mask) override;
152 int Utime(const char *file, Long_t modtime, Long_t actime) override;
153 const char *FindFile(const char *search, TString& file, EAccessMode mode = kFileExists) override;
154
155 //---- Users & Groups ---------------------------------------
156 Int_t GetUid(const char *user = nullptr) override;
157 Int_t GetGid(const char *group = nullptr) override;
158 Int_t GetEffectiveUid() override;
159 Int_t GetEffectiveGid() override;
160 UserGroup_t *GetUserInfo(Int_t uid) override;
161 UserGroup_t *GetUserInfo(const char *user = nullptr) override;
162 UserGroup_t *GetGroupInfo(Int_t gid) override;
163 UserGroup_t *GetGroupInfo(const char *group = nullptr) override;
164
165 //---- Environment Manipulation -----------------------------
166 const char *Getenv(const char *name) override;
167 void Setenv(const char *name, const char *value) override;
168 void Unsetenv(const char *name) override;
169
170 //---- System Logging ---------------------------------------
171 void Openlog(const char *name, Int_t options, ELogFacility facility) override;
172 void Syslog(ELogLevel level, const char *mess) override;
173 void Closelog() override;
174
175 //---- Standard Output redirection --------------------------
176 Int_t RedirectOutput(const char *name, const char *mode = "a",
177 RedirectHandle_t *h = nullptr) override;
178
179 //---- Dynamic Loading --------------------------------------
180 void AddDynamicPath(const char *lib) override;
181 const char *GetDynamicPath() override;
182 void SetDynamicPath(const char *lib) override;
183 const char *FindDynamicLibrary(TString &lib, Bool_t quiet = kFALSE) override;
184 Func_t DynFindSymbol(const char *module, const char *entry) override;
185 int Load(const char *module, const char *entry = "", Bool_t system = kFALSE) override;
186 void Unload(const char *module) override;
187 void ListSymbols(const char *module, const char *re = "") override;
188 void ListLibraries(const char *regexp = "") override;
189
190 //---- RPC --------------------------------------------------
191 TInetAddress GetHostByName(const char *server) override;
192 TInetAddress GetPeerName(int sock) override;
193 TInetAddress GetSockName(int sock) override;
194 int GetServiceByName(const char *service) override;
195 char *GetServiceByPort(int port) override;
196 int ConnectService(const char *server, int port, int tcpwindowsize, const char *protocol = "tcp");
197 int OpenConnection(const char *server, int port, int tcpwindowsize = -1, const char *protocol = "tcp") override;
198 int AnnounceTcpService(int port, Bool_t reuse, int backlog, int tcpwindowsize = -1) override;
199 int AnnounceUdpService(int port, int backlog) override;
200 int AnnounceUnixService(int port, int backlog) override;
201 int AnnounceUnixService(const char *sockpath, int backlog) override;
202 int AcceptConnection(int sock) override;
203 void CloseConnection(int sock, Bool_t force = kFALSE) override;
204 int RecvRaw(int sock, void *buffer, int length, int flag) override;
205 int SendRaw(int sock, const void *buffer, int length, int flag) override;
206 int RecvBuf(int sock, void *buffer, int length) override;
207 int SendBuf(int sock, const void *buffer, int length) override;
208 int SetSockOpt(int sock, int option, int val) override;
209 int GetSockOpt(int sock, int option, int *val) override;
210
211 //---- System, CPU and Memory info
212 int GetSysInfo(SysInfo_t *info) const override;
213 int GetCpuInfo(CpuInfo_t *info, Int_t sampleTime = 1000) const override;
214 int GetMemInfo(MemInfo_t *info) const override;
215 int GetProcInfo(ProcInfo_t *info) const override;
216
217 ClassDefOverride(TUnixSystem,0) //Interface to Unix OS services
218};
219
220#endif
typedef void(GLAPIENTRYP _GLUfuncptr)(void)
#define h(i)
Definition: RSha256.hxx:106
int Int_t
Definition: RtypesCore.h:45
unsigned int UInt_t
Definition: RtypesCore.h:46
const Bool_t kFALSE
Definition: RtypesCore.h:101
long Long_t
Definition: RtypesCore.h:54
bool Bool_t
Definition: RtypesCore.h:63
long long Long64_t
Definition: RtypesCore.h:80
const Bool_t kTRUE
Definition: RtypesCore.h:100
#define ClassDefOverride(name, id)
Definition: Rtypes.h:329
char name[80]
Definition: TGX11.cxx:110
ESignals
void(* Func_t)()
Definition: TSystem.h:238
EAccessMode
Definition: TSystem.h:43
@ kFileExists
Definition: TSystem.h:44
ELogFacility
Definition: TSystem.h:66
ELogLevel
Definition: TSystem.h:55
@ kDefaultMask
Definition: TSystem.h:84
void(* SigHandler_t)(ESignals)
Definition: TUnixSystem.h:29
This class represents an Internet Protocol (IP) address.
Definition: TInetAddress.h:36
A doubly linked list.
Definition: TList.h:44
Basic string class.
Definition: TString.h:136
Abstract base class defining a generic interface to the underlying Operating System.
Definition: TSystem.h:266
Basic time type with millisecond precision.
Definition: TTime.h:27
Handles synchronous and a-synchronous timer events.
Definition: TTimer.h:51
void AddTimer(TTimer *ti) override
Add timer to list of system timers.
int RecvRaw(int sock, void *buffer, int length, int flag) override
Receive exactly length bytes into buffer.
int OpenConnection(const char *server, int port, int tcpwindowsize=-1, const char *protocol="tcp") override
Open a connection to a service on a server.
int GetMemInfo(MemInfo_t *info) const override
Returns ram and swap memory usage info into the MemInfo_t structure.
Bool_t IsPathLocal(const char *path) override
Returns TRUE if the url in 'path' points to the local file system.
int Symlink(const char *from, const char *to) override
Create a symlink from file1 to file2.
const char * HomeDirectory(const char *userName=nullptr) override
Return the user's home directory.
Int_t GetGid(const char *group=nullptr) override
Returns the group's id. If group = 0, returns current user's group.
static int UnixUdpConnect(const char *hostname, int port)
Creates a UDP socket connection Is called via the TSocket constructor.
int CopyFile(const char *from, const char *to, Bool_t overwrite=kFALSE) override
Copy a file.
TTimer * RemoveTimer(TTimer *ti) override
Remove timer from list of system timers.
int AnnounceUdpService(int port, int backlog) override
Announce UDP service.
int AnnounceUnixService(int port, int backlog) override
Announce unix domain service on path "kServerPath/<port>".
static int UnixTcpConnect(const char *hostname, int port, int tcpwindowsize)
Open a TCP/IP connection to server and connect to a service (i.e.
Int_t SetFPEMask(Int_t mask=kDefaultMask) override
Set which conditions trigger a floating point exception.
static const char * UnixGetdirentry(void *dir)
Returns the next directory entry.
void Setenv(const char *name, const char *value) override
Set environment variable.
int ConnectService(const char *server, int port, int tcpwindowsize, const char *protocol="tcp")
Connect to service servicename on server servername.
Bool_t ChangeDirectory(const char *path) override
Change directory. Returns kTRUE in case of success, kFALSE otherwise.
static const char * UnixHomedirectory(const char *user=nullptr)
Returns the user's home directory.
char * GetServiceByPort(int port) override
Get name of internet service.
Bool_t CheckSignals(Bool_t sync)
Check if some signals were raised and call their Notify() member.
static int UnixMakedir(const char *name)
Make a Unix file system directory.
static void UnixSigAlarmInterruptsSyscalls(Bool_t set)
When the argument is true the SIGALRM signal handler is set so that interrupted syscalls will not be ...
Int_t GetFPEMask() override
Return the bitmap of conditions that trigger a floating point exception.
static int UnixUnixConnect(int port)
Connect to a Unix domain socket.
int GetSysInfo(SysInfo_t *info) const override
Returns static system info, like OS type, CPU type, number of CPUs RAM size, etc into the SysInfo_t s...
void Exit(int code, Bool_t mode=kTRUE) override
Exit the application.
int AnnounceTcpService(int port, Bool_t reuse, int backlog, int tcpwindowsize=-1) override
Announce TCP/IP service.
void AddDynamicPath(const char *lib) override
Add a new directory to the dynamic path.
void SetDynamicPath(const char *lib) override
Set the dynamic path to a new value.
int ClosePipe(FILE *pipe) override
Close the pipe.
std::string GetHomeDirectory(const char *userName=nullptr) const override
Return the user's home directory.
Int_t Select(TList *active, Long_t timeout) override
Select on file descriptors.
void Unsetenv(const char *name) override
Unset environment variable.
virtual ~TUnixSystem()
Reset to original state.
void Abort(int code=0) override
Abort the application.
void Syslog(ELogLevel level, const char *mess) override
Send mess to syslog daemon.
UserGroup_t * GetGroupInfo(Int_t gid) override
Returns all group info in the UserGroup_t structure.
Int_t GetUid(const char *user=nullptr) override
Returns the user's id. If user = 0, returns current user's id.
Bool_t ExpandPathName(TString &patbuf) override
Expand a pathname getting rid of special shell characters like ~.
void Openlog(const char *name, Int_t options, ELogFacility facility) override
Open connection to system log daemon.
int AcceptConnection(int sock) override
Accept a connection.
TTime Now() override
Get current time in milliseconds since 0:00 Jan 1 1995.
static void UnixResetSignal(ESignals sig)
Restore old signal handler for specified signal.
int GetServiceByName(const char *service) override
Get port # of internet service.
const char * FindFile(const char *search, TString &file, EAccessMode mode=kFileExists) override
Find location of file "wfil" in a search path.
void SigAlarmInterruptsSyscalls(Bool_t set) override
When the argument is true the SIGALRM signal handler is set so that interrupted syscalls will not be ...
static int UnixUdpService(int port, int backlog)
Open a socket, bind to it and start listening for UDP connections on the port.
int Utime(const char *file, Long_t modtime, Long_t actime) override
Set a files modification and access times.
const char * GetLinkedLibraries() override
Get list of shared libraries loaded at the start of the executable.
FILE * TempFileName(TString &base, const char *dir=nullptr) override
Create a secure temporary file by appending a unique 6 letter string to base.
const char * GetError() override
Return system error string.
std::string GetWorkingDirectory() const override
Return working directory.
Bool_t AccessPathName(const char *path, EAccessMode mode=kFileExists) override
Returns FALSE if one can access a file using the specified access mode.
void DispatchOneEvent(Bool_t pendingOnly=kFALSE) override
Dispatch a single event.
int Chmod(const char *file, UInt_t mode) override
Set the file permission bits. Returns -1 in case or error, 0 otherwise.
const char * PrependPathName(const char *dir, TString &name) override
Concatenate a directory and a file name.
Bool_t DispatchTimers(Bool_t mode)
Handle and dispatch timers.
void IgnoreSignal(ESignals sig, Bool_t ignore=kTRUE) override
If ignore is true ignore the specified signal, else restore previous behaviour.
void ListSymbols(const char *module, const char *re="") override
List symbols in a shared library.
int Load(const char *module, const char *entry="", Bool_t system=kFALSE) override
Load a shared library.
void StackTrace() override
Print a stack trace.
TInetAddress GetHostByName(const char *server) override
Get Internet Protocol (IP) address of host.
int SendBuf(int sock, const void *buffer, int length) override
Send a buffer headed by a length indicator.
const char * HostName() override
Return the system's host name.
void CheckChilds()
Check if children have finished.
int RecvBuf(int sock, void *buffer, int length) override
Receive a buffer headed by a length indicator.
static int UnixUnixService(int port, int backlog)
Open a socket, bind to it and start listening for Unix domain connections to it.
UserGroup_t * GetUserInfo(Int_t uid) override
Returns all user info in the UserGroup_t structure.
void SetDisplay() override
Set DISPLAY environment variable based on utmp entry. Only for UNIX.
TFileHandler * RemoveFileHandler(TFileHandler *fh) override
Remove a file handler from the list of file handlers.
static const char * UnixSigname(ESignals sig)
Return the signal name associated with a signal.
static Long64_t UnixNow()
Get current time in milliseconds since 0:00 Jan 1 1995.
static int UnixFSstat(const char *path, Long_t *id, Long_t *bsize, Long_t *blocks, Long_t *bfree)
Get info about a file system: id, bsize, bfree, blocks.
void ResetSignals() override
Reset signals handlers to previous behaviour.
TInetAddress GetSockName(int sock) override
Get Internet Protocol (IP) address of host and port #.
int Link(const char *from, const char *to) override
Create a link from file1 to file2.
int GetProcInfo(ProcInfo_t *info) const override
Returns cpu and memory used by this process into the ProcInfo_t structure.
int SetSockOpt(int sock, int option, int val) override
Set socket option.
static int UnixSetitimer(Long_t ms)
Set interval timer to time-out in ms milliseconds.
static int UnixSend(int sock, const void *buf, int len, int flag)
Send exactly length bytes from buffer.
TInetAddress GetPeerName(int sock) override
Get Internet Protocol (IP) address of remote host and port #.
static void UnixIgnoreSignal(ESignals sig, Bool_t ignore)
If ignore is true ignore the specified signal, else restore previous behaviour.
static int UnixTcpService(int port, Bool_t reuse, int backlog, int tcpwindowsize)
Open a socket, bind to it and start listening for TCP/IP connections on the port.
void DispatchSignals(ESignals sig)
Handle and dispatch signals.
void AddFileHandler(TFileHandler *fh) override
Add a file handler to the list of system file handlers.
void * OpenDirectory(const char *name) override
Open a Unix file system directory. Returns 0 if directory does not exist.
int Rename(const char *from, const char *to) override
Rename a file. Returns 0 when successful, -1 in case of failure.
const char * Getenv(const char *name) override
Get environment variable.
int GetPathInfo(const char *path, FileStat_t &buf) override
Get info about a file.
Int_t GetEffectiveGid() override
Returns the effective group id.
static int UnixSelect(Int_t nfds, TFdSet *readready, TFdSet *writeready, Long_t timeout)
Wait for events on the file descriptors specified in the readready and writeready masks or for timeou...
int GetPid() override
Get process id.
Int_t Exec(const char *shellcmd) override
Execute a command.
void ResetTimer(TTimer *ti) override
Reset a-sync timer.
TSignalHandler * RemoveSignalHandler(TSignalHandler *sh) override
Remove a signal handler from list of signal handlers.
static void UnixSignal(ESignals sig, SigHandler_t h)
Set a signal handler for a signal.
void CloseConnection(int sock, Bool_t force=kFALSE) override
Close socket.
Bool_t CheckDescriptors()
Check if there is activity on some file descriptors and call their Notify() member.
Bool_t Init() override
Initialize Unix system interface.
void Unload(const char *module) override
Unload a shared library.
int Umask(Int_t mask) override
Set the process file creation mode mask.
static int UnixFilestat(const char *path, FileStat_t &buf)
Get info about a file.
static int UnixRecv(int sock, void *buf, int len, int flag)
Receive exactly length bytes into buffer.
Int_t GetEffectiveUid() override
Returns the effective user id.
void FillWithCwd(char *cwd) const
Fill buffer with current working directory.
static int UnixWaitchild()
Wait till child is finished.
int Unlink(const char *name) override
Unlink, i.e.
void ListLibraries(const char *regexp="") override
List all loaded shared libraries.
void Closelog() override
Close connection to system log daemon.
Int_t RedirectOutput(const char *name, const char *mode="a", RedirectHandle_t *h=nullptr) override
Redirect standard output (stdout, stderr) to the specified file.
void Sleep(UInt_t milliSec) override
Sleep milliSec milliseconds.
void ResetSignal(ESignals sig, Bool_t reset=kTRUE) override
If reset is true reset the signal handler for the specified signal to the default handler,...
const char * TempDirectory() const override
Return a user configured or systemwide directory to create temporary files in.
Func_t DynFindSymbol(const char *module, const char *entry) override
dynamic linking of module
const char * GetDynamicPath() override
Return the dynamic path (used to find shared libraries).
FILE * OpenPipe(const char *shellcmd, const char *mode) override
Open a pipe.
void FreeDirectory(void *dirp) override
Close a Unix file system directory.
static void UnixResetSignals()
Restore old signal handlers.
int GetCpuInfo(CpuInfo_t *info, Int_t sampleTime=1000) const override
Returns cpu load average and load info into the CpuInfo_t structure.
void AddSignalHandler(TSignalHandler *sh) override
Add a signal handler to list of system signal handlers.
static void * UnixOpendir(const char *name)
Open a directory.
int SendRaw(int sock, const void *buffer, int length, int flag) override
Send exactly length bytes from buffer.
const char * WorkingDirectory() override
Return working directory.
int GetSockOpt(int sock, int option, int *val) override
Get socket option.
const char * FindDynamicLibrary(TString &lib, Bool_t quiet=kFALSE) override
Returns the path of a shared library (searches for library in the shared library search path).
void SetProgname(const char *name) override
Set the application name (from command line, argv[0]) and copy it in gProgName.
const char * GetDirEntry(void *dirp) override
Get next Unix file system directory entry. Returns 0 if no more entries.
int MakeDirectory(const char *name) override
Make a Unix file system directory.
int GetFsInfo(const char *path, Long_t *id, Long_t *bsize, Long_t *blocks, Long_t *bfree) override
Get info about a file system: id, bsize, bfree, blocks.
static constexpr double ms
Definition: file.py:1