speedtest-cli.1 3.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143
  1. .TH "speedtest-cli" 1 "2018-01-05" "speedtest-cli"
  2. .SH NAME
  3. speedtest\-cli \- Command line interface for testing internet bandwidth using speedtest.net
  4. .SH SYNOPSIS
  5. .B speedtest\-cli
  6. [OPTION...]
  7. .SH DESCRIPTION
  8. Speedtest.net is a web service for testing your broadband connection by downloading a file
  9. from a nearby speedtest.net server on the web. This tool allows you to access the service
  10. from the command line.
  11. Speedtest mini is a version of the Speedtest.net server that you can host locally.
  12. .SH OPTIONS
  13. Usage: speedtest\-cli [OPTION...]
  14. .B Help Options
  15. \fB\-h, \-\-help\fR
  16. .RS
  17. Displays usage for the tool.
  18. .RE
  19. .B Options
  20. \fB\-\-no\-download\fR
  21. .RS
  22. Do not perform download test
  23. .RE
  24. \fB\-\-no\-upload\fR
  25. .RS
  26. Do not perform upload test
  27. .RE
  28. \fB\-\-single\fR
  29. .RS
  30. Only use a single connection instead of multiple. This simulates a typical file transfer.
  31. .RE
  32. \fB\-\-bytes\fR
  33. .RS
  34. Display values in bytes instead of bits. Does not affect the image generated by \-\-share, nor output from \-\-json or \-\-csv
  35. .RE
  36. \fB\-\-share\fR
  37. .RS
  38. Generate and provide a URL to the speedtest.net share results image, not displayed with \-\-csv
  39. .RE
  40. \fB\-\-simple\fR
  41. .RS
  42. Suppress verbose output, only show basic information
  43. .RE
  44. \fB\-\-csv\fR
  45. .RS
  46. Suppress verbose output, only show basic information in CSV format. Speeds listed in bit/s and not affected by \-\-bytes
  47. .RE
  48. \fB\-\-csv\-delimiter CSV_DELIMITER\fR
  49. .RS
  50. Single character delimiter to use in CSV output. Default ","
  51. .RE
  52. \fB\-\-csv\-header\fR
  53. .RS
  54. Print CSV headers
  55. .RE
  56. \fB\-\-json\fR
  57. .RS
  58. Suppress verbose output, only show basic information in JSON format. Speeds listed in bit/s and not affected by \-\-bytes
  59. .RE
  60. \fB\-\-list\fR
  61. .RS
  62. Display a list of speedtest.net servers sorted by distance
  63. .RE
  64. \fB\-\-server SERVER\fR
  65. .RS
  66. Specify a server ID to test against. Can be supplied multiple times
  67. .RE
  68. \fB\-\-exclude EXCLUDE\fR
  69. .RS
  70. Exclude a server from selection. Can be supplied multiple times
  71. .RE
  72. \fB\-\-mini MINI\fR
  73. .RS
  74. URL of the Speedtest Mini server
  75. .RE
  76. \fB\-\-source SOURCE\fR
  77. .RS
  78. Source IP address to bind to
  79. .RE
  80. \fB\-\-timeout TIMEOUT\fR
  81. .RS
  82. HTTP timeout in seconds. Default 10
  83. .RE
  84. \fB\-\-secure\fR
  85. .RS
  86. Use HTTPS instead of HTTP when communicating with speedtest.net operated servers
  87. .RE
  88. \fB\-\-no\-pre\-allocate\fR
  89. .RS
  90. Do not pre allocate upload data. Pre allocation is enabled by default to improve upload performance. To support systems with insufficient memory, use this option to avoid a MemoryError
  91. .RE
  92. \fB\-\-version\fR
  93. .RS
  94. Show the version number and exit
  95. .RE
  96. .SH EXAMPLES
  97. \fBAutomatically find closest server and start testing\fR
  98. .RS
  99. speedtest\-cli
  100. .RE
  101. \fBSpecify testing against server 1491\fR
  102. .RS
  103. speedtest-cli \-\-server 1491
  104. .RE
  105. \fBTesting against Speedtest Mini\fR
  106. .RS
  107. speedtest-cli \-\-mini 172.18.66.1
  108. .RE
  109. .SH REPORTING BUGS
  110. Please file issues on the Github bug tracker: https://github.com/sivel/speedtest\-cli
  111. .SH AUTHORS
  112. This manual page was written by Jonathan Carter <jonathan@ubuntu.com>
  113. Speedtest\-cli was written by Matt Martz <matt@sivel.net>