.TH zpm-fetchurl 8 2019-03-05 "ZPM 0.7.0"
.SH NAME
zpm-fetchurl \- download files
.SH SYNOPSIS
.B zpm fetchurl
[
.B -OIrRfnp
]
[
.BI -L " redirlimit"
]
[
.BI -z " lastmodfile"
]
[
.BI \-U " useragent"
]
[
.BI -o file
]
.I [ url ]
.SH DESCRIPTION
\fBzpm-fetchurl\fR downloads files
.PP
\fBzpm-fetchurl\fR understands http, https, and file type urls.
For https, it uses a trust on first use model for ssl certificates, but a more
common model verifying via root certificates, or no verfication can also be
used.
.PP
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.  The output file
is ignored and the header is written to stdout.
.TP
.B \-r
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
.TP
.B \-k
Don't verify any certificates.
.TP
.B \-K
Verify certificates via root certificates.  This is normally the default for
TLS, but zpm-fetchurl uses a trust on first use policy instead.  Root
certificates are found by default in /etc/zpm/roots.pem, but the ZPM_ROOTFILE
environment variable can be used to override this.
.TP
.B \-R
Output the request header.
.TP
.BI \-z " path"
Only download if remote is newer than the file given by path
.TP
.BI \-o " path"
Write the output to the file given by \fIpath\fR.  Output is
written to stdout by default.
.TP
.B \-O
Calculate the output file name from the url.
.TP
.B \-n
Only if newer.  Like \-z, except use the output file name, if any.
.TP
.B \-f
Fail silently on errors.
.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
/etc/zpm/roots.pem
.SH ENVIRONMENT
ZPM_KNOWNHOSTS
ZPM_ROOTFILE
.SH AUTHOR
Nathan Wagner
.SH SEE ALSO
zpm(8)