sjero.net Git - wget/blob - vms/VMS_NOTES.TXT

   1                                                 29 January 2008.  SMS.
   2
   3                        Wget 1.11 for VMS (1.11a)
   4                        =========================
   5
   6 ------------------------------------------------------------------------
   7
   8       Disclaimer
   9       ----------
  10
  11    No claims of any sort are made herein.  The main Wget developers seem
  12 indifferent to this effort.  Any suggestions for improving the code in
  13 the VMS-specific sections are welcome, but low expectations are more
  14 realistic than high ones.
  15
  16 ------------------------------------------------------------------------
  17
  18       Description
  19       -----------
  20
  21    This note accompanies a quick VMS port of Wget version 1.10.2, a GNU
  22 free network utility to retrieve files from the World Wide Web using
  23 HTTP and FTP.  The most obvious features seem to work, but many have not
  24 been tested.
  25
  26    Built and tested (slightly) in these environments:
  27
  28 OpenVMS Alpha V7.3-2, HP C V7.3-009, TCPIP V5.4 - ECO 6
  29
  30 OpenVMS IA64 V8.3, HP C V7.3-018, TCPIP V5.6.
  31
  32 OpenVMS VAX V7.3, Compaq C V6.4-005, TCPIP V5.1.
  33
  34 ------------------------------------------------------------------------
  35
  36       News
  37       ----
  38
  39    Version 1.11a (PRELIMINARY)  2008-01-30
  40    ---------------------------------------
  41
  42 - General code update to Wget 1.11.
  43
  44 - Changed to avoid trying "LIST -a" for a VMS FTP server.
  45
  46 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  47
  48    Version 1.10.2c  2006-11-16
  49    ----------------------------
  50
  51 - Changed the code which determines the FTP server type to avoid an
  52   ACCVIO if no text was returned in response to a "SYST" inquiry.
  53
  54 - Fixed a command-line parsing problem with the "--ftp-stmlf" option.
  55
  56 - Fixed an unclosed comment (again?) in FTP-LS.C which could have caused
  57   problems with ODS5 extended file names.
  58
  59 - Changed VMS-WGET.COM to assume that nothing special is now required
  60   for use with the MultiNet IP package.  For obsolete VMS and/or
  61   MultiNet versions where the old MultiNet-specific changes are still
  62   needed, specify "MULTINET" on the VMS-WGET.COM command line.
  63
  64 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  65
  66    Version 1.10.2b  2004-12-15
  67    ----------------------------
  68
  69 - Changed the "-V" version report to include some host type information.
  70
  71 - Changed the I/O scheme on VMS for progress dots to avoid spurious
  72   newline characters when output is directed to a file.
  73
  74 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  75
  76    Version 1.10.2a  2004-10-13
  77    ----------------------------
  78
  79 - General code update to Wget 1.10.2.
  80
  81 - Many legitimate FTP CWD operations on a VMS FTP server failed.  The
  82   typical symptom was "No such directory `perfectly/vaild/directory'."
  83
  84 - FTP CWD operations on a VMS FTP server now end with a "CWD []".  For
  85   an FTP URL like "ftp://host/a/b/c/d.e" (and contrary to the RFC), Wget
  86   uses a UNIX-like directory specification in its CWD command, here,
  87   "CWD a/b/c".  This was observed to switch a TCPware FTP server
  88   (V5.6-2) into its UNIX emulation mode.  Because Wget checks the system
  89   type only once at the beginning of a session, the associated change in
  90   directory listing format confused the program.  The typical symptom
  91   was "No such file `-rwx---r-x'."  The added "CWD []" command resets
  92   the TCPware server to VMS mode, and should be harmless on other VMS
  93   FTP servers.
  94
  95 - VMS-WGET.COM now finds MMK when it's on DCL$PATH as well as when a
  96   foreign command symbol "MMK" is defined.
  97
  98 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  99
 100    Version 1.10.1a  2004-09-09
 101    ---------------------------
 102
 103 - General code update to Wget 1.10.1.
 104
 105 - VMS-specific files are now in the new [.VMS] directory.
 106
 107 - Changes to VMS-WGET.COM:
 108    - New command-line option, LARGE, enables large-file support on
 109      non-VAX systems.
 110    - VMS-WGET.COM may now be run from any default directory, not only
 111      [.SRC].
 112
 113 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 114
 115    Version 1.9.1e  2005-09-09
 116    --------------------------
 117
 118 - The default User-Agent string on VMS now includes the host
 119   architecture and VMS version.  For example, "Wget/1.9.1e (VMS Alpha
 120   V7.3-2)".
 121
 122 - Fixed a problem on VMS with an ODS5 destination file system when a
 123   URL-derived file name contained an invalid character ("?" or "*").  A
 124   typical complaint might look like:
 125      Cannot write to `www.foraddift.non/aspx/index.asp?sid=463e'
 126      (file specification syntax error).
 127   Now, "?" is converted to "!", and "*" to "#".
 128
 129 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 130
 131    Version 1.9.1d  2005-06-21
 132    --------------------------
 133
 134 - Replaced the remaining instances where ".orig" was appended to a file
 135   name.  Now (for VMS), "_orig" is used everywhere (except in the
 136   documentation).
 137
 138 - Disabled (for VMS) the code which appended ".nnn" (decimal "nnn") to
 139   an output file name to avoid overwriting an existing file.  The file
 140   name is now used unchanged, and VMS file versioning is expected to
 141   prevent overwriting.  (The multi-dot file names made this way caused
 142   I/O errors on ODS2 file systems.)
 143
 144 - Changed to do translation of CR-LF line endings to local line endings
 145   for ASCII FTP transfers.
 146
 147 - Changed (on VMS) to use fixed-512 format for binary FTP files.  Added
 148   the new "--ftp-stmlf" option ("ftpstmlf on" command) to let the user
 149   restore the old behavior, where Stream_LF was used for both ASCII and
 150   binary.
 151
 152 - Added (on VMS) a new open callback function which senses (where
 153   supported) the process RMS_DEFAULT values for file extend quantity
 154   (deq), multi-block count (mbc), and multi-buffer count (mbf), and sets
 155   the FAB/RAB parameters accordingly.  The default deq is now much
 156   larger than before (16384, was none), and the default mbc is now 127
 157   (was none), speeding creation of a large output file.  Explicitly set
 158   RMS_DEFAULT values override built-in defaults.
 159
 160 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 161
 162    Version 1.9.1c  2004-12-15
 163    --------------------------
 164
 165 - Added https (SSL) support, changing DESCRIP.MMS and VMS-WGET.COM, and
 166   adding WGET_SSL.OPT and WGET_SSL_HP.OPT.  Limited testing was done on
 167   Alpha, using HP SSL V1.1-B and OpenSSL version 0.9.7e.  The build
 168   procedure automatically enables SSL support if it can find one of the
 169   SSL header files.  The details are explained in comments in
 170   VMS-WGET.COM, including its new command-line options, HPSSL and NOSSL.
 171
 172 - Changed CONNECT.C to fix some problems with MultiNet TCP/IP software.
 173
 174    - A build problem related to header files (netdb.h) when compiled
 175      with MultiNet.  Typical symptom:
 176
 177          %CC-E-REDEFSTRUCT, In this declaration, the struct "hostent" is
 178          redefined. at line number 178 in module NETDB of text library
 179          SYS$COMMON:[SYSLIB]DECC$RTLDEF.TLB;1
 180
 181    - A run-time problem with an FTP URL. Typical symptom:
 182
 183          accept: bad address
 184
 185 - Changed FTP.C to fix various problems with time-stamping ("-N",
 186   "--timestamping") when using an FTP URL.  Some of the misbehavior was
 187   specific to a VMS FTP server, but not all.  The typical result was a
 188   file with the modification date (and, in some cases, the creation
 189   date) left at the date of the download, rather than set to match the
 190   date on the server.  Some misleading diagnostic messages also have
 191   been corrected.
 192
 193 - Changed FTP-LS.C to fix a typographical error (unclosed comment).
 194
 195 - Changed NETRC.C to fix a potential build problem on non-VMS systems.
 196   Adding some VMS-specific code introduced some improper statement
 197   ordering, which may generate complaints (or failure) with some C
 198   compilers.
 199
 200 - Changed VMS.C to fix a problem with the utime() function (supplied
 201   with Wget) when the user specified a non-UNIX file name with the Wget
 202   "-O" option.  Typical symptom:
 203
 204      utime(home_sms:[sms.wget]t.h): error 0
 205
 206   As the message might suggest, the file date-time was not being set
 207   correctly.  With this fix, utime() should work with either a UNIX-like
 208   or VMS-like file specification, and it should also set errno properly
 209   when it fails, enabling a more informative error message.
 210
 211 - New MMS/MMK description files and associated command procedures enable
 212   automatic source dependency generation.  Changed: DESCRIP.MMS and
 213   VMS-WGET.COM.  New: DESCRIP_DEPS.MMS, DESCRIP_MKDEPS.MMS,
 214   DESCRIP_SRC.MMS, COLLECT_DEPS.COM, and MOD_DEP.COM.
 215
 216 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 217
 218    Version 1.9.1b  2004-09-28
 219    --------------------------
 220
 221 - Changed CONFIG.H_VMS to fix a build problem with C RTL before VMS
 222   V7.3-1 with C Runtime ECO V3.0 on Alpha:
 223      %LINK-W-NUDFSYMS, 2 undefined symbols:
 224      %LINK-I-UDFSYM,         DECC$GXSNPRINTF
 225      %LINK-I-UDFSYM,         DECC$GXVSNPRINTF
 226      [...]
 227
 228 - Changed VMS.C:
 229
 230    - Fixed a build problem with C RTL before V7.2:
 231         %CC-E-UNDECLARED, In this statement, "DVI$C_ACP_F11V5" is not
 232         declared. at line number 262 in file
 233         disk:[xxx.WGET-1_9_1A_VMS.SRC]VMS.C;1
 234
 235    - Fixed a build problem with C RTL before VMS V7.3 with C Runtime ECO
 236      2 on Alpha:
 237         %CC-I-IMPLICITFUNC, In this statement, the identifier
 238         "decc$feature_get_index" is implicitly declared as a function.
 239         at line number 155 in file disk:[xxx.WGET-1_9_1A_VMS.SRC]VMS.C;1
 240
 241         %CC-I-IMPLICITFUNC, In this statement, the identifier
 242         "decc$feature_get_value" is implicitly declared as a function.
 243         at line number 159 in file disk:[xxx.WGET-1_9_1A_VMS.SRC]VMS.C;1
 244
 245         %CC-I-IMPLICITFUNC, In this statement, the identifier
 246         "decc$feature_set_value" is implicitly declared as a function.
 247         at line number 169 in file disk:[xxx.WGET-1_9_1A_VMS.SRC]VMS.C;1
 248
 249      and the related:
 250
 251         %LINK-W-NUDFSYMS, 3 undefined symbols:
 252         %LINK-I-UDFSYM,         DECC$FEATURE_GET_INDEX
 253         %LINK-I-UDFSYM,         DECC$FEATURE_GET_VALUE
 254         %LINK-I-UDFSYM,         DECC$FEATURE_SET_VALUE
 255         [...]
 256
 257    - Fixed a build problem with Multinet involving use of both the
 258      Multinet-specific and generic netdb.h header files:
 259
 260         %CC-E-REDEFSTRUCT, In this declaration, the struct "hostent" is
 261         redefined. at line number 178 in module NETDB of text library
 262         SYS$COMMON:[SYSLIB]DECC$RTLDEF.TLB;1
 263
 264    - Fixed a typographical error (unclosed comment) which kept the C RTL
 265      feature DECC$EFS_CHARSET from being enabled as intended. This
 266      caused a run-time problem on non-VAX systems with some ODS5
 267      extended file specifications with multiple dots in file names,
 268      typically when "-m" ("--mirror"), "-O" ("--output-document"), or
 269      "-r" ("--recursive") was used:
 270
 271         hostname/test/a.B.c: file specification syntax error
 272      or
 273         test/a.B.c: non-translatable vms error code: 0x186D4
 274         rms-f-syn, file specification syntax error
 275
 276    - Fixed a spurious diagnostic message when doing HTTP and
 277      complex FTP transfers:
 278
 279         utime().  sys$parse() = 00010001.
 280
 281 - Changed FTP.C to fix a variety of problems encountered when using a
 282   VMS FTP server.  These problems (not seen in Wget 1.5.3h) were caused
 283   mostly by inappropriate code added (in the main Wget development
 284   stream) to "help" deal with a VMS FTP server.  Removing this code and
 285   reforming the procedure used for getting to relative directories seems
 286   to have fixed the problems.  As before, a single-slash URL
 287   ("ftp://host/one/two/name.type") will be treated as specifying a
 288   relative directory ("one/two"), while a double-slash URL
 289   ("ftp://host//one/two/name.type") will be treated as specifying an
 290   absolute directory ("/one/two").  As usual, the VMS FTP server will
 291   attempt to puzzle out whether "/one/two" should really be interpreted
 292   as "one:[two]", but it's better equipped to do it than Wget is.
 293
 294 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 295
 296    Version 1.9.1a  2004-04-28
 297    --------------------------
 298
 299 - Changes to VMS-WGET.COM since Wget 1.5.3h:
 300
 301    - A separate LIST command-line option now controls compiler listing
 302      files.  The DBG option no longer implies compiler listing files.
 303      The LIST option also generates a link map with cross-reference.
 304
 305    - The DBG option may actually work now.
 306
 307    - Added support for IA64 architecture.
 308
 309 - Changes to DESCRIP.MMS since Wget 1.5.3h:
 310
 311    - Compiler listing files (.LIS) and link maps (.MAP) are now put into
 312      the system-specific directory with the corresponding object files
 313      (.OBJ), namely, [.SRC.ALPHA], [.SRC.IA64], or [.SRC.VAX].
 314      Previously, they were put into the source directory ([.SRC])
 315      itself.
 316
 317    - CLEAN target now deletes any .LIS and .MAP files.
 318
 319    - New HELP target creates a Wget help library.
 320
 321    - The OS_TYPE macro is now defined, including the VMS version.
 322
 323    - No more complaints like "%MMS-W-MBREDEFILL, Illegal attempt to
 324      redefine macro 'CFLAGS'" on old versions of MMS.
 325
 326    - A separate LIST macro now controls compiler listing files.  The
 327      DBG macro no longer implies compiler listing files.
 328
 329    - New support for IA64 architecture.
 330
 331 - Built-in initialization of some DECC$* run-time options on non-VAX
 332   systems.  Currently this behavior is compiled in, so any changes must
 333   be made in the VMS.C source file.  These changes have no effect on VAX
 334   (or older Alpha) systems where the OS and C run-time support is
 335   absent.
 336
 337    - Command-line case preservation.  Wget for VMS enables the following
 338      DECC$* run-time option:
 339         DECC$ARGV_PARSE_STYLE
 340      With extended command parsing enabled ("SET PROCESS
 341      /PARSE_STYLE = EXTENDED"), command-line case is preserved.  This
 342      obviates quoting case-sensitive option switches, URLs, and other
 343      parameters.
 344
 345    - Extended file names on ODS5 file systems.  Wget for VMS enables the
 346      following DECC$* run-time options:
 347         DECC$EFS_CASE_PRESERVE
 348         DECC$EFS_CHARSET
 349      Thus, if an ODS5 file system is used as the destination for
 350      downloaded files, multiple dots will be permitted and case will be
 351      preserved in file names.  If an ODS2 file system is used, the same
 352      character substitutions will be made as in Wget 1.5.3h, namely,
 353      "." -> "_" (where needed), "~" -> "-", and "@" -> "$".
 354
 355 ------------------------------------------------------------------------
 356
 357       Changes to Source Files
 358       -----------------------
 359
 360    Files new for VMS (all in [.VMS]):
 361
 362       COLLECT_DEPS.COM   Dependency collector for DESCRIP_MKDEPS.MMS.
 363
 364       config.h_vms       VMS-specific CONFIG.H.
 365
 366       decc_ver.c         Diagnostic program to provide build environment
 367                          information.
 368
 369       DESCRIP.MMS        Main MMK or MMS description ("make") file.
 370
 371       DESCRIP_CONFIG.MMS CONFIG.H description file.
 372
 373       DESCRIP_DEPS.MMS   Source dependency description file.
 374
 375       DESCRIP_MKDEPS.MMS Source dependency generator description file.
 376
 377       DESCRIP_SRC.MMS    Source list description file.
 378
 379       VMS-WGET.COM       DCL procedure to build the executable from the
 380                          source, using MMK or MMS (and DESCRIP*.MMS).
 381
 382       vms.c              Various VMS-specific code: DEC C run-time
 383                          initialization, ODS2-ODS5 file system
 384                          detection, ODS2 file name adjustment, file open
 385                          callback function for better RMS parameters,
 386                          "utime()" replacement function, and for VMS
 387                          before V7.0, "getpwuid()" and "localtime_r()".
 388
 389       vms.h              VMS-specific header file.  For VMS C RTL before
 390                          V7.3, replacement for <utime.h>.  For VMS C RTL
 391                          before V7.0, replacement for <pwd.h>.
 392                          Declarations of replacement data
 393                          types/structures and function prototypes for
 394                          vms.c.
 395
 396       vms_ip.h           IP software type-specific "#include"
 397                          directives.  Used by host.c.
 398
 399       vms_name_fix.sh    UNIX shell script to restore file names after
 400                          storage on an ODS2 file system.
 401
 402       VMS_NOTES.TXT      These notes.
 403
 404       WGET.HLP           Simple help file.
 405
 406       WGET.OPT           LINK options file.
 407
 408       WGET_MULTINET.OPT  LINK options file supplement for Multinet.
 409
 410       WGET_SSL.OPT       LINK options file supplement for OpenSSL.
 411
 412       WGET_SSL_HP.OPT    LINK options file supplement for HP SSL.
 413
 414
 415    Files modified for VMS (all in [.SRC]):
 416
 417       connect.c         Added code for VMS header files.
 418
 419       convert.c         Changed to use "_orig" instead of ".orig" on VMS
 420                         as the file name suffix used for the "-K"
 421                         ("--backup-converted") option.
 422
 423       ftp.c             Added code for VMS header files.
 424                         Changed to eliminate a spurious -debug message
 425                         ("Unrecognized permissions for <directory>").
 426                         Changed to eliminate spurious complaints when
 427                         recursive downloads hit an empty directory.
 428                         Changed to fix various problems dealing with a
 429                         VMS FTP server.
 430                         Changed to fix various problems with FTP and
 431                         time-stamping ("-N").
 432                         Changed to distinguish between ASCII and binary
 433                         FTP transfers for proper local line endings.
 434                         Added (for VMS) VMS-specific file open options.
 435
 436       ftp.h             Added ftp_dele() function.  (See ftp-basic.c.)
 437                         Added an argument to ftp_list() for the FTP
 438                         server type.  (See ftp-basic.c.)
 439
 440       ftp-basic.c       Added ftp_dele() function to accomodate a remote
 441                         delete-after-download option.
 442                         Changed ftp_list() to avoid trying "LIST -a" for
 443                         an VMS FTP server.
 444
 445       ftp-ls.c          Changed to open the ".listing" file in text
 446                         mode, not binary.
 447                         Changed VMS FTP DIR-parsing code to tolerate
 448                         more variability (leading blank lines).
 449                         Added support for the environment variable
 450                         "WGET_TIMEZONE_DIFFERENTIAL" for file time
 451                         adjustment (as in Wget 1.5.3h for VMS).
 452
 453       host.c            Added code for VMS header files.
 454
 455       host.h            Added code for VMS header files.
 456
 457       http.c            Added code for VMS header files.
 458                         Changed to use an OS-specific file name suffix,
 459                         "_orig" for VMS, rather than a hard-coded
 460                         ".orig".
 461                         Added (for VMS) VMS-specific file open options.
 462                         Added (for VMS) host type and OS version info to
 463                         the default User-Agent string.
 464                         Changed "ssl_connect()" to "ssl_connect_wget()"
 465                         to avoid conflict with "SSL_connect()".
 466                         Added a type cast to remove a
 467                         %CC-I-QUESTCOMPARE1 compiler complaint.
 468
 469       init.c            Changed (on VMS) to use "SYS$LOGIN:.wgetrc" as
 470                         the name of the user-specific initialization
 471                         file (if "WGETRC" is not defined), and
 472                         "SYSTEM_WGETRC" (expected to be a logical name)
 473                         as the system-wide initialization file.
 474                         Changed to open ".wgetrc" in text mode, not
 475                         binary.
 476                         Added (for VMS) "--ftp-stmlf" option ("ftpstmlf
 477                         on" command to force Stream_LF format (instead
 478                         of fixed-512) for binary FTP output files.
 479
 480       log.c             Changed the I/O scheme on VMS for progress dots
 481                         to avoid spurious newline characters when output
 482                         is directed to a file.
 483
 484       main.c            Changed the program identification debug message
 485                         ("built on OS_TYPE" instead of "on OS_TYPE"),
 486                         and added host information to the "-V" version
 487                         report.
 488                         Changed to set ODS5 flag if the download
 489                         destination is on an ODS5 file system.
 490                         Added (for VMS) "--ftp-stmlf" option ("ftpstmlf
 491                         on" command to force Stream_LF format (instead
 492                         of fixed-512) for binary FTP output files.
 493                         Adjusted the help message for -K to say "_orig"
 494                         instead of ".orig".  (See convert.c.)
 495
 496       netrc.c           Changed to use "SYS$LOGIN:.netrc" as the name of
 497                         the user name and password file on VMS.
 498
 499       openssl.c         Changed "ssl_connect()" to "ssl_connect_wget()"
 500                         to avoid conflict with "SSL_connect()".
 501
 502       options.h         Added (for VMS) "--ftp-stmlf" option ("ftpstmlf
 503                         on" command to force Stream_LF format (instead
 504                         of fixed-512) for binary FTP output files.
 505
 506       retr.c            Changed to adjust CR-LF line endings in ASCII
 507                         FTP data to proper local line endings.
 508                         Changed to disable (for VMS) a useless fflush()
 509                         which was slowing file I/O.
 510
 511       retr.h            Changed to accomodate changes for FTP to
 512                         distinguish between ASCII and binary FTP
 513                         transfers for proper local ASCII line endings.
 514
 515       ssl.h             Changed "ssl_connect()" to "ssl_connect_wget()"
 516                         to avoid conflict with "SSL_connect()".
 517
 518       url.c             Added code for VMS header files.
 519                         Added code to replace unacceptable dots (".")
 520                         (and other invalid characters) with underscores
 521                         ("_"), tildes ("~") with hyphens ("-"), and at
 522                         signs ("@") with dollar signs ("$"),
 523                         respectively, in URL-derived file specifications
 524                         on ODS2 file systems.
 525
 526       utils.c           Added VMS-specific code to work around the lack
 527                         of "fork()".
 528                         Changed to assist ODS2 name reversion.
 529                         Added (for VMS) VMS-specific file open options.
 530                         Changed to use a macro, UNIQ_SEP, instead of a
 531                         hard-coded ".", as the separator character when
 532                         adding a decimal "nnn" suffix to a file name to
 533                         make it unique.  Not defining UNIQ_SEP, as on
 534                         VMS, now disables adding the suffix.  (See
 535                         WGET.H.)
 536
 537       utils.h           Added a declaration of the character properties
 538                         look-up table for use in ftp-ls.c.
 539
 540       version.h         Adapted from version.c.  Changed the version
 541                         string from "1.11" to "1.11a".
 542
 543       wget.h            Added a definition of an OS-specific file name
 544                         suffix, ORIG_SFX ("_orig", for VMS), to be used
 545                         instead of a hard-coded ".orig".  (See
 546                         convert.c, http.c.)
 547                         Added a definition of an OS-specific separator
 548                         character, UNIQ_SEP, for the decimal "nnn"
 549                         version number appended to a file name to make
 550                         it unique.  (See utils.c.)
 551                         Fixed a defective typedef (affecting small-file
 552                         builds).
 553
 554 ------------------------------------------------------------------------
 555
 556       Home source URL
 557       ---------------
 558
 559 http://www.gnu.org/directory/wget.html
 560 http://ftp.gnu.org/gnu/wget/
 561 ftp://ftp.gnu.org/gnu/wget/
 562
 563 ------------------------------------------------------------------------
 564
 565       Instructions
 566       ------------
 567
 568    Extract the files from the distribution kit.  The kit includes
 569 objects and executables for Alpha, IA64, and VAX, in the corresponding
 570 host-specific subdirectories.  These builds were done with options
 571 (explained below) "DASHD", "LARGE" (except VAX), and "NOSSL".
 572
 573    The command procedure VMS-WGET.COM attempts to determine the CPU
 574 type, the IP package, and SSL availability.  It defines the appropriate
 575 macros for MMK or MMS, and then builds the appropriate executable from
 576 the source:
 577
 578       SET DEFAULT [.WGET-1_10_2C_VMS.VMS]   ! For convenience.
 579       @ VMS-WGET CLEAN  ! Deletes all object, list, map, and executable
 580                         ! files for the current CPU type.
 581       @ VMS-WGET        ! Copies CONFIG.H_VMS to CONFIG.H, compiles the
 582                         ! source files, and links the executable,
 583                         ! WGET.EXE.
 584                         ! Add "DASHD" to this command line to enable the
 585                         ! Wget "-d" command-line option.
 586                         ! Add "DBG" to this command line to build a
 587                         ! debug executable.
 588                         ! Add "LARGE" to enable large-file support on
 589                         ! non-VAX systems.
 590                         ! Add "LIST" if compiler listing and link map
 591                         ! files are desired.
 592                         ! Add "MMS" to use MMS instead of MMK when both
 593                         ! are available.
 594                         ! Add "NOSSL" to inhibit use of any SSL package.
 595                         ! Add "HPSSL" to use the HP SSL package when
 596                         ! OpenSSL (the default choice) is also available.
 597       @ VMS-WGET HELP   ! Creates a help library.  (Optional.  See
 598                         ! below.)
 599
 600    Set the symbol for the foreign command:
 601
 602       WGET :== $ actual_device:[actual.directory]WGET.EXE
 603
 604    A very basic VMS HELP file is supplied in [.DOC]WGET.HLP.  To be
 605 used, it must be added to a HELP library, either an existing library or
 606 one just for Wget.  As mentioned above, a new Wget help library may be
 607 created using the command, "@ VMS-WGET HELP".
 608
 609    When a new HELP library is created, a logical name "HLP$LIBRARY_n"
 610 may be defined to allow the HELP utility to find it.  See "HELP HELP
 611 /USERLIBRARY" for details.
 612
 613    Try to read the original documentation to learn how to use Wget.  The
 614 principal differences in this VMS adaptation are:
 615
 616    "-b" ("background") has no effect.  (It uses "fork()".)
 617
 618    Excess dots are replaced by underscores in URL-derived file
 619 specifications on ODS2 file systems.  For example, on a UNIX system, the
 620 URL "ftp://ftp.anywhere.org/x.y.z/a.b.c" could produce the local file
 621 "ftp.anywhere.org/x.y.z/a.b.c".  With this VMS adaptation, the local
 622 ODS2 file would be "[.FTP_ANYWHERE_ORG.X_Y_Z]A_B.C".  On an ODS5 file
 623 system, the file would be [.ftp^.anywhere^.org.x^.y^.z]a^.b.c".
 624
 625 ------------------------------------------------------------------------
 626
 627    The accompanying source kit may suffer from storage on an ODS2 file
 628 system, which does not preserve case or allow multiple dots in a file
 629 name.  Building this kit should work on VMS, but it may be expected to
 630 fail on other systems.  To use this kit on a non-VMS system, the files
 631 may need to be renamed to restore their original mixed-case and/or
 632 multi-dot names.  The UNIX shell script "vms_name_fix.sh" (or something
 633 like it) should do the job.
 634
 635 ------------------------------------------------------------------------
 636
 637    Steven M. Schweda               (+1) 651-699-9818  (voice)
 638    382 South Warwick Street        sms@antinode.org
 639    Saint Paul  MN  55105-2547
 640