-.TH zpm-fetchurl 8 2019-02-16 "ZPM 0.4"
+.TH zpm-fetchurl 8 2019-03-05 "ZPM 0.7.0"
.SH NAME
zpm-fetchurl \- download files
.SH SYNOPSIS
.B zpm fetchurl
[
-.B -ISkKrOnp
+.B -OIrRfnp
+]
+[
+.BI -L " redirlimit"
+]
+[
+.BI -z " lastmodfile"
+]
+[
+.BI \-U " useragent"
]
[
.BI -o file
While this program can be used directly, it is intended for use by zpm scripts
for downloading repositories and packages without requiring an external
dependency.
+.PP
+URLs of the file scheme have an http style response header generated
+internally so the same code and output are used.
.SH OPTIONS
.TP
.B \-I
-output the response header only, implies -r
+output the response header only, implies \-r. The output file
+is ignored and the header is written to stdout.
.TP
.B \-r
-output the entire response header, including the header
+output the entire response, including the header
+.TP
+.BI -L " limit"
+Limit the maximum number of redirects to \fIlimit\fR. The default is
+50.
.TP
.B \-S
output the response status code only
certificates are found by default in /etc/zpm/roots.pem, but the ZPM_ROOTFILE
environment variable can be used to override this.
.TP
-.BI \-R " limit"
-set the limit on following redirects, defaults to 50
+.B \-R
+Output the request header.
.TP
.BI \-z " path"
Only download if remote is newer than the file given by path
.TP
.B \-p \-#
Output a progress bar. A '#' is accepted for compatibility with curl.
+.TP
+.BI \-U " useragent"
+Set the User-Agent header to \fIuseragent\fR.
.SH EXAMPLES
.TP
zpm fetchurl -o zpm-0.1.2.zpm https://zoranix.net/repo/packages/zpm-0.1.2.zpm
.SH EXIT STATUS
0 on success non zero on failure
+.PP
+Failure is any exit status code >= 400.
.SH FILES
/var/lib/zpm/known_hosts
~/.zpm/known_hosts