Commit | Line | Data |
fe14fcc3 |
1 | .\" $Header: gsh.man,v 4.0 91/03/20 01:10:46 lwall Locked $ |
378cc40b |
2 | .TH GSH 8 "13 May 1988" |
3 | .SH NAME |
4 | gsh \- global shell |
5 | .SH SYNOPSIS |
6 | .B gsh |
7 | [options] |
8 | .I host |
9 | [options] |
10 | .I command |
11 | .SH DESCRIPTION |
12 | .I gsh |
13 | works just like rsh(1C) except that you may specify a set of hosts to execute |
14 | the command on. |
15 | The host sets are defined in the file /etc/ghosts. |
16 | (An individual host name can be used as a set containing one member.) |
17 | You can give a command like |
18 | |
19 | gsh sun /etc/mungmotd |
20 | |
21 | to run /etc/mungmotd on all your Suns. |
22 | .P |
23 | You may specify the union of two or more sets by using + as follows: |
24 | |
25 | gsh 750+mc /etc/mungmotd |
26 | |
27 | which will run mungmotd on all 750's and Masscomps. |
28 | .P |
29 | Commonly used sets should be defined in /etc/ghosts. |
30 | For example, you could add a line that says |
31 | |
32 | pep=manny+moe+jack |
33 | |
34 | Another way to do that would be to add the word "pep" after each of the host |
35 | entries: |
36 | |
37 | manny sun3 pep |
38 | .br |
39 | moe sun3 pep |
40 | .br |
41 | jack sun3 pep |
42 | |
43 | Hosts and sets of host can also be excluded: |
44 | |
45 | foo=sun-sun2 |
46 | |
47 | Any host so excluded will never be included, even if a subsequent set on the |
48 | line includes it: |
49 | |
50 | foo=abc+def |
51 | bar=xyz-abc+foo |
52 | |
53 | comes out to xyz+def. |
54 | |
55 | You can define private host sets by creating .ghosts in your current directory |
56 | with entries just like /etc/ghosts. |
57 | Also, if there is a file .grem, it defines "rem" to be the remaining hosts |
58 | from the last gsh or gcp that didn't succeed everywhere. |
59 | |
60 | Options include all those defined by rsh, as well as |
61 | |
62 | .IP "\-d" 8 |
63 | Causes gsh to collect input till end of file, and then distribute that input |
64 | to each invokation of rsh. |
65 | .IP "\-h" 8 |
66 | Rather than print out the command followed by the output, merely prepends the |
67 | host name to each line of output. |
68 | .IP "\-s" 8 |
69 | Do work silently. |
70 | .PP |
71 | Interrupting with a SIGINT will cause the rsh to the current host to be skipped |
72 | and execution resumed with the next host. |
73 | To stop completely, send a SIGQUIT. |
74 | .SH SEE ALSO |
75 | rsh(1C) |
76 | .SH BUGS |
77 | All the bugs of rsh, since it calls rsh. |
78 | |
79 | Also, will not properly return data from the remote execution that contains |
80 | null characters. |