home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / arc_lbr / lu.arc / LUU213.DOC < prev    next >
Encoding:
Text File  |  1986-04-28  |  9.6 KB  |  252 lines
  1. -                                                                      Page 1
  2.                         LUU - Library Update Utility
  3.                        Version 2.13 - April 28, 1986
  4.                           (c) Vernon D. Buerg 1986
  5.  
  6.  
  7. LUU Command
  8. -----------
  9.  
  10. Purpose:   To place one or more files into a single library (LBR)
  11.            file for archiving, data transmission or back-up.
  12.  
  13. Format:    LUU   [d:][path]filename[.LBR]  filespec(s) /N /Q /D /nnn
  14.  
  15. Remarks:   The library name and at least one input member file name
  16.            must be supplied. The library name may contain a drive,
  17.            path names, and a filename with an extension. If the
  18.            library extension is omitted, .LBR is assumed.
  19.  
  20.            There may be one or more member file names. Separate each
  21.            member name by one blank. Each member name may include a
  22.            drive, path names, and wildcard characters in the file
  23.            name and extension.
  24.  
  25.            Files larger than 1024 bytes are automatically sQueezed
  26.            using the Greenlaw/Huffman algorithm. You may use the /N
  27.            option to negate sQueezing. If the squeezed file is larger
  28.            than the original file, an extra step is taken to place
  29.            the smaller original file into the library. You may use
  30.            the /Q option to bypass this step and put the squeezed
  31.            version of the file into the library.
  32.  
  33.            The input files may be deleted (after being placed into
  34.            the library file) by using the /D option.
  35.  
  36.            If the LBR file does not exist, you are prompted to enter
  37.            a number for the size of the library directory. You may
  38.            use the /nnn option to supply this number and avoid the
  39.            prompt.
  40.  
  41.            The DOS error level is set to 1 if LUU terminates with an
  42.            error.
  43.  
  44. Notes:     Written for the IBM PC using DOS 2.0 through DOS 3.1.
  45.            For private, personal use. Commercial use prohibited.
  46.  
  47.            Copyright (c) 1985 by Vernon Buerg. All rights reserved.
  48.                 456 Lakeshire Drive
  49.                 Daly City, CA 94015
  50.                 RBBS: 415-994-2944
  51.                 CompuServe: 70007,1212
  52.  
  53.            LUU duplicates the A(dd) and U(pdate) functions of LU.
  54.            When used with LUT and LUE, original file dates are
  55.            preserved and recorded.
  56.  
  57.            The advantages of LUU are:
  58.              o  smaller, so a copy can be kept on the "system" disk
  59.              o  faster, mucho
  60.              o  handles paths and wildcards
  61.              o  retains input file (or member) date/time
  62.              o  replaces in-place to save disk space
  63.              o  automatically squeezes files to save disk space
  64. -
  65.                         LUU - Library Update Utility
  66.  
  67. Command Options
  68. ---------------
  69.  
  70.         /N    indicates do Not squeeze the files, place the original
  71.               files, as-is, into the library
  72.  
  73.         /Q    indicates that the sQueezed version of the files be
  74.               placed into the library whether they are larger than
  75.               the original version or not
  76.  
  77.         /D    indicates that the original files be deleted after
  78.               being added to the library
  79.  
  80.         /nnn  supplies the number of directory to allocate to a
  81.               new library, thus bypassing the prompt. A value of
  82.               1 to 255 may be used.
  83.  
  84.         All command options must be entered after any filename
  85.         parameters. That is, at the end of the command line.
  86.  
  87.         The defaults result in squeezing any file that is larger than
  88.         1024 bytes, and placing the squeezed version of the file into
  89.         the library only if it is smaller than the original file.
  90.  
  91.  
  92. Examples
  93. --------
  94.  
  95.         o  Place all files on drive B which have an extension
  96.            of "AQM" into the file called "AQM.LBR":
  97.  
  98.                 LUU a:AQM.LBR  b:*.AQM
  99.  
  100.  
  101.         o  Place all files on drive B which have a filename
  102.            of PCT366 into the file PCT366.LBR and do not sQueeze
  103.            them:
  104.  
  105.                 LUU PCT366 b:PCT366.* /N
  106.  
  107.  
  108.         o  Place all files from drive B which match the file
  109.            specification "AB??XX.???", and all files from the
  110.            the directory "PROD" on drive A which have an extension
  111.            of "ASC" into the file "SOURCE.LBR" in the directory
  112.            called "TEST" on drive C:
  113.  
  114.                 LUU c:\test\source.lbr  b:ab??xx.*  a:\prod\*.asc
  115.  
  116.  
  117.         o  Place all files from the current drive into a new
  118.            library called "TEST.LBR", and allocate 32 directory
  119.            entries if the library does not exist:
  120.  
  121.                 LUU test *.* /32
  122.  
  123. -
  124.                         LUU - Library Update Utility
  125.  
  126. File Formats
  127. ------------
  128.  
  129.                An LBR file consists of a directory and one or more
  130.            "members". The directory contains from 4 to 256 entries.
  131.            Each entry is 32 bytes long and describes a member, if
  132.            one exists.
  133.  
  134.                 The first directory entry describes the directory
  135.            itself. Thus, the number of entries allocated is increased
  136.            by one.
  137.  
  138.                 All space allocation is in terms of sectors. Each
  139.            sector is 128 bytes long. Four directory entries fit
  140.            in one sector, so the directory is allocated in multiples
  141.            of four.
  142.  
  143.                 There are three directory formats recognized by LUU.
  144.            They are: 1) old LU, 2) LUPC, and 3) new LU86. When a new
  145.            library is created, LUU uses the new LU86 directory format.
  146.            If LUU is updating an existing LBR file, it uses the same
  147.            format that the file was created with.
  148.  
  149.                         Directory format
  150.                         ----------------
  151.                 0 - File status; 0=active, 254=deleted, 255=free
  152.                 1 - Member name; filename in FCB format, dir name is blanks
  153.                12 - Offset to data in sectors of 128 bytes
  154.                14 - Length of member in sectors.
  155.                16 - all zero for 'old LU' format
  156.  
  157.                         LUPC format extension
  158.                         ---------------------
  159.                 1 - master directory name is ********DIR
  160.                16 - Original member file creation date, MM/DD/YY
  161.                24 - Original member file creation time, HH:MM:SS
  162.  
  163.                         LU86 Directory Format
  164.                         ---------------------
  165.  
  166.                 0 - File status; 0=active, 254=deleted, 255=free
  167.                 1 - Member name; filename in FCB format, dir name is blanks
  168.                12 - Offset to data in sectors of 128 bytes
  169.                14 - Length of member in sectors.
  170.                16 - CRC word, or zero if Cyclic Redundancy Checking not used
  171.                18 - File create date, CP/M format
  172.                20 - File create time, DOS format
  173.                22 - Date file last updated (replaced), CP/M format
  174.                24 - Time file last updated, DOS format
  175.                26 - Number of bytes in last sector
  176.                27 - reserved/unused/zero
  177.  
  178.  
  179.            The date and time stamp fields vary in format. LUU uses
  180.            the LU86 format when it creates a library. Otherwise, the
  181.            format used when the library was created is used.
  182.  
  183.            The member name for the directory entry is all blanks.
  184.            This allows for compatibility checking between versions
  185.            of LU and LUU.
  186. -
  187.                                                                         Page 4
  188.                         LUU - Library Update Utility
  189.  
  190.  
  191.  
  192. Version History
  193. ---------------
  194.  
  195.            1.2, July 30, 1984.
  196.            1.3, August 6, 1984.
  197.              -  Ignore CRC bytes in directory.
  198.              -  Update in place if replacement member is same size
  199.                 or smaller, of is last member in directory.
  200.  
  201.            1.4, August 13, 1984.
  202.              -  recognize new CPM date/time stamp format
  203.  
  204.            1.5, December 21, 1984,
  205.              -  allow multiple member names to be specified
  206.  
  207.            1.6, January 23, 1984,
  208.              -  default to LU86 directory format
  209.  
  210.            1.65, April 13, 1985,
  211.              - set ERRORLEVEL to 1 if any errors
  212.              - use DOS functions for displaying messages to allow
  213.                for redirection, etc.
  214.  
  215.            1.66, May 14, 1985,
  216.              - correct CP/M dates from LU86 formats
  217.  
  218.            1.67, June 17, 1985,
  219.              - correct MAJOR problem "Updating" the last file,
  220.                would result in damage to other files.
  221.  
  222.            2.00, June 26, 1985
  223.              - add CRC for LBR files
  224.              - add CRC for directory
  225.              - re-use deleted entries
  226.  
  227.            2.05, July 13, 1985
  228.              - automatically sQueeze files larger than 1024 bytes
  229.              - add /N option to suppress sQueezing
  230.  
  231.            2.08, December 29, 1985
  232.              - add the /nnn option to supply the number of directory
  233.                entries for new library files
  234.              - add /D option to delete input files
  235.  
  236.              - use smaller of original file or squeezed file
  237.              - add /Q option to use sQueezed file regardless of size
  238.  
  239.              - correct directory update problem if "File not found"
  240.                error occurs
  241.              - implement CRC for squeezed files
  242.  
  243.            2.09, January 27, 1986
  244.              - correct losing directory if run out of directory entries,
  245.                or any other error
  246.  
  247.            2.13, April 28, 1986
  248.              - correct replacement of members that were automatically
  249.                squeezed
  250.  
  251.  
  252.