summaryrefslogtreecommitdiff
path: root/docs/man/man3/serverrec.3
blob: 756987d578e75c2891f04cee297a072e3b502500 (plain)
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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
.TH "serverrec" 3 "25 May 2005" "InspIRCd" \" -*- nroff -*-
.ad l
.nh
.SH NAME
serverrec \- A class that defines the local server or a remote server.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <servers.h>\fP
.PP
Inherits \fBconnection\fP.
.PP
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBserverrec\fP ()"
.br
.RI "\fIConstructor. \fP"
.ti -1c
.RI "\fBserverrec\fP (char *n, long ver, bool jupe)"
.br
.RI "\fIConstructor which initialises some of the main variables. \fP"
.ti -1c
.RI "\fB~serverrec\fP ()"
.br
.RI "\fIDestructor. \fP"
.ti -1c
.RI "bool \fBCreateListener\fP (char *\fBhost\fP, int p)"
.br
.RI "\fICreate a listening socket on 'host' using port number 'p'. \fP"
.ti -1c
.RI "bool \fBBeginLink\fP (char *targethost, int \fBport\fP, char *password, char *servername, int myport)"
.br
.RI "\fIBegin an outbound link to another ircd at targethost. \fP"
.ti -1c
.RI "bool \fBMeshCookie\fP (char *targethost, int \fBport\fP, unsigned long cookie, char *servername)"
.br
.RI "\fIBegin an outbound mesh link to another ircd on a network you are already an authenticated member of. \fP"
.ti -1c
.RI "void \fBTerminateLink\fP (char *targethost)"
.br
.RI "\fITerminate a link to 'targethost' by calling the \fBircd_connector::CloseConnection\fP method. \fP"
.ti -1c
.RI "bool \fBSendPacket\fP (char *message, const char *\fBhost\fP)"
.br
.RI "\fISend a message to a server by name, if the server is unavailable directly route the packet via another server If the server still cannot be reached after attempting to route the message remotely, returns false. \fP"
.ti -1c
.RI "bool \fBRecvPacket\fP (std::deque< std::string > &messages, char *\fBhost\fP, std::deque< std::string > &sums)"
.br
.RI "\fIReturns the next available packet and returns true if data is available. \fP"
.ti -1c
.RI "\fBircd_connector\fP * \fBFindHost\fP (std::string \fBhost\fP)"
.br
.RI "\fIFind the \fBircd_connector\fP oject related to a certain servername given in 'host'. \fP"
.ti -1c
.RI "bool \fBAddIncoming\fP (int \fBfd\fP, char *targethost, int sourceport)"
.br
.RI "\fIAdd an incoming connection to the connection pool. \fP"
.ti -1c
.RI "void \fBFlushWriteBuffers\fP ()"
.br
.RI "\fIFlushes all data waiting to be written for all of this server's connections. \fP"
.in -1c
.SS "Public Attributes"

.in +1c
.ti -1c
.RI "char \fBname\fP [MAXBUF]"
.br
.RI "\fIserver name \fP"
.ti -1c
.RI "long \fBpingtime\fP"
.br
.RI "\fIlast ping response (ms) \fP"
.ti -1c
.RI "long \fBusercount_i\fP"
.br
.RI "\fIinvisible users on server \fP"
.ti -1c
.RI "long \fBusercount\fP"
.br
.RI "\fInon-invisible users on server \fP"
.ti -1c
.RI "long \fBopercount\fP"
.br
.RI "\fIopers on server \fP"
.ti -1c
.RI "int \fBhops_away\fP"
.br
.RI "\fInumber of hops away (for quick access) \fP"
.ti -1c
.RI "long \fBversion\fP"
.br
.RI "\fIircd version \fP"
.ti -1c
.RI "bool \fBjupiter\fP"
.br
.RI "\fIis a JUPE server (faked to enforce a server ban) \fP"
.ti -1c
.RI "char \fBdescription\fP [MAXBUF]"
.br
.RI "\fIDescription of the server. \fP"
.ti -1c
.RI "char \fBnickserv\fP [NICKMAX]"
.br
.RI "\fIHolds nickserv's name on U:lined (services) servers (this is a kludge for ircservices which ASSUMES things :/). \fP"
.ti -1c
.RI "bool \fBsync_soon\fP"
.br
.ti -1c
.RI "std::vector< \fBircd_connector\fP > \fBconnectors\fP"
.br
.RI "\fIWith a serverrec, this is a list of all established server connections. \fP"
.in -1c
.SH "Detailed Description"
.PP 
A class that defines the local server or a remote server. Definition at line 30 of file servers.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "serverrec::serverrec ()"
.PP
Constructor. Definition at line 46 of file servers.cpp.
.PP
References connectors, connection::fd, hops_away, jupiter, connection::lastping, name, nickserv, opercount, pingtime, connection::signon, sync_soon, TIME, usercount, usercount_i, and version.
.PP
.nf
47 {
48         strlcpy(name,'',256);
49         pingtime = 0;
50         lastping = TIME;
51         usercount_i = usercount = opercount = version = 0;
52         hops_away = 1;
53         signon = TIME;
54         jupiter = false;
55         fd = 0;
56         sync_soon = false;
57         strlcpy(nickserv,'',NICKMAX);
58         connectors.clear();
59 }
.fi
.SS "serverrec::serverrec (char * n, long ver, bool jupe)"
.PP
Constructor which initialises some of the main variables. Definition at line 66 of file servers.cpp.
.PP
References connectors, connection::fd, hops_away, jupiter, connection::lastping, name, nickserv, opercount, connection::signon, sync_soon, TIME, usercount, usercount_i, and version.
.PP
.nf
67 {
68         strlcpy(name,n,256);
69         lastping = TIME;
70         usercount_i = usercount = opercount = 0;
71         version = ver;
72         hops_away = 1;
73         signon = TIME;
74         jupiter = jupe;
75         fd = 0;
76         sync_soon = false;
77         strlcpy(nickserv,'',NICKMAX);
78         connectors.clear();
79 }
.fi
.SS "serverrec::~\fBserverrec\fP ()"
.PP
Destructor. Definition at line 62 of file servers.cpp.
.PP
.nf
63 {
64 }
.fi
.SH "Member Function Documentation"
.PP 
.SS "bool serverrec::AddIncoming (int fd, char * targethost, int sourceport)"
.PP
Add an incoming connection to the connection pool. (reserved for core use) Definition at line 212 of file servers.cpp.
.PP
References connectors, DEBUG, ircd_connector::SetDescriptor(), ircd_connector::SetHostAndPort(), ircd_connector::SetServerName(), ircd_connector::SetState(), and STATE_NOAUTH_INBOUND.
.PP
.nf
213 {
214         ircd_connector connector;
215 
216         // targethost has been turned into an ip...
217         // we dont want this as the server name.
218         connector.SetServerName(targethost);
219         connector.SetDescriptor(newfd);
220         connector.SetState(STATE_NOAUTH_INBOUND);
221         int flags = fcntl(newfd, F_GETFL, 0);
222         fcntl(newfd, F_SETFL, flags | O_NONBLOCK);
223         int sendbuf = 32768;
224         int recvbuf = 32768;
225         setsockopt(newfd,SOL_SOCKET,SO_SNDBUF,(const void *)&sendbuf,sizeof(sendbuf));
226         setsockopt(newfd,SOL_SOCKET,SO_RCVBUF,(const void *)&recvbuf,sizeof(sendbuf));
227         connector.SetHostAndPort(targethost, sourceport);
228         connector.SetState(STATE_NOAUTH_INBOUND);
229         log(DEBUG,'serverrec::AddIncoming() Added connection: %s:%d',targethost,sourceport);
230         this->connectors.push_back(connector);
231         return true;
232 }
.fi
.SS "bool serverrec::BeginLink (char * targethost, int port, char * password, char * servername, int myport)"
.PP
Begin an outbound link to another ircd at targethost. Definition at line 142 of file servers.cpp.
.PP
References connectors, connection::fd, FindHost(), ircd_connector::MakeOutboundConnection(), SendPacket(), ircd_connector::SetHostAndPort(), ircd_connector::SetServerName(), ircd_connector::SetState(), STATE_DISCONNECTED, and STATE_NOAUTH_OUTBOUND.
.PP
.nf
143 {
144         char connect[MAXBUF];
145 
146         ircd_connector connector;
147         ircd_connector *cn = this->FindHost(servername);
148 
149 
150         if (cn)
151         {
152                 WriteOpers('CONNECT aborted: Server %s already exists',servername);
153                 return false;
154         }
155 
156 
157         if (this->fd)
158         {
159                 if (connector.MakeOutboundConnection(targethost,newport))
160                 {
161                         // targethost has been turned into an ip...
162                         // we dont want this as the server name.
163                         connector.SetServerName(servername);
164                         snprintf(connect,MAXBUF,'S %s %s %lu %s :%s',getservername().c_str(),password,(unsigned long)myport,GetRevision().c_str(),getserverdesc().c_str());
165                         connector.SetState(STATE_NOAUTH_OUTBOUND);
166                         connector.SetHostAndPort(targethost, newport);
167                         this->connectors.push_back(connector);
168                         // this packet isn't actually sent until the socket connects -- the STATE_NOAUTH_OUTBOUND state
169                         // queues outbound data until the socket is polled as writeable (e.g. the connection is established)
170                         return this->SendPacket(connect, servername);
171                 }
172                 else
173                 {
174                         connector.SetState(STATE_DISCONNECTED);
175                         WriteOpers('Could not create outbound connection to %s:%d',targethost,newport);
176                 }
177         }
178         return false;
179 }
.fi
.SS "bool serverrec::CreateListener (char * host, int p)"
.PP
Create a listening socket on 'host' using port number 'p'. Definition at line 81 of file servers.cpp.
.PP
References connection::fd, MaxConn, and connection::port.
.PP
.nf
82 {
83         sockaddr_in host_address;
84         int flags;
85         in_addr addy;
86         int on = 0;
87         struct linger linger = { 0 };
88 
89         this->port = p;
90 
91         fd = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
92         if (fd <= 0)
93         {
94                 return false;
95         }
96 
97         setsockopt(fd,SOL_SOCKET,SO_REUSEADDR,(const char*)&on,sizeof(on));
98         linger.l_onoff = 1;
99         linger.l_linger = 1;
100         setsockopt(fd,SOL_SOCKET,SO_LINGER,(const char*)&linger,sizeof(linger));
101 
102         // attempt to increase socket sendq and recvq as high as its possible
103         // to get them on linux.
104         int sendbuf = 32768;
105         int recvbuf = 32768;
106         setsockopt(fd,SOL_SOCKET,SO_SNDBUF,(const void *)&sendbuf,sizeof(sendbuf));
107         setsockopt(fd,SOL_SOCKET,SO_RCVBUF,(const void *)&recvbuf,sizeof(sendbuf));
108 
109         memset((void*)&host_address, 0, sizeof(host_address));
110 
111         host_address.sin_family = AF_INET;
112 
113         if (!strcmp(newhost,''))
114         {
115                 host_address.sin_addr.s_addr = htonl(INADDR_ANY);
116         }
117         else
118         {
119                 inet_aton(newhost,&addy);
120                 host_address.sin_addr = addy;
121         }
122 
123         host_address.sin_port = htons(p);
124 
125         if (bind(fd,(sockaddr*)&host_address,sizeof(host_address))<0)
126         {
127                 return false;
128         }
129 
130         // make the socket non-blocking
131         flags = fcntl(fd, F_GETFL, 0);
132         fcntl(fd, F_SETFL, flags | O_NONBLOCK);
133 
134         this->port = p;
135 
136         listen(this->fd, MaxConn);
137 
138         return true;
139 }
.fi
.SS "\fBircd_connector\fP * serverrec::FindHost (std::string host)"
.PP
Find the \fBircd_connector\fP oject related to a certain servername given in 'host'. Definition at line 242 of file servers.cpp.
.PP
References connectors.
.PP
Referenced by BeginLink(), IsRoutable(), and SendPacket().
.PP
.nf
243 {
244         for (int i = 0; i < this->connectors.size(); i++)
245         {
246                 if (this->connectors[i].GetServerName() == findhost)
247                 {
248                         return &this->connectors[i];
249                 }
250         }
251         return NULL;
252 }
.fi
.SS "void serverrec::FlushWriteBuffers ()"
.PP
Flushes all data waiting to be written for all of this server's connections. Definition at line 284 of file servers.cpp.
.PP
References connectors, has_been_netsplit, IsRoutable(), STATE_DISCONNECTED, STATE_NOAUTH_INBOUND, STATE_NOAUTH_OUTBOUND, and TIME.
.PP
.nf
285 {
286         for (int i = 0; i < this->connectors.size(); i++)
287         {
288                 // don't try and ping a NOAUTH_OUTBOUND state, its not authed yet!
289                 if ((this->connectors[i].GetState() == STATE_NOAUTH_OUTBOUND) && (TIME > this->connectors[i].age+30))
290                 {
291                         // however if we reach this timer its connected timed out :)
292                         WriteOpers('*** Connection to %s timed out',this->connectors[i].GetServerName().c_str());
293                         DoSplit(this->connectors[i].GetServerName().c_str());
294                         return;
295                 }
296                 else if ((this->connectors[i].GetState() == STATE_NOAUTH_INBOUND) && (TIME > this->connectors[i].age+30))
297                 {
298                         WriteOpers('*** Connection from %s timed out',this->connectors[i].GetServerName().c_str());
299                         DoSplit(this->connectors[i].GetServerName().c_str());
300                         return;
301                 }
302                 else if (this->connectors[i].GetState() != STATE_DISCONNECTED)
303                 {
304                         if (!this->connectors[i].CheckPing())
305                         {
306                                 WriteOpers('*** Lost single connection to %s: Ping timeout',this->connectors[i].GetServerName().c_str());
307                                 this->connectors[i].CloseConnection();
308                                 this->connectors[i].SetState(STATE_DISCONNECTED);
309                                 if (!IsRoutable(this->connectors[i].GetServerName()))
310                                 {
311                                         WriteOpers('*** Server %s is no longer routable, disconnecting.',this->connectors[i].GetServerName().c_str());
312                                         DoSplit(this->connectors[i].GetServerName().c_str());
313                                 }
314                                 has_been_netsplit = true;
315                         }
316                 }
317                 if (this->connectors[i].HasBufferedOutput())
318                 {
319                         if (!this->connectors[i].FlushWriteBuf())
320                         {
321                                 // if we're here the write() caused an error, we cannot proceed
322                                 WriteOpers('*** Lost single connection to %s, link inactive and retrying: %s',this->connectors[i].GetServerName().c_str(),this->connectors[i].GetWriteError().c_str());
323                                 this->connectors[i].CloseConnection();
324                                 this->connectors[i].SetState(STATE_DISCONNECTED);
325                                 if (!IsRoutable(this->connectors[i].GetServerName()))
326                                 {
327                                         WriteOpers('*** Server %s is no longer routable, disconnecting.',this->connectors[i].GetServerName().c_str());
328                                         DoSplit(this->connectors[i].GetServerName().c_str());
329                                 }
330                                 has_been_netsplit = true;
331                         }
332                 }
333         }
334 }
.fi
.SS "bool serverrec::MeshCookie (char * targethost, int port, unsigned long cookie, char * servername)"
.PP
Begin an outbound mesh link to another ircd on a network you are already an authenticated member of. Definition at line 182 of file servers.cpp.
.PP
References connectors, connection::fd, ircd_connector::MakeOutboundConnection(), SendPacket(), ircd_connector::SetHostAndPort(), ircd_connector::SetServerName(), ircd_connector::SetState(), STATE_DISCONNECTED, and STATE_NOAUTH_OUTBOUND.
.PP
.nf
183 {
184         char connect[MAXBUF];
185 
186         ircd_connector connector;
187 
188         WriteOpers('Establishing meshed link to %s:%d',servername,newport);
189 
190         if (this->fd)
191         {
192                 if (connector.MakeOutboundConnection(targethost,newport))
193                 {
194                         // targethost has been turned into an ip...
195                         // we dont want this as the server name.
196                         connector.SetServerName(servername);
197                         snprintf(connect,MAXBUF,'- %lu %s :%s',cookie,getservername().c_str(),getserverdesc().c_str());
198                         connector.SetState(STATE_NOAUTH_OUTBOUND);
199                         connector.SetHostAndPort(targethost, newport);
200                         this->connectors.push_back(connector);
201                         return this->SendPacket(connect, servername);
202                 }
203                 else
204                 {
205                         connector.SetState(STATE_DISCONNECTED);
206                         WriteOpers('Could not create outbound connection to %s:%d',targethost,newport);
207                 }
208         }
209         return false;
210 }
.fi
.SS "bool serverrec::RecvPacket (std::deque< std::string > & messages, char * host, std::deque< std::string > & sums)"
.PP
Returns the next available packet and returns true if data is available. Writes the servername the data came from to 'host'. If no data is available this function returns false. This function will automatically close broken links and reroute pathways, generating split messages on the network. Definition at line 431 of file servers.cpp.
.PP
References already_have_sum(), connectors, DEBUG, has_been_netsplit, IsRoutable(), and STATE_DISCONNECTED.
.PP
.nf
432 {
433         char data[65536];
434         memset(data, 0, 65536);
435         for (int i = 0; i < this->connectors.size(); i++)
436         {
437                 if (this->connectors[i].GetState() != STATE_DISCONNECTED)
438                 {
439                         // returns false if the packet could not be sent (e.g. target host down)
440                         int rcvsize = 0;
441 
442                         // check if theres any data on this socket
443                         // if not, continue onwards to the next.
444                         pollfd polls;
445                         polls.fd = this->connectors[i].GetDescriptor();
446                         polls.events = POLLIN;
447                         int ret = poll(&polls,1,1);
448                         if (ret <= 0) continue;
449 
450                         rcvsize = recv(this->connectors[i].GetDescriptor(),data,65000,0);
451                         data[rcvsize] = '\0';
452                         if (rcvsize == -1)
453                         {
454                                 if (errno != EAGAIN)
455                                 {
456                                         log(DEBUG,'recv() failed for serverrec::RecvPacket(): %s',strerror(errno));
457                                         log(DEBUG,'Disabling connector: %s',this->connectors[i].GetServerName().c_str());
458                                         this->connectors[i].CloseConnection();
459                                         this->connectors[i].SetState(STATE_DISCONNECTED);
460                                         if (!IsRoutable(this->connectors[i].GetServerName()))
461                                         {
462                                                 WriteOpers('*** Server %s is no longer routable, disconnecting.',this->connectors[i].GetServerName().c_str());
463                                                 DoSplit(this->connectors[i].GetServerName().c_str());
464                                         }
465                                         has_been_netsplit = true;
466                                 }
467                         }
468                         int pushed = 0;
469                         if (rcvsize > 0)
470                         {
471                                 if (!this->connectors[i].AddBuffer(data))
472                                 {
473                                         WriteOpers('*** Read buffer for %s exceeds maximum, closing connection!',this->connectors[i].GetServerName().c_str());
474                                         this->connectors[i].CloseConnection();
475                                         this->connectors[i].SetState(STATE_DISCONNECTED);
476                                         if (!IsRoutable(this->connectors[i].GetServerName()))
477                                         {
478                                                 WriteOpers('*** Server %s is no longer routable, disconnecting.',this->connectors[i].GetServerName().c_str());
479                                                 DoSplit(this->connectors[i].GetServerName().c_str());
480                                         }
481                                         has_been_netsplit = true;
482                                 }
483                                 if (this->connectors[i].BufferIsComplete())
484                                 {
485                                         this->connectors[i].ResetPing();
486                                         while (this->connectors[i].BufferIsComplete())
487                                         {
488                                                 std::string text = this->connectors[i].GetBuffer();
489                                                 if (text != '')
490                                                 {
491                                                         if ((text[0] == ':') && (text.find(' ') != std::string::npos))
492                                                         {
493                                                                 std::string orig = text;
494                                                                 log(DEBUG,'Original: %s',text.c_str());
495                                                                 std::string sum = text.substr(1,text.find(' ')-1);
496                                                                 text = text.substr(text.find(' ')+1,text.length());
497                                                                 std::string possible_token = text.substr(1,text.find(' ')-1);
498                                                                 if (possible_token.length() > 1)
499                                                                 {
500                                                                         sums.push_back('*');
501                                                                         text = orig;
502                                                                         log(DEBUG,'Non-mesh, non-tokenized string passed up the chain');
503                                                                 }
504                                                                 else
505                                                                 {
506                                                                         log(DEBUG,'Packet sum: '%s'',sum.c_str());
507                                                                         if ((already_have_sum(sum)) && (sum != '*'))
508                                                                         {
509                                                                                 // we don't accept dupes
510                                                                                 continue;
511                                                                         }
512                                                                         sums.push_back(sum.c_str());
513                                                                 }
514                                                         }
515                                                         else sums.push_back('*');
516                                                         messages.push_back(text.c_str());
517                                                         strlcpy(recvhost,this->connectors[i].GetServerName().c_str(),160);
518                                                         log(DEBUG,'serverrec::RecvPacket() %d:%s->%s',pushed++,recvhost,text.c_str());
519                                                 }
520                                         }
521                                         return true;
522                                 }
523                         }
524                 }
525         }
526         // nothing new yet -- message and host will be undefined
527         return false;
528 }
.fi
.SS "bool serverrec::SendPacket (char * message, const char * host)"
.PP
Send a message to a server by name, if the server is unavailable directly route the packet via another server If the server still cannot be reached after attempting to route the message remotely, returns false. Definition at line 336 of file servers.cpp.
.PP
References ircd_connector::AddWriteBuf(), ircd_connector::CloseConnection(), connectors, DEBUG, FindHost(), ircd_connector::FlushWriteBuf(), ircd_connector::GetServerName(), ircd_connector::GetState(), ircd_connector::GetWriteError(), ircd_connector::SetState(), and STATE_DISCONNECTED.
.PP
Referenced by BeginLink(), and MeshCookie().
.PP
.nf
337 {
338         if ((!message) || (!sendhost))
339                 return true;
340 
341         ircd_connector* cn = this->FindHost(sendhost);
342 
343         if (!strchr(message,'\n'))
344         {
345                 strlcat(message,'\n',MAXBUF);
346         }
347 
348         if (cn)
349         {
350                 log(DEBUG,'main: serverrec::SendPacket() sent '%s' to %s',message,cn->GetServerName().c_str());
351 
352                 if (cn->GetState() == STATE_DISCONNECTED)
353                 {
354                         // fix: can only route one hop to avoid a loop
355                         if (strncmp(message,'R ',2))
356                         {
357                                 log(DEBUG,'Not a double reroute');
358                                 // this route is down, we must re-route the packet through an available point in the mesh.
359                                 for (int k = 0; k < this->connectors.size(); k++)
360                                 {
361                                         log(DEBUG,'Check connector %d: %s',k,this->connectors[k].GetServerName().c_str());
362                                         // search for another point in the mesh which can 'reach' where we want to go
363                                         for (int m = 0; m < this->connectors[k].routes.size(); m++)
364                                         {
365                                                 if (!strcasecmp(this->connectors[k].routes[m].c_str(),sendhost))
366                                                 {
367                                                         log(DEBUG,'Found alternative route for packet: %s',this->connectors[k].GetServerName().c_str());
368                                                         char buffer[MAXBUF];
369                                                         snprintf(buffer,MAXBUF,'R %s %s',sendhost,message);
370                                                         this->SendPacket(buffer,this->connectors[k].GetServerName().c_str());
371                                                         return true;
372                                                 }
373                                         }
374                                 }
375                         }
376                         char buffer[MAXBUF];
377                         snprintf(buffer,MAXBUF,'& %s',sendhost);
378                         WriteOpers('*** All connections to %s lost.',sendhost);
379                         NetSendToAllExcept(sendhost,buffer);
380                         DoSplit(sendhost);
381                         return false;
382                 }
383 
384                 // returns false if the packet could not be sent (e.g. target host down)
385                 if (!cn->AddWriteBuf(message))
386                 {
387                         // if we're here, there was an error pending, and the send cannot proceed
388                         log(DEBUG,'cn->AddWriteBuf() failed for serverrec::SendPacket(): %s',cn->GetWriteError().c_str());
389                         log(DEBUG,'Disabling connector: %s',cn->GetServerName().c_str());
390                         cn->CloseConnection();
391                         cn->SetState(STATE_DISCONNECTED);
392                         WriteOpers('*** Lost single connection to %s, link inactive and retrying: %s',cn->GetServerName().c_str(),cn->GetWriteError().c_str());
393                         // retry the packet along a new route so either arrival OR failure are gauranteed (bugfix)
394                         return this->SendPacket(message,sendhost);
395                 }
396                 if (!cn->FlushWriteBuf())
397                 {
398                         // if we're here the write() caused an error, we cannot proceed
399                         log(DEBUG,'cn->FlushWriteBuf() failed for serverrec::SendPacket(): %s',cn->GetWriteError().c_str());
400                         log(DEBUG,'Disabling connector: %s',cn->GetServerName().c_str());
401                         cn->CloseConnection();
402                         cn->SetState(STATE_DISCONNECTED);
403                         WriteOpers('*** Lost single connection to %s, link inactive and retrying: %s',cn->GetServerName().c_str(),cn->GetWriteError().c_str());
404                         // retry the packet along a new route so either arrival OR failure are gauranteed
405                         return this->SendPacket(message,sendhost);
406                 }
407                 return true;
408         }
409 }
.fi
.SS "void serverrec::TerminateLink (char * targethost)"
.PP
Terminate a link to 'targethost' by calling the \fBircd_connector::CloseConnection\fP method. Definition at line 234 of file servers.cpp.
.PP
.nf
235 {
236         // this locates the targethost in the serverrec::connectors vector of the class,
237        // and terminates it by sending it an SQUIT token and closing its descriptor.
238         // TerminateLink with a null string causes a terminate of ALL links
239 }
.fi
.SH "Member Data Documentation"
.PP 
.SS "std::vector<\fBircd_connector\fP> \fBserverrec::connectors\fP"
.PP
With a serverrec, this is a list of all established server connections. Definition at line 81 of file servers.h.
.PP
Referenced by AddIncoming(), BeginLink(), FindHost(), FlushWriteBuffers(), IsRoutable(), MeshCookie(), RecvPacket(), SendPacket(), and serverrec().
.SS "char \fBserverrec::description\fP[MAXBUF]"
.PP
Description of the server. Definition at line 61 of file servers.h.
.SS "int \fBserverrec::hops_away\fP"
.PP
number of hops away (for quick access) Definition at line 51 of file servers.h.
.PP
Referenced by serverrec().
.SS "bool \fBserverrec::jupiter\fP"
.PP
is a JUPE server (faked to enforce a server ban) Definition at line 57 of file servers.h.
.PP
Referenced by serverrec().
.SS "char \fBserverrec::name\fP[MAXBUF]"
.PP
server name Definition at line 36 of file servers.h.
.PP
Referenced by serverrec().
.SS "char \fBserverrec::nickserv\fP[NICKMAX]"
.PP
Holds nickserv's name on U:lined (services) servers (this is a kludge for ircservices which ASSUMES things :/). Definition at line 65 of file servers.h.
.PP
Referenced by serverrec().
.SS "long \fBserverrec::opercount\fP"
.PP
opers on server Definition at line 48 of file servers.h.
.PP
Referenced by serverrec().
.SS "long \fBserverrec::pingtime\fP"
.PP
last ping response (ms) Definition at line 39 of file servers.h.
.PP
Referenced by serverrec().
.SS "bool \fBserverrec::sync_soon\fP"
.PP
Definition at line 67 of file servers.h.
.PP
Referenced by serverrec().
.SS "long \fBserverrec::usercount\fP"
.PP
non-invisible users on server Definition at line 45 of file servers.h.
.PP
Referenced by serverrec().
.SS "long \fBserverrec::usercount_i\fP"
.PP
invisible users on server Definition at line 42 of file servers.h.
.PP
Referenced by serverrec().
.SS "long \fBserverrec::version\fP"
.PP
ircd version Definition at line 54 of file servers.h.
.PP
Referenced by serverrec().

.SH "Author"
.PP 
Generated automatically by Doxygen for InspIRCd from the source code.