hurl.1 - hurl - Gopher/HTTP/HTTPS file grabber
 (HTM) git clone git://git.codemadness.org/hurl
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       hurl.1 (1465B)
       ---
            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