home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / perl / perl30 / readme < prev    next >
Text File  |  1990-05-09  |  5KB  |  131 lines
  1.          Notes on the binary release of MS-DOS Perl
  2.  
  3.  
  4.             Perl program designed and created by
  5.            Larry Wall <lwall@devvax.jpl.nasa.gov>
  6.  
  7.                DOS port and binary release by
  8.             Diomidis Spinellis <dds@cc.ic.ac.uk>
  9.  
  10.  
  11. 1.  Copying
  12.  
  13.      Perl  is  copyrighted  under  the  GNU  General  Public
  14. License  a  copy  of  which can be found in the file ``Copy-
  15. ing.''  Please read the  license  before  copying  or  using
  16. Perl.   This  binary  distribution  is  based on paragraph 3
  17. clause c) of it. You can find the complete  source  of  Perl
  18. available  for  anonymous  ftp  and uucp on uunet.uu.net and
  19. other comp.sources.unix archives.
  20.  
  21. 2.  Contents
  22.  
  23.      The following files are included in this distribution
  24.  
  25.         Name          Length   CRC
  26.         ============  ======== ====
  27.         PERL.EXE        267813 5246     Perl executable
  28.         GLOB.EXE          6373 2a1c     Wildcard expansion
  29.         COPYING          12735 6512     GNU General Public License
  30.         PERL.MAN        216516 5007     Manual
  31.         README          fixed point     This file
  32.         DRIVES.BAT        1153 ab1d     Example program
  33.         ABBREV.PL          584 4a6b     Various library utilities
  34.         CTIME.PL          1314 8f48
  35.         DUMPVAR.PL         612 de91
  36.         GETOPT.PL         1070 9439
  37.         GETOPTS.PL         950 66a9
  38.         IMPORTEN.PL        358 2e02
  39.         LOOK.PL           1062 0a35
  40.         PERLDB.PL        11399 bfce
  41.         STAT.PL            635 95f6
  42.  
  43.  
  44. 3.  Installation
  45.  
  46.      In order to install Perl you need to copy the Perl exe-
  47. cutable  (perl.exe) and the filename wildcard expansion com-
  48. mand (glob.exe) in a directory included in  your  path.   In
  49. order  to use the Perl debugger and the other library utili-
  50. ties you need to copy all the .pl files  in  the  directory:
  51. /usr/local/lib/perl.   The  manual can be printed on 66 line
  52. per page paper on any printer capable of overstriking.
  53.  
  54.  
  55. 4.  Using MS-DOS Perl
  56.  
  57.      The MS-DOS version of perl has most of the  functional-
  58. ity of the Unix version.  Functions that can not be provided
  59. under  MS-DOS  like  sockets,  password  and  host  database
  60. access,  fork  and wait have been ommited and will terminate
  61. with a fatal error.  Care has been taken  to  implement  the
  62. rest.   In particular directory access, redirection (includ-
  63. ing pipes, but excluding the pipe function),  system,  ioctl
  64. and sleep have been provided.
  65.  
  66. 4.1.  Interface to the MS-DOS ioctl system call.
  67.  
  68.      The function code of the  ioctl  function  (the  second
  69. argument) is encoded as follows:
  70.  
  71.         - The lowest nibble of the function code goes to AL.
  72.         - The two middle nibbles go to CL.
  73.         - The high nibble goes to CH.
  74.  
  75.      The return code is -1 in the case of an  error  and  if
  76. successful:
  77.  
  78.         - for functions AL = 00, 09, 0a the value of the register DX
  79.         - for functions AL = 02 - 08, 0e the value of the register AX
  80.         - for functions AL = 01, 0b - 0f the number 0.
  81.  
  82.      See the perl manual for instruction on how  to  distin-
  83. guish between the return value and the success of ioctl.
  84.  
  85.      Some ioctl functions need a number as the  first  argu-
  86. ment.   Provided  that  no  other files have been opened the
  87. number  can  be   obtained   if   ioctl   is   called   with
  88. @fdnum[number]  as  the  first  argument after executing the
  89. following code:
  90.  
  91.                 @fdnum = ("STDIN", "STDOUT", "STDERR");
  92.                 $maxdrives = 15;
  93.                 for ($i = 3; $i < $maxdrives; $i++) {
  94.                         open("FD$i", "nul");
  95.                         @fdnum[$i - 1] = "FD$i";
  96.                 }
  97.  
  98.  
  99. 4.2.  Binary file access
  100.  
  101.      Files are opened in text mode by default.   This  means
  102. that  CR LF pairs are translated to LF.  If binary access is
  103. needed the `binary'  function  should  be  used.   There  is
  104. currently  no  way to reverse the effect of the binary func-
  105. tion.  If that is needed close and reopen the file.
  106.  
  107. 4.3.  Interpreter startup.
  108.  
  109.      The effect of the Unix #!/bin/perl interpreter  startup
  110. can  be  obtained  under  MS-DOS by giving the script a .bat
  111. extension and using the following lines on its begining:
  112.  
  113.                 @REM=("
  114.                 @perl %0.bat %1 %2 %3 %4 %5 %6 %7 %8 %9
  115.                 @goto end ") if 0 ;
  116.  
  117. And the following ones at the end:
  118.  
  119.                 @REM=("
  120.                 :end ") if 0 ;
  121.  
  122. (Note that you will probably want an absolute path  name  in
  123. front of %0.bat).
  124.  
  125.                                         May 1990
  126.  
  127.                                         Diomidis Spinellis <dds@cc.ic.ac.uk>
  128.                                         Myrsinis 1
  129.                                         GR-145 62 Kifissia
  130.                                         Greece
  131.