![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to mkpkg.8 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / man / man8|
Return to mkpkg.8 CVS log | Up to [Research Unix] / researchv10dc / man / man8 |
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.