diff options
Diffstat (limited to 'net/dccp/ackvec.h')
-rw-r--r-- | net/dccp/ackvec.h | 115 |
1 files changed, 65 insertions, 50 deletions
diff --git a/net/dccp/ackvec.h b/net/dccp/ackvec.h index 7ea557b7c6b1..23880be8fc29 100644 --- a/net/dccp/ackvec.h +++ b/net/dccp/ackvec.h | |||
@@ -3,9 +3,9 @@ | |||
3 | /* | 3 | /* |
4 | * net/dccp/ackvec.h | 4 | * net/dccp/ackvec.h |
5 | * | 5 | * |
6 | * An implementation of the DCCP protocol | 6 | * An implementation of Ack Vectors for the DCCP protocol |
7 | * Copyright (c) 2007 University of Aberdeen, Scotland, UK | ||
7 | * Copyright (c) 2005 Arnaldo Carvalho de Melo <acme@mandriva.com> | 8 | * Copyright (c) 2005 Arnaldo Carvalho de Melo <acme@mandriva.com> |
8 | * | ||
9 | * This program is free software; you can redistribute it and/or modify it | 9 | * This program is free software; you can redistribute it and/or modify it |
10 | * under the terms of the GNU General Public License version 2 as | 10 | * under the terms of the GNU General Public License version 2 as |
11 | * published by the Free Software Foundation. | 11 | * published by the Free Software Foundation. |
@@ -13,75 +13,89 @@ | |||
13 | 13 | ||
14 | #include <linux/dccp.h> | 14 | #include <linux/dccp.h> |
15 | #include <linux/compiler.h> | 15 | #include <linux/compiler.h> |
16 | #include <linux/ktime.h> | ||
17 | #include <linux/list.h> | 16 | #include <linux/list.h> |
18 | #include <linux/types.h> | 17 | #include <linux/types.h> |
19 | 18 | ||
20 | /* We can spread an ack vector across multiple options */ | 19 | /* |
21 | #define DCCP_MAX_ACKVEC_LEN (DCCP_SINGLE_OPT_MAXLEN * 2) | 20 | * Ack Vector buffer space is static, in multiples of %DCCP_SINGLE_OPT_MAXLEN, |
21 | * the maximum size of a single Ack Vector. Setting %DCCPAV_NUM_ACKVECS to 1 | ||
22 | * will be sufficient for most cases of low Ack Ratios, using a value of 2 gives | ||
23 | * more headroom if Ack Ratio is higher or when the sender acknowledges slowly. | ||
24 | * The maximum value is bounded by the u16 types for indices and functions. | ||
25 | */ | ||
26 | #define DCCPAV_NUM_ACKVECS 2 | ||
27 | #define DCCPAV_MAX_ACKVEC_LEN (DCCP_SINGLE_OPT_MAXLEN * DCCPAV_NUM_ACKVECS) | ||
22 | 28 | ||
23 | /* Estimated minimum average Ack Vector length - used for updating MPS */ | 29 | /* Estimated minimum average Ack Vector length - used for updating MPS */ |
24 | #define DCCPAV_MIN_OPTLEN 16 | 30 | #define DCCPAV_MIN_OPTLEN 16 |
25 | 31 | ||
26 | #define DCCP_ACKVEC_STATE_RECEIVED 0 | 32 | enum dccp_ackvec_states { |
27 | #define DCCP_ACKVEC_STATE_ECN_MARKED (1 << 6) | 33 | DCCPAV_RECEIVED = 0x00, |
28 | #define DCCP_ACKVEC_STATE_NOT_RECEIVED (3 << 6) | 34 | DCCPAV_ECN_MARKED = 0x40, |
35 | DCCPAV_RESERVED = 0x80, | ||
36 | DCCPAV_NOT_RECEIVED = 0xC0 | ||
37 | }; | ||
38 | #define DCCPAV_MAX_RUNLEN 0x3F | ||
29 | 39 | ||
30 | #define DCCP_ACKVEC_STATE_MASK 0xC0 /* 11000000 */ | 40 | static inline u8 dccp_ackvec_runlen(const u8 *cell) |
31 | #define DCCP_ACKVEC_LEN_MASK 0x3F /* 00111111 */ | 41 | { |
42 | return *cell & DCCPAV_MAX_RUNLEN; | ||
43 | } | ||
32 | 44 | ||
33 | /** struct dccp_ackvec - ack vector | 45 | static inline u8 dccp_ackvec_state(const u8 *cell) |
34 | * | 46 | { |
35 | * This data structure is the one defined in RFC 4340, Appendix A. | 47 | return *cell & ~DCCPAV_MAX_RUNLEN; |
36 | * | 48 | } |
37 | * @av_buf_head - circular buffer head | 49 | |
38 | * @av_buf_tail - circular buffer tail | 50 | /** struct dccp_ackvec - Ack Vector main data structure |
39 | * @av_buf_ackno - ack # of the most recent packet acknowledgeable in the | ||
40 | * buffer (i.e. %av_buf_head) | ||
41 | * @av_buf_nonce - the one-bit sum of the ECN Nonces on all packets acked | ||
42 | * by the buffer with State 0 | ||
43 | * | ||
44 | * Additionally, the HC-Receiver must keep some information about the | ||
45 | * Ack Vectors it has recently sent. For each packet sent carrying an | ||
46 | * Ack Vector, it remembers four variables: | ||
47 | * | 51 | * |
48 | * @av_records - list of dccp_ackvec_record | 52 | * This implements a fixed-size circular buffer within an array and is largely |
49 | * @av_ack_nonce - the one-bit sum of the ECN Nonces for all State 0. | 53 | * based on Appendix A of RFC 4340. |
50 | * | 54 | * |
51 | * @av_time - the time in usecs | 55 | * @av_buf: circular buffer storage area |
52 | * @av_buf - circular buffer of acknowledgeable packets | 56 | * @av_buf_head: head index; begin of live portion in @av_buf |
57 | * @av_buf_tail: tail index; first index _after_ the live portion in @av_buf | ||
58 | * @av_buf_ackno: highest seqno of acknowledgeable packet recorded in @av_buf | ||
59 | * @av_tail_ackno: lowest seqno of acknowledgeable packet recorded in @av_buf | ||
60 | * @av_buf_nonce: ECN nonce sums, each covering subsequent segments of up to | ||
61 | * %DCCP_SINGLE_OPT_MAXLEN cells in the live portion of @av_buf | ||
62 | * @av_overflow: if 1 then buf_head == buf_tail indicates buffer wraparound | ||
63 | * @av_records: list of %dccp_ackvec_record (Ack Vectors sent previously) | ||
64 | * @av_veclen: length of the live portion of @av_buf | ||
53 | */ | 65 | */ |
54 | struct dccp_ackvec { | 66 | struct dccp_ackvec { |
55 | u64 av_buf_ackno; | 67 | u8 av_buf[DCCPAV_MAX_ACKVEC_LEN]; |
56 | struct list_head av_records; | ||
57 | ktime_t av_time; | ||
58 | u16 av_buf_head; | 68 | u16 av_buf_head; |
69 | u16 av_buf_tail; | ||
70 | u64 av_buf_ackno:48; | ||
71 | u64 av_tail_ackno:48; | ||
72 | bool av_buf_nonce[DCCPAV_NUM_ACKVECS]; | ||
73 | u8 av_overflow:1; | ||
74 | struct list_head av_records; | ||
59 | u16 av_vec_len; | 75 | u16 av_vec_len; |
60 | u8 av_buf_nonce; | ||
61 | u8 av_ack_nonce; | ||
62 | u8 av_buf[DCCP_MAX_ACKVEC_LEN]; | ||
63 | }; | 76 | }; |
64 | 77 | ||
65 | /** struct dccp_ackvec_record - ack vector record | 78 | /** struct dccp_ackvec_record - Records information about sent Ack Vectors |
66 | * | 79 | * |
67 | * ACK vector record as defined in Appendix A of spec. | 80 | * These list entries define the additional information which the HC-Receiver |
81 | * keeps about recently-sent Ack Vectors; again refer to RFC 4340, Appendix A. | ||
68 | * | 82 | * |
69 | * The list is sorted by avr_ack_seqno | 83 | * @avr_node: the list node in @av_records |
84 | * @avr_ack_seqno: sequence number of the packet the Ack Vector was sent on | ||
85 | * @avr_ack_ackno: the Ack number that this record/Ack Vector refers to | ||
86 | * @avr_ack_ptr: pointer into @av_buf where this record starts | ||
87 | * @avr_ack_runlen: run length of @avr_ack_ptr at the time of sending | ||
88 | * @avr_ack_nonce: the sum of @av_buf_nonce's at the time this record was sent | ||
70 | * | 89 | * |
71 | * @avr_node - node in av_records | 90 | * The list as a whole is sorted in descending order by @avr_ack_seqno. |
72 | * @avr_ack_seqno - sequence number of the packet this record was sent on | ||
73 | * @avr_ack_ackno - sequence number being acknowledged | ||
74 | * @avr_ack_ptr - pointer into av_buf where this record starts | ||
75 | * @avr_ack_nonce - av_ack_nonce at the time this record was sent | ||
76 | * @avr_sent_len - lenght of the record in av_buf | ||
77 | */ | 91 | */ |
78 | struct dccp_ackvec_record { | 92 | struct dccp_ackvec_record { |
79 | struct list_head avr_node; | 93 | struct list_head avr_node; |
80 | u64 avr_ack_seqno; | 94 | u64 avr_ack_seqno:48; |
81 | u64 avr_ack_ackno; | 95 | u64 avr_ack_ackno:48; |
82 | u16 avr_ack_ptr; | 96 | u16 avr_ack_ptr; |
83 | u16 avr_sent_len; | 97 | u8 avr_ack_runlen; |
84 | u8 avr_ack_nonce; | 98 | u8 avr_ack_nonce:1; |
85 | }; | 99 | }; |
86 | 100 | ||
87 | struct sock; | 101 | struct sock; |
@@ -102,10 +116,11 @@ extern int dccp_ackvec_parse(struct sock *sk, const struct sk_buff *skb, | |||
102 | u64 *ackno, const u8 opt, | 116 | u64 *ackno, const u8 opt, |
103 | const u8 *value, const u8 len); | 117 | const u8 *value, const u8 len); |
104 | 118 | ||
105 | extern int dccp_insert_option_ackvec(struct sock *sk, struct sk_buff *skb); | 119 | extern int dccp_ackvec_update_records(struct dccp_ackvec *av, u64 seq, u8 sum); |
120 | extern u16 dccp_ackvec_buflen(const struct dccp_ackvec *av); | ||
106 | 121 | ||
107 | static inline int dccp_ackvec_pending(const struct dccp_ackvec *av) | 122 | static inline bool dccp_ackvec_is_empty(const struct dccp_ackvec *av) |
108 | { | 123 | { |
109 | return av->av_vec_len; | 124 | return av->av_overflow == 0 && av->av_buf_head == av->av_buf_tail; |
110 | } | 125 | } |
111 | #endif /* _ACKVEC_H */ | 126 | #endif /* _ACKVEC_H */ |