Merge pull request #2216 from jwillemsen/jwi-cxxversionchecks
[ACE_TAO.git] / ACE / apps / drwho / README
blob5ebc2a9bf2a58a579c9d3e05e1815442bb3720f5
3 This directory contains the "distributed rwho" (drwho) program.  Drwho
4 alleviates certain rwho(1) limitations.  For instance it adds
5 functionality that spans subnets.  In addition, drwho prints a much
6 more concise listing of who's logged in around a network.
8 Below are some examples of how to use drwho.
10 0. Start by running the server in a window or as a daemon, e.g., run
11    the following on a local machine, such as tango.cs.wustl.edu:
13 % drwho-server
15 Then, If you'd like to find out who's logged in, try the following
16 commands:
18 1. Print out the command-line options.
20 % drwho-client -h
21 usage: ./drwho-client
22 -?      prints a short usage message
23 -A      append the following hostname to the list of predefined hostnames.
24 -a      return information on *all* users remotely logged in (uses yp passwd).
25 -b      run the server in the background (i.e., as a daemon).
26 -d      turn on debugging.
27 -F      use the following file contents to initialize the host list.
28 -f      use the following file contents to initialize the friends database.
29 -H      use the following hostname as part of the new list of hostnames.
30         (this option overwrites the existing default names).
31 -h      print a long usage message.
32 -L      print the login name rather than the real name (which is the default).
33 -l      print information in long format (works for all protocols).
34 -p      set the port number (server must correspond).
35 -r      do the remote lookups (i.e., local operations are the default).
36 -R      print info using the rusers format.
37 -s      sort the output by login name.
38 -S      sort the output by real name.
39 -t      set the amount of time we wait for servers to timeout.
40 -w      return information on just one user.
42 ----------------------------------------
44 2. Find out which friends are logged in (* means currently active)
46 % drwho-client -A tango.cs.wustl.edu -r -f ~schmidt/.friends.dta
47 remote friends logged on
48 ------------------------
49 *Doug O'las    [tango*(3) mambo]
50  Carlos O'Ryan [tango swarm.cs.wustl.edu macarena]
51  Irfan Pyarali [merengue]
52  Nanbor Wang   [lambada]
53  Marina Spivak [mambo]
54  Chris Gill    [tango]
55 *Vishal        [merengue*(2)]
56  Kirthika      [tango waltz]
57  Naga          [tango polka]
58  Alex          [lindy]
59  Bala          [cumbia]
60  Pradeep       [flamenco]
61  Matt Braun    [lambada]
62 ------------------------
63 friends: 5      users: 168
65 You'll to write a friends.dta file in order for this feature to work.
66 Here's one that I've got:
68 schmidt  Doug O'las
69 coryan   Carlos O'Ryan
70 irfan    Irfan Pyarali
71 levine   David Levine
72 nanbor   Nanbor Wang
73 jp4      Jeff Parsons
74 marina   Marina Spivak
75 cdgill   Chris Gill
76 vishal   Vishal
77 kirthika Kirthika
78 naga     Naga
79 alex     Alex
80 bala     Bala
81 pradeep  Pradeep
82 brunsch  Darrell Brunsch
83 jxh      James Hu
84 yamuna   Yamuna
85 mjb2     Matt Braun
86 gokhale  Andy Gokhale
87 fredk    Fred Kuhns
89 If you put this file in ~/.friends.dta drwho will automatically locate
90 it.
92 ----------------------------------------
94 3. Find out where a particular person is logged in:
96 % drwho-client -A tango.cs.wustl.edu -r -w schmidt
97 tango
99 This is useful for remote commands that require a hostname, e.g.:
101 % talk schmidt@`drwho-client -A tango.cs.wustl.edu -r -w schmidt`
105 % rsh `drwho-client -w schmidt` ps
106    PID TTY      TIME CMD
107   1844 pts/9    0:01 tcsh_6.0
108   4821 ?        0:02 perfmete
109     77 pts/20   0:01 tcsh_6.0
110   4845 pts/2    0:00 tcsh_6.0
111   4766 ?        0:00 xmessage
112   4850 pts/3    0:06 tcsh_6.0
113   5057 pts/4    0:01 tcsh_6.0
114   4826 ?       18:07 netscape
115   4802 ?        0:07 mwm
116 % foreach host (`drwho -r -l -w schmidt`)
117 ? echo $host
118 ? rsh $host w | grep -E schmidt
119 ? end
121 ----------------------------------------
123 4. Find out everyone who is logged in everywhere!
125 % drwho-client -A tango.cs.wustl.edu -r -a
126 remote users logged on
127 ------------------------
128  rlneblet                          [ascc]
129  woody                             [fixer]
130  Jyoti Parwatikar                  [hopscotch]
131  Stephen D. Scott                  [occam]
132  klkramer                          [ascc]
133  dmorris                           [ascc]
134 *pabacard                          [ascc*]
135  sestasne                          [ascc]
136  Sumedh Mungee                     [merengue lindy]
137  Alexander Babu Arulanthu          [lindy]
138  Robert A. Rouse                   [siesta]
139  asamarak                          [ascc]
140  Tom Chaney                        [snoodles]
141  Joe Hoffert                       [monkeybars]
142  ircornel                          [ascc]
143  Chris Cleeland                    [macarena]
144 *Matthew Karl Lundberg             [enz lcs*(2)]
145  dmschult                          [ascc]
146  sherlia                           [owen]
147 *wmwhites                          [ascc*]
148  Marius Mihai Tutunaru             [siesta]
149  Ken Wong                          [ackbar sarlacc]
150  abstutts                          [ascc]
151  Barry L. Kalman                   [sachel]
152  Yunhong Zhou                      [siesta]
153  Marina Igorevna Spivak            [mambo]
154  mschraed                          [ascc]
155  tuck                              [ascc]
156  Daniel Robert Dooly               [cardinal]
157  emlentz                           [ascc]
158  Margaret Flucke                   [honker yoda brainmap]
159  Jonathan S. Pollack               [siesta]
160  Gurudatta M. Parulkar             [ackbar]
161  Mike Richards                     [teebo]
162 *Vishal Kachroo                    [merengue*(1)]
163  The dump man                      [tapeworm]
164  Uooyeol Yoon                      [siesta]
165  jtlink                            [ascc]
166  Dan Rosenstein                    [tubman]
167  cdnorden                          [ascc]
168  Jon Turner                        [spanky]
169  Stan C. Kwasny                    [lambda]
170  aymessin                          [ascc]
171  Nanbor Wang                       [lambada]
172  wolf                              [sarlacc]
173  jgbers                            [ascc]
174  Pradeep Gore                      [flamenco]
175  Chris D. Gill                     [tango]
176  sduseja                           [ascc]
177  amgarcia                          [ascc]
178 *Hongyin Quan                      [ackbar*(2)]
179  firemen                           [helen]
180 *lskafenb                          [ascc*]
181  Sally Goldman                     [occam]
182  Marcel Waldvogel                  [tiger]
183  klforesm                          [ascc]
184  Andy Fingerhut                    [yoda leia]
185  root@tango                        [tango emperor siren flora helen boushi tapeworm siesta rainier taumsauk honker polka]
186  Nagarajan Surendran               [tango polka]
187  ajeckste                          [ascc]
188  Linda Suri                        [kavita]
189  Sarah Elizabeth Burcham           [helen]
190  Salathiel Sawyer                  [helen]
191  A. Maynard Engebretson            [wicket]
192  Theresa Manzara                   [siesta]
193  aagrillo                          [ascc]
194  ksviehen                          [ascc]
195  Will Gillett                      [gel]
196  Elaine M Ashton                   [helen]
197  James C. Gray                     [siesta]
198  Ian Flanigan                      [siesta]
199  jacrank                           [ascc]
200  Matthew J Braun                   [lambada]
201 *pjhanrah                          [ascc*]
202  Vadim Adamov                      [siesta]
203 *rbherrin                          [ascc*]
204  kslee                             [ascc]
205  Balachandran Natarajan            [cumbia]
206 *Qianbo Huai                       [ecommerce*(2)]
207  Scott Thomas Haug                 [bacon kato]
208  Yuhua Chen                        [beru]
209  blawrenc                          [ascc]
210  dcoats                            [ascc]
211 *sdsinger                          [ascc*]
212  Katherine Skirving Larson         [odysseus mas]
213  rmcarbon                          [ascc]
214  rer                               [luke honker leia]
215  Ron Loui                          [ai siesta]
216  Sergio Flores                     [tango siesta]
217  maint                             [helen]
218  mewedeha                          [ascc]
219  Scott Simon                       [ackbar]
220  weathert                          [anakin hobbie honker]
221  Kirthika Parameswaran             [waltz tango]
222  Scott Douglas Powers              [greedo buster]
223 *vehays                            [ascc*]
224  Multiagent Systems Research Group [siren]
225 *Douglas C. Schmidt                [tango*(3) mambo]
226  sunyh                             [r2d2]
227 *jbbrooks                          [ascc*]
228  mweisema                          [ascc]
229 *baruethe                          [ascc*]
230  Yan Zhou                          [thunderball]
231 *jennyc                            [ascc*]
232  Karl Stiefvater                   [tamarin helen]
233  John Roman                        [helen]
234  slstraus                          [ascc]
235  Subhash Suri                      [kavita]
236  Sandeep Sikka                     [siesta]
237  Dna Mutants                       [lcs]
238  Irfan Pyarali                     [merengue]
239  ajhingst                          [ascc]
240  Tuomas Sandholm                   [siren]
241  Carlos O'Ryan                     [tango swarm.cs.wustl.edu macarena]
242  Tilman Wolf                       [siesta]
243 ------------------------
244 friends: 20     users: 20
246 ----------------------------------------
248 5. Print out all machines and who is logged into each one
250 % drwho-client -A tango.cs.wustl.edu -R -l
251 kavita             Subhash Suri, Linda Suri
252 lcs                Matthew Karl Lundberg*(2), Dna Mutants
253 leia               Andy Fingerhut, rer
254 rainier            root@tango
255 thunderball        Yan Zhou
256 lindy              Sumedh Mungee, Alexander Babu Arulanthu
257 flamenco           Pradeep Gore
258 ai                 Ron Loui
259 wicket             A. Maynard Engebretson
260 occam              Stephen D. Scott, Sally Goldman
261 helen              firemen, Sarah Elizabeth Burcham, Elaine M Ashton, root@tango, maint, John Roman, Karl Stiefvater, Salathiel Sawyer
262 enz                Matthew Karl Lundberg
263 tamarin            Karl Stiefvater
264 tiger              Marcel Waldvogel
265 cumbia             Balachandran Natarajan
266 r2d2               sunyh
267 fixer              woody
268 ecommerce          Qianbo Huai*(2)
269 lambda             Stan C. Kwasny
270 boushi             root@tango
271 mambo              Douglas C. Schmidt, Marina Igorevna Spivak
272 ascc               slstraus, rmcarbon, aymessin, aagrillo, sdsinger*, dmschult, sestasne, dmorris, jgbers, jennyc*, sduseja, baruethe*, gzhou*, vehays*, pjhanrah*, dcoats, saduthie*, ksviehen, cdnorden, ajhingst*, mschraed, asamarak, pabacard*, mewedeha, ajeckste, jbbrooks, blawrenc, amgarcia, abstutts, klforesm, klkramer, pkshah*, jtlink, jacrank, wmwhites*, kslee, mweisema, emlentz, rlneblet, tuck
273 beru               Yuhua Chen
274 emperor            root@tango
275 siren              Tuomas Sandholm, root@tango, Multiagent Systems Research Group
276 tubman             Dan Rosenstein
277 gel                Will Gillett
278 honker             Margaret Flucke, root@tango, weathert, rer
279 greedo             Scott Douglas Powers
280 swarm.cs.wustl.edu Carlos O'Ryan
281 tapeworm           root@tango, The dump man
282 siesta             Uooyeol Yoon, Marius Mihai Tutunaru, Vadim Adamov, Robert A. Rouse, Jonathan S. Pollack, James C. Gray, Sergio Flores, Sandeep Sikka, Ron Loui, Yunhong Zhou, Tilman Wolf, Theresa Manzara, Ian Flanigan, root@tango
283 luke               rer
284 snoodles           Tom Chaney
285 ackbar             Ken Wong, Scott Simon, Gurudatta M. Parulkar, Hongyin Quan*(1)
286 buster             Scott Douglas Powers
287 tango              Nagarajan Surendran, Sergio Flores, Chris D. Gill, Kirthika Parameswaran, Carlos O'Ryan, root@tango, Douglas C. Schmidt*(3)
288 teebo              Mike Richards
289 cardinal           Daniel Robert Dooly
290 lambada            Nanbor Wang, Matthew J Braun
291 merengue           Sumedh Mungee, Vishal Kachroo*(1), Irfan Pyarali
292 macarena           Chris Cleeland, Carlos O'Ryan
293 sarlacc            wolf, Ken Wong
294 spanky             Jon Turner
295 brainmap           Margaret Flucke
296 polka              Nagarajan Surendran, root@tango
297 waltz              Kirthika Parameswaran
298 flora              root@tango
299 anakin             weathert
300 bacon              Scott Thomas Haug
301 hopscotch          Jyoti Parwatikar
302 mas                Katherine Skirving Larson
303 kato               Scott Thomas Haug
304 hobbie             weathert
305 odysseus           Katherine Skirving Larson
306 sachel             Barry L. Kalman
307 taumsauk           root@tango
308 yoda               Margaret Flucke, Andy Fingerhut
309 owen               sherlia
310 monkeybars         Joe Hoffert