Logo ROOT  
Reference Guide
No Matches
Go to the documentation of this file.
1// @(#)root/net:$Id$
2// Author: Fons Rademakers 18/12/96
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 *************************************************************************/
12#ifndef ROOT_TSocket
13#define ROOT_TSocket
17// //
18// TSocket //
19// //
20// This class implements client sockets. A socket is an endpoint for //
21// communication between two machines. //
22// The actual work is done via the TSystem class (either TUnixSystem, //
23// or TWinNTSystem). //
24// //
27#include "TSystem.h"
28#include "Compression.h"
29#include "TNamed.h"
30#include "TBits.h"
31#include "TInetAddress.h"
32#include "MessageTypes.h"
33#include "TVirtualAuth.h"
34#include "TSecContext.h"
35#include "TTimeStamp.h"
36#include "TVirtualMutex.h"
38class TMessage;
39class THostAuth;
41class TSocket : public TNamed {
43friend class TServerSocket;
44friend class TProofServ; // to be able to call SetDescriptor(), RecvHostAuth()
45friend class TSlave; // to be able to call SendHostAuth()
48 enum EStatusBits { kIsUnix = BIT(16), // set if unix socket
49 kBrokenConn = BIT(17) // set if conn reset by peer or broken
50 };
51 enum EInterest { kRead = 1, kWrite = 2 };
58 };
59 TInetAddress fAddress; // remote internet address and port #
60 UInt_t fBytesRecv; // total bytes received over this socket
61 UInt_t fBytesSent; // total bytes sent using this socket
62 Int_t fCompress; // Compression level and algorithm
63 TInetAddress fLocalAddress; // local internet address and port #
64 Int_t fRemoteProtocol; // protocol of remote daemon
65 TSecContext *fSecContext; // after a successful Authenticate call
66 // points to related security context
67 TString fService; // name of service (matches remote port #)
68 EServiceType fServType; // remote service type
69 Int_t fSocket; // socket descriptor
70 Int_t fTcpWindowSize; // TCP window size (default 65535);
71 TString fUrl; // needs this for special authentication options
72 TBits fBitsInfo; // bits array to mark TStreamerInfo classes already sent
73 TList *fUUIDs; // list of TProcessIDs already sent through the socket
75 TVirtualMutex *fLastUsageMtx; // Protect last usage setting / reading
76 TTimeStamp fLastUsage; // Time stamp of last usage
78 static ULong64_t fgBytesRecv; // total bytes received by all socket objects
79 static ULong64_t fgBytesSent; // total bytes sent by all socket objects
81 static Int_t fgClientProtocol; // client "protocol" version
83 TSocket() : fAddress(), fBytesRecv(0), fBytesSent(0), fCompress(ROOT::RCompressionSetting::EAlgorithm::kUseGlobal),
86 fBitsInfo(), fUUIDs(nullptr), fLastUsageMtx(nullptr), fLastUsage() {}
88 Bool_t Authenticate(const char *user);
89 void SetDescriptor(Int_t desc) { fSocket = desc; }
90 void SendStreamerInfos(const TMessage &mess);
92 void SendProcessIDs(const TMessage &mess);
97 TSocket& operator=(const TSocket &) = delete;
98 Option_t *GetOption() const override { return TObject::GetOption(); }
101 TSocket(TInetAddress address, const char *service, Int_t tcpwindowsize = -1);
102 TSocket(TInetAddress address, Int_t port, Int_t tcpwindowsize = -1);
103 TSocket(const char *host, const char *service, Int_t tcpwindowsize = -1);
104 TSocket(const char *host, Int_t port, Int_t tcpwindowsize = -1);
105 TSocket(const char *sockpath);
106 TSocket(Int_t descriptor);
107 TSocket(Int_t descriptor, const char *sockpath);
108 TSocket(const TSocket &s);
109 virtual ~TSocket() { Close(); }
111 virtual void Close(Option_t *opt="");
112 virtual Int_t GetDescriptor() const { return fSocket; }
115 Int_t GetPort() const { return fAddress.GetPort(); }
116 const char *GetService() const { return fService; }
117 Int_t GetServType() const { return (Int_t)fServType; }
118 virtual Int_t GetLocalPort();
119 UInt_t GetBytesSent() const { return fBytesSent; }
120 UInt_t GetBytesRecv() const { return fBytesRecv; }
124 Int_t GetErrorCode() const;
125 virtual Int_t GetOption(ESockOptions opt, Int_t &val);
130 const char *GetUrl() const { return fUrl.Data(); }
131 virtual Bool_t IsAuthenticated() const { return fSecContext ? kTRUE : kFALSE; }
132 virtual Bool_t IsValid() const { return fSocket < 0 ? kFALSE : kTRUE; }
133 virtual Int_t Recv(TMessage *&mess);
134 virtual Int_t Recv(Int_t &status, Int_t &kind);
135 virtual Int_t Recv(char *mess, Int_t max);
136 virtual Int_t Recv(char *mess, Int_t max, Int_t &kind);
137 virtual Int_t RecvRaw(void *buffer, Int_t length, ESendRecvOptions opt = kDefault);
138 virtual Int_t Reconnect() { return -1; }
139 virtual Int_t Select(Int_t interest = kRead, Long_t timeout = -1);
140 virtual Int_t Send(const TMessage &mess);
141 virtual Int_t Send(Int_t kind);
142 virtual Int_t Send(Int_t status, Int_t kind);
143 virtual Int_t Send(const char *mess, Int_t kind = kMESS_STRING);
144 virtual Int_t SendObject(const TObject *obj, Int_t kind = kMESS_OBJECT);
145 virtual Int_t SendRaw(const void *buffer, Int_t length,
150 virtual Int_t SetOption(ESockOptions opt, Int_t val);
151 void SetRemoteProtocol(Int_t rproto) { fRemoteProtocol = rproto; }
153 void SetService(const char *service) { fService = service; }
155 void SetUrl(const char *url) { fUrl = url; }
159 static Int_t GetClientProtocol();
164 static TSocket *CreateAuthSocket(const char *user, const char *host,
165 Int_t port, Int_t size = 0,
166 Int_t tcpwindowsize = -1, TSocket *s = nullptr, Int_t *err = nullptr);
167 static TSocket *CreateAuthSocket(const char *url, Int_t size = 0,
168 Int_t tcpwindowsize = -1, TSocket *s = nullptr, Int_t *err = nullptr);
169 static void NetError(const char *where, Int_t error);
171 ClassDefOverride(TSocket,0) //This class implements client sockets
177 return (fCompress < 0) ? -1 : fCompress / 100;
183 return (fCompress < 0) ? -1 : fCompress % 100;
189 return (fCompress < 0) ? -1 : fCompress;
size_t size(const MatrixT &matrix)
retrieve the size of a square matrix
bool Bool_t
Definition RtypesCore.h:63
int Int_t
Definition RtypesCore.h:45
long Long_t
Definition RtypesCore.h:54
constexpr Bool_t kFALSE
Definition RtypesCore.h:101
unsigned long long ULong64_t
Definition RtypesCore.h:81
constexpr Bool_t kTRUE
Definition RtypesCore.h:100
const char Option_t
Definition RtypesCore.h:66
#define BIT(n)
Definition Rtypes.h:85
#define ClassDefOverride(name, id)
Definition Rtypes.h:341
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t Float_t Float_t Float_t Int_t Int_t UInt_t UInt_t Rectangle_t Int_t Int_t Window_t TString Int_t GCValues_t GetPrimarySelectionOwner GetDisplay GetScreen GetColormap GetNativeEvent const char const char dpyName wid window const char font_name cursor keysym reg const char only_if_exist regb h Point_t winding char text const char depth char const char Int_t count const char ColorStruct_t color const char Pixmap_t Pixmap_t PictureAttributes_t attr const char char ret_data h unsigned char height h length
Definition TSystem.h:215
Definition TSystem.h:228
@ kDefault
Definition TSystem.h:229
#define R__LOCKGUARD2(mutex)
Container of bits.
Definition TBits.h:26
This class represents an Internet Protocol (IP) address.
Int_t GetPort() const
A doubly linked list.
Definition TList.h:38
The TNamed class is the base class for all named ROOT classes.
Definition TNamed.h:29
Mother of all ROOT objects.
Definition TObject.h:41
virtual Option_t * GetOption() const
Definition TObject.h:139
Class providing the PROOF server.
Definition TProofServ.h:66
Class describing a PROOF worker server.
Definition TSlave.h:46
TInetAddress fAddress
Definition TSocket.h:59
Int_t fCompress
Definition TSocket.h:62
virtual Int_t SetOption(ESockOptions opt, Int_t val)
Set socket options.
Definition TSocket.cxx:1013
Int_t fSocket
Definition TSocket.h:69
Int_t GetErrorCode() const
Returns error code.
Definition TSocket.cxx:1035
void SetServType(Int_t st)
Definition TSocket.h:154
TVirtualMutex * fLastUsageMtx
Definition TSocket.h:75
UInt_t GetBytesRecv() const
Definition TSocket.h:120
void SetRemoteProtocol(Int_t rproto)
Definition TSocket.h:151
void SetCompressionLevel(Int_t level=ROOT::RCompressionSetting::ELevel::kUseMin)
See comments for function SetCompressionSettings.
Definition TSocket.cxx:1060
void SendStreamerInfos(const TMessage &mess)
Check if TStreamerInfo must be sent.
Definition TSocket.cxx:649
Definition TSocket.h:55
@ kInvalidStillInList
Definition TSocket.h:57
@ kInvalid
Definition TSocket.h:56
TString fUrl
Definition TSocket.h:71
const char * GetService() const
Definition TSocket.h:116
void SetCompressionAlgorithm(Int_t algorithm=ROOT::RCompressionSetting::EAlgorithm::kUseGlobal)
See comments for function SetCompressionSettings.
Definition TSocket.cxx:1046
Definition TSocket.h:83
static ULong64_t GetSocketBytesSent()
Get total number of bytes sent via all sockets.
Definition TSocket.cxx:1489
TTimeStamp GetLastUsage()
Definition TSocket.h:129
TString fService
Definition TSocket.h:67
Bool_t RecvStreamerInfos(TMessage *mess)
Receive a message containing streamer infos.
Definition TSocket.cxx:928
Definition TSocket.h:51
@ kRead
Definition TSocket.h:51
@ kWrite
Definition TSocket.h:51
virtual Int_t Recv(TMessage *&mess)
Receive a TMessage object.
Definition TSocket.cxx:818
TList * fUUIDs
Definition TSocket.h:73
static Int_t GetClientProtocol()
Static method returning supported client protocol.
Definition TSocket.cxx:1469
TBits fBitsInfo
Definition TSocket.h:72
void SetService(const char *service)
Definition TSocket.h:153
Int_t GetRemoteProtocol() const
Definition TSocket.h:126
UInt_t GetBytesSent() const
Definition TSocket.h:119
Bool_t Authenticate(const char *user)
Authenticated the socket with specified user.
Definition TSocket.cxx:1106
TInetAddress fLocalAddress
Definition TSocket.h:63
Int_t GetTcpWindowSize() const
Definition TSocket.h:128
static ULong64_t fgBytesRecv
Definition TSocket.h:78
Definition TSocket.h:48
@ kIsUnix
Definition TSocket.h:48
@ kBrokenConn
Definition TSocket.h:49
virtual void Close(Option_t *opt="")
Close the socket.
Definition TSocket.cxx:389
void MarkBrokenConnection()
Close the socket and mark as due to a broken connection.
Definition TSocket.cxx:371
void Touch()
Definition TSocket.h:157
Bool_t RecvProcessIDs(TMessage *mess)
Receive a message containing process ids.
Definition TSocket.cxx:975
void SetUrl(const char *url)
Definition TSocket.h:155
TInetAddress GetInetAddress() const
Definition TSocket.h:113
Int_t GetCompressionLevel() const
Definition TSocket.h:181
virtual Int_t RecvRaw(void *buffer, Int_t length, ESendRecvOptions opt=kDefault)
Receive a raw buffer of specified length bytes.
Definition TSocket.cxx:898
TSecContext * GetSecContext() const
Definition TSocket.h:127
static ULong64_t fgBytesSent
Definition TSocket.h:79
virtual Int_t SendRaw(const void *buffer, Int_t length, ESendRecvOptions opt=kDefault)
Send a raw buffer of specified length.
Definition TSocket.cxx:620
TTimeStamp fLastUsage
Definition TSocket.h:76
void SendProcessIDs(const TMessage &mess)
Check if TProcessIDs must be sent.
Definition TSocket.cxx:684
static Int_t fgClientProtocol
Definition TSocket.h:81
virtual TInetAddress GetLocalInetAddress()
Return internet address of local host to which the socket is bound.
Definition TSocket.cxx:409
TSecContext * fSecContext
Definition TSocket.h:65
virtual Int_t Select(Int_t interest=kRead, Long_t timeout=-1)
Waits for this socket to change status.
Definition TSocket.cxx:443
virtual Int_t GetLocalPort()
Return the local port # to which the socket is bound.
Definition TSocket.cxx:423
virtual ~TSocket()
Definition TSocket.h:109
void SetDescriptor(Int_t desc)
Definition TSocket.h:89
Int_t fTcpWindowSize
Definition TSocket.h:70
Option_t * GetOption() const override
Definition TSocket.h:98
Definition TSocket.h:52
Definition TSocket.h:52
Definition TSocket.h:52
Definition TSocket.h:52
static TSocket * CreateAuthSocket(const char *user, const char *host, Int_t port, Int_t size=0, Int_t tcpwindowsize=-1, TSocket *s=nullptr, Int_t *err=nullptr)
Creates a socket or a parallel socket and authenticates to the remote server specified in 'url' on re...
Definition TSocket.cxx:1432
static void NetError(const char *where, Int_t error)
Print error string depending on error code.
Definition TSocket.cxx:1477
virtual Int_t GetDescriptor() const
Definition TSocket.h:112
Int_t GetCompressionSettings() const
Definition TSocket.h:187
Int_t GetPort() const
Definition TSocket.h:115
Int_t GetServType() const
Definition TSocket.h:117
EServiceType fServType
Definition TSocket.h:68
TSocket & operator=(const TSocket &)=delete
virtual Int_t SendObject(const TObject *obj, Int_t kind=kMESS_OBJECT)
Send an object.
Definition TSocket.cxx:600
void SetCompressionSettings(Int_t settings=ROOT::RCompressionSetting::EDefaults::kUseCompiledDefault)
Used to specify the compression level and algorithm: settings = 100 * algorithm + level.
Definition TSocket.cxx:1098
void SetSecContext(TSecContext *ctx)
Definition TSocket.h:152
UInt_t fBytesSent
Definition TSocket.h:61
Int_t fRemoteProtocol
Definition TSocket.h:64
UInt_t fBytesRecv
Definition TSocket.h:60
Int_t GetCompressionAlgorithm() const
Definition TSocket.h:175
virtual Bool_t IsValid() const
Definition TSocket.h:132
virtual Int_t Reconnect()
Definition TSocket.h:138
const char * GetUrl() const
Definition TSocket.h:130
virtual Int_t Send(const TMessage &mess)
Send a TMessage object.
Definition TSocket.cxx:522
virtual Bool_t IsAuthenticated() const
Definition TSocket.h:131
static ULong64_t GetSocketBytesRecv()
Get total number of bytes received via all sockets.
Definition TSocket.cxx:1497
Basic string class.
Definition TString.h:139
const char * Data() const
Definition TString.h:380
The TTimeStamp encapsulates seconds and ns since EPOCH.
Definition TTimeStamp.h:45
void Set()
Set Date/Time to current time as reported by the system.
This class implements a mutex interface.
This file contains a specialised ROOT message handler to test for diagnostic in unit tests.
@ kUseGlobal
Use the global compression algorithm.
Definition Compression.h:90
@ kUseCompiledDefault
Use the compile-time default setting.
Definition Compression.h:52
@ kUseMin
Compression level reserved when we are not sure what to use (1 is for the fastest compression)
Definition Compression.h:70