add disclaimer about perl 4 libraries (modified version of
[p5sagit/p5-mst-13.2.git] / eg / g / gcp.man
CommitLineData
79072805 1.\" $RCSfile: gcp.man,v $$Revision: 4.1 $$Date: 92/08/07 17:20:17 $
378cc40b 2.TH GCP 1C "13 May 1988"
3.SH NAME
4gcp \- global file copy
5.SH SYNOPSIS
6.B gcp
7file1 file2
8.br
9.B gcp
10[
11.B \-r
12] file ... directory
13.SH DESCRIPTION
14.I gcp
15works just like rcp(1C) except that you may specify a set of hosts to copy files
16from or to.
17The host sets are defined in the file /etc/ghosts.
18(An individual host name can be used as a set containing one member.)
19You can give a command like
20
21 gcp /etc/motd sun:
22
23to copy your /etc/motd file to /etc/motd on all the Suns.
24If, on the other hand, you say
25
26 gcp /a/foo /b/bar sun:/tmp
27
28then your files will be copied to /tmp on all the Suns.
29The general rule is that if you don't specify the destination directory,
30files go to the same directory they are in currently.
31.P
32You may specify the union of two or more sets by using + as follows:
33
34 gcp /a/foo /b/bar 750+mc:
35
36which will copy /a/foo to /a/foo on all 750's and Masscomps, and then copy
37/b/bar to /b/bar on all 750's and Masscomps.
38.P
39Commonly used sets should be defined in /etc/ghosts.
40For example, you could add a line that says
41
42 pep=manny+moe+jack
43
44Another way to do that would be to add the word "pep" after each of the host
45entries:
46
47 manny sun3 pep
48.br
49 moe sun3 pep
50.br
51 jack sun3 pep
52
53Hosts and sets of host can also be excluded:
54
55 foo=sun-sun2
56
57Any host so excluded will never be included, even if a subsequent set on the
58line includes it:
59
60 foo=abc+def
61.br
62 bar=xyz-abc+foo
63
64comes out to xyz+def.
65
66You can define private host sets by creating .ghosts in your current directory
67with entries just like /etc/ghosts.
68Also, if there is a file .grem, it defines "rem" to be the remaining hosts
69from the last gsh or gcp that didn't succeed everywhere.
70.PP
71Interrupting with a SIGINT will cause the rcp to the current host to be skipped
72and execution resumed with the next host.
73To stop completely, send a SIGQUIT.
74.SH SEE ALSO
75rcp(1C)
76.SH BUGS
77All the bugs of rcp, since it calls rcp.