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     ! 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.