hget 1.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  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 -dv
  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 -d
  49. turns on debugging written to standard error.
  50. .PP
  51. Normally,
  52. .I hget
  53. uses the IP stack mounted under
  54. .BR /net .
  55. The
  56. .B -x
  57. option can be used to specify the mount point of
  58. a different IP stack to use.
  59. .PP
  60. Option
  61. .B -v
  62. writes progress lines to standard output once a second.
  63. Each line contains two numbers, the bytes transferred so
  64. far and the total length to be transferred.
  65. .SH SOURCE
  66. .B /sys/src/cmd/hget.c
  67. .SH "SEE ALSO"
  68. .IR ftpfs (4)