pd.if.org Git - zpackage/blob - doc/zpm-fetchurl.8

   1 .TH zpm-fetchurl 8 2019-02-15 "ZPM 0.4"
   2 .SH NAME
   3 zpm-fetchurl \- download files
   4 .SH SYNOPSIS
   5 .B zpm fetchurl
   6 [
   7 .B -ISkKr
   8 ]
   9 [
  10 .BI -o file
  11 ]
  12 .I [ url ]
  13 .SH DESCRIPTION
  14 \fBzpm-fetchurl\fR downloads files
  15 .PP
  16 \fBzpm-fetchurl\fR understands http, https, and file type urls.
  17 For https, it uses a trust on first use model for ssl certificates, but a more
  18 common model verifying via root certificates, or no verfication can also be
  19 used.
  20 .PP
  21 While this program can be used directly, it is intended for use by zpm scripts
  22 for downloading repositories and packages without requiring an external
  23 dependency.
  24 .SH OPTIONS
  25 .TP
  26 .B \-I
  27 output the response header only, implies -r
  28 .TP
  29 .B \-r
  30 output the entire response header, including the header
  31 .TP
  32 .B \-S
  33 output the response status code only
  34 .TP
  35 .B \-k
  36 Don't verify any certificates.
  37 .TP
  38 .B \-K
  39 Verify certificates via root certificates.  This is normally the default for
  40 TLS, but zpm-fetchurl uses a trust on first use policy instead.  Root
  41 certificates are found by default in /etc/zpm/roots.pem, but the ZPM_ROOTFILE
  42 environment variable can be used to override this.
  43 .TP
  44 .BI \-R " limit"
  45 set the limit on following redirects, defaults to 50
  46 .TP
  47 .BI \-z " path"
  48 Only download if remote is newer than the file given by path
  49 .TP
  50 .BI \-o " path"
  51 Write the output to the file given by \fIpath\fR.  Output is
  52 written to stdout by default.
  53 .TP
  54 .B \-f
  55 Fail silently on errors.
  56 .TP
  57 .B \-#
  58 Output a progress bar.
  59 .SH EXAMPLES
  60 .TP
  61 zpm fetchurl -o zpm-0.1.2.zpm https://zoranix.net/repo/packages/zpm-0.1.2.zpm
  62 .SH EXIT STATUS
  63 0 on success non zero on failure
  64 .SH FILES
  65 /var/lib/zpm/known_hosts
  66 ~/.zpm/known_hosts
  67 /etc/zpm/roots.pem
  68 .SH ENVIRONMENT
  69 ZPM_KNOWNHOSTS
  70 ZPM_ROOTFILE
  71 .SH AUTHOR
  72 Nathan Wagner
  73 .SH SEE ALSO
  74 zpm(8)