DEVEL15-openafs-string-header-cleanup-20071030
[openafs.git] / src / xstat / xstat_fs.c
1 /*
2  * Copyright 2000, International Business Machines Corporation and others.
3  * All Rights Reserved.
4  * 
5  * This software has been released under the terms of the IBM Public
6  * License.  For details, see the LICENSE file in the top-level source
7  * directory or online at http://www.openafs.org/dl/license10.html
8  */
9
10 /*
11  * Description:
12  *      Implementation of the client side of the AFS File Server extended
13  *      statistics facility.
14  *
15  *------------------------------------------------------------------------*/
16
17 #include <afsconfig.h>
18 #include <afs/param.h>
19
20 RCSID
21     ("$Header$");
22
23 #include "xstat_fs.h"           /*Interface for this module */
24 #include <lwp.h>                /*Lightweight process package */
25
26 #include <afs/afsutil.h>
27 #include <string.h>
28
29 #define LWP_STACK_SIZE  (16 * 1024)
30
31 /*
32  * Routines we need that don't have explicit include file definitions.
33  */
34 extern int RXAFSCB_ExecuteRequest();    /*AFS callback dispatcher */
35 extern char *hostutil_GetNameByINet();  /*Host parsing utility */
36
37 /*
38  * Help out the linker by explicitly importing the callback routines
39  * File Servers may be lobbing at us.
40  */
41 extern afs_int32 SRXAFSCB_CallBack();
42 extern afs_int32 SRXAFSCB_InitCallBackState3();
43 extern afs_int32 SRXAFSCB_Probe();
44 extern afs_int32 SRXAFSCB_ProbeUUID();
45 extern afs_int32 SRXAFSCB_GetCE();
46 extern afs_int32 SRXAFSCB_GetLock();
47
48 /*
49  * Exported variables.
50  */
51 int xstat_fs_numServers;        /*Num connected servers */
52 struct xstat_fs_ConnectionInfo
53  *xstat_fs_ConnInfo;            /*Ptr to connection array */
54 int numCollections;             /*Number of data collections */
55 struct xstat_fs_ProbeResults xstat_fs_Results;  /*Latest probe results */
56 char terminationEvent;          /*One-shot termination event */
57
58 afs_int32 xstat_fsData[AFS_MAX_XSTAT_LONGS];    /*Buffer for collected data */
59
60 /*
61  * Private globals.
62  */
63 static int xstat_fs_ProbeFreqInSecs;    /*Probe freq. in seconds */
64 static int xstat_fs_initflag = 0;       /*Was init routine called? */
65 static int xstat_fs_debug = 0;  /*Debugging output enabled? */
66 static int xstat_fs_oneShot = 0;        /*One-shot operation? */
67 static int (*xstat_fs_Handler) ();      /*Probe handler routine */
68 static PROCESS probeLWP_ID;     /*Probe LWP process ID */
69 static int xstat_fs_numCollections;     /*Number of desired collections */
70 static afs_int32 *xstat_fs_collIDP;     /*Ptr to collection IDs desired */
71
72 /*
73  * We have to pass a port to Rx to start up our callback listener
74  * service, but 7001 is already taken up by the Cache Manager.  So,
75  * we make up our own.
76  */
77 #define XSTAT_FS_CBPORT 7101
78
79
80 /*------------------------------------------------------------------------
81  * [private] xstat_fs_CleanupInit
82  *
83  * Description:
84  *      Set up for recovery after an error in initialization (i.e.,
85  *      during a call to xstat_fs_Init.
86  *
87  * Arguments:
88  *      None.
89  *
90  * Returns:
91  *      0 on success,
92  *      Error value otherwise.
93  *
94  * Environment:
95  *      This routine is private to the module.
96  *
97  * Side Effects:
98  *      Zeros out basic data structures.
99  *------------------------------------------------------------------------*/
100
101 static int
102 xstat_fs_CleanupInit()
103 {
104     afs_int32 code;             /*Return code from callback stubs */
105     struct rx_call *rxcall;     /*Bogus param */
106     AFSCBFids *Fids_Array;      /*Bogus param */
107     AFSCBs *CallBack_Array;     /*Bogus param */
108
109     xstat_fs_ConnInfo = (struct xstat_fs_ConnectionInfo *)0;
110     xstat_fs_Results.probeNum = 0;
111     xstat_fs_Results.probeTime = 0;
112     xstat_fs_Results.connP = (struct xstat_fs_ConnectionInfo *)0;
113     xstat_fs_Results.collectionNumber = 0;
114     xstat_fs_Results.data.AFS_CollData_len = AFS_MAX_XSTAT_LONGS;
115     xstat_fs_Results.data.AFS_CollData_val = (afs_int32 *) xstat_fsData;
116     xstat_fs_Results.probeOK = 0;
117
118     rxcall = (struct rx_call *)0;
119     Fids_Array = (AFSCBFids *) 0;
120     CallBack_Array = (AFSCBs *) 0;
121
122     /*
123      * Call each of the callback routines our module provides (in
124      * xstat_fs_callback.c) to make sure they're all there.
125      */
126     code = SRXAFSCB_CallBack(rxcall, Fids_Array, CallBack_Array);
127     if (code)
128         return (code);
129     code = SRXAFSCB_InitCallBackState3(rxcall, (afsUUID *) 0);
130     if (code)
131         return (code);
132     code = SRXAFSCB_Probe(rxcall);
133     return (code);
134 }
135
136
137 /*------------------------------------------------------------------------
138  * [exported] xstat_fs_Cleanup
139  *
140  * Description:
141  *      Clean up our memory and connection state.
142  *
143  * Arguments:
144  *      int a_releaseMem : Should we free up malloc'ed areas?
145  *
146  * Returns:
147  *      0 on total success,
148  *      -1 if the module was never initialized, or there was a problem
149  *              with the xstat_fs connection array.
150  *
151  * Environment:
152  *      xstat_fs_numServers should be properly set.  We don't do anything
153  *      unless xstat_fs_Init() has already been called.
154  *
155  * Side Effects:
156  *      Shuts down Rx connections gracefully, frees allocated space
157  *      (if so directed).
158  *------------------------------------------------------------------------*/
159
160 int
161 xstat_fs_Cleanup(int a_releaseMem)
162 {
163     static char rn[] = "xstat_fs_Cleanup";      /*Routine name */
164     int code;                   /*Return code */
165     int conn_idx;               /*Current connection index */
166     struct xstat_fs_ConnectionInfo *curr_conn;  /*Ptr to xstat_fs connection */
167
168     /*
169      * Assume the best, but check the worst.
170      */
171     if (!xstat_fs_initflag) {
172         fprintf(stderr, "[%s] Refused; module not initialized\n", rn);
173         return (-1);
174     } else
175         code = 0;
176
177     /*
178      * Take care of all Rx connections first.  Check to see that the
179      * server count is a legal value.
180      */
181     if (xstat_fs_numServers <= 0) {
182         fprintf(stderr,
183                 "[%s] Illegal number of servers (xstat_fs_numServers = %d)\n",
184                 rn, xstat_fs_numServers);
185         code = -1;
186     } else {
187         if (xstat_fs_ConnInfo != (struct xstat_fs_ConnectionInfo *)0) {
188             /*
189              * The xstat_fs connection structure array exists.  Go through
190              * it and close up any Rx connections it holds.
191              */
192             curr_conn = xstat_fs_ConnInfo;
193             for (conn_idx = 0; conn_idx < xstat_fs_numServers; conn_idx++) {
194                 if (curr_conn->rxconn != (struct rx_connection *)0) {
195                     rx_DestroyConnection(curr_conn->rxconn);
196                     curr_conn->rxconn = (struct rx_connection *)0;
197                 }
198                 curr_conn++;
199             }                   /*for each xstat_fs connection */
200         }                       /*xstat_fs connection structure exists */
201     }                           /*Legal number of servers */
202
203     /*
204      * If asked to, release the space we've allocated.
205      */
206     if (a_releaseMem) {
207         if (xstat_fs_ConnInfo != (struct xstat_fs_ConnectionInfo *)0)
208             free(xstat_fs_ConnInfo);
209     }
210
211     /*
212      * Return the news, whatever it is.
213      */
214     return (code);
215 }
216
217
218 /*------------------------------------------------------------------------
219  * [private] xstat_fs_LWP
220  *
221  * Description:
222  *      This LWP iterates over the server connections and gathers up
223  *      the desired statistics from each one on a regular basis.  When
224  *      the sweep is done, the associated handler function is called
225  *      to process the new data.
226  *
227  * Arguments:
228  *      None.
229  *
230  * Returns:
231  *      Nothing.
232  *
233  * Environment:
234  *      Started by xstat_fs_Init(), uses global structures and the
235  *      global private xstat_fs_oneShot variable.
236  *
237  * Side Effects:
238  *      Nothing interesting.
239  *------------------------------------------------------------------------*/
240
241 static void
242 xstat_fs_LWP()
243 {
244     static char rn[] = "xstat_fs_LWP";  /*Routine name */
245     register afs_int32 code;    /*Results of calls */
246     int oneShotCode;            /*Result of one-shot signal */
247     struct timeval tv;          /*Time structure */
248     int conn_idx;               /*Connection index */
249     struct xstat_fs_ConnectionInfo *curr_conn;  /*Current connection */
250     afs_int32 srvVersionNumber; /*Xstat version # */
251     afs_int32 clientVersionNumber;      /*Client xstat version */
252     afs_int32 numColls;         /*Number of collections to get */
253     afs_int32 *currCollIDP;     /*Curr collection ID desired */
254
255     static afs_int32 xstat_VersionNumber;       /*Version # of server */
256
257     /*
258      * Set up some numbers we'll need.
259      */
260     clientVersionNumber = AFS_XSTAT_VERSION;
261
262     while (1) {                 /*Service loop */
263         /*
264          * Iterate through the server connections, gathering data.
265          * Don't forget to bump the probe count and zero the statistics
266          * areas before calling the servers.
267          */
268         if (xstat_fs_debug)
269             printf("[%s] Waking up, getting data from %d server(s)\n", rn,
270                    xstat_fs_numServers);
271         curr_conn = xstat_fs_ConnInfo;
272         xstat_fs_Results.probeNum++;
273
274         for (conn_idx = 0; conn_idx < xstat_fs_numServers; conn_idx++) {
275             /*
276              * Grab the statistics for the current File Server, if the
277              * connection is valid.
278              */
279             if (xstat_fs_debug)
280                 printf("[%s] Getting collections from File Server '%s'\n", rn,
281                        curr_conn->hostName);
282             if (curr_conn->rxconn != (struct rx_connection *)0) {
283                 if (xstat_fs_debug)
284                     printf("[%s] Connection OK, calling RXAFS_GetXStats\n",
285                            rn);
286
287                 currCollIDP = xstat_fs_collIDP;
288                 for (numColls = 0; numColls < xstat_fs_numCollections;
289                      numColls++, currCollIDP++) {
290                     /*
291                      * Initialize the per-probe values.
292                      */
293                     if (xstat_fs_debug)
294                         printf("[%s] Asking for data collection %d\n", rn,
295                                *currCollIDP);
296                     xstat_fs_Results.collectionNumber = *currCollIDP;
297                     xstat_fs_Results.data.AFS_CollData_len =
298                         AFS_MAX_XSTAT_LONGS;
299                     memset(xstat_fs_Results.data.AFS_CollData_val, 0,
300                            AFS_MAX_XSTAT_LONGS * 4);
301
302                     xstat_fs_Results.connP = curr_conn;
303
304                     if (xstat_fs_debug) {
305                         printf
306                             ("%s: Calling RXAFS_GetXStats, conn=0x%x, clientVersionNumber=%d, collectionNumber=%d, srvVersionNumberP=0x%x, timeP=0x%x, dataP=0x%x\n",
307                              rn, curr_conn->rxconn, clientVersionNumber,
308                              *currCollIDP, &srvVersionNumber,
309                              &(xstat_fs_Results.probeTime),
310                              &(xstat_fs_Results.data));
311                         printf("%s: [bufflen=%d, buffer at 0x%x]\n", rn,
312                                xstat_fs_Results.data.AFS_CollData_len,
313                                xstat_fs_Results.data.AFS_CollData_val);
314                     }
315
316                     xstat_fs_Results.probeOK =
317                         RXAFS_GetXStats(curr_conn->rxconn,
318                                         clientVersionNumber, *currCollIDP,
319                                         &srvVersionNumber,
320                                         &(xstat_fs_Results.probeTime),
321                                         &(xstat_fs_Results.data));
322
323                     /*
324                      * Now that we (may) have the data for this connection,
325                      * call the associated handler function.  The handler does
326                      * not take any explicit parameters, but rather gets to the
327                      * goodies via some of the objects exported by this module.
328                      */
329                     if (xstat_fs_debug)
330                         printf("[%s] Calling handler routine.\n", rn);
331                     code = xstat_fs_Handler();
332                     if (code)
333                         fprintf(stderr,
334                                 "[%s] Handler returned error code %d\n", rn,
335                                 code);
336
337                 }               /*For each collection */
338             }
339
340             /*Valid Rx connection */
341             /*
342              * Advance the xstat_fs connection pointer.
343              */
344             curr_conn++;
345
346         }                       /*For each xstat_fs connection */
347
348         /*
349          * All (valid) connections have been probed.  Fall asleep for the
350          * prescribed number of seconds, unless we're a one-shot.  In
351          * that case, we need to signal our caller that we're done.
352          */
353         if (xstat_fs_debug)
354             printf("[%s] Polling complete for probe round %d.\n", rn,
355                    xstat_fs_Results.probeNum);
356
357         if (xstat_fs_oneShot) {
358             /*
359              * One-shot execution desired.  Signal our main procedure
360              * that we've finished our collection round.
361              */
362             if (xstat_fs_debug)
363                 printf("[%s] Signalling main process at 0x%x\n", rn,
364                        &terminationEvent);
365             oneShotCode = LWP_SignalProcess(&terminationEvent);
366             if (oneShotCode)
367                 fprintf(stderr, "[%s] Error %d from LWP_SignalProcess()", rn,
368                         oneShotCode);
369             break;              /*from the perpetual while loop */
370         } /*One-shot execution */
371         else {
372             /*
373              * Continuous execution desired.  Sleep for the required
374              * number of seconds.
375              */
376             tv.tv_sec = xstat_fs_ProbeFreqInSecs;
377             tv.tv_usec = 0;
378             if (xstat_fs_debug)
379                 printf("[%s] Falling asleep for %d seconds\n", rn,
380                        xstat_fs_ProbeFreqInSecs);
381             code = IOMGR_Select(0,      /*Num fids */
382                                 0,      /*Descs ready for reading */
383                                 0,      /*Descs ready for writing */
384                                 0,      /*Descs w/exceptional conditions */
385                                 &tv);   /*Ptr to timeout structure */
386             if (code)
387                 fprintf(stderr, "[%s] IOMGR_Select returned code %d\n", rn,
388                         code);
389         }                       /*Continuous execution */
390     }                           /*Service loop */
391 }
392
393 /*------------------------------------------------------------------------
394  * [exported] xstat_fs_Init
395  *
396  * Description:
397  *      Initialize the xstat_fs module: set up Rx connections to the
398  *      given set of File Servers, start up the probe and callback LWPs,
399  *      and associate the routine to be called when a probe completes.
400  *      Also, let it know which collections you're interested in.
401  *
402  * Arguments:
403  *      int a_numServers                  : Num. servers to connect to.
404  *      struct sockaddr_in *a_socketArray : Array of server sockets.
405  *      int a_ProbeFreqInSecs             : Probe frequency in seconds.
406  *      int (*a_ProbeHandler)()           : Ptr to probe handler fcn.
407  *      int a_flags                       : Various flags.
408  *      int a_numCollections              : Number of collections desired.
409  *      afs_int32 *a_collIDP                      : Ptr to collection IDs.
410  *
411  * Returns:
412  *      0 on success,
413  *      -2 for (at least one) connection error,
414  *      LWP process creation code, if it failed,
415  *      -1 for other fatal errors.
416  *
417  * Environment:
418  *      *** MUST BE THE FIRST ROUTINE CALLED FROM THIS PACKAGE ***
419  *      Also, the server security object CBsecobj MUST be a static,
420  *      since it has to stick around after this routine exits.
421  *
422  * Side Effects:
423  *      Sets up just about everything.
424  *------------------------------------------------------------------------*/
425
426 int
427 xstat_fs_Init(int a_numServers, struct sockaddr_in *a_socketArray,
428               int a_ProbeFreqInSecs, int (*a_ProbeHandler) (), int a_flags,
429               int a_numCollections, afs_int32 * a_collIDP)
430 {
431     static char rn[] = "xstat_fs_Init"; /*Routine name */
432     register afs_int32 code;    /*Return value */
433     static struct rx_securityClass *CBsecobj;   /*Callback security object */
434     struct rx_securityClass *secobj;    /*Client security object */
435     struct rx_service *rxsrv_afsserver; /*Server for AFS */
436     int arg_errfound;           /*Argument error found? */
437     int curr_srv;               /*Current server idx */
438     struct xstat_fs_ConnectionInfo *curr_conn;  /*Ptr to current conn */
439     char *hostNameFound;        /*Ptr to returned host name */
440     int conn_err;               /*Connection error? */
441     int PortToUse;              /*Callback port to use */
442     int collIDBytes;            /*Num bytes in coll ID array */
443     char hoststr[16];
444
445     /*
446      * If we've already been called, snicker at the bozo, gently
447      * remind him of his doubtful heritage, and return success.
448      */
449     if (xstat_fs_initflag) {
450         fprintf(stderr, "[%s] Called multiple times!\n", rn);
451         return (0);
452     } else
453         xstat_fs_initflag = 1;
454
455     /*
456      * Check the parameters for bogosities.
457      */
458     arg_errfound = 0;
459     if (a_numServers <= 0) {
460         fprintf(stderr, "[%s] Illegal number of servers: %d\n", rn,
461                 a_numServers);
462         arg_errfound = 1;
463     }
464     if (a_socketArray == (struct sockaddr_in *)0) {
465         fprintf(stderr, "[%s] Null server socket array argument\n", rn);
466         arg_errfound = 1;
467     }
468     if (a_ProbeFreqInSecs <= 0) {
469         fprintf(stderr, "[%s] Illegal probe frequency: %d\n", rn,
470                 a_ProbeFreqInSecs);
471         arg_errfound = 1;
472     }
473     if (a_ProbeHandler == (int (*)())0) {
474         fprintf(stderr, "[%s] Null probe handler function argument\n", rn);
475         arg_errfound = 1;
476     }
477     if (a_numCollections <= 0) {
478         fprintf(stderr, "[%s] Illegal collection count argument: %d\n", rn,
479                 a_numServers);
480         arg_errfound = 1;
481     }
482     if (a_collIDP == NULL) {
483         fprintf(stderr, "[%s] Null collection ID array argument\n", rn);
484         arg_errfound = 1;
485     }
486     if (arg_errfound)
487         return (-1);
488
489     /*
490      * Record our passed-in info.
491      */
492     xstat_fs_debug = (a_flags & XSTAT_FS_INITFLAG_DEBUGGING);
493     xstat_fs_oneShot = (a_flags & XSTAT_FS_INITFLAG_ONE_SHOT);
494     xstat_fs_numServers = a_numServers;
495     xstat_fs_Handler = a_ProbeHandler;
496     xstat_fs_ProbeFreqInSecs = a_ProbeFreqInSecs;
497     xstat_fs_numCollections = a_numCollections;
498     collIDBytes = xstat_fs_numCollections * sizeof(afs_int32);
499     xstat_fs_collIDP = (afs_int32 *) (malloc(collIDBytes));
500     memcpy(xstat_fs_collIDP, a_collIDP, collIDBytes);
501     if (xstat_fs_debug) {
502         printf("[%s] Asking for %d collection(s): ", rn,
503                xstat_fs_numCollections);
504         for (curr_srv = 0; curr_srv < xstat_fs_numCollections; curr_srv++)
505             printf("%d ", *(xstat_fs_collIDP + curr_srv));
506         printf("\n");
507     }
508
509     /*
510      * Get ready in case we have to do a cleanup - basically, zero
511      * everything out.
512      */
513     code = xstat_fs_CleanupInit();
514     if (code)
515         return (code);
516
517     /*
518      * Allocate the necessary data structures and initialize everything
519      * else.
520      */
521     xstat_fs_ConnInfo = (struct xstat_fs_ConnectionInfo *)
522         malloc(a_numServers * sizeof(struct xstat_fs_ConnectionInfo));
523     if (xstat_fs_ConnInfo == (struct xstat_fs_ConnectionInfo *)0) {
524         fprintf(stderr,
525                 "[%s] Can't allocate %d connection info structs (%d bytes)\n",
526                 rn, a_numServers,
527                 (a_numServers * sizeof(struct xstat_fs_ConnectionInfo)));
528         return (-1);            /*No cleanup needs to be done yet */
529     }
530
531     /*
532      * Initialize the Rx subsystem, just in case nobody's done it.
533      */
534     if (xstat_fs_debug)
535         printf("[%s] Initializing Rx\n", rn);
536     PortToUse = XSTAT_FS_CBPORT;
537
538     do {
539         code = rx_Init(htons(PortToUse));
540         if (code) {
541             if (code == RX_ADDRINUSE) {
542                 if (xstat_fs_debug)
543                     fprintf(stderr,
544                             "[%s] Callback port %d in use, advancing\n", rn,
545                             PortToUse);
546                 PortToUse++;
547             } else {
548                 fprintf(stderr, "[%s] Fatal error in rx_Init()\n", rn);
549                 return (-1);
550             }
551         }
552     } while (code);
553     if (xstat_fs_debug)
554         printf("[%s] Rx initialized on port %d\n", rn, PortToUse);
555
556     /*
557      * Create a null Rx server security object, to be used by the
558      * Callback listener.
559      */
560     CBsecobj = (struct rx_securityClass *)
561         rxnull_NewServerSecurityObject();
562     if (CBsecobj == (struct rx_securityClass *)0) {
563         fprintf(stderr,
564                 "[%s] Can't create callback listener's security object.\n",
565                 rn);
566         xstat_fs_Cleanup(1);    /*Delete already-malloc'ed areas */
567         return (-1);
568     }
569     if (xstat_fs_debug)
570         printf("[%s] Callback server security object created\n", rn);
571
572     /*
573      * Create a null Rx client security object, to be used by the
574      * probe LWP.
575      */
576     secobj = rxnull_NewClientSecurityObject();
577     if (secobj == (struct rx_securityClass *)0) {
578         fprintf(stderr,
579                 "[%s] Can't create probe LWP client security object.\n", rn);
580         xstat_fs_Cleanup(1);    /*Delete already-malloc'ed areas */
581         return (-1);
582     }
583     if (xstat_fs_debug)
584         printf("[%s] Probe LWP client security object created\n", rn);
585
586     curr_conn = xstat_fs_ConnInfo;
587     conn_err = 0;
588     for (curr_srv = 0; curr_srv < a_numServers; curr_srv++) {
589         /*
590          * Copy in the socket info for the current server, resolve its
591          * printable name if possible.
592          */
593         if (xstat_fs_debug) {
594             char hoststr[16];
595             printf("[%s] Copying in the following socket info:\n", rn);
596             printf("[%s] IP addr %s, port %d\n", rn,
597                    afs_inet_ntoa_r((a_socketArray + curr_srv)->sin_addr.s_addr,hoststr),
598                    ntohs((a_socketArray + curr_srv)->sin_port));
599         }
600         memcpy(&(curr_conn->skt), a_socketArray + curr_srv,
601                sizeof(struct sockaddr_in));
602
603         hostNameFound =
604             hostutil_GetNameByINet(curr_conn->skt.sin_addr.s_addr);
605         if (hostNameFound == NULL) {
606             fprintf(stderr,
607                     "[%s] Can't map Internet address %s to a string name\n",
608                     rn, afs_inet_ntoa_r(curr_conn->skt.sin_addr.s_addr,hoststr));
609             curr_conn->hostName[0] = '\0';
610         } else {
611             strcpy(curr_conn->hostName, hostNameFound);
612             if (xstat_fs_debug)
613                 printf("[%s] Host name for server index %d is %s\n", rn,
614                        curr_srv, curr_conn->hostName);
615         }
616
617         /*
618          * Make an Rx connection to the current server.
619          */
620         if (xstat_fs_debug)
621             printf
622                 ("[%s] Connecting to srv idx %d, IP addr %s, port %d, service 1\n",
623                  rn, curr_srv, afs_inet_ntoa_r(curr_conn->skt.sin_addr.s_addr,hoststr),
624                  ntohs(curr_conn->skt.sin_port));
625
626         curr_conn->rxconn = rx_NewConnection(curr_conn->skt.sin_addr.s_addr,    /*Server addr */
627                                              curr_conn->skt.sin_port,   /*Server port */
628                                              1, /*AFS service # */
629                                              secobj,    /*Security obj */
630                                              0);        /*# of above */
631         if (curr_conn->rxconn == (struct rx_connection *)0) {
632             fprintf(stderr,
633                     "[%s] Can't create Rx connection to server '%s' (%s)\n",
634                     rn, curr_conn->hostName, afs_inet_ntoa_r(curr_conn->skt.sin_addr.s_addr,hoststr));
635             conn_err = 1;
636         }
637         if (xstat_fs_debug)
638             printf("[%s] New connection at 0x%lx\n", rn, curr_conn->rxconn);
639
640         /*
641          * Bump the current xstat_fs connection to set up.
642          */
643         curr_conn++;
644
645     }                           /*for curr_srv */
646
647     /*
648      * Create the AFS callback service (listener).
649      */
650     if (xstat_fs_debug)
651         printf("[%s] Creating AFS callback listener\n", rn);
652     rxsrv_afsserver = rx_NewService(0,  /*Use default port */
653                                     1,  /*Service ID */
654                                     "afs",      /*Service name */
655                                     &CBsecobj,  /*Ptr to security object(s) */
656                                     1,  /*# of security objects */
657                                     RXAFSCB_ExecuteRequest);    /*Dispatcher */
658     if (rxsrv_afsserver == (struct rx_service *)0) {
659         fprintf(stderr, "[%s] Can't create callback Rx service/listener\n",
660                 rn);
661         xstat_fs_Cleanup(1);    /*Delete already-malloc'ed areas */
662         return (-1);
663     }
664     if (xstat_fs_debug)
665         printf("[%s] Callback listener created\n", rn);
666
667     /*
668      * Start up the AFS callback service.
669      */
670     if (xstat_fs_debug)
671         printf("[%s] Starting up callback listener.\n", rn);
672     rx_StartServer(0);          /*Don't donate yourself to LWP pool */
673
674     /*
675      * Start up the probe LWP.
676      */
677     if (xstat_fs_debug)
678         printf("[%s] Creating the probe LWP\n", rn);
679     code = LWP_CreateProcess(xstat_fs_LWP,      /*Function to start up */
680                              LWP_STACK_SIZE,    /*Stack size in bytes */
681                              1, /*Priority */
682                              (void *)0, /*Parameters */
683                              "xstat_fs Worker", /*Name to use */
684                              &probeLWP_ID);     /*Returned LWP process ID */
685     if (code) {
686         fprintf(stderr, "[%s] Can't create xstat_fs LWP!  Error is %d\n", rn,
687                 code);
688         xstat_fs_Cleanup(1);    /*Delete already-malloc'ed areas */
689         return (code);
690     }
691     if (xstat_fs_debug)
692         printf("[%s] Probe LWP process structure located at 0x%x\n", rn,
693                probeLWP_ID);
694
695     /*
696      * Return the final results.
697      */
698     if (conn_err)
699         return (-2);
700     else
701         return (0);
702 }
703
704
705 /*------------------------------------------------------------------------
706  * [exported] xstat_fs_ForceProbeNow
707  *
708  * Description:
709  *      Wake up the probe LWP, forcing it to execute a probe immediately.
710  *
711  * Arguments:
712  *      None.
713  *
714  * Returns:
715  *      0 on success,
716  *      Error value otherwise.
717  *
718  * Environment:
719  *      The module must have been initialized.
720  *
721  * Side Effects:
722  *      As advertised.
723  *------------------------------------------------------------------------*/
724
725 int
726 xstat_fs_ForceProbeNow()
727 {
728     static char rn[] = "xstat_fs_ForceProbeNow";        /*Routine name */
729
730     /*
731      * There isn't a prayer unless we've been initialized.
732      */
733     if (!xstat_fs_initflag) {
734         fprintf(stderr, "[%s] Must call xstat_fs_Init first!\n", rn);
735         return (-1);
736     }
737
738     /*
739      * Kick the sucker in the side.
740      */
741     IOMGR_Cancel(probeLWP_ID);
742
743     /*
744      * We did it, so report the happy news.
745      */
746     return (0);
747 }