home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol149 / unix-lu.doc < prev    next >
Encoding:
Text File  |  1984-04-29  |  2.2 KB  |  97 lines
  1.            LAR     1  LAR     C  u           .TH LAR linus
  2. .SH NAME
  3. LAR \- CP/M lu compatible file archiver
  4. .SH SYNOPSIS
  5. .B lar
  6. key library [ file ... ]
  7. .SH DESCRIPTION
  8. Lar is a Unix program to manipulate CP/M LU format libraries.
  9. The primary use of lar is to combine several
  10. files together for upload/download to a personal computer.
  11. Its actions are controlled by the
  12. .I key\^
  13. argument.
  14. The
  15. .I key\^
  16. is a string of characters containing
  17. at most one function letter and possibly
  18. one or more function modifiers.
  19. Other arguments to the command are
  20. .I files\^
  21. specifying which files are to be dumped or restored.
  22. .PP
  23. The function portion of
  24. the key is specified by one of the following letters:
  25. .PP
  26. .PD 0
  27. .TP 8
  28. .B u
  29. The named
  30. .I files\^
  31. are added to the library.
  32. .TP
  33. .B e
  34. The named
  35. .I files\^
  36. are extracted from the tape.
  37. .TP
  38. .B p
  39. Print files in library.
  40. .TP
  41. .B d
  42. Delete files in library.
  43. .TP
  44. .B r
  45. Reorganize library.
  46. .TP
  47. .B t
  48. The names of the specified files are listed each time that they occur
  49. on the library.
  50. If no
  51. .I files\^
  52. argument is given,
  53. all the names
  54. on the tape are listed.
  55. .PD
  56. .PP
  57. The following characters may be used in addition to the letter
  58. that selects the desired function:
  59. .PP
  60. .PD 0
  61. .TP 8
  62. .TP
  63. .B v
  64. Normally,
  65. .I Lar\^
  66. does its work silently.
  67. The
  68. .B v
  69. (verbose)
  70. option causes it to type the name of each file it treats,
  71. preceded by the function letter.
  72. With the
  73. .B t
  74. function,
  75. .B v
  76. gives more information about the
  77. library entries than just the name.
  78. .SH DIAGNOSTICS
  79. Invoking lar without arguments prints a help message.
  80. .SH AUTHOR
  81. The original CP/M library program LU is the product of Gary P. Novosielski.
  82. Unix version by Stephen Hemminger,  Mitre Corp. Bedford MA.
  83. .SH BUGS
  84. Pathnames are stored in CP/M format (XXXXXXXX.XXX).
  85. .br
  86. Lar tries to detect
  87. text files vs. binaries by checking for non-Ascii (8th bit set) chars.
  88. If the file is text lar will throw away Control-Z chars which
  89. CP/M puts on the end.
  90. All files in the library are padded with Control-Z
  91. up to the end to the CP/M sector size if necessary.
  92. No effort is made to handle the difference between CP/M and Unix
  93. end of line chars.
  94. CP/M uses Cr/Lf and Unix just uses Lf.
  95. .SH SEE ALSO
  96. comhex(1), chek(1), cpmcat(1), crck(1), mkbin(1), sum(1), wc(1).
  97.