hget 1.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879
  1. .TH HGET 1
  2. .SH NAME
  3. hget \- retrieve a web page corresponding to a url
  4. .SH SYNOPSIS
  5. .PP
  6. .B hget
  7. [
  8. .B -dhv
  9. ][
  10. .B -o
  11. .I ofile
  12. ][
  13. .B -p
  14. .I body
  15. ][
  16. .B -x
  17. .I netmntpt
  18. ]
  19. .I url
  20. .SH DESCRIPTION
  21. .I Hget
  22. retrieves the web page specified by the URL
  23. .I url
  24. and writes it, absent the
  25. .B -o
  26. option, to standard output.
  27. The known URL types are: http and ftp.
  28. .PP
  29. If
  30. .I url
  31. is of type HTTP and the
  32. .B -p
  33. option is specified, then an HTTP POST is performed
  34. with
  35. .I body
  36. as the data to be posted.
  37. .PP
  38. The
  39. .B -o
  40. option is used to keep a local file in sync with a
  41. web page. If the web page has been modified later than the
  42. file, it is copied into the file. If the file is up to date
  43. but incomplete,
  44. .I hget
  45. will fetch the missing bytes.
  46. .PP
  47. Option
  48. .B -h
  49. causes HTTP headers to be printed to standard output
  50. in addition to the transferred web page.
  51. .PP
  52. Option
  53. .B -d
  54. turns on debugging written to standard error.
  55. .PP
  56. Normally,
  57. .I hget
  58. uses the IP stack mounted under
  59. .BR /net .
  60. The
  61. .B -x
  62. option can be used to specify the mount point of
  63. a different IP stack to use.
  64. .PP
  65. Option
  66. .B -v
  67. writes progress lines to standard output once a second.
  68. Each line contains two numbers, the bytes transferred so
  69. far and the total length to be transferred.
  70. .PP
  71. If the environment variable
  72. .B httpproxy
  73. is set, it is used as a URL denoting an HTTP proxy server.
  74. All HTTP accesses use this server to get the page instead of
  75. calling the destination server.
  76. .SH SOURCE
  77. .B /sys/src/cmd/hget.c
  78. .SH "SEE ALSO"
  79. .IR ftpfs (4)