add man page, cleanup
[unix-history] / usr / src / old / uudiff / uudiff.1c
CommitLineData
136bc9c9
KM
1.\" @(#)uudiff.1c 4.1 (Berkeley) %G%
2.\"
3.TH UUDIFF 1C
4.AT 3
5.SH NAME
6uudiff \- directory comparison between machines
7.SH SYNOPSIS
8.B uudiff
9[ \-d ]
10local-name remote-name
11.SH DESCRIPTION
12.I Uudiff
13compares the files in the directory
14.I local-name
15and the directory
16.I remote-name,
17(where
18.I remote-name
19may be of the form
20.I system-name!directory-name
21and
22.I system-name
23is a
24.I uucp
25Unix name).
26It reports (via mail)
27which files are added, deleted, or changed, and provides
28a
29.I diff(1)
30of altered printable files.
31.PP
32If a part of
33.I remote-name
34is omitted
35(either the system or the directory)
36the corresponding part of
37.I local-name
38is used.
39If
40.I local-name
41is a file, rather than a directory,
42.I remote-name
43is also assumed to be a file and the program degenerates into
44.IR diff(1) .
45.PP
46The option
47.B \-d
48does not diff altered files; only
49the summary by file names is prepared.
50.SH FILES
51Lots. Files zz[abcdeglmn]????? are used for scratch space;
52files brought back from the remote machine for
53.I diffing
54are stored (and left around) as
55.I name.?????
56and the final report is left in
57.I uudiff.?????
58(the exact name is reported by mail).
59.SH "SEE ALSO"
60diff(1), uucp(1)
61.SH DIAGNOSTICS
62Almost none. Anything more serious than misspelling
63.I local-name
64causes unpredictable and obscure results.
65.SH BUGS
66In addition to the standard
67.I uucp
68requirements a hook is needed at the remote
69system, and at present is only installed
70on the systems "research" and "inter".
71.br
72This program is written in shell and should be translated
73to C so it could give diagnostics.
74.br
75Even if "remote-system" is the local system, uudiff
76is subject to delays in uucp traffic.
77.br
78It should probably write the standard output, instead of insisting
79on going into the background.
80.br
81Since checksums are used there is a probability of 1 in 2**32
82of missing differences between files.
83.br
84The ~userid syntax is not recognized.