3 * Communication with the peer
5 * (c) 2001 Straylight/Edgeware
8 /*----- Licensing notice --------------------------------------------------*
10 * This file is part of Trivial IP Encryption (TrIPE).
12 * TrIPE is free software: you can redistribute it and/or modify it under
13 * the terms of the GNU General Public License as published by the Free
14 * Software Foundation; either version 3 of the License, or (at your
15 * option) any later version.
17 * TrIPE is distributed in the hope that it will be useful, but WITHOUT
18 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
19 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
22 * You should have received a copy of the GNU General Public License
23 * along with TrIPE. If not, see <https://www.gnu.org/licenses/>.
26 /*----- Header files ------------------------------------------------------*/
30 /*----- Static variables --------------------------------------------------*/
32 static sym_table byname
;
33 static addrmap byaddr
;
35 static unsigned nmobile
;
37 /*----- Tunnel table ------------------------------------------------------*/
39 const tunnel_ops
*tunnels
[] = {
53 /*----- Main code ---------------------------------------------------------*/
55 /* --- @p_pingtype@ --- *
57 * Arguments: @unsigned msg@ = message type
59 * Returns: String to describe the message.
62 static const char *p_pingtype(unsigned msg
)
64 switch (msg
& MSG_TYPEMASK
) {
67 return "transport-ping";
70 return "encrypted-ping";
76 /* --- @p_ponged@ --- *
78 * Arguments: @peer *p@ = peer packet arrived from
79 * @unsigned msg@ = message type
80 * @buf *b@ = buffer containing payload
84 * Use: Processes a ping response.
87 static void p_ponged(peer
*p
, unsigned msg
, buf
*b
)
94 trace(T_PEER
, "peer: received %s reply from %s",
95 p_pingtype(msg
), p
->spec
.name
);
96 trace_block(T_PACKET
, "peer: ping contents", BBASE(b
), BSZ(b
));
99 if (buf_getu32(b
, &id
) ||
100 (magic
= buf_get(b
, sizeof(pg
->magic
))) == 0 ||
102 a_warn("PEER", "?PEER", p
, "malformed-%s", p_pingtype(msg
), A_END
);
106 for (pg
= p
->pings
; pg
; pg
= pg
->next
) {
112 "unexpected-%s", p_pingtype(msg
),
113 "0x%08lx", (unsigned long)id
,
118 if (memcmp(magic
, pg
->magic
, sizeof(pg
->magic
)) != 0) {
119 a_warn("PEER", "?PEER", p
, "corrupt-%s", p_pingtype(msg
), A_END
);
122 p_pingdone(pg
, PING_OK
);
125 /* --- @p_rxupdstats@ --- *
127 * Arguments: @peer *p@ = peer to update
128 * @size_t n@ = size of incoming packet
132 * Use: Updates the peer's incoming packet statistics.
135 static void p_rxupdstats(peer
*p
, size_t n
)
137 p
->st
.t_last
= time(0);
142 /* --- @p_encrypt@ --- *
144 * Arguments: @peer *p@ = peer to encrypt message to
145 * @int ty@ message type to send
146 * @buf *bin, *bout@ = input and output buffers
150 * Use: Convenience function for packet encryption. Forces
151 * renegotiation when necessary. Check for the output buffer
152 * being broken to find out whether the encryption was
156 static int p_encrypt(peer
*p
, int ty
, buf
*bin
, buf
*bout
)
158 int err
= ksl_encrypt(&p
->ks
, ty
, bin
, bout
);
160 if (err
== KSERR_REGEN
) {
169 /* --- @p_updateaddr@ --- *
171 * Arguments: @peer *p@ = pointer to peer block
172 * @const addr *a@ = address to associate with this peer
174 * Returns: Zero if the address was changed; @+1@ if it was already
177 * Use: Updates our idea of @p@'s address.
180 int p_updateaddr(peer
*p
, const addr
*a
)
183 peer_byaddr
*pa
, *qa
;
186 /* --- Figure out how to proceed --- *
188 * If this address already belongs to a different peer, then swap the
189 * addresses over. This doesn't leave the displaced peer in an especially
190 * good state, but it ought to get sorted out soon enough.
193 pa
= am_find(&byaddr
, a
, sizeof(peer_byaddr
), &f
);
197 T( trace(T_PEER
, "peer: updating address for `%s'", p_name(p
)); )
198 am_remove(&byaddr
, p
->byaddr
);
199 p
->byaddr
= pa
; p
->spec
.sa
= *a
; pa
->p
= p
;
200 a_notify("NEWADDR", "?PEER", p
, "?ADDR", a
, A_END
);
203 q
= pa
->p
; qa
= p
->byaddr
;
204 T( trace(T_PEER
, "peer: swapping addresses for `%s' and `%s'",
205 p_name(p
), p_name(q
)); )
206 q
->byaddr
= qa
; qa
->p
= q
; q
->spec
.sa
= p
->spec
.sa
;
207 p
->byaddr
= pa
; pa
->p
= p
; p
->spec
.sa
= *a
;
208 a_notify("NEWADDR", "?PEER", p
, "?ADDR", a
, A_END
);
209 a_notify("NEWADDR", "?PEER", q
, "?ADDR", &q
->spec
.sa
, A_END
);
214 /* --- @p_decrypt@ --- *
216 * Arguments: @peer **pp@ = pointer to peer to decrypt message from
217 * @addr *a@ = address the packet arrived on
218 * @size_t n@ = size of original incoming packet
219 * @int ty@ = message type to expect
220 * @buf *bin, *bout@ = input and output buffers
222 * Returns: Zero on success; nonzero on error.
224 * Use: Convenience function for packet decryption. Reports errors
225 * and updates statistics appropriately.
227 * If @*pp@ is null on entry and there are mobile peers then we
228 * see if any of them can decrypt the packet. If so, we record
229 * @*a@ as the peer's new address and send a notification.
232 static int p_decrypt(peer
**pp
, addr
*a
, size_t n
,
233 int ty
, buf
*bin
, buf
*bout
)
236 int err
= KSERR_DECRYPT
;
238 /* --- If we have a match on the source address then try that first --- */
242 T( trace(T_PEER
, "peer: decrypting packet from known peer `%s'",
244 if ((err
= ksl_decrypt(&q
->ks
, ty
, bin
, bout
)) != KSERR_DECRYPT
||
245 !(q
->spec
.f
& PSF_MOBILE
) || nmobile
== 1) {
249 T( trace(T_PEER
, "peer: failed to decrypt: try other mobile peers..."); )
251 T( trace(T_PEER
, "peer: unknown source: trying mobile peers...") );
257 /* --- See whether any mobile peer is interested --- */
261 if (qq
== q
|| !(qq
->spec
.f
& PSF_MOBILE
)) continue;
262 if ((err
= ksl_decrypt(&qq
->ks
, ty
, bin
, bout
)) == KSERR_DECRYPT
) {
263 T( trace(T_PEER
, "peer: peer `%s' failed to decrypt",
270 trace(T_PEER
, "peer: peer `%s' reports success", p_name(qq
));
272 trace(T_PEER
, "peer: peer `%s' reports decryption error %d",
280 /* --- We've searched the mobile peers --- */
285 a_warn("PEER", "-", "unexpected-source", "?ADDR", a
, A_END
);
287 a_warn("PEER", "?PEER", p
, "decrypt-failed",
288 "error-code", "%d", err
, A_END
);
294 /* --- We found one that accepted, so update the peer's address --- */
304 if (p
) p
->st
.n_reject
++;
305 a_warn("PEER", "?PEER", p
, "decrypt-failed",
306 "error-code", "%d", err
, A_END
);
314 /* --- @p_read@ --- *
316 * Arguments: @int fd@ = file descriptor to read from
317 * @unsigned mode@ = what happened
318 * @void *v@ = an uninteresting pointer
322 * Use: Reads a packet from somewhere.
325 static void p_read(int fd
, unsigned mode
, void *v
)
334 /* --- Read the data --- */
338 n
= recvfrom(fd
, buf_i
, sizeof(buf_i
), 0, &a
.sa
, &sz
);
340 a_warn("PEER", "-", "socket-read-error", "?ERRNO", A_END
);
344 /* --- If the packet is a greeting, don't check peers --- */
346 if (n
&& buf_i
[0] == (MSG_MISC
| MISC_GREET
)) {
348 trace(T_PEER
, "peer: greeting received from INET %s %u",
349 inet_ntoa(a
.sin
.sin_addr
),
350 (unsigned)ntohs(a
.sin
.sin_port
));
351 trace_block(T_PACKET
, "peer: greeting contents", buf_i
, n
);
353 buf_init(&b
, buf_i
, n
);
355 if (c_check(&b
) || BLEFT(&b
)) {
356 a_warn("PEER", "-", "invalid-greeting", A_END
);
360 "?B64", buf_i
+ 1, (size_t)(n
- 1),
366 /* --- Find the appropriate peer --- *
368 * At this stage, don't worry too much about whether we actually found it.
371 p
= p_findbyaddr(&a
);
376 "peer: packet received from `%s' from address INET %s %d",
377 p_name(p
), inet_ntoa(a
.sin
.sin_addr
), ntohs(a
.sin
.sin_port
));
379 trace(T_PEER
, "peer: packet received from unknown address INET %s %d",
380 inet_ntoa(a
.sin
.sin_addr
), ntohs(a
.sin
.sin_port
));
382 trace_block(T_PACKET
, "peer: packet contents", buf_i
, n
);
385 /* --- Pick the packet apart --- */
387 buf_init(&b
, buf_i
, n
);
388 if ((ch
= buf_getbyte(&b
)) < 0) {
389 a_warn("PEER", "?PEER", p
, "bad-packet", "no-type", A_END
);
392 switch (ch
& MSG_CATMASK
) {
394 if (ch
& MSG_TYPEMASK
) {
398 "unknown-type", "0x%02x", ch
,
400 if (p
) p
->st
.n_reject
++;
403 buf_init(&bb
, buf_o
, sizeof(buf_o
));
404 if (p_decrypt(&p
, &a
, n
, MSG_PACKET
, &b
, &bb
))
408 p
->st
.sz_ipin
+= BSZ(&b
);
409 p
->t
->ops
->inject(p
->t
, &bb
);
412 a_warn("PEER", "?PEER", p
, "packet-build-failed", A_END
);
418 kx_message(&p
->kx
, ch
& MSG_TYPEMASK
, &b
);
421 switch (ch
& MSG_TYPEMASK
) {
425 T( trace(T_PEER
, "peer: received NOP packet"); )
430 buf_put(p_txstart(p
, MSG_MISC
| MISC_PONG
), BCUR(&b
), BLEFT(&b
));
436 p_ponged(p
, MISC_PONG
, &b
);
439 buf_init(&bb
, buf_t
, sizeof(buf_t
));
440 if (p_decrypt(&p
, &a
, n
, ch
, &b
, &bb
))
444 p_encrypt(p
, MSG_MISC
| MISC_EPONG
, &bb
,
445 p_txstart(p
, MSG_MISC
| MISC_EPONG
));
450 buf_init(&bb
, buf_t
, sizeof(buf_t
));
451 if (p_decrypt(&p
, &a
, n
, ch
, &b
, &bb
))
455 p_ponged(p
, MISC_EPONG
, &bb
);
461 if (p
) p
->st
.n_reject
++;
465 "unknown-category", "0x%02x", ch
,
469 a_warn("PEER", "-", "unexpected-source", "?ADDR", &a
, A_END
);
474 /* --- @p_txstart@ --- *
476 * Arguments: @peer *p@ = pointer to peer block
477 * @unsigned msg@ = message type code
479 * Returns: A pointer to a buffer to write to.
481 * Use: Starts sending to a peer. Only one send can happen at a
485 buf
*p_txstart(peer
*p
, unsigned msg
)
487 buf_init(&p
->b
, buf_o
, sizeof(buf_o
));
488 buf_putbyte(&p
->b
, msg
);
492 /* --- @p_txend@ --- *
494 * Arguments: @peer *p@ = pointer to peer block
498 * Use: Sends a packet to the peer.
501 static void p_setkatimer(peer
*);
503 static int p_dotxend(peer
*p
)
505 socklen_t sasz
= addrsz(&p
->spec
.sa
);
508 a_warn("PEER", "?PEER", p
, "packet-build-failed", A_END
);
511 IF_TRACING(T_PEER
, trace_block(T_PACKET
, "peer: sending packet",
512 BBASE(&p
->b
), BLEN(&p
->b
)); )
513 if (sendto(sock
.fd
, BBASE(&p
->b
), BLEN(&p
->b
),
514 0, &p
->spec
.sa
.sa
, sasz
) < 0) {
515 a_warn("PEER", "?PEER", p
, "socket-write-error", "?ERRNO", A_END
);
519 p
->st
.sz_out
+= BLEN(&p
->b
);
524 void p_txend(peer
*p
)
526 if (p_dotxend(p
) && p
->spec
.t_ka
) {
527 sel_rmtimer(&p
->tka
);
532 /* --- @p_pingwrite@ --- *
534 * Arguments: @ping *p@ = ping structure
535 * @buf *b@ = buffer to write in
539 * Use: Fills in a ping structure and writes the packet payload.
542 static void p_pingwrite(ping
*p
, buf
*b
)
544 static uint32 seq
= 0;
547 GR_FILL(&rand_global
, p
->magic
, sizeof(p
->magic
));
548 buf_putu32(b
, p
->id
);
549 buf_put(b
, p
->magic
, sizeof(p
->magic
));
552 /* --- @p_pingdone@ --- *
554 * Arguments: @ping *p@ = ping structure
555 * @int rc@ = return code to pass on
559 * Use: Disposes of a ping structure, maybe sending a notification.
562 void p_pingdone(ping
*p
, int rc
)
564 if (p
->prev
) p
->prev
->next
= p
->next
;
565 else p
->p
->pings
= p
->next
;
566 if (p
->next
) p
->next
->prev
= p
->prev
;
567 if (rc
!= PING_TIMEOUT
) sel_rmtimer(&p
->t
);
568 T( trace(T_PEER
, "peer: ping 0x%08lx done (rc = %d)",
569 (unsigned long)p
->id
, rc
); )
570 if (rc
>= 0) p
->func(rc
, p
->arg
);
573 /* --- @p_pingtimeout@ --- *
575 * Arguments: @struct timeval *now@ = the time now
576 * @void *pv@ = pointer to ping block
580 * Use: Called when a ping times out.
583 static void p_pingtimeout(struct timeval
*now
, void *pv
)
587 T( trace(T_PEER
, "peer: ping 0x%08lx timed out", (unsigned long)p
->id
); )
588 p_pingdone(p
, PING_TIMEOUT
);
591 /* --- @p_pingsend@ --- *
593 * Arguments: @peer *p@ = destination peer
594 * @ping *pg@ = structure to fill in
595 * @unsigned type@ = message type
596 * @unsigned long timeout@ = how long to wait before giving up
597 * @void (*func)(int, void *)@ = callback function
598 * @void *arg@ = argument for callback
600 * Returns: Zero if successful, nonzero if it failed.
602 * Use: Sends a ping to a peer. Call @func@ with a nonzero argument
603 * if we get an answer within the timeout, or zero if no answer.
606 int p_pingsend(peer
*p
, ping
*pg
, unsigned type
,
607 unsigned long timeout
,
608 void (*func
)(int, void *), void *arg
)
616 b
= p_txstart(p
, MSG_MISC
| MISC_PING
);
621 pg
->msg
= MISC_EPONG
;
622 b
= p_txstart(p
, MSG_MISC
| MISC_EPING
);
623 buf_init(&bb
, buf_t
, sizeof(buf_t
));
624 p_pingwrite(pg
, &bb
);
626 p_encrypt(p
, MSG_MISC
| MISC_EPING
, &bb
, b
);
641 if (p
->pings
) p
->pings
->prev
= pg
;
643 gettimeofday(&tv
, 0);
644 tv
.tv_sec
+= timeout
;
645 sel_addtimer(&sel
, &pg
->t
, &tv
, p_pingtimeout
, pg
);
646 T( trace(T_PEER
, "peer: send %s 0x%08lx to %s",
647 p_pingtype(type
), (unsigned long)pg
->id
, p
->spec
.name
); )
651 /* --- @p_greet@ --- *
653 * Arguments: @peer *p@ = peer to send to
654 * @const void *c@ = pointer to challenge
655 * @size_t sz@ = size of challenge
659 * Use: Sends a greeting packet.
662 void p_greet(peer
*p
, const void *c
, size_t sz
)
664 buf
*b
= p_txstart(p
, MSG_MISC
| MISC_GREET
);
671 * Arguments: @peer *p@ = pointer to peer block
672 * @buf *b@ = buffer containing incoming packet
676 * Use: Handles a packet which needs to be sent to a peer.
679 void p_tun(peer
*p
, buf
*b
)
681 buf
*bb
= p_txstart(p
, MSG_PACKET
);
684 p_encrypt(p
, MSG_PACKET
, b
, bb
);
685 if (BOK(bb
) && BLEN(bb
)) {
687 p
->st
.sz_ipout
+= BLEN(bb
);
692 /* --- @p_keyreload@ --- *
698 * Use: Forces a check of the daemon's keyring files.
701 void p_keyreload(void)
704 FOREACH_PEER(p
, { kx_newkeys(&p
->kx
); });
707 /* --- @p_interval@ --- *
713 * Use: Called periodically to do tidying.
716 void p_interval(void)
719 FOREACH_PEER(p
, { ksl_prune(&p
->ks
); });
722 /* --- @p_stats@ --- *
724 * Arguments: @peer *p@ = pointer to a peer block
726 * Returns: A pointer to the peer's statistics.
729 stats
*p_stats(peer
*p
) { return (&p
->st
); }
731 /* --- @p_ifname@ --- *
733 * Arguments: @peer *p@ = pointer to a peer block
735 * Returns: A pointer to the peer's interface name.
738 const char *p_ifname(peer
*p
) { return (p
->ifname
); }
740 /* --- @p_setifname@ --- *
742 * Arguments: @peer *p@ = pointer to a peer block
743 * @const char *name@ = pointer to the new name
747 * Use: Changes the name held for a peer's interface.
750 void p_setifname(peer
*p
, const char *name
)
753 p
->ifname
= xstrdup(name
);
754 if (p
->spec
.tops
->setifname
)
755 p
->spec
.tops
->setifname(p
->t
, name
);
758 /* --- @p_addr@ --- *
760 * Arguments: @peer *p@ = pointer to a peer block
762 * Returns: A pointer to the peer's address.
765 const addr
*p_addr(peer
*p
) { return (&p
->spec
.sa
); }
767 /* --- @p_init@ --- *
769 * Arguments: @struct in_addr addr@ = address to bind to
770 * @unsigned port@ = port number to listen to
774 * Use: Initializes the peer system; creates the socket.
777 void p_init(struct in_addr addr
, unsigned port
)
780 struct sockaddr_in sin
;
783 /* --- Note on socket buffer sizes --- *
785 * For some bizarre reason, Linux 2.2 (at least) doubles the socket buffer
786 * sizes I pass to @setsockopt@. I'm not putting special-case code here
787 * for Linux: BSD (at least TCPv2) does what I tell it rather than second-
791 if ((fd
= socket(PF_INET
, SOCK_DGRAM
, 0)) < 0)
792 die(EXIT_FAILURE
, "socket creation failed: %s", strerror(errno
));
794 sin
.sin_family
= AF_INET
;
796 sin
.sin_port
= htons(port
);
797 if (bind(fd
, (struct sockaddr
*)&sin
, sizeof(sin
)))
798 die(EXIT_FAILURE
, "bind failed: %s", strerror(errno
));
799 if (setsockopt(fd
, SOL_SOCKET
, SO_RCVBUF
, &len
, sizeof(len
)) ||
800 setsockopt(fd
, SOL_SOCKET
, SO_SNDBUF
, &len
, sizeof(len
))) {
801 die(EXIT_FAILURE
, "failed to set socket buffer sizes: %s",
804 fdflags(fd
, O_NONBLOCK
, O_NONBLOCK
, FD_CLOEXEC
, FD_CLOEXEC
);
805 sel_initfile(&sel
, &sock
, fd
, SEL_READ
, p_read
, 0);
807 T( trace(T_PEER
, "peer: created socket"); )
813 /* --- @p_port@ --- *
817 * Returns: Port number used for socket.
820 unsigned p_port(void)
823 socklen_t sz
= sizeof(addr
);
825 if (getsockname(sock
.fd
, &a
.sa
, &sz
))
826 die(EXIT_FAILURE
, "couldn't read port number: %s", strerror(errno
));
827 assert(a
.sa
.sa_family
== AF_INET
);
828 return (ntohs(a
.sin
.sin_port
));
831 /* --- @p_keepalive@ --- *
833 * Arguments: @struct timeval *now@ = the current time
834 * @void *pv@ = peer to wake up
838 * Use: Sends a keepalive ping message to its peer.
841 static void p_keepalive(struct timeval
*now
, void *pv
)
845 p_txstart(p
, MSG_MISC
| MISC_NOP
); p_dotxend(p
);
846 T( trace(T_PEER
, "peer: sent keepalive to %s", p
->spec
.name
); )
850 /* --- @p_setkatimer@ --- *
852 * Arguments: @peer *p@ = peer to set
856 * Use: Resets the keepalive timer thing.
859 static void p_setkatimer(peer
*p
)
865 gettimeofday(&tv
, 0);
866 tv
.tv_sec
+= p
->spec
.t_ka
;
867 sel_addtimer(&sel
, &p
->tka
, &tv
, p_keepalive
, p
);
870 /* --- @p_create@ --- *
872 * Arguments: @peerspec *spec@ = information about this peer
874 * Returns: Pointer to the peer block, or null if it failed.
876 * Use: Creates a new named peer block. No peer is actually attached
880 peer
*p_create(peerspec
*spec
)
882 peer
*p
= CREATE(peer
);
883 const tunnel_ops
*tops
= spec
->tops
;
887 p
->byname
= sym_find(&byname
, spec
->name
, -1, sizeof(peer_byname
), &f
);
889 p
->byaddr
= am_find(&byaddr
, &spec
->sa
, sizeof(peer_byaddr
), &f
);
891 p
->byname
->p
= p
->byaddr
->p
= p
;
893 T( trace(T_PEER
, "peer: creating new peer `%s'", spec
->name
); )
895 p
->spec
.name
= (/*unconst*/ char *)SYM_NAME(p
->byname
);
896 if (spec
->tag
) p
->spec
.tag
= xstrdup(spec
->tag
);
897 if (spec
->privtag
) p
->spec
.privtag
= xstrdup(spec
->privtag
);
901 memset(&p
->st
, 0, sizeof(stats
));
902 p
->st
.t_start
= time(0);
903 if (!(tops
->flags
& TUNF_PRIVOPEN
))
905 else if ((fd
= ps_tunfd(tops
, &p
->ifname
)) < 0)
907 if ((p
->t
= tops
->create(p
, fd
, &p
->ifname
)) == 0)
909 T( trace(T_TUNNEL
, "peer: attached interface %s to peer `%s'",
910 p
->ifname
, p_name(p
)); )
912 if (kx_init(&p
->kx
, p
, &p
->ks
, p
->spec
.f
& PSF_KXMASK
))
917 "?ADDR", &p
->spec
.sa
,
919 if (!(p
->spec
.f
& KXF_CORK
)) {
920 a_notify("KXSTART", "?PEER", p
, A_END
);
921 /* Couldn't tell anyone before */
923 if (p
->spec
.f
& PSF_MOBILE
) nmobile
++;
927 if (spec
->t_ka
) sel_rmtimer(&p
->tka
);
929 p
->t
->ops
->destroy(p
->t
);
931 if (fd
>= 0) close(fd
);
933 am_remove(&byaddr
, p
->byaddr
);
934 if (p
->spec
.tag
) xfree(p
->spec
.tag
);
935 if (p
->spec
.privtag
) xfree(p
->spec
.privtag
);
937 sym_remove(&byname
, p
->byname
);
943 /* --- @p_name@ --- *
945 * Arguments: @peer *p@ = pointer to a peer block
947 * Returns: A pointer to the peer's name.
950 const char *p_name(peer
*p
)
951 { if (p
) return (p
->spec
.name
); else return ("-"); }
955 * Arguments: @peer *p@ = pointer to a peer block
957 * Returns: A pointer to the peer's public key tag.
960 const char *p_tag(peer
*p
)
961 { return (p
->spec
.tag ? p
->spec
.tag
: p
->spec
.name
); }
963 /* --- @p_privtag@ --- *
965 * Arguments: @peer *p@ = pointer to a peer block
967 * Returns: A pointer to the peer's private key tag.
970 const char *p_privtag(peer
*p
)
971 { return (p
->spec
.privtag ? p
->spec
.privtag
: tag_priv
); }
973 /* --- @p_spec@ --- *
975 * Arguments: @peer *p@ = pointer to a peer block
977 * Returns: Pointer to the peer's specification
980 const peerspec
*p_spec(peer
*p
) { return (&p
->spec
); }
982 /* --- @p_findbyaddr@ --- *
984 * Arguments: @const addr *a@ = address to look up
986 * Returns: Pointer to the peer block, or null if not found.
988 * Use: Finds a peer by address.
991 peer
*p_findbyaddr(const addr
*a
)
995 if ((pa
= am_find(&byaddr
, a
, 0, 0)) != 0) {
1002 /* --- @p_find@ --- *
1004 * Arguments: @const char *name@ = name to look up
1006 * Returns: Pointer to the peer block, or null if not found.
1008 * Use: Finds a peer by name.
1011 peer
*p_find(const char *name
)
1015 if ((pn
= sym_find(&byname
, name
, -1, 0, 0)) != 0)
1020 /* --- @p_destroy@ --- *
1022 * Arguments: @peer *p@ = pointer to a peer
1026 * Use: Destroys a peer.
1029 void p_destroy(peer
*p
)
1033 T( trace(T_PEER
, "peer: destroying peer `%s'", p
->spec
.name
); )
1034 a_notify("KILL", "%s", p
->spec
.name
, A_END
);
1037 if (p
->spec
.f
& PSF_MOBILE
) nmobile
--;
1038 if (p
->ifname
) xfree(p
->ifname
);
1039 if (p
->spec
.tag
) xfree(p
->spec
.tag
);
1040 if (p
->spec
.privtag
) xfree(p
->spec
.privtag
);
1041 p
->t
->ops
->destroy(p
->t
);
1042 if (p
->spec
.t_ka
) sel_rmtimer(&p
->tka
);
1043 for (pg
= p
->pings
; pg
; pg
= ppg
) {
1045 p_pingdone(pg
, PING_PEERDIED
);
1047 sym_remove(&byname
, p
->byname
);
1048 am_remove(&byaddr
, p
->byaddr
);
1052 /* --- @p_mkiter@ --- *
1054 * Arguments: @peer_iter *i@ = pointer to an iterator
1058 * Use: Initializes the iterator.
1061 void p_mkiter(peer_iter
*i
) { sym_mkiter(&i
->i
, &byname
); }
1063 /* --- @p_next@ --- *
1065 * Arguments: @peer_iter *i@ = pointer to an iterator
1067 * Returns: Next peer, or null if at the end.
1069 * Use: Returns the next peer.
1072 peer
*p_next(peer_iter
*i
)
1076 if ((pn
= sym_next(&i
->i
)) == 0)
1081 /*----- That's all, folks -------------------------------------------------*/