projects / unix-history / blame
| Commit | Line | Data |
|---|---|---|
| 6b3a1146 KB |
1 | .TH VMSPREP LOCAL "4/10/85 UCB Local" |
| 2 | .SH NAME | |
| c03ecd27 | 3 | vmsprep - VMS tape preparation aid |
| 6b3a1146 KB |
4 | .SH SYNOPSIS |
| 5 | .B vmsprep | |
| 6 | [-] [name ...] | |
| 7 | .SH DESCRIPTION | |
| 8 | .I Vmsprep | |
| 9 | traverses hierarchies of files and prepares them for | |
| 10 | transportation to VMS. | |
| 11 | Since ANSI stardard tapes (the VMS standard) do | |
| 12 | not allow hierarchy, this program provides a | |
| 13 | method of flattening the hierarchy onto a tape | |
| 14 | in such a way that it can be unpacked on VMS | |
| 15 | to recreate the same tree structure. | |
| 16 | .PP | |
| 17 | For reasons best not described here, | |
| 18 | .I vmsprep | |
| 19 | will attempt to exclude all RCS and SCCS archives by | |
| 20 | ignoring all files or directories named 'RCS' or 'SCCS', or | |
| 21 | files starting with 's.' or ending in ',v'. | |
| 22 | .PP | |
| 23 | The output of | |
| 24 | .I vmsprep | |
| 25 | is a pair of files vmsprep.namelist and UNPACK.COM. | |
| 26 | vmsprep.namelist is a list of files to be placed on | |
| 27 | the tape in the format required by | |
| 28 | .I ansitape. | |
| 29 | If the first argument is '-' instead of a file or directory name, | |
| 30 | vmsprep will instead send the namelist to standard output, and | |
| 31 | place UNPACK.COM in /tmp to avoid attempting to write in the | |
| 32 | current directory. | |
| 33 | All of the files except UNPACK.COM will | |
| 34 | be placed on the tape under cryptic names. | |
| 35 | UNPACK.COM is a VMS command script which will recreate | |
| 36 | all of the necessary directories and then move the | |
| 37 | cryptically named files to their proper place. | |
| 38 | .PP | |
| 39 | A typical sequence would be: | |
| 40 | .br | |
| 41 | .RS | |
| 42 | vmsprep - tree1 tree2 file | ansitape cln trees - | |
| 43 | .RE | |
| 44 | .br | |
| 45 | .I Then on a VMS machine | |
| 46 | .br | |
| 47 | .RS | |
| 48 | mount MFA0: trees | |
| 49 | .br | |
| 50 | copy MFA0:*.*.* * | |
| 51 | .br | |
| 52 | @UNPACK | |
| 53 | .RE | |
| 54 | .br | |
| 55 | .SH FILES | |
| 56 | vmsprep.namelist | |
| 57 | .br | |
| 58 | UNPACK.COM | |
| 59 | .br | |
| 60 | .SH DIAGNOSTICS | |
| 61 | A warning is reported if a file or directory name contains | |
| 62 | a character not permitted in VMS names. | |
| 63 | The offending character is replaced by 'Z' and | |
| 64 | .I vmsprep | |
| 65 | continues. | |
| 66 | .br | |
| 67 | .SH "SEE ALSO" | |
| 68 | ansitape(l) | |
| 69 | .SH BUGS | |
| 70 | Extra periods in file names may not be dealt with optimally. | |
| 71 | .br | |
| 72 | All files and directories to be moved must be descendants of the | |
| 73 | current working directory. Absolute path names and paths containing ".." | |
| 74 | will produce unpredictable results. | |
| 75 | .br | |
| 76 | Since vmsprep uses find(1) internally, it does not follow symbolic links. | |
| 77 | .br | |
| 78 | The exclusion of RCS and SCCS files should be controlled by a command line flag. | |
| 79 | .br | |
| 80 | Assumes VMS v4.0 or greater for long file names. | |
| 81 | .br |