Logo ROOT   6.18/05
Reference Guide
TServerSocket.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_TServerSocket
13#define ROOT_TServerSocket
14
15
16//////////////////////////////////////////////////////////////////////////
17// //
18// TServerSocket //
19// //
20// This class implements server sockets. A server socket waits for //
21// requests to come in over the network. It performs some operation //
22// based on that request and then possibly returns a full duplex socket //
23// to the requester. The actual work is done via the TSystem class //
24// (either TUnixSystem or TWinNTSystem). //
25// //
26//////////////////////////////////////////////////////////////////////////
27
28#include "TSocket.h"
29#include <string>
30
31class TSeqCollection;
32
33typedef Int_t (*SrvAuth_t)(TSocket *sock, const char *, const char *,
34 std::string&, Int_t &, Int_t &, std::string &,
37
38// These mask are globally available to manipulate the option to Accept
39const UChar_t kSrvAuth = 0x1; // Require client authentication
40const UChar_t kSrvNoAuth = (kSrvAuth<<4); // Force no client authentication
41
42class TServerSocket : public TSocket {
43
44private:
45 TSeqCollection *fSecContexts; // List of TSecContext with cleanup info
48 static UChar_t fgAcceptOpt; // Default accept options
49
52 void operator=(const TServerSocket &);
54
55public:
56 enum { kDefaultBacklog = 10 };
57
58 TServerSocket(Int_t port, Bool_t reuse = kFALSE, Int_t backlog = kDefaultBacklog,
59 Int_t tcpwindowsize = -1);
60 TServerSocket(const char *service, Bool_t reuse = kFALSE,
61 Int_t backlog = kDefaultBacklog, Int_t tcpwindowsize = -1);
62 virtual ~TServerSocket();
63
64 virtual TSocket *Accept(UChar_t Opt = 0);
66 virtual Int_t GetLocalPort();
67
69 { MayNotUse("Send(const TMessage &)"); return 0; }
71 { MayNotUse("Send(Int_t)"); return 0; }
73 { MayNotUse("Send(Int_t, Int_t)"); return 0; }
74 Int_t Send(const char *, Int_t = kMESS_STRING)
75 { MayNotUse("Send(const char *, Int_t)"); return 0; }
77 { MayNotUse("SendObject(const TObject *, Int_t)"); return 0; }
79 { MayNotUse("SendRaw(const void *, Int_t, ESendRecvOptions)"); return 0; }
81 { MayNotUse("Recv(TMessage *&)"); return 0; }
83 { MayNotUse("Recv(Int_t &, Int_t &)"); return 0; }
84 Int_t Recv(char *, Int_t)
85 { MayNotUse("Recv(char *, Int_t)"); return 0; }
86 Int_t Recv(char *, Int_t, Int_t &)
87 { MayNotUse("Recv(char *, Int_t, Int_t &)"); return 0; }
89 { MayNotUse("RecvRaw(void *, Int_t, ESendRecvOptions)"); return 0; }
90
92 static void SetAcceptOptions(UChar_t Opt);
93 static void ShowAcceptOptions();
94
95 ClassDef(TServerSocket, 0); //This class implements server sockets
96};
97
98#endif
@ kMESS_STRING
Definition: MessageTypes.h:34
@ kMESS_OBJECT
Definition: MessageTypes.h:35
int Int_t
Definition: RtypesCore.h:41
unsigned char UChar_t
Definition: RtypesCore.h:34
const Bool_t kFALSE
Definition: RtypesCore.h:88
bool Bool_t
Definition: RtypesCore.h:59
#define ClassDef(name, id)
Definition: Rtypes.h:326
Int_t(* SrvClup_t)(TSeqCollection *)
Definition: TServerSocket.h:36
const UChar_t kSrvNoAuth
Definition: TServerSocket.h:40
const UChar_t kSrvAuth
Definition: TServerSocket.h:39
Int_t(* SrvAuth_t)(TSocket *sock, const char *, const char *, std::string &, Int_t &, Int_t &, std::string &, TSeqCollection *)
Definition: TServerSocket.h:33
ESendRecvOptions
Definition: TSystem.h:230
@ kDefault
Definition: TSystem.h:231
This class represents an Internet Protocol (IP) address.
Definition: TInetAddress.h:36
Mother of all ROOT objects.
Definition: TObject.h:37
void MayNotUse(const char *method) const
Use this method to signal that a method (defined in a base class) may not be called in a derived clas...
Definition: TObject.cxx:933
Sequenceable collection abstract base class.
Int_t Recv(Int_t &, Int_t &)
Receives a status and a message type.
Definition: TServerSocket.h:82
Int_t Send(Int_t)
Send a single message opcode.
Definition: TServerSocket.h:70
static SrvAuth_t fgSrvAuthHook
Definition: TServerSocket.h:46
Int_t Recv(char *, Int_t, Int_t &)
Receive a character string message of maximum max length.
Definition: TServerSocket.h:86
Int_t Send(const char *, Int_t=kMESS_STRING)
Send a character string buffer.
Definition: TServerSocket.h:74
Int_t Recv(TMessage *&)
Receive a TMessage object.
Definition: TServerSocket.h:80
Int_t Send(const TMessage &)
Send a TMessage object.
Definition: TServerSocket.h:68
TServerSocket(const TServerSocket &)
virtual Int_t GetLocalPort()
Get port # to which server socket is bound. In case of error returns -1.
Int_t SendRaw(const void *, Int_t, ESendRecvOptions=kDefault)
Send a raw buffer of specified length.
Definition: TServerSocket.h:78
static UChar_t fgAcceptOpt
Definition: TServerSocket.h:48
Int_t Send(Int_t, Int_t)
Send a status and a single message opcode.
Definition: TServerSocket.h:72
static void SetAcceptOptions(UChar_t Opt)
Set default options for Accept according to modifier 'mod'.
void operator=(const TServerSocket &)
Bool_t Authenticate(TSocket *)
Check authentication request from the client on new open connection.
static SrvClup_t fgSrvAuthClupHook
Definition: TServerSocket.h:47
virtual ~TServerSocket()
Destructor: cleanup authentication stuff (if any) and close.
static void ShowAcceptOptions()
Print default options for Accept.
Int_t SendObject(const TObject *, Int_t=kMESS_OBJECT)
Send an object.
Definition: TServerSocket.h:76
static UChar_t GetAcceptOptions()
Return default options for Accept.
virtual TSocket * Accept(UChar_t Opt=0)
Accept a connection on a server socket.
virtual TInetAddress GetLocalInetAddress()
Return internet address of host to which the server socket is bound, i.e.
TSeqCollection * fSecContexts
Definition: TServerSocket.h:45
Int_t RecvRaw(void *, Int_t, ESendRecvOptions=kDefault)
Receive a raw buffer of specified length bytes.
Definition: TServerSocket.h:88
Int_t Recv(char *, Int_t)
Receive a character string message of maximum max length.
Definition: TServerSocket.h:84