xref: /freebsd/libexec/phttpget/phttpget.8 (revision 9b30b96c1fa4ee0dfc540878fbb3247bf92d19eb)
16703731dSKyle Evans.\"-
26703731dSKyle Evans.\" Copyright (c) 2015 Xin LI <delphij@FreeBSD.org>
36703731dSKyle Evans.\"
46703731dSKyle Evans.\" Redistribution and use in source and binary forms, with or without
56703731dSKyle Evans.\" modification, are permitted provided that the following conditions
66703731dSKyle Evans.\" are met:
76703731dSKyle Evans.\" 1. Redistributions of source code must retain the above copyright
86703731dSKyle Evans.\"    notice, this list of conditions and the following disclaimer.
96703731dSKyle Evans.\" 2. Redistributions in binary form must reproduce the above copyright
106703731dSKyle Evans.\"    notice, this list of conditions and the following disclaimer in the
116703731dSKyle Evans.\"    documentation and/or other materials provided with the distribution.
126703731dSKyle Evans.\"
136703731dSKyle Evans.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
146703731dSKyle Evans.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
156703731dSKyle Evans.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
166703731dSKyle Evans.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
176703731dSKyle Evans.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
186703731dSKyle Evans.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
196703731dSKyle Evans.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
206703731dSKyle Evans.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
216703731dSKyle Evans.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
226703731dSKyle Evans.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
236703731dSKyle Evans.\" SUCH DAMAGE.
246703731dSKyle Evans.\"
256703731dSKyle Evans.Dd January 3, 2015
266703731dSKyle Evans.Dt PHTTPGET 8
276703731dSKyle Evans.Os
286703731dSKyle Evans.Sh NAME
296703731dSKyle Evans.Nm phttpget
306703731dSKyle Evans.Nd retrieve multiple files via pipelined HTTP
316703731dSKyle Evans.Sh SYNOPSIS
326703731dSKyle Evans.Nm
336703731dSKyle Evans.Ar server
346703731dSKyle Evans.Ar file ...
356703731dSKyle Evans.Sh DESCRIPTION
366703731dSKyle EvansThe
376703731dSKyle Evans.Nm
386703731dSKyle Evansutility is a minimalist pipelined HTTP client,
396703731dSKyle Evanswhich is used to retrieve multiple
406703731dSKyle Evans.Ar file Ns s
416703731dSKyle Evansfrom one
426703731dSKyle Evans.Ar server ,
436703731dSKyle Evansand saves the downloaded files in the current working directory,
446703731dSKyle Evansusing the last portion of their download path as file names.
456703731dSKyle Evans.Pp
466703731dSKyle EvansBy making several "in flight" HTTP requests,
476703731dSKyle Evansit can dramatically increase performance when a large number of
486703731dSKyle Evanssmall files need to be downloaded.
496703731dSKyle Evans.Pp
506703731dSKyle EvansThe
516703731dSKyle Evans.Xr freebsd-update 8
52*9b30b96cSOlivier Certnertool uses
536703731dSKyle Evans.Nm
546703731dSKyle Evansto download binary patch files.
556703731dSKyle Evans.Sh ENVIRONMENT
566703731dSKyle Evans.Bl -tag -width HTTP_PROXY_AUTH
576703731dSKyle Evans.It Ev HTTP_PROXY
586703731dSKyle EvansURL of the proxy to use for HTTP requests.
596703731dSKyle Evans.It Ev HTTP_PROXY_AUTH
606703731dSKyle EvansAuthorization parameters for the HTTP proxy.
616703731dSKyle Evans.It Ev HTTP_USER_AGENT
626703731dSKyle EvansThe User-Agent string to use for HTTP requests.
636703731dSKyle EvansThe default is
646703731dSKyle Evans.Dq phttpget/0.1 .
656703731dSKyle Evans.It Ev HTTP_TIMEOUT
666703731dSKyle EvansTimeout for HTTP request in seconds.
676703731dSKyle Evans.El
686703731dSKyle Evans.Sh SEE ALSO
696703731dSKyle Evans.Xr fetch 1 ,
70*9b30b96cSOlivier Certner.Xr freebsd-update 8
716703731dSKyle Evans.Sh AUTHORS
726703731dSKyle Evans.An -nosplit
736703731dSKyle EvansThe
746703731dSKyle Evans.Nm
756703731dSKyle Evansutility was written by
766703731dSKyle Evans.An Colin Percival Aq Mt cperciva@FreeBSD.org
77*9b30b96cSOlivier Certnerinitially for use with
786703731dSKyle Evans.Xr portsnap 8
79*9b30b96cSOlivier Certner(now removed) and has been used by
806703731dSKyle Evans.Xr freebsd-update 8 .
816703731dSKyle EvansThis manual page was written by
826703731dSKyle Evans.An Xin LI Aq Mt delphij@FreeBSD.org .
83