socket.h 5.63 KB
Newer Older
1 2 3
/*
 *	BIRD Socket Interface
 *
4
 *	(c) 1998--2004 Martin Mares <mj@ucw.cz>
5 6 7 8 9 10 11
 *
 *	Can be freely distributed and used under the terms of the GNU GPL.
 */

#ifndef _BIRD_SOCKET_H_
#define _BIRD_SOCKET_H_

Ondřej Zajíček's avatar
Ondřej Zajíček committed
12
#include <errno.h>
13
// #include <sys/socket.h>
Ondřej Zajíček's avatar
Ondřej Zajíček committed
14

15
#include "lib/resource.h"
16

17 18
typedef struct birdsock {
  resource r;
19
  pool *pool;				/* Pool where incoming connections should be allocated (for SK_xxx_PASSIVE) */
20 21 22
  int type;				/* Socket type */
  void *data;				/* User data */
  ip_addr saddr, daddr;			/* IPA_NONE = unspecified */
Pavel Tvrdík's avatar
Pavel Tvrdík committed
23
  uint sport, dport;			/* 0 = unspecified (for IP: protocol type) */
24 25
  int tos;				/* TOS / traffic class, -1 = default */
  int priority;				/* Local socket priority, -1 = default */
26
  int ttl;				/* Time To Live, -1 = default */
27
  u32 flags;
Martin Mareš's avatar
Martin Mareš committed
28
  struct iface *iface;			/* Interface; specify this for broad/multicast sockets */
29 30

  byte *rbuf, *rpos;			/* NULL=allocate automatically */
31
  uint fast_rx;				/* RX has higher priority in event loop */
Pavel Tvrdík's avatar
Pavel Tvrdík committed
32
  uint rbsize;
Martin Mareš's avatar
Martin Mareš committed
33
  int (*rx_hook)(struct birdsock *, int size); /* NULL=receiving turned off, returns 1 to clear rx buffer */
34 35 36

  byte *tbuf, *tpos;			/* NULL=allocate automatically */
  byte *ttx;				/* Internal */
Pavel Tvrdík's avatar
Pavel Tvrdík committed
37
  uint tbsize;
38 39
  void (*tx_hook)(struct birdsock *);

Martin Mareš's avatar
Martin Mareš committed
40
  void (*err_hook)(struct birdsock *, int); /* errno or zero if EOF */
41

42 43
  /* Information about received datagrams (UDP, RAW), valid in rx_hook */
  ip_addr faddr, laddr;			/* src (From) and dst (Local) address of the datagram */
Pavel Tvrdík's avatar
Pavel Tvrdík committed
44 45
  uint fport;				/* src port of the datagram */
  uint lifindex;			/* local interface that received the datagram */
46
  /* laddr and lifindex are valid only if SKF_LADDR_RX flag is set to request it */
Martin Mareš's avatar
Martin Mareš committed
47

48
  int af;				/* Address family (AF_INET, AF_INET6 or 0 for non-IP) of fd */
Martin Mareš's avatar
Martin Mareš committed
49
  int fd;				/* System-dependent data */
50
  int index;				/* Index in poll buffer */
51
  int rcv_ttl;				/* TTL of last received datagram */
Martin Mareš's avatar
Martin Mareš committed
52
  node n;
53
  void *rbuf_alloc, *tbuf_alloc;
54 55
  char *password;			/* Password for MD5 authentication */
  char *err;				/* Error message */
Martin Mareš's avatar
Martin Mareš committed
56 57
} sock;

58 59 60
sock *sock_new(pool *);			/* Allocate new socket */
#define sk_new(X) sock_new(X)		/* Wrapper to avoid name collision with OpenSSL */

Martin Mareš's avatar
Martin Mareš committed
61
int sk_open(sock *);			/* Open socket */
62
int sk_rx_ready(sock *s);
Pavel Tvrdík's avatar
Pavel Tvrdík committed
63 64
int sk_send(sock *, uint len);		/* Send data, <0=err, >0=ok, 0=sleep */
int sk_send_to(sock *, uint len, ip_addr to, uint port); /* sk_send to given destination */
65
void sk_reallocate(sock *);		/* Free and allocate tbuf & rbuf */
66 67 68
void sk_set_rbsize(sock *s, uint val);	/* Resize RX buffer */
void sk_set_tbsize(sock *s, uint val);	/* Resize TX buffer, keeping content */
void sk_set_tbuf(sock *s, void *tbuf);	/* Switch TX buffer, NULL-> return to internal */
Martin Mareš's avatar
Martin Mareš committed
69
void sk_dump_all(void);
70

71 72
static inline int sk_send_buffer_empty(sock *sk)
{ return sk->tbuf == sk->tpos; }
73 74


75
#ifdef IPV6
76 77 78 79 80
#define sk_is_ipv4(X) 0
#define sk_is_ipv6(X) 1
#else
#define sk_is_ipv4(X) 1
#define sk_is_ipv6(X) 0
81 82
#endif

83

84 85 86 87 88 89 90 91 92 93 94
int sk_setup_multicast(sock *s);	/* Prepare UDP or IP socket for multicasting */
int sk_join_group(sock *s, ip_addr maddr);	/* Join multicast group on sk iface */
int sk_leave_group(sock *s, ip_addr maddr);	/* Leave multicast group on sk iface */
int sk_setup_broadcast(sock *s);
int sk_set_ttl(sock *s, int ttl);	/* Set transmit TTL for given socket */
int sk_set_min_ttl(sock *s, int ttl);	/* Set minimal accepted TTL for given socket */
int sk_set_md5_auth(sock *s, ip_addr a, struct iface *ifa, char *passwd);
int sk_set_ipv6_checksum(sock *s, int offset);
int sk_set_icmp6_filter(sock *s, int p1, int p2);
void sk_log_error(sock *s, const char *p);

Ondřej Zajíček's avatar
Ondřej Zajíček committed
95 96
byte * sk_rx_buffer(sock *s, int *len);	/* Temporary */

97
extern int sk_priority_control;		/* Suggested priority for control traffic, should be sysdep define */
Martin Mareš's avatar
Martin Mareš committed
98

99 100 101

/* Socket flags */

102 103 104 105 106
#define SKF_V4ONLY	0x01	/* Use IPv4 for IP sockets */
#define SKF_V6ONLY	0x02	/* Use IPV6_V6ONLY socket option */
#define SKF_LADDR_RX	0x04	/* Report local address for RX packets */
#define SKF_TTL_RX	0x08	/* Report TTL / Hop Limit for RX packets */
#define SKF_BIND	0x10	/* Bind datagram socket to given source address */
107
#define SKF_HIGH_PORT	0x20	/* Choose port from high range if possible */
108

109
#define SKF_THREAD	0x100	/* Socked used in thread, Do not add to main loop */
110 111 112
#define SKF_TRUNCATED	0x200	/* Received packet was truncated, set by IO layer */
#define SKF_HDRINCL	0x400	/* Used internally */
#define SKF_PKTINFO	0x800	/* Used internally */
113

114
/*
Martin Mareš's avatar
Martin Mareš committed
115
 *	Socket types		     SA SP DA DP IF  TTL SendTo	(?=may, -=must not, *=must)
116 117
 */

Martin Mareš's avatar
Martin Mareš committed
118 119 120
#define SK_TCP_PASSIVE	0	   /* ?  *  -  -  -  ?   -	*/
#define SK_TCP_ACTIVE	1          /* ?  ?  *  *  -  ?   -	*/
#define SK_TCP		2
Ondřej Zajíček's avatar
Ondřej Zajíček committed
121 122
#define SK_UDP		3          /* ?  ?  ?  ?  ?  ?   ?	*/
#define SK_IP		5          /* ?  -  ?  *  ?  ?   ?	*/
123
#define SK_MAGIC	7	   /* Internal use by sysdep code */
124 125
#define SK_UNIX_PASSIVE	8
#define SK_UNIX		9
126

127
/*
Ondřej Zajíček's avatar
Ondřej Zajíček committed
128 129 130 131 132 133 134 135 136 137
 *  For SK_UDP or SK_IP sockets setting DA/DP allows to use sk_send(),
 *  otherwise sk_send_to() must be used.
 *
 *  For SK_IP sockets setting DP specifies protocol number, which is used
 *  for both receiving and sending.
 *
 *  For multicast on SK_UDP or SK_IP sockets set IF and TTL,
 *  call sk_setup_multicast() to enable multicast on that socket,
 *  and then use sk_join_group() and sk_leave_group() to manage
 *  a set of received multicast groups.
138 139 140 141 142 143 144 145
 *
 *  For datagram (SK_UDP, SK_IP) sockets, there are two ways to handle
 *  source address. The socket could be bound to it using bind()
 *  syscall, but that also forbids the reception of multicast packets,
 *  or the address could be set on per-packet basis using platform
 *  dependent options (but these are not available in some corner
 *  cases). The first way is used when SKF_BIND is specified, the
 *  second way is used otherwise.
146 147
 */

148
#endif