]> pd.if.org Git - zpackage/blob - doc/zpm-fetchurl.8
ocb mode fixup
[zpackage] / doc / zpm-fetchurl.8
1 .TH zpm-fetchurl 8 2019-03-05 "ZPM 0.7.0"
2 .SH NAME
3 zpm-fetchurl \- download files
4 .SH SYNOPSIS
5 .B zpm fetchurl
6 [
7 .B -OIrRfnp
8 ]
9 [
10 .BI -L " redirlimit"
11 ]
12 [
13 .BI -z " lastmodfile"
14 ]
15 [
16 .BI \-U " useragent"
17 ]
18 [
19 .BI -o file
20 ]
21 .I [ url ]
22 .SH DESCRIPTION
23 \fBzpm-fetchurl\fR downloads files
24 .PP
25 \fBzpm-fetchurl\fR understands http, https, and file type urls.
26 For https, it uses a trust on first use model for ssl certificates, but a more
27 common model verifying via root certificates, or no verfication can also be
28 used.
29 .PP
30 While this program can be used directly, it is intended for use by zpm scripts
31 for downloading repositories and packages without requiring an external
32 dependency.
33 .PP
34 URLs of the file scheme have an http style response header generated
35 internally so the same code and output are used.
36 .SH OPTIONS
37 .TP
38 .B \-I
39 output the response header only, implies \-r.  The output file
40 is ignored and the header is written to stdout.
41 .TP
42 .B \-r
43 output the entire response, including the header
44 .TP
45 .BI -L " limit"
46 Limit the maximum number of redirects to \fIlimit\fR.  The default is
47 50.
48 .TP
49 .B \-S
50 output the response status code only
51 .TP
52 .B \-k
53 Don't verify any certificates.
54 .TP
55 .B \-K
56 Verify certificates via root certificates.  This is normally the default for
57 TLS, but zpm-fetchurl uses a trust on first use policy instead.  Root
58 certificates are found by default in /etc/zpm/roots.pem, but the ZPM_ROOTFILE
59 environment variable can be used to override this.
60 .TP
61 .B \-R
62 Output the request header.
63 .TP
64 .BI \-z " path"
65 Only download if remote is newer than the file given by path
66 .TP
67 .BI \-o " path"
68 Write the output to the file given by \fIpath\fR.  Output is
69 written to stdout by default.
70 .TP
71 .B \-O
72 Calculate the output file name from the url.
73 .TP
74 .B \-n
75 Only if newer.  Like \-z, except use the output file name, if any.
76 .TP
77 .B \-f
78 Fail silently on errors.
79 .TP
80 .B \-p \-#
81 Output a progress bar.  A '#' is accepted for compatibility with curl.
82 .TP
83 .BI \-U " useragent"
84 Set the User-Agent header to \fIuseragent\fR.
85 .SH EXAMPLES
86 .TP
87 zpm fetchurl -o zpm-0.1.2.zpm https://zoranix.net/repo/packages/zpm-0.1.2.zpm
88 .SH EXIT STATUS
89 0 on success non zero on failure
90 .PP
91 Failure is any exit status code >= 400.
92 .SH FILES
93 /var/lib/zpm/known_hosts
94 ~/.zpm/known_hosts
95 /etc/zpm/roots.pem
96 .SH ENVIRONMENT
97 ZPM_KNOWNHOSTS
98 ZPM_ROOTFILE
99 .SH AUTHOR
100 Nathan Wagner
101 .SH SEE ALSO
102 zpm(8)