X-Git-Url: http://sjero.net/git/?p=wget;a=blobdiff_plain;f=vms%2FWGET.HLP;fp=vms%2FWGET.HLP;h=f99c777fcd27abc35d0c649c9828ca2bf7676516;hp=0000000000000000000000000000000000000000;hb=714ccdcd844314cc3902fa4fd1b48757d9db9296;hpb=0a0d73a03f87ca6393d49869604922ee884c6021 diff --git a/vms/WGET.HLP b/vms/WGET.HLP new file mode 100644 index 00000000..f99c777f --- /dev/null +++ b/vms/WGET.HLP @@ -0,0 +1,245 @@ +1 WGET + GNU Wget 1.11a, a non-interactive network retriever. + Usage: + WGET :== $ device:[directory]WGET.EXE ! Define foreign command. + WGET [OPTION [...]] [URL [...]] + + Mandatory arguments for long options are also mandatory for short options. + +2 Startup + -V, --version display the version of Wget and exit. + -h, --help print this help. + -b, --background go to background after startup. (Ignored on VMS.) + -e, --execute=COMMAND execute a `.wgetrc'-style command. + +2 Logging_and_input_file + -o, --output-file=FILE log messages to FILE. + -a, --append-output=FILE append messages to FILE. + -d, --debug print debugging information. + -q, --quiet quiet (no output). + -v, --verbose be verbose. (This is the default.) + -nv, --non-verbose turn off verboseness, without being quiet. + -i, --input-file=FILE download URLs found in FILE. + -F, --force-html treat input file as HTML. + -B, --base=URL prepends URL to relative links in -F -i file. + +2 Download + -t, --tries=NUMBER set number of retries to NUMBER + (0 unlimits). + --retry-connrefused retry even if connection is refused. + -O --output-document=FILE write documents to FILE. + -nc, --no-clobber skip downloads that would download to + existing files. + -c, --continue resume getting a partially downloaded file. + --progress=TYPE select progress gauge type. + -N, --timestamping don't re-retrieve files unless newer than + local. + -S, --server-response print server response. + --spider don't download anything. + -T, --timeout=SECONDS set all timeout values to SECONDS. + --dns-timeout=SECS set the DNS lookup timeout to SECS. + --connect-timeout=SECS set the connect timeout to SECS. + --read-timeout=SECS set the read timeout to SECS. + -w, --wait=SECONDS wait SECONDS between retrievals. + --waitretry=SECS wait 1...SECS between retrieval retries. + --random-wait wait from 0...2*WAIT secs between + retrievals. + --no-proxy explicitly turn off proxy. + -Q, --quota=NUMBER set retrieval quota to NUMBER. + --bind-address=ADDRESS bind to ADDRESS (hostname or IP) on local + host. + --limit-rate=RATE limit download rate to RATE. + --no-dns-cache disable caching DNS lookups. + --restrict-file-names=OS restrict file name chars to ones OS allows. + --ignore-case ignore case when matching files/dirs. + -4, --inet4-only connect only to IPv4 addresses. + -6, --inet6-only connect only to IPv6 addresses. + --prefer-family=FAMILY connect first to addresses of specified + family, one of IPv6, IPv4, or none. + --user=USER set both FTP and HTTP user to USER. + --password=PASS set both FTP and HTTP password to PASS. + +2 Directories + -nd --no-directories don't create directories. + -x, --force-directories force creation of directories. + -nH, --no-host-directories don't create host directories. + --protocol-directories use protocol name in directories. + -P, --directory-prefix=PREFIX save files to PREFIX/... + --cut-dirs=NUMBER ignore NUMBER remote directory components. + +2 HTTP_options + --http-user=USER set HTTP user to USER. + --http-passwd=PASS set HTTP password to PASS. + --no-cache disallow server-cached data. + -E, --html-extension save HTML documents with ".html" extension. + --ignore-length ignore "Content-Length" header field. + --header=STRING insert STRING among the headers. + --proxy-user=USER set USER as proxy username. + --proxy-passwd=PASS set PASS as proxy password. + --referer=URL include "Referer: URL" header in HTTP + request. + --save-headers save the HTTP headers to file. + -U, --user-agent=AGENT identify as AGENT instead of Wget/VERSION. + --no-http-keep-alive disable HTTP keep-alive (persistent + connections). + --no-cookies don't use cookies. + --load-cookies=FILE load cookies from FILE before session. + --save-cookies=FILE save cookies to FILE after session. + --keep-session-cookies load and save session (non-permanent) + cookies. + --post-data=STRING use the POST method; send STRING as the data. + --post-file=FILE use the POST method; send contents of FILE. + --content-disposition honor the Content-Disposition header when + choosing local file names (EXPERIMENTAL). + +2 HTTPS (SSL/TLS) options: + --secure-protocol=PR choose secure protocol, PR, one of: auto, + SSLv2, SSLv3, and TLSv1. + --no-check-certificate don't validate the server's certificate. + --certificate=FILE client certificate file. + --certificate-type=TYPE client certificate type, PEM or DER. + --private-key=FILE private key file. + --private-key-type=TYPE private key type, PEM or DER. + --ca-certificate=FILE file with the bundle of CA's. + --ca-directory=DIR directory where hash list of CA's is stored. + --random-file=FILE FILE with random data to seed the SSL PRNG. + --egd-file=FILE FILE naming the EGD socket with random data. + +2 FTP_options + --ftp-stmlf All binary FTP files use Stream_LF format. + --ftp-user=USER set FTP user to USER. + --ftp-password=PASS set FTP password to PASS. + --no-remove-listing don't remove ".listing" files. + --no-glob turn off FTP file name globbing. + --no-passive-ftp disable the "passive" transfer mode. + --retr-symlinks when recursing, get linked-to files (not + dir). + --preserve-permissions preserve remote file permissions. + +2 Recursive_retrieval + -r, --recursive recursive download. + -l, --level=NUMBER maximum recursion depth (inf or 0 for infinite). + --delete-after delete files locally after downloading them. + -k, --convert-links make links in downloaded HTML point to local + files. + -K, --backup-converted before converting file X, back up as X_orig. + -m, --mirror shortcut for -r -N -l inf --no-remove-listing. + -p, --page-requisites get all images, etc. needed by HTML page. + --strict-comments turn on strict (SGML) handling of HTML comments. + +2 Recursive_accept-reject + -A, --accept=LIST comma-separated list of accepted + extensions. + -R, --reject=LIST comma-separated list of rejected + extensions. + -D, --domains=LIST comma-separated list of accepted domains. + --exclude-domains=LIST comma-separated list of rejected domains. + --follow-ftp follow FTP links from HTML documents. + --follow-tags=LIST comma-separated list of followed HTML + tags. + -G, --ignore-tags=LIST comma-separated list of ignored HTML + tags. + -H, --span-hosts go to foreign hosts when recursive. + -L, --relative follow relative links only. + -I, --include-directories=LIST list of allowed directories. + -X, --exclude-directories=LIST list of excluded directories. + -np, --no-parent don't ascend to the parent directory. + +2 VMS_specifics + Wget on VMS systems may behave differently in some ways from Wget on other + systems. + + The "-b" or "--background" command-line option is ignored on VMS systems. + + Other differences involve command-line case, restrictions on directory + and file names, some FTP behavior, and some RMS default parameters. + +3 Command-line_case + On non-VAX systems, Wget for VMS enables the following DECC$* run-time + option: + DECC$ARGV_PARSE_STYLE + + This way, with extended command parsing enabled ("SET PROCESS + /PARSE_STYLE = EXTENDED"), command-line case is preserved, which + obviates quoting case-sensitive option switches, URLs, and other + parameters. + +3 Directory_and_file_names + When the destination for a downloaded file is an ODS2 file system, + excessive dots (".") in file names and directory names generated by + recursive retrieval (which would be illegal in ODS2 directory or file + names) are replaced by underscores ("_"). All tildes ("~") are replaced + by hyphens ("-"), and all "at" signs ("@") are replaced by dollar signs + ("$"). Any other invalid characters are replaced by underscores ("_"). + Also, case information is lost. + + For example, the command: + wget -r "ftp://ftp.xfree86.org/pub/XFree86/3.3.5/binaries/NetBSD-1.3/" + + on a UNIX system, should put files into the directory: + ./ftp.xfree86.org/pub/XFree86/3.3.5/binaries/NetBSD-1.3/ + + while on a VMS ODS2 file system, the directory would be: + [.FTP_XFREE86_ORG.PUB.XFREE86.3_3_5.BINARIES.NETBSD-1_3] + + When the destination for a downloaded file is an ODS5 file system, the + ODS5-invalid characters "?" and "*" are converted to "!" and "#", + respectively. + + On non-VAX systems, Wget for VMS enables the following DECC$* run-time + options: + DECC$EFS_CHARSET + DECC$EFS_CASE_PRESERVE + + This way, when the destination for a downloaded file is an ODS5 file + system, multiple dots will be permitted and case will be preserved in + directory and file names, so the previous example directory would be: + [.ftp^.xfree86^.org.pub.XFree86.3^.3^.5.binaries.NetBSD-1^.3] + +3 FTP_file_date + Files downloaded using FTP from some servers may get date-time info in + server-local time. Define an environment variable (symbol or logical + name) WGET_TIMEZONE_DIFFERENTIAL (a signed time in seconds) to offset + these file dates. + +3 FTP_file_format + By default, when Wget does a binary (Image) FTP transfer, the + destination file is created with fixed-length, 512-byte records. When + Wget does an ASCII FTP transfer, the destination file is created with + Stream_LF format. + + In Wget versions before 1.10.1, an FTP destination file was always + created with Stream_LF format. + + A new command-line option, --ftp-stmlf, forces all FTP destination + files to Stream_LF format, as in Wget versions before 1.10.1. + + Add ";type=a" to the end of an FTP URL to specify an ASCII transfer. + + Destination files specified using "-O" ("--output-document") are always + created with Stream_LF format. + +3 FTP_file_versions + To specify an explicit ";nnn" version number in an FTP URL, escape the + ";" as "%3B", or, if the (VMS) FTP server will accept it, use a second + dot. For example, for "file.type;25" use a URL like: + ftp://server/directory/file.type%3B25 + or: + ftp://server/directory/file.type.25 + +3 RMS_default_parameters + For improved I/O speed, when writing a downloaded file, Wget uses these + RMS parameter values by default: BLOCK_COUNT = 127, BUFFER_COUNT = 2, + EXTEND_QUANTITY = 16384. + + The user may overide these values by specifying different (non-zero) + values for these parameters using the SET RMS_DEFAULT command. + +3 File_attributes + As with many C programs which originated on non-VMS systems, Wget may + make some assumptions about file attributes which can cause some + problems. One example is the "--post-file=FILE" option, which requires + that the "FILE" be in Stream_LF format. (In this case, HTTP 1.0 + requires the length of the request to be known, and the method used to + determine the size of the file will fail for Variable-length format + files.)