1 | .TH SYNCTREE 8 "May 6, 1988" |
---|
2 | .UC |
---|
3 | .SH NAME |
---|
4 | synctree \- reconcile directory tree with original |
---|
5 | .SH SYNOPSIS |
---|
6 | .B synctree |
---|
7 | [ |
---|
8 | .B \-v | \-q |
---|
9 | ] [ |
---|
10 | .B \-n |
---|
11 | ] [ |
---|
12 | .B \-nosrcrules |
---|
13 | ] [ |
---|
14 | .B \-nodstrules |
---|
15 | ] [ |
---|
16 | .B \-s |
---|
17 | .I srcdir |
---|
18 | ] [ |
---|
19 | .B \-d |
---|
20 | .I dstdir |
---|
21 | ] [ |
---|
22 | .B \-a |
---|
23 | .I rules |
---|
24 | ] |
---|
25 | .br |
---|
26 | .SH DESCRIPTION |
---|
27 | .I Synctree |
---|
28 | intelligently copies one directory tree to |
---|
29 | another, according to a set of rules files found in both the source and |
---|
30 | destination directory trees. |
---|
31 | .I synctree |
---|
32 | allows files to copied from the source to the destination, establish |
---|
33 | symbolic links on the destination tree, and allows commands to be |
---|
34 | executed when files are updated. |
---|
35 | |
---|
36 | .I synctree |
---|
37 | is useful for installing or updating systems, by reconciling the files |
---|
38 | on the destination system with the original. Depending on the rules |
---|
39 | files, directories and files on the destination tree can be links to |
---|
40 | the original, allowing them to remain on a file server. Synctree |
---|
41 | records what the modification times for files that it creates, so that |
---|
42 | it can tell if a file has been independently modified on the |
---|
43 | destination tree. |
---|
44 | |
---|
45 | .SH OPTIONS |
---|
46 | .TP |
---|
47 | .B \-v |
---|
48 | Verbose mode. Prints debugging level information. Each occurrence of |
---|
49 | this option increments the debugging level (and thus more will be |
---|
50 | displayed). The default setting is 1, which prints all file updates |
---|
51 | that are transpiring. |
---|
52 | .TP |
---|
53 | .B \-q |
---|
54 | Quiet mode. Does not inform user of what updates occur. |
---|
55 | .TP |
---|
56 | .B \-n |
---|
57 | No-op mode. No updates or deletions will be performed. This mode is |
---|
58 | useful for seeing what would occur, without causing any damage to the |
---|
59 | destination tree. |
---|
60 | .TP |
---|
61 | .B \-nosrcrules |
---|
62 | Rules files from the source tree are ignored. |
---|
63 | .TP |
---|
64 | .B \-nodstrules |
---|
65 | Rules files from the destination tree are ignored. |
---|
66 | .TP |
---|
67 | .B \-s |
---|
68 | Specifies the source directory tree. The default is /server. |
---|
69 | .TP |
---|
70 | .B \-d |
---|
71 | Specifies the destination directory tree. The default is /. |
---|
72 | .TP |
---|
73 | .B \-a |
---|
74 | Specifies a file containing additional rules to use. |
---|
75 | |
---|
76 | .SH RULES |
---|
77 | Rules for reconciling the source and destination trees can be found both |
---|
78 | in the source tree |
---|
79 | .BI (\.rconf) " and in the destination tree " (\.rconf\.local). |
---|
80 | These files (which may be in any sub-directory and apply to that |
---|
81 | directory downward) indicate the steps that should be taken to synctree |
---|
82 | the two directory trees. The rules files are parsed top-down, with |
---|
83 | later actions in the rules files superceding earlier rules. |
---|
84 | .PP |
---|
85 | The available options in the rules files are: |
---|
86 | .TP |
---|
87 | .B map |
---|
88 | Map files from the source directory to the destination directory. |
---|
89 | .TP |
---|
90 | .B copy |
---|
91 | Copy files from the source directory to the destination directory. |
---|
92 | .TP |
---|
93 | .B link |
---|
94 | Create symbolic links from the destination directory to the source |
---|
95 | directory. |
---|
96 | .TP |
---|
97 | .B chase |
---|
98 | Copy files, chasing symbolic links, from the source directory to the |
---|
99 | destination directory. |
---|
100 | .TP |
---|
101 | .B ignore |
---|
102 | Do not perform any actions on the listed files. |
---|
103 | .TP |
---|
104 | .B delete |
---|
105 | Delete files from the destination directory. |
---|
106 | |
---|
107 | .PP |
---|
108 | The format of the majority of the actions is: |
---|
109 | .TP |
---|
110 | <action> file [\-option \-option \.\.\.] |
---|
111 | .TP |
---|
112 | where file can be a wildcard expression. Wildcard expressions consist |
---|
113 | of: |
---|
114 | .TP |
---|
115 | * |
---|
116 | .TP |
---|
117 | [range of letters] |
---|
118 | .TP |
---|
119 | and can be suffixed by a semi-colon, followed by the file type |
---|
120 | (r,l,d,b,c,s). |
---|
121 | |
---|
122 | .PP |
---|
123 | Some of the action-options available are: |
---|
124 | .TP |
---|
125 | .B copy \-p |
---|
126 | This mode will preserve owner, group, and setuid/setgid information |
---|
127 | during the copy. |
---|
128 | .TP |
---|
129 | .B copy/link \-f |
---|
130 | This mode will force a copy, regardless of whether the source and |
---|
131 | destination file types differ or the destination file was more recent |
---|
132 | than the source. |
---|
133 | .TP |
---|
134 | .B ignore \-d |
---|
135 | Normally, a directory is only descended into if it is copied or |
---|
136 | mapped. This mode will cause an ignored directory to be descended |
---|
137 | into if the destination directory exists. |
---|
138 | |
---|
139 | .SH AUTHOR |
---|
140 | Tim Shepard, |
---|
141 | with some input from Mark Reinhold and Stan Zanarotti. |
---|
142 | Re-written by Richard Basch and Ezra Peisach, MIT Project Athena. |
---|
143 | .SH FILES |
---|
144 | .ta 3i |
---|
145 | .nf |
---|
146 | .rconf Rules files on source directory tree |
---|
147 | .rconf.local Rules files on destination directory tree |
---|
148 | .reconcile_dates.{dir,pag} Database where file modification times are |
---|
149 | stored |
---|
150 | .fi |
---|
151 | .SH BUGS |
---|
152 | Synctree is still under development, and under documented. |
---|