Fernando Apesteguía wrote:
Author: fernape (ports committer)
Date: Thu Oct 29 18:34:47 2020
New Revision: 367141
URL: https://svnweb.freebsd.org/changeset/base/367141
Log:
fetch(1): Add EXAMPLES section
Add a few examples covering flags: 1, R, a, o, q, r, s, v
Approved by: manpages (bcr@)
Differential Revision: https://reviews.freebsd.org/D26946
Modified:
head/usr.bin/fetch/fetch.1
Modified: head/usr.bin/fetch/fetch.1
==============================================================================
--- head/usr.bin/fetch/fetch.1 Thu Oct 29 18:29:22 2020 (r367140)
+++ head/usr.bin/fetch/fetch.1 Thu Oct 29 18:34:47 2020 (r367141)
@@ -30,7 +30,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd May 6, 2018
+.Dd October 29, 2020
.Dt FETCH 1
.Os
.Sh NAME
@@ -384,6 +384,51 @@ If the
argument is used and the remote file is not newer than the
specified file then the command will still return success,
although no file is transferred.
+.Sh EXAMPLES
+Silently try to fetch the URLs passed as parameters.
+The first one will fail.
+If the second URL succeeds the third one will not be tried:
+.Bd -literal -offset indent
+$ fetch -1 -q https://www.freebsd.org/bad.html \\
+ ftp.freebsd.org/pub/FreeBSD/README.TXT \\
+ https://www.fake.url
+fetch: https://www.freebsd.org/bad.html: Not Found
+.Ed
+.Pp
+Be verbose when retrieving the
+.Ql README.TXT
+file:
+.Bd -literal -offset indent
+$ fetch -v ftp.freebsd.org/pub/FreeBSD/README.TXT
+resolving server address: ftp.freebsd.org:80
+requesting http://ftp.freebsd.org/pub/FreeBSD/README.TXT
+local size / mtime: 4259 / 1431015519
+remote size / mtime: 4259 / 1431015519
+README.TXT 4259 B 44 MBps 00s
+.Ed
+.Pp
+Quietly save the
+.Ql README.TXT file as
"file as" should be on separate line, otherwise it's treated as part of
.Ql argument. BTW, why are we not using .Pa for these?
+.Ql myreadme.txt
+and do not delete the output file under any circumstances:
+.Bd -literal -offset indent
+fetch -o myreadme.txt -q -R ftp.freebsd.org/pub/FreeBSD/README.TXT
+.Ed
+.Pp
+Print the size of the requested file and identify the request with a custom
user
+agent string:
+.Bd -literal -offset indent
+$ fetch -s ftp.freebsd.org/pub/FreeBSD/README.TXT
+--user-agent="Mozilla/5.0 (X11; FreeBSD x86_64; rv:78.0) Gecko/20100101"
+3513231
+.Ed
+.Pp
+Restart the transfer of the
+.Ql README.TXT
+file and retry the transfer upon soft failures:
+.Bd -literal -offset indent
+$ fetch -a -r http://ftp.freebsd.org/pub/FreeBSD/README.TXT
+.Ed
.Sh SEE ALSO
.Xr fetch 3 ,
.Xr phttpget 8
_______________________________________________
svn-src-head@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/svn-src-head
To unsubscribe, send any mail to "svn-src-head-unsubscr...@freebsd.org"
