Return to mkpkg.8 CVS log

Up to [Research Unix] / researchv10dc / man / man8

Annotation of researchv10dc/man/man8/mkpkg.8, revision 1.1

1.1     ! root        1: .TH MKPKG 8
        !             2: .CT 1 comm_mach
        !             3: .SH NAME
        !             4: mkpkg, inspkg, seal, unseal \- package files for automatic software distribution
        !             5: .SH SYNOPSIS
        !             6: .B mkpkg
        !             7: [
        !             8: .I option ...
        !             9: ]
        !            10: .I file ...
        !            11: .PP
        !            12: .B inspkg
        !            13: [
        !            14: .I option ...
        !            15: ]
        !            16: [
        !            17: .I file ...
        !            18: ]
        !            19: .PP
        !            20: .B seal
        !            21: [
        !            22: .I option
        !            23: ]
        !            24: [
        !            25: .I file ...
        !            26: ]
        !            27: .PP
        !            28: .B unseal
        !            29: [
        !            30: .I option
        !            31: ]
        !            32: [
        !            33: .I file ...
        !            34: ]
        !            35: .SH DESCRIPTION
        !            36: These programs are used by
        !            37: .IR ship (8)
        !            38: to keep files identical across machines.
        !            39: .PP
        !            40: .I Mkpkg
        !            41: packages
        !            42: .I files
        !            43: and writes the result on the standard output.
        !            44: .I Inspkg
        !            45: installs the named packages
        !            46: or the standard input.
        !            47: .PP
        !            48: Non-existent files given to 
        !            49: .I mkpkg
        !            50: are deleted upon installation.
        !            51: Directories are copied with all their contents.
        !            52: Hard links are reproduced.
        !            53: Symbolic links and special files
        !            54: are reproduced with the same inode contents.
        !            55: File modification and access times and owner and group names
        !            56: are reproduced as far as possible.
        !            57: Old versions of files are removed before installation:
        !            58: .I inspkg
        !            59: needs write permission in containing directories.
        !            60: .PP
        !            61: Options for both
        !            62: .I mkpkg
        !            63: and
        !            64: .IR inspkg :
        !            65: .nr xx \w'\f5-K \f2keyfile '
        !            66: .TP \n(xxu
        !            67: .B -v
        !            68: Place running commentary on the standard error file.
        !            69: .br
        !            70: .ns
        !            71: .TP
        !            72: .BI -D path1 = path2
        !            73: Pretend that any pathname beginning with
        !            74: .I path1
        !            75: really begins with
        !            76: .IR path2 .
        !            77: Relative pathnames are extended to full pathnames before comparison.
        !            78: .PP
        !            79: Options for
        !            80: .IR mkpkg ;
        !            81: only one may occur:
        !            82: .TP \n(xxu
        !            83: .BI -x command
        !            84: Include in the package instructions to execute the shell
        !            85: .I command
        !            86: after all files have been installed.
        !            87: .I Command 
        !            88: is unaffected by option
        !            89: .BR -D .
        !            90: .br
        !            91: .ns
        !            92: .TP
        !            93: .BI -X file
        !            94: Include in the package instructions to
        !            95: run the shell script
        !            96: .I file
        !            97: after all files have been installed.
        !            98: The file name is subject to option
        !            99: .BR -D .
        !           100: .PP
        !           101: Options for
        !           102: .IR inspkg :
        !           103: .TP \n(xxu
        !           104: .B -n
        !           105: Skip the actual installation, but verify
        !           106: the input packages and produce a backup if requested.
        !           107: .br
        !           108: .ns
        !           109: .TP
        !           110: .B
        !           111: -b
        !           112: Write on the standard output a backup package
        !           113: that contains whatever was destroyed.
        !           114: .PP
        !           115: A package is an
        !           116: .IR ar (1)
        !           117: archive containing an extra 
        !           118: .SM ASCII
        !           119: file named
        !           120: .FR Instructions .
        !           121: .PP
        !           122: .I Seal
        !           123: concatenates the named
        !           124: .I files
        !           125: or the standard input
        !           126: onto the standard output in 
        !           127: an error-detecting form suitable for shipment by
        !           128: .IR mail (1).
        !           129: .I Unseal
        !           130: reverses the process, concatenating copies of all the
        !           131: original inputs onto the standard output.
        !           132: When
        !           133: .IR asd (8)
        !           134: uses
        !           135: .IR uucp (1), 
        !           136: it sends sealed packages.
        !           137: .PP
        !           138: A sealed file is printable, has
        !           139: fewer than 128 characters per line, and has no lines
        !           140: consisting of a single period.
        !           141: The first line is
        !           142: .L !<seal>
        !           143: and the last one begins with
        !           144: .LR !end .
        !           145: Other lines, such as mail headers, can be added to
        !           146: either end of a sealed file
        !           147: without hindering
        !           148: .IR unseal .
        !           149: .PP
        !           150: Options for 
        !           151: .I seal
        !           152: and
        !           153: .IR unseal :
        !           154: .TP \n(xxu
        !           155: .B -k
        !           156: A key will be demanded to encrypt the
        !           157: checksum calculation.
        !           158: .br
        !           159: .ns
        !           160: .TP
        !           161: .BI -K " keyfile"
        !           162: Same, but taking the first line of
        !           163: .I keyfile
        !           164: as the key.
        !           165: .SH SEE ALSO
        !           166: .IR ar (1), 
        !           167: .IR cpio (1), 
        !           168: .IR tar (1), 
        !           169: .IR bundle (1),
        !           170: .IR ship (8),
        !           171: .IR ar (5),
        !           172: .IR asd (8)
        !           173: .SH BUGS
        !           174: The pipeline
        !           175: .L mkpkg ... | inspkg
        !           176: fails if input and output files overlap.
        !           177: .br
        !           178: .I Inspkg
        !           179: fills any holes in files.

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