Wed Oct 1 12:43:46 2008 UTC ()
mention the delete bug in the man page. prompted by perry.


(christos)
diff -r1.14 -r1.15 src/usr.sbin/sup/source/sup.1
cvs diff -r1.14 -r1.15 src/usr.sbin/sup/source/Attic/sup.1 (expand / switch to unified diff)

--- src/usr.sbin/sup/source/Attic/sup.1 2003/01/02 00:22:31 1.14
+++ src/usr.sbin/sup/source/Attic/sup.1 2008/10/01 12:43:46 1.15
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: sup.1,v 1.14 2003/01/02 00:22:31 jschauma Exp $ 1.\" $NetBSD: sup.1,v 1.15 2008/10/01 12:43:46 christos Exp $
2.\" 2.\"
3.\" Copyright (c) 1992 Carnegie Mellon University 3.\" Copyright (c) 1992 Carnegie Mellon University
4.\" All Rights Reserved. 4.\" All Rights Reserved.
5.\" 5.\"
6.\" Permission to use, copy, modify and distribute this software and its 6.\" Permission to use, copy, modify and distribute this software and its
7.\" documentation is hereby granted, provided that both the copyright 7.\" documentation is hereby granted, provided that both the copyright
8.\" notice and this permission notice appear in all copies of the 8.\" notice and this permission notice appear in all copies of the
9.\" software, derivative works or modified versions, and any portions 9.\" software, derivative works or modified versions, and any portions
10.\" thereof, and that both notices appear in supporting documentation. 10.\" thereof, and that both notices appear in supporting documentation.
11.\" 11.\"
12.\" CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS" 12.\" CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
13.\" CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR 13.\" CONDITION. CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
14.\" ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE. 14.\" ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
@@ -35,27 +35,27 @@ @@ -35,27 +35,27 @@
35.\" 35.\"
36.\" 10-May-86 Glenn Marcy (gm0w) at Carnegie-Mellon University 36.\" 10-May-86 Glenn Marcy (gm0w) at Carnegie-Mellon University
37.\" Replaced reference to /usr/cmu with /usr/cs. 37.\" Replaced reference to /usr/cmu with /usr/cs.
38.\" 38.\"
39.\" 29-Mar-86 Glenn Marcy (gm0w) at Carnegie-Mellon University 39.\" 29-Mar-86 Glenn Marcy (gm0w) at Carnegie-Mellon University
40.\" Updated manual entry to version 5.14 of sup. 40.\" Updated manual entry to version 5.14 of sup.
41.\" 41.\"
42.\" 14-Jan-86 Glenn Marcy (gm0w) at Carnegie-Mellon University 42.\" 14-Jan-86 Glenn Marcy (gm0w) at Carnegie-Mellon University
43.\" Updated manual entry to version 5.7 of sup. 43.\" Updated manual entry to version 5.7 of sup.
44.\" 44.\"
45.\" 04-Apr-85 Steven Shafer (sas) at Carnegie-Mellon University 45.\" 04-Apr-85 Steven Shafer (sas) at Carnegie-Mellon University
46.\" Created. 46.\" Created.
47.\" 47.\"
48.TH SUP 1 02/08/92 48.TH SUP 1 10/01/08
49.CM 4 49.CM 4
50.SH "NAME" 50.SH "NAME"
51sup \- software upgrade protocol 51sup \- software upgrade protocol
52.SH "SYNOPSIS" 52.SH "SYNOPSIS"
53\fBsup\fR [ \fIflags\fR ] [ \fIsupfile\fR ] [ \fIcollection\fR ...] 53\fBsup\fR [ \fIflags\fR ] [ \fIsupfile\fR ] [ \fIcollection\fR ...]
54.SH "DESCRIPTION" 54.SH "DESCRIPTION"
55.I Sup 55.I Sup
56is a program used for upgrading collections of files from other machines 56is a program used for upgrading collections of files from other machines
57to your machine. You execute 57to your machine. You execute
58.IR sup , 58.IR sup ,
59the 59the
60.I client 60.I client
61program, which talks over the network using IP/TCP to a 61program, which talks over the network using IP/TCP to a
@@ -845,13 +845,25 @@ default base directory for a file collec @@ -845,13 +845,25 @@ default base directory for a file collec
845.i0 845.i0
846.DT 846.DT
847.PP 847.PP
848.SH "SEE ALSO" 848.SH "SEE ALSO"
849.IR supservers (8) 849.IR supservers (8)
850.br 850.br
851\fIThe SUP Software Upgrade Protocol\fR, S. A. Shafer, 851\fIThe SUP Software Upgrade Protocol\fR, S. A. Shafer,
852CMU Computer Science Department, 1985. 852CMU Computer Science Department, 1985.
853.SH "EXAMPLE" 853.SH "EXAMPLE"
854\*[Lt]example\*[Gt] 854\*[Lt]example\*[Gt]
855.SH "BUGS" 855.SH "BUGS"
856The encryption mechanism should be strengthened, although it's 856The encryption mechanism should be strengthened, although it's
857not trivial. 857not trivial.
 858.Pp
 859.I sup
 860can delete files it should not with the delete option.
 861This is because in the delete pass, it tries to delete all files
 862in the old list that don't exist in the new list.
 863This is a problem when a directory becomes a symlink to a hierarchy
 864that contains the same names.
 865Then sup will cross the symlink and start deleting files and directories
 866from the destination.
 867This is not easily fixed.
 868Don't use sup with symlink/rsymlink and the delete
 869option at the same time or *be careful*!