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(0, 0, &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 -------------------------------------------------*/