1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
includefile(include/header)
COMMENT(manpage, section, releasedate, archive, short name)
manpage(FBB::LocalClientSocket)(3bobcat)
(_CurYrs_)(libbobcat-dev__CurVers_)
(Unix Domain client Socket)
manpagename(FBB::LocalClientSocket)
(Client Socket connecting to a Server in the Unix Domain)
manpagesynopsis()
bf(#include <bobcat/localclientsocket>)nl()
Linking option: tt(-lbobcat)
manpagedescription()
An bf(FBB::LocalClientSocket) may be constructed to connect to a server
process in the Unix Domain. The socket made available by the
bf(FBB:LocalClientSocket) may be used to initialize a bf(std::istream) and/or
bf(std::ostream). The bf(std::istream) is used to read information from the
server process to which the bf(FBB::LocalClientSocket) connects, The
bf(std::ostream) is used to send information to the server process to which
the bf(FBB::LocalClientSocket) connects. Since a socket may be considered a
em(file descriptor) the available bf(FBB::IFdStream), bf(FBB::IFdStreamBuf),
bf(FBB::OFdStream), and bf(FBB::OFdStreamBuf) classes may be used profitably
here. Note that having available a socket does not mean that this defines the
communication protocol. It is (still) the responsibility of the programmer to
comply with an existing protocol or to implement a tailor-made protocol. The
latter situation implies that the sequence of input- and output operations is
defined by the programmer.
includefile(include/namespace)
manpagesection(INHERITS FROM)
bf(FBB::LocalSocketBase)
manpagesection(CONSTRUCTOR)
itemization(
itb(LocalClientSocket())
This constructor merely creates a bf(FBB::LocalClientSocket)
object. Before it can be used, its tt(open()) member must be called.
itb(LocalClientSocket(std::string const &name))
This constructor initializes an bf(FBB::LocalClientSocket) object,
using the named Unix Domain socket to connect to the server using the named
Unix Domain socket. An bf(FBB::Exception) is thrown if the socket could not be
constructed. The construction of the socket does not mean that a connection
has actually been established. In order to connect to the server, the member
bf(connect()) (see below) should be used.
)
Copy and move constructors (and assignment operators) are not available.
manpagesection(MEMBER FUNCTION)
itemization(
itb(int connect())
This member returns a socket that can be used to communicate with the
server process. An bf(FBB::Exception) exception is thrown if the connection could
not be established.
itb(open(std::string const &name))
This member function prepares the bf(FBB::LocalClientSocket) object,
constructed earlier using the default constructor, for use. The named Unix
Domain socket is used to connect to the server using the named Unix Domain
socket. An bf(FBB::Exception) is thrown if the socket could not be
constructed. The construction of the socket does not mean that a connection
has actually been established. In order to connect to the server, the member
bf(connect()) should be used.
)
manpagesection(EXAMPLE)
See also the bf(localserversocket)(3bobcat) example.
verb(
#include <iostream>
#include <bobcat/localclientsocket>
#include <bobcat/ifdstream>
#include <bobcat/ofdstream>
using namespace std;
using namespace FBB;
int main(int argc, char **argv)
try
{
if (argc == 1)
{
cerr << "Provide filename representing the unix domain socket\n";
return 1;
}
LocalClientSocket client(argv[1]);
int fd = client.connect();
string line;
cout << "Connecting to socket " << fd << endl;
IFdStream in(fd); // stream to read from
OFdStream out(fd); // stream to write to
while (true)
{
// Ask for a textline, stop if empty / none
cout << "? ";
if (!getline(cin, line) || line.length() == 0)
return 0;
cout << "Line read: " << line << endl;
// Return the line to the server
out << line.c_str() << endl;
cout << "wrote line\n";
// Wait for a reply from the server
getline(in, line);
cout << "Answer: " << line << endl;
}
}
catch (Exception const &err)
{
cerr << err.what() << "\n" <<
"Can't connect to " << argv[1] << ", port " << argv[2] << endl;
return 1;
}
)
manpagefiles()
em(bobcat/localclientsocket) - defines the class interface
manpageseealso()
bf(bobcat)(7), bf(ifdstream)(3bobcat), bf(ifdbuf)(3bobcat),
bf(clientsocket)(3bobcat), bf(localserversocket)(3bobcat),
bf(localsocketbase)(3bobcat), bf(ofdstream)(3bobcat), bf(ofdstream)(3bobcat)
manpagebugs()
None Reported.
includefile(include/trailer)
|
