Return to vmsprep.n CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / ansi

Annotation of 43BSD/contrib/ansi/vmsprep.n, revision 1.1.1.1

1.1       root        1: .TH VMSPREP LOCAL "4/10/85 UCB Local"
                      2: .SH NAME
                      3: vmsprep - VMS tape preperation aid
                      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

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.