Logo ROOT   6.18/05
Reference Guide
TSocket.h
Go to the documentation of this file.
1// @(#)root/net:$Id$
2// Author: Fons Rademakers 18/12/96
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_TSocket
13#define ROOT_TSocket
14
15
16//////////////////////////////////////////////////////////////////////////
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// //
25//////////////////////////////////////////////////////////////////////////
26
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"
37
38class TMessage;
39class THostAuth;
40
41class TSocket : public TNamed {
42
43friend class TServerSocket;
44friend class TProofServ; // to be able to call SetDescriptor(), RecvHostAuth()
45friend class TSlave; // to be able to call SendHostAuth()
46
47public:
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 };
53
54protected:
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
74
75 TVirtualMutex *fLastUsageMtx; // Protect last usage setting / reading
76 TTimeStamp fLastUsage; // Time stamp of last usage
77
78 static ULong64_t fgBytesRecv; // total bytes received by all socket objects
79 static ULong64_t fgBytesSent; // total bytes sent by all socket objects
80
81 static Int_t fgClientProtocol; // client "protocol" version
82
83 TSocket() : fAddress(), fBytesRecv(0), fBytesSent(0), fCompress(ROOT::RCompressionSetting::EAlgorithm::kUseGlobal),
87
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);
95
96private:
97 TSocket& operator=(const TSocket &); // not implemented
98 Option_t *GetOption() const { return TObject::GetOption(); }
99
100public:
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(); }
110
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; }
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; }
156
158
159 static Int_t GetClientProtocol();
160
163
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 = 0, Int_t *err = 0);
167 static TSocket *CreateAuthSocket(const char *url, Int_t size = 0,
168 Int_t tcpwindowsize = -1, TSocket *s = 0, Int_t *err = 0);
169 static void NetError(const char *where, Int_t error);
170
171 ClassDef(TSocket,0) //This class implements client sockets
172};
173
174//______________________________________________________________________________
176{
177 return (fCompress < 0) ? -1 : fCompress / 100;
178}
179
180//______________________________________________________________________________
182{
183 return (fCompress < 0) ? -1 : fCompress % 100;
184}
185
186//______________________________________________________________________________
188{
189 return (fCompress < 0) ? -1 : fCompress;
190}
191
192#endif
@ kMESS_STRING
Definition: MessageTypes.h:34
@ kMESS_OBJECT
Definition: MessageTypes.h:35
int Int_t
Definition: RtypesCore.h:41
unsigned int UInt_t
Definition: RtypesCore.h:42
const Bool_t kFALSE
Definition: RtypesCore.h:88
long Long_t
Definition: RtypesCore.h:50
bool Bool_t
Definition: RtypesCore.h:59
unsigned long long ULong64_t
Definition: RtypesCore.h:70
const Bool_t kTRUE
Definition: RtypesCore.h:87
const char Option_t
Definition: RtypesCore.h:62
#define ClassDef(name, id)
Definition: Rtypes.h:326
#define BIT(n)
Definition: Rtypes.h:83
ESockOptions
Definition: TSystem.h:217
ESendRecvOptions
Definition: TSystem.h:230
@ kDefault
Definition: TSystem.h:231
#define R__LOCKGUARD2(mutex)
Container of bits.
Definition: TBits.h:27
This class represents an Internet Protocol (IP) address.
Definition: TInetAddress.h:36
Int_t GetPort() const
Definition: TInetAddress.h:73
A doubly linked list.
Definition: TList.h:44
The TNamed class is the base class for all named ROOT classes.
Definition: TNamed.h:29
Mother of all ROOT objects.
Definition: TObject.h:37
virtual Option_t * GetOption() const
Definition: TObject.h:120
EStatusBits
Definition: TObject.h:57
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
Option_t * GetOption() const
Definition: TSocket.h:98
Int_t fCompress
Definition: TSocket.h:62
virtual Int_t SetOption(ESockOptions opt, Int_t val)
Set socket options.
Definition: TSocket.cxx:1011
Int_t fSocket
Definition: TSocket.h:69
Int_t GetErrorCode() const
Returns error code.
Definition: TSocket.cxx:1033
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:1058
void SendStreamerInfos(const TMessage &mess)
Check if TStreamerInfo must be sent.
Definition: TSocket.cxx:648
ESocketErrors
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:1044
TSocket()
Definition: TSocket.h:83
static ULong64_t GetSocketBytesSent()
Get total number of bytes sent via all sockets.
Definition: TSocket.cxx:1487
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:926
EInterest
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:816
TList * fUUIDs
Definition: TSocket.h:73
static Int_t GetClientProtocol()
Static method returning supported client protocol.
Definition: TSocket.cxx:1467
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:1104
TInetAddress fLocalAddress
Definition: TSocket.h:63
Int_t GetTcpWindowSize() const
Definition: TSocket.h:128
static ULong64_t fgBytesRecv
Definition: TSocket.h:78
@ kIsUnix
Definition: TSocket.h:48
@ kBrokenConn
Definition: TSocket.h:49
virtual void Close(Option_t *opt="")
Close the socket.
Definition: TSocket.cxx:388
void MarkBrokenConnection()
Close the socket and mark as due to a broken connection.
Definition: TSocket.cxx:370
void Touch()
Definition: TSocket.h:157
Bool_t RecvProcessIDs(TMessage *mess)
Receive a message containing process ids.
Definition: TSocket.cxx:973
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:896
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:619
TTimeStamp fLastUsage
Definition: TSocket.h:76
void SendProcessIDs(const TMessage &mess)
Check if TProcessIDs must be sent.
Definition: TSocket.cxx:683
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:408
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:442
virtual Int_t GetLocalPort()
Return the local port # to which the socket is bound.
Definition: TSocket.cxx:422
virtual ~TSocket()
Definition: TSocket.h:109
static TSocket * CreateAuthSocket(const char *user, const char *host, Int_t port, Int_t size=0, Int_t tcpwindowsize=-1, TSocket *s=0, Int_t *err=0)
Creates a socket or a parallel socket and authenticates to the remote server specified in 'url' on re...
Definition: TSocket.cxx:1430
void SetDescriptor(Int_t desc)
Definition: TSocket.h:89
Int_t fTcpWindowSize
Definition: TSocket.h:70
TSocket & operator=(const TSocket &)
EServiceType
Definition: TSocket.h:52
@ kSOCKD
Definition: TSocket.h:52
@ kROOTD
Definition: TSocket.h:52
@ kPROOFD
Definition: TSocket.h:52
static void NetError(const char *where, Int_t error)
Print error string depending on error code.
Definition: TSocket.cxx:1475
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
void SetCompressionSettings(Int_t settings=ROOT::RCompressionSetting::EDefaults::kUseGeneralPurpose)
Used to specify the compression level and algorithm: settings = 100 * algorithm + level.
Definition: TSocket.cxx:1096
EServiceType fServType
Definition: TSocket.h:68
virtual Int_t SendObject(const TObject *obj, Int_t kind=kMESS_OBJECT)
Send an object.
Definition: TSocket.cxx:599
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:521
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:1495
Basic string class.
Definition: TString.h:131
The TTimeStamp encapsulates seconds and ns since EPOCH.
Definition: TTimeStamp.h:71
void Set()
Set Date/Time to current time as reported by the system.
Definition: TTimeStamp.cxx:556
This class implements a mutex interface.
Definition: TVirtualMutex.h:34
Namespace for new ROOT classes and functions.
Definition: StringConv.hxx:21
static constexpr double s
@ kUseGlobal
Use the global compression algorithm.
Definition: Compression.h:81
@ kUseGeneralPurpose
Use the recommended general-purpose setting; moderate read / write speed and compression ratio.
Definition: Compression.h:53