]> sjero.net Git - iperf/blob - src/Locale.c
Support for continuous runs
[iperf] / src / Locale.c
1
2 /*--------------------------------------------------------------- 
3  * Copyright (c) 1999,2000,2001,2002,2003                              
4  * The Board of Trustees of the University of Illinois            
5  * All Rights Reserved.                                           
6  *--------------------------------------------------------------- 
7  * Permission is hereby granted, free of charge, to any person    
8  * obtaining a copy of this software (Iperf) and associated       
9  * documentation files (the "Software"), to deal in the Software  
10  * without restriction, including without limitation the          
11  * rights to use, copy, modify, merge, publish, distribute,        
12  * sublicense, and/or sell copies of the Software, and to permit     
13  * persons to whom the Software is furnished to do
14  * so, subject to the following conditions: 
15  *
16  *     
17  * Redistributions of source code must retain the above 
18  * copyright notice, this list of conditions and 
19  * the following disclaimers. 
20  *
21  *     
22  * Redistributions in binary form must reproduce the above 
23  * copyright notice, this list of conditions and the following 
24  * disclaimers in the documentation and/or other materials 
25  * provided with the distribution. 
26  * 
27  *     
28  * Neither the names of the University of Illinois, NCSA, 
29  * nor the names of its contributors may be used to endorse 
30  * or promote products derived from this Software without
31  * specific prior written permission. 
32  * 
33  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 
34  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES 
35  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 
36  * NONINFRINGEMENT. IN NO EVENT SHALL THE CONTIBUTORS OR COPYRIGHT 
37  * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, 
38  * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 
39  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE
40  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 
41  * ________________________________________________________________
42  * National Laboratory for Applied Network Research 
43  * National Center for Supercomputing Applications 
44  * University of Illinois at Urbana-Champaign 
45  * http://www.ncsa.uiuc.edu
46  * ________________________________________________________________ 
47  *
48  * Locale.c
49  * by Ajay Tirumala <tirumala@ncsa.uiuc.edu>
50  * & Mark Gates <mgates@nlanr.net>
51  * -------------------------------------------------------------------
52  * Strings and other stuff that is locale specific.
53  * ------------------------------------------------------------------- */
54 #include "version.h"
55 #ifdef HAVE_CONFIG_H
56 #include "config.h"
57 #else
58 #endif
59
60 #ifdef __cplusplus
61 extern "C" {
62 #endif
63 /* -------------------------------------------------------------------
64  * usage
65  * ------------------------------------------------------------------- */
66
67 const char usage_short[] = "\
68 Usage: %s [-s|-c host] [options]\n\
69 Try `%s --help' for more information.\n";
70
71 const char usage_long[] = "\
72 Usage: iperf [-s|-c host] [options]\n\
73        iperf [-h|--help] [-v|--version]\n\
74 \n\
75 Client/Server:\n\
76   -f, --format    [kmKM]   format to report: Kbits, Mbits, KBytes, MBytes\n\
77   -i, --interval  #        seconds between periodic bandwidth reports\n\
78   -l, --len       #[KM]    length of buffer to read or write (default 8 KB)\n\
79   -m, --print_mss          print TCP maximum segment size (MTU - TCP/IP header)\n\
80   -p, --port      #        server port to listen on/connect to\n\
81   -u, --udp                use UDP as transport protocol\n\
82   -d, --dccp               use DCCP as transport protocol\n\
83   -w, --window    #[KM]    TCP window size (socket buffer size)\n\
84   -A, --algorithm          set TCP congestion control algorithm\n\
85   -B, --bind      <host>   bind to <host>, an interface or multicast address\n\
86   -C, --compatibility      for use with older versions does not sent extra msgs\n\
87   -M, --mss       #        set TCP maximum segment size (MTU - 40 bytes)\n\
88   -N, --nodelay            set TCP no delay, disabling Nagle's Algorithm\n\
89   -V, --IPv6Version        Set the domain to IPv6\n\
90 \n\
91 Server specific:\n\
92   -s, --server             run in server mode\n\
93   -U, --single_udp         run in single threaded UDP mode\n\
94   -D, --daemon             run the server as a daemon\n\
95 \n\
96 Client specific:\n\
97   -b, --bandwidth #[KM]    for UDP/DCCP, bandwidth to send at in bits/sec\n\
98                            (default 1 Mbit/sec, implies -u)\n\
99   -c, --client    <host>   run in client mode, connecting to <host>\n\
100   -2, --dualtest           Do a bidirectional test simultaneously\n\
101   -r, --tradeoff           Do a bidirectional test individually\n\
102   -t, --time      #        time in seconds to transmit for (default 10 secs)\n\
103                            or 0 for continuous\n\
104   -n, --num       #[KM]    number of bytes to transmit (instead of -t)\n\
105   -F, --fileinput <name>   input the data to be transmitted from a file\n\
106   -I, --stdin              input the data to be transmitted from stdin\n\
107   -L, --listenport #       port to receive bidirectional tests back on\n\
108   -P, --parallel  #        number of parallel client threads to run\n\
109   -T, --ttl       #        time-to-live, for multicast (default 1)\n\
110 \n\
111 Miscellaneous:\n\
112   -h, --help               print this message and quit\n\
113   -v, --version            print version information and quit\n\
114 \n\
115 [KM] Indicates options that support a K or M suffix for kilo- or mega-\n\
116 \n\
117 The TCP window size option can be set by the environment variable\n\
118 TCP_WINDOW_SIZE. Most other options can be set by an environment variable\n\
119 IPERF_<long option name>, such as IPERF_BANDWIDTH.\n\
120 \n\
121 Report bugs to <gerrit@erg.abdn.ac.uk>";
122
123 // include a description of the threading in the version
124 #if   defined( HAVE_POSIX_THREAD )
125     #define IPERF_THREADS "pthreads"
126 #else
127     #define IPERF_THREADS "single threaded"
128 #endif
129
130 const char version[] =
131 "iperf version " IPERF_VERSION " (" IPERF_VERSION_DATE ") " IPERF_THREADS;
132
133 /* -------------------------------------------------------------------
134  * settings
135  * ------------------------------------------------------------------- */
136
137 const char seperator_line[] =
138 "------------------------------------------------------------\n";
139
140 const char server_port[] =
141 "Server listening on %s port %d\n";
142
143 const char client_port[] =
144 "Client connecting to %s, %s port %d\n";
145
146 const char bind_address[] =
147 "Binding to local address %s\n";
148
149 const char multicast_ttl[] =
150 "Setting multicast TTL to %d\n";
151
152 const char join_multicast[] =
153 "Joining multicast group %s on %s\n";
154
155 const char client_datagram_size[] =
156 "Sending %d byte datagrams\n";
157
158 const char server_datagram_size[] =
159 "Receiving %d byte datagrams\n";
160
161 const char tcp_window_size[] =
162 "TCP window size";
163
164 const char dgram_buffer_size[] =
165 "datagram buffer size";
166
167 const char window_default[] =
168 "(default)";
169
170 const char wait_server_threads[] =
171 "Waiting for server threads to complete. Interrupt again to force quit.\n";
172
173 /* -------------------------------------------------------------------
174  * reports
175  * ------------------------------------------------------------------- */
176
177 const char report_read_lengths[] =
178 "[%3d] Read lengths occurring in more than 5%% of reads:\n";
179
180 const char report_read_length_times[] =
181 "[%3d] %5d bytes read %5d times (%.3g%%)\n";
182
183 const char report_bw_header[] =
184 "[ ID] Interval       Transfer     Bandwidth\n";
185
186 const char report_bw_format[] =
187 "[%3d] %4.1f-%4.1f sec  %ss  %ss/sec\n";
188
189 const char report_sum_bw_format[] =
190 "[SUM] %4.1f-%4.1f sec  %ss  %ss/sec\n";
191
192 const char report_bw_jitter_loss_header[] =
193 "[ ID] Interval       Transfer     Bandwidth       Jitter   Lost/Total \
194 Datagrams\n";
195
196 const char report_bw_jitter_loss_format[] =
197 "[%3d] %4.1f-%4.1f sec  %ss  %ss/sec  %6.3f ms %4d/%5d (%.2g%%)\n";
198
199 const char report_sum_bw_jitter_loss_format[] =
200 "[SUM] %4.1f-%4.1f sec  %ss  %ss/sec  %6.3f ms %4d/%5d (%.2g%%)\n";
201
202 const char report_outoforder[] =
203 "[%3d] %4.1f-%4.1f sec  %d datagrams received out-of-order\n";
204
205 const char report_sum_outoforder[] =
206 "[SUM] %4.1f-%4.1f sec  %d datagrams received out-of-order\n";
207
208 const char report_peer[] =
209 "[%3d] local %s port %u connected with %s port %u\n";
210
211 const char report_mss_unsupported[] =
212 "[%3d] MSS and MTU size unknown (socket option not supported by OS?)\n";
213
214 const char report_mss[] =
215 "[%3d] MSS size %d bytes (MTU %d bytes, %s)\n";
216
217 const char report_datagrams[] =
218 "[%3d] Sent %d datagrams\n";
219
220 const char report_sum_datagrams[] =
221 "[SUM] Sent %d datagrams\n";
222
223 const char server_reporting[] =
224 "[%3d] Server Report:\n";
225
226 const char reportCSV_peer[] =
227 "%s,%u,%s,%u";
228
229 #ifdef HAVE_QUAD_SUPPORT
230 #ifdef HAVE_PRINTF_QD
231 const char reportCSV_bw_format[] =
232 "%s,%s,%d,%.1f-%.1f,%qd,%qd\n";
233
234 const char reportCSV_bw_jitter_loss_format[] =
235 "%s,%s,%d,%.1f-%.1f,%qd,%qd,%.3f,%d,%d,%.3f,%d\n";
236 #else // HAVE_PRINTF_QD
237 const char reportCSV_bw_format[] =
238 "%s,%s,%d,%.1f-%.1f,%lld,%lld\n";
239
240 const char reportCSV_bw_jitter_loss_format[] =
241 "%s,%s,%d,%.1f-%.1f,%lld,%lld,%.3f,%d,%d,%.3f,%d\n";
242 #endif // HAVE_PRINTF_QD
243 #else // HAVE_QUAD_SUPPORT
244 const char reportCSV_bw_format[] =
245 "%s,%s,%d,%.1f-%.1f,%d,%d\n";
246
247 const char reportCSV_bw_jitter_loss_format[] =
248 "%s,%s,%d,%.1f-%.1f,%d,%d,%.3f,%d,%d,%.3f,%d\n";
249 #endif //HAVE_QUAD_SUPPORT
250 /* -------------------------------------------------------------------
251  * warnings
252  * ------------------------------------------------------------------- */
253
254 const char warn_window_requested[] =
255 " (WARNING: requested %s)";
256
257 const char warn_delay_large[] =
258 "WARNING: delay too large, reducing from %.1f to 1.0 seconds.\n";
259
260 const char warn_no_pathmtu[] =
261 "WARNING: Path MTU Discovery may not be enabled.\n";
262
263 const char warn_no_ack[]=
264 "[%3d] WARNING: did not receive ack of last datagram after %d tries.\n";
265
266 const char warn_ack_failed[]=
267 "[%3d] WARNING: ack of last datagram failed after %d tries.\n";
268
269 const char warn_fileopen_failed[]=
270 "WARNING: Unable to open file stream for transfer\n\
271 Using default data stream. \n";
272
273 const char unable_to_change_win[]=
274 "WARNING: Unable to change the window size\n";
275
276 const char opt_estimate[]=
277 "Optimal Estimate\n";
278
279 const char report_interval_small[] =
280 "WARNING: interval too small, increasing from %3.2f to 0.5 seconds.\n";
281
282 const char warn_invalid_server_option[] =
283 "WARNING: option -%c is not valid for server mode\n";
284
285 const char warn_invalid_client_option[] =
286 "WARNING: option -%c is not valid for client mode\n";
287
288 const char warn_invalid_compatibility_option[] =
289 "WARNING: option -%c is not valid in compatibility mode\n";
290
291 const char warn_implied_compatibility[] =
292 "WARNING: option -%c has implied compatibility mode\n";
293
294 const char warn_buffer_too_small[] =
295 "WARNING: the buffer was increased to %d for proper operation\n";
296
297 const char warn_invalid_single_threaded[] =
298 "WARNING: option -%c is not valid in single threaded versions\n";
299
300 const char warn_invalid_report_style[] =
301 "WARNING: unknown reporting style \"%s\", switching to default\n";
302
303 const char warn_invalid_report[] =
304 "WARNING: unknown reporting type \"%c\"\n";
305
306 #ifdef __cplusplus
307 } /* end extern "C" */
308 #endif