hurl | Simple gopher and http(s) client. |
| download: http://git.y1.nz/archives/hurl.tar.gz | |
| README | Files | Log | Refs | LICENSE |
hurl.1
1 .Dd September 13, 2022
2 .Dt HURL 1
3 .Os
4 .Sh NAME
5 .Nm hurl
6 .Nd HTTP/HTTPS/Gopher file grabber
7 .Sh SYNOPSIS
8 .Nm
9 .Op Fl c Ar ca_file
10 .Op Fl H Ar headers
11 .Op Fl l
12 .Op Fl m Ar filesize
13 .Op Fl t Ar timeout
14 .Ar url
15 .Sh DESCRIPTION
16 .Nm
17 fetches data and writes it to stdout.
18 .Nm
19 supports the protocols: HTTP, HTTPS and Gopher.
20 .Pp
21 The options are as follows:
22 .Bl -tag -width Ds
23 .It Fl c Ar ca_file
24 Set CA certificate file to use for TLS connections.
25 .It Fl H Ar headers
26 Add headers to HTTP or HTTPS requests.
27 This is the raw data appended to the request header.
28 This can be multiple lines, all but the last line should not end with CR LF.
29 .It Fl l
30 Enable legacy ciphers and negotiation for TLS (default off).
31 .It Fl m Ar filesize
32 Maximum size of the data in bytes.
33 .It Fl t Ar timeout
34 Maximum time for the connection and fetching the data in seconds.
35 This sets up a timer that kills the connection after
36 .Ar timeout
37 seconds.
38 The default is to use no timer.
39 .El
40 .Pp
41 For HTTP and HTTPS it will write the data except the header to stdout when the
42 HTTP statuscode is "200 OK" and exit with statuscode 0 when all data is
43 successfully written.
44 When the header is retrieved but it is not "200 OK" it will write the HTTP
45 header to stderr and exit with a non-zero statuscode.
46 .Pp
47 For Gopher it will write the data to stdout and exit with statuscode 0 when all
48 data is successfully written.
49 .Sh SEE ALSO
50 .Xr ftp 1 ,
51 .Xr nc 1
52 .Sh AUTHORS
53 .An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org
This webpage is intended to be an accessible preview of this repository. To get a fuller picture, clone it and use the git CLI.