opr: Assert opr_cv_timedwait return codes
[openafs.git] / src / xstat / xstat_fs.c
index 146b7e4..006bcce 100644 (file)
@@ -1,7 +1,7 @@
 /*
  * Copyright 2000, International Business Machines Corporation and others.
  * All Rights Reserved.
- * 
+ *
  * This software has been released under the terms of the IBM Public
  * License.  For details, see the LICENSE file in the top-level source
  * directory or online at http://www.openafs.org/dl/license10.html
 #include <afsconfig.h>
 #include <afs/param.h>
 
-RCSID
-    ("$Header$");
+#include <roken.h>
+#include <afs/opr.h>
 
 #include "xstat_fs.h"          /*Interface for this module */
-#include <lwp.h>               /*Lightweight process package */
+#include <pthread.h>
 
 #include <afs/afsutil.h>
-#include <string.h>
-
-#define LWP_STACK_SIZE (16 * 1024)
-
-/*
- * Routines we need that don't have explicit include file definitions.
- */
-extern int RXAFSCB_ExecuteRequest();   /*AFS callback dispatcher */
-extern char *hostutil_GetNameByINet(); /*Host parsing utility */
-
-/*
- * Help out the linker by explicitly importing the callback routines
- * File Servers may be lobbing at us.
- */
-extern afs_int32 SRXAFSCB_CallBack();
-extern afs_int32 SRXAFSCB_InitCallBackState3();
-extern afs_int32 SRXAFSCB_Probe();
-extern afs_int32 SRXAFSCB_ProbeUUID();
-extern afs_int32 SRXAFSCB_GetCE();
-extern afs_int32 SRXAFSCB_GetLock();
+#include <afs/afscbint.h>
 
 /*
  * Exported variables.
@@ -51,9 +32,7 @@ extern afs_int32 SRXAFSCB_GetLock();
 int xstat_fs_numServers;       /*Num connected servers */
 struct xstat_fs_ConnectionInfo
  *xstat_fs_ConnInfo;           /*Ptr to connection array */
-int numCollections;            /*Number of data collections */
 struct xstat_fs_ProbeResults xstat_fs_Results; /*Latest probe results */
-char terminationEvent;         /*One-shot termination event */
 
 afs_int32 xstat_fsData[AFS_MAX_XSTAT_LONGS];   /*Buffer for collected data */
 
@@ -64,17 +43,12 @@ static int xstat_fs_ProbeFreqInSecs;        /*Probe freq. in seconds */
 static int xstat_fs_initflag = 0;      /*Was init routine called? */
 static int xstat_fs_debug = 0; /*Debugging output enabled? */
 static int xstat_fs_oneShot = 0;       /*One-shot operation? */
-static int (*xstat_fs_Handler) ();     /*Probe handler routine */
-static PROCESS probeLWP_ID;    /*Probe LWP process ID */
+static int (*xstat_fs_Handler) (void); /*Probe handler routine */
+static pthread_t xstat_fs_thread;      /*Probe thread */
 static int xstat_fs_numCollections;    /*Number of desired collections */
 static afs_int32 *xstat_fs_collIDP;    /*Ptr to collection IDs desired */
-
-/*
- * We have to pass a port to Rx to start up our callback listener
- * service, but 7001 is already taken up by the Cache Manager.  So,
- * we make up our own.
- */
-#define XSTAT_FS_CBPORT        7101
+static opr_mutex_t xstat_fs_force_lock;        /*Lock to wakeup probe */
+static opr_cv_t xstat_fs_force_cv;     /*Condvar to wakeup probe */
 
 
 /*------------------------------------------------------------------------
@@ -99,7 +73,7 @@ static afs_int32 *xstat_fs_collIDP;   /*Ptr to collection IDs desired */
  *------------------------------------------------------------------------*/
 
 static int
-xstat_fs_CleanupInit()
+xstat_fs_CleanupInit(void)
 {
     afs_int32 code;            /*Return code from callback stubs */
     struct rx_call *rxcall;    /*Bogus param */
@@ -219,7 +193,7 @@ xstat_fs_Cleanup(int a_releaseMem)
  * [private] xstat_fs_LWP
  *
  * Description:
- *     This LWP iterates over the server connections and gathers up
+ *     This thread iterates over the server connections and gathers up
  *     the desired statistics from each one on a regular basis.  When
  *     the sweep is done, the associated handler function is called
  *     to process the new data.
@@ -241,10 +215,10 @@ xstat_fs_Cleanup(int a_releaseMem)
 static void *
 xstat_fs_LWP(void *unused)
 {
-    static char rn[] = "xstat_fs_LWP"; /*Routine name */
-    register afs_int32 code;   /*Results of calls */
-    int oneShotCode;           /*Result of one-shot signal */
+    static char rn[] = "xstat_fs_thread";      /*Routine name */
+    afs_int32 code;    /*Results of calls */
     struct timeval tv;         /*Time structure */
+    struct timespec wait;      /*Time to wait */
     int conn_idx;              /*Connection index */
     struct xstat_fs_ConnectionInfo *curr_conn; /*Current connection */
     afs_int32 srvVersionNumber;        /*Xstat version # */
@@ -252,8 +226,6 @@ xstat_fs_LWP(void *unused)
     afs_int32 numColls;                /*Number of collections to get */
     afs_int32 *currCollIDP;    /*Curr collection ID desired */
 
-    static afs_int32 xstat_VersionNumber;      /*Version # of server */
-
     /*
      * Set up some numbers we'll need.
      */
@@ -303,12 +275,12 @@ xstat_fs_LWP(void *unused)
 
                    if (xstat_fs_debug) {
                        printf
-                           ("%s: Calling RXAFS_GetXStats, conn=0x%" AFS_PTR_FMT ", clientVersionNumber=%d, collectionNumber=%d, srvVersionNumberP=0x%" AFS_PTR_FMT ", timeP=0x%" AFS_PTR_FMT ", dataP=0x%" AFS_PTR_FMT "\n",
+                           ("%s: Calling RXAFS_GetXStats, conn=%p, clientVersionNumber=%d, collectionNumber=%d, srvVersionNumberP=%p, timeP=%p, dataP=%p\n",
                             rn, curr_conn->rxconn, clientVersionNumber,
                             *currCollIDP, &srvVersionNumber,
                             &(xstat_fs_Results.probeTime),
                             &(xstat_fs_Results.data));
-                       printf("%s: [bufflen=%d, buffer at 0x%" AFS_PTR_FMT "]\n", rn,
+                       printf("%s: [bufflen=%d, buffer at %p]\n", rn,
                               xstat_fs_Results.data.AFS_CollData_len,
                               xstat_fs_Results.data.AFS_CollData_val);
                    }
@@ -356,36 +328,20 @@ xstat_fs_LWP(void *unused)
 
        if (xstat_fs_oneShot) {
            /*
-            * One-shot execution desired.  Signal our main procedure
-            * that we've finished our collection round.
+            * One-shot execution desired.
             */
-           if (xstat_fs_debug)
-               printf("[%s] Signalling main process at 0x%" AFS_PTR_FMT "\n", rn,
-                      &terminationEvent);
-           oneShotCode = LWP_SignalProcess(&terminationEvent);
-           if (oneShotCode)
-               fprintf(stderr, "[%s] Error %d from LWP_SignalProcess()", rn,
-                       oneShotCode);
-           break;              /*from the perpetual while loop */
-       } /*One-shot execution */
-       else {
+           break;
+       } else {
            /*
             * Continuous execution desired.  Sleep for the required
-            * number of seconds.
+            * number of seconds or wakeup sooner if forced.
             */
-           tv.tv_sec = xstat_fs_ProbeFreqInSecs;
-           tv.tv_usec = 0;
-           if (xstat_fs_debug)
-               printf("[%s] Falling asleep for %d seconds\n", rn,
-                      xstat_fs_ProbeFreqInSecs);
-           code = IOMGR_Select(0,      /*Num fids */
-                               0,      /*Descs ready for reading */
-                               0,      /*Descs ready for writing */
-                               0,      /*Descs w/exceptional conditions */
-                               &tv);   /*Ptr to timeout structure */
-           if (code)
-               fprintf(stderr, "[%s] IOMGR_Select returned code %d\n", rn,
-                       code);
+           gettimeofday(&tv, NULL);
+           wait.tv_sec = tv.tv_sec + xstat_fs_ProbeFreqInSecs;
+           wait.tv_nsec = tv.tv_usec * 1000;
+           opr_mutex_enter(&xstat_fs_force_lock);
+           code = opr_cv_timedwait(&xstat_fs_force_cv, &xstat_fs_force_lock, &wait);
+           opr_mutex_exit(&xstat_fs_force_lock);
        }                       /*Continuous execution */
     }                          /*Service loop */
     return NULL;
@@ -396,7 +352,7 @@ xstat_fs_LWP(void *unused)
  *
  * Description:
  *     Initialize the xstat_fs module: set up Rx connections to the
- *     given set of File Servers, start up the probe and callback LWPs,
+ *     given set of File Servers, start up the probe and callback threads,
  *     and associate the routine to be called when a probe completes.
  *     Also, let it know which collections you're interested in.
  *
@@ -426,11 +382,11 @@ xstat_fs_LWP(void *unused)
 
 int
 xstat_fs_Init(int a_numServers, struct sockaddr_in *a_socketArray,
-             int a_ProbeFreqInSecs, int (*a_ProbeHandler) (), int a_flags,
+             int a_ProbeFreqInSecs, int (*a_ProbeHandler) (void), int a_flags,
              int a_numCollections, afs_int32 * a_collIDP)
 {
     static char rn[] = "xstat_fs_Init";        /*Routine name */
-    register afs_int32 code;   /*Return value */
+    afs_int32 code;    /*Return value */
     static struct rx_securityClass *CBsecobj;  /*Callback security object */
     struct rx_securityClass *secobj;   /*Client security object */
     struct rx_service *rxsrv_afsserver;        /*Server for AFS */
@@ -439,7 +395,6 @@ xstat_fs_Init(int a_numServers, struct sockaddr_in *a_socketArray,
     struct xstat_fs_ConnectionInfo *curr_conn; /*Ptr to current conn */
     char *hostNameFound;       /*Ptr to returned host name */
     int conn_err;              /*Connection error? */
-    int PortToUse;             /*Callback port to use */
     int collIDBytes;           /*Num bytes in coll ID array */
     char hoststr[16];
 
@@ -453,6 +408,9 @@ xstat_fs_Init(int a_numServers, struct sockaddr_in *a_socketArray,
     } else
        xstat_fs_initflag = 1;
 
+    opr_mutex_init(&xstat_fs_force_lock);
+    opr_cv_init(&xstat_fs_force_cv);
+
     /*
      * Check the parameters for bogosities.
      */
@@ -471,7 +429,7 @@ xstat_fs_Init(int a_numServers, struct sockaddr_in *a_socketArray,
                a_ProbeFreqInSecs);
        arg_errfound = 1;
     }
-    if (a_ProbeHandler == (int (*)())0) {
+    if (a_ProbeHandler == NULL) {
        fprintf(stderr, "[%s] Null probe handler function argument\n", rn);
        arg_errfound = 1;
     }
@@ -497,7 +455,7 @@ xstat_fs_Init(int a_numServers, struct sockaddr_in *a_socketArray,
     xstat_fs_ProbeFreqInSecs = a_ProbeFreqInSecs;
     xstat_fs_numCollections = a_numCollections;
     collIDBytes = xstat_fs_numCollections * sizeof(afs_int32);
-    xstat_fs_collIDP = (afs_int32 *) (malloc(collIDBytes));
+    xstat_fs_collIDP = malloc(collIDBytes);
     memcpy(xstat_fs_collIDP, a_collIDP, collIDBytes);
     if (xstat_fs_debug) {
        printf("[%s] Asking for %d collection(s): ", rn,
@@ -519,11 +477,11 @@ xstat_fs_Init(int a_numServers, struct sockaddr_in *a_socketArray,
      * Allocate the necessary data structures and initialize everything
      * else.
      */
-    xstat_fs_ConnInfo = (struct xstat_fs_ConnectionInfo *)
-       malloc(a_numServers * sizeof(struct xstat_fs_ConnectionInfo));
+    xstat_fs_ConnInfo = malloc(a_numServers
+                              * sizeof(struct xstat_fs_ConnectionInfo));
     if (xstat_fs_ConnInfo == (struct xstat_fs_ConnectionInfo *)0) {
        fprintf(stderr,
-               "[%s] Can't allocate %d connection info structs (%d bytes)\n",
+               "[%s] Can't allocate %d connection info structs (%" AFS_SIZET_FMT " bytes)\n",
                rn, a_numServers,
                (a_numServers * sizeof(struct xstat_fs_ConnectionInfo)));
        return (-1);            /*No cleanup needs to be done yet */
@@ -534,25 +492,13 @@ xstat_fs_Init(int a_numServers, struct sockaddr_in *a_socketArray,
      */
     if (xstat_fs_debug)
        printf("[%s] Initializing Rx\n", rn);
-    PortToUse = XSTAT_FS_CBPORT;
-
-    do {
-       code = rx_Init(htons(PortToUse));
-       if (code) {
-           if (code == RX_ADDRINUSE) {
-               if (xstat_fs_debug)
-                   fprintf(stderr,
-                           "[%s] Callback port %d in use, advancing\n", rn,
-                           PortToUse);
-               PortToUse++;
-           } else {
-               fprintf(stderr, "[%s] Fatal error in rx_Init()\n", rn);
-               return (-1);
-           }
-       }
-    } while (code);
+    code = rx_Init(0);
+    if (code) {
+       fprintf(stderr, "[%s] Fatal error in rx_Init()\n", rn);
+       return (-1);
+    }
     if (xstat_fs_debug)
-       printf("[%s] Rx initialized on port %d\n", rn, PortToUse);
+       printf("[%s] Rx initialized\n", rn);
 
     /*
      * Create a null Rx server security object, to be used by the
@@ -572,17 +518,17 @@ xstat_fs_Init(int a_numServers, struct sockaddr_in *a_socketArray,
 
     /*
      * Create a null Rx client security object, to be used by the
-     * probe LWP.
+     * probe thread.
      */
     secobj = rxnull_NewClientSecurityObject();
     if (secobj == (struct rx_securityClass *)0) {
        fprintf(stderr,
-               "[%s] Can't create probe LWP client security object.\n", rn);
+               "[%s] Can't create probe thread client security object.\n", rn);
        xstat_fs_Cleanup(1);    /*Delete already-malloc'ed areas */
        return (-1);
     }
     if (xstat_fs_debug)
-       printf("[%s] Probe LWP client security object created\n", rn);
+       printf("[%s] Probe thread client security object created\n", rn);
 
     curr_conn = xstat_fs_ConnInfo;
     conn_err = 0;
@@ -636,7 +582,7 @@ xstat_fs_Init(int a_numServers, struct sockaddr_in *a_socketArray,
            conn_err = 1;
        }
        if (xstat_fs_debug)
-           printf("[%s] New connection at 0x%" AFS_PTR_FMT "\n", rn, curr_conn->rxconn);
+           printf("[%s] New connection at %p\n", rn, curr_conn->rxconn);
 
        /*
         * Bump the current xstat_fs connection to set up.
@@ -676,22 +622,14 @@ xstat_fs_Init(int a_numServers, struct sockaddr_in *a_socketArray,
      * Start up the probe LWP.
      */
     if (xstat_fs_debug)
-       printf("[%s] Creating the probe LWP\n", rn);
-    code = LWP_CreateProcess(xstat_fs_LWP,     /*Function to start up */
-                            LWP_STACK_SIZE,    /*Stack size in bytes */
-                            1, /*Priority */
-                            (void *)0, /*Parameters */
-                            "xstat_fs Worker", /*Name to use */
-                            &probeLWP_ID);     /*Returned LWP process ID */
+       printf("[%s] Creating the probe thread\n", rn);
+    code = pthread_create(&xstat_fs_thread, NULL, xstat_fs_LWP, NULL);
     if (code) {
-       fprintf(stderr, "[%s] Can't create xstat_fs LWP!  Error is %d\n", rn,
+       fprintf(stderr, "[%s] Can't create xstat_fs thread!  Error is %d\n", rn,
                code);
        xstat_fs_Cleanup(1);    /*Delete already-malloc'ed areas */
        return (code);
     }
-    if (xstat_fs_debug)
-       printf("[%s] Probe LWP process structure located at 0x%" AFS_PTR_FMT "\n", rn,
-              probeLWP_ID);
 
     /*
      * Return the final results.
@@ -707,7 +645,7 @@ xstat_fs_Init(int a_numServers, struct sockaddr_in *a_socketArray,
  * [exported] xstat_fs_ForceProbeNow
  *
  * Description:
- *     Wake up the probe LWP, forcing it to execute a probe immediately.
+ *     Wake up the probe thread, forcing it to execute a probe immediately.
  *
  * Arguments:
  *     None.
@@ -724,7 +662,7 @@ xstat_fs_Init(int a_numServers, struct sockaddr_in *a_socketArray,
  *------------------------------------------------------------------------*/
 
 int
-xstat_fs_ForceProbeNow()
+xstat_fs_ForceProbeNow(void)
 {
     static char rn[] = "xstat_fs_ForceProbeNow";       /*Routine name */
 
@@ -739,10 +677,212 @@ xstat_fs_ForceProbeNow()
     /*
      * Kick the sucker in the side.
      */
-    IOMGR_Cancel(probeLWP_ID);
+    opr_mutex_enter(&xstat_fs_force_lock);
+    opr_cv_signal(&xstat_fs_force_cv);
+    opr_mutex_exit(&xstat_fs_force_lock);
 
     /*
      * We did it, so report the happy news.
      */
     return (0);
 }
+
+/**
+ * Fill the xstat full perf data structure from the data collection array.
+ *
+ * This function is a client-side decoding of the non-portable xstat_fs full
+ * performance data.  The full perf structure includes timeval structures,
+ * which have platform dependent size.
+ *
+ * To make things even more interesting, the word ordering of the time
+ * values on hosts with 64-bit time depend on endianess. The ordering
+ * within a given afs_int32 is handled by xdr.
+ *
+ * @param[out] aout an address to a stats structure pointer
+ * @param[in] ain array of int32s received
+ * @param[in] alen length of ain
+ * @param[inout] abuf a buffer provided by the caller
+ *
+ * @return 0 on success
+ */
+int
+xstat_fs_DecodeFullPerfStats(struct fs_stats_FullPerfStats **aout,
+                            afs_int32 * ain,
+                            afs_int32 alen,
+                            struct fs_stats_FullPerfStats *abuf)
+{
+    int i;
+    afs_int32 *p;
+    int snbo = -2;     /* detected remote site has network-byte ordering */
+
+    static const int XSTAT_FPS_LEN = sizeof(struct fs_stats_FullPerfStats) / sizeof(afs_int32);        /* local size of fps */
+    static const int XSTAT_FPS_SMALL = 424;    /**< fps size when sizeof(timeval) is 2*sizeof(afs_int32) */
+    static const int XSTAT_FPS_LARGE = 666;    /**< fps size when sizeof(timeval) is 2*sizeof(afs_int64) */
+
+#define DECODE_TV(t) \
+    do { \
+       if (alen == XSTAT_FPS_SMALL) { \
+           (t).tv_sec = *p++; \
+           (t).tv_usec = *p++; \
+       } else { \
+           if (snbo) { \
+               p++; \
+               (t).tv_sec = *p++; \
+               p++; \
+               (t).tv_usec = *p++; \
+           } else { \
+               (t).tv_sec = *p++; \
+               p++; \
+               (t).tv_usec = *p++; \
+               p++; \
+           } \
+       } \
+    } while (0)
+
+    if (alen != XSTAT_FPS_SMALL && alen != XSTAT_FPS_LARGE) {
+       return -1;              /* unrecognized size */
+    }
+
+    if (alen == XSTAT_FPS_LEN && alen == XSTAT_FPS_SMALL) {
+       /* Same size, and xdr dealt with byte ordering; no decoding needed. */
+       *aout = (struct fs_stats_FullPerfStats *)ain;
+       return 0;
+    }
+
+    if (alen == XSTAT_FPS_LARGE) {
+       /* Attempt to detect the word ordering of the time values. */
+       struct fs_stats_FullPerfStats *fps =
+           (struct fs_stats_FullPerfStats *)ain;
+       afs_int32 *epoch = (afs_int32 *) & (fps->det.epoch);
+       if (epoch[0] == 0 && epoch[1] != 0) {
+           snbo = 1;
+       } else if (epoch[0] != 0 && epoch[1] == 0) {
+           snbo = 0;
+       } else {
+           return -2;          /* failed to detect server word ordering */
+       }
+    }
+
+    if (alen == XSTAT_FPS_LEN && alen == XSTAT_FPS_LARGE
+#if defined(WORDS_BIGENDIAN)
+       && snbo
+#else /* WORDS_BIGENDIAN */
+       && !snbo
+#endif /* WORDS_BIGENDIAN */
+       ) {
+       /* Same size and order; no decoding needed. */
+       *aout = (struct fs_stats_FullPerfStats *)ain;
+       return 0;
+    }
+
+    /* Either different sizes, or different ordering, or both. Schlep over
+     * each field, decoding time values. The fields up to the first time value
+     * can be copied in bulk. */
+    if (xstat_fs_debug) {
+       printf("debug: Decoding xstat full perf stats; length=%d", alen);
+       if (alen == XSTAT_FPS_LARGE) {
+           printf(", order='%s'", (snbo ? "big-endian" : "little-endian"));
+       }
+       printf("\n");
+    }
+
+    p = ain;
+    memset(abuf, 0, sizeof(struct fs_stats_FullPerfStats));
+    memcpy(abuf, p, sizeof(struct afs_PerfStats));
+    p += sizeof(struct afs_PerfStats) / sizeof(afs_int32);
+
+    DECODE_TV(abuf->det.epoch);
+    for (i = 0; i < FS_STATS_NUM_RPC_OPS; i++) {
+       struct fs_stats_opTimingData *td = abuf->det.rpcOpTimes + i;
+       td->numOps = *p++;
+       td->numSuccesses = *p++;
+       DECODE_TV(td->sumTime);
+       DECODE_TV(td->sqrTime);
+       DECODE_TV(td->minTime);
+       DECODE_TV(td->maxTime);
+    }
+    for (i = 0; i < FS_STATS_NUM_XFER_OPS; i++) {
+       struct fs_stats_xferData *xd = abuf->det.xferOpTimes + i;
+       xd->numXfers = *p++;
+       xd->numSuccesses = *p++;
+       DECODE_TV(xd->sumTime);
+       DECODE_TV(xd->sqrTime);
+       DECODE_TV(xd->minTime);
+       DECODE_TV(xd->maxTime);
+       xd->sumBytes = *p++;
+       xd->minBytes = *p++;
+       xd->maxBytes = *p++;
+       memcpy((void *)xd->count, (void *)p,
+              sizeof(afs_int32) * FS_STATS_NUM_XFER_BUCKETS);
+       p += FS_STATS_NUM_XFER_BUCKETS;
+    }
+    *aout = abuf;
+    return 0;
+#undef DECODE_TV
+}
+
+/*
+ * Wait for the collection to complete. Returns after one cycle if running in
+ * one-shot mode, otherwise wait for a given amount of time.
+ *
+ * Args:
+ *    int sleep_secs : time to wait in seconds when running
+ *                     in continuous mode. 0 means wait forever.
+ *
+ * Returns:
+ *    0 on success
+ */
+int
+xstat_fs_Wait(int sleep_secs)
+{
+    static char rn[] = "xstat_fs_Wait";        /*Routine name */
+    int code;
+    struct timeval tv;         /*Time structure */
+
+    if (xstat_fs_oneShot) {
+       /*
+        * One-shot operation; just wait for the collection to be done.
+        */
+       if (xstat_fs_debug)
+           printf("[%s] Calling pthread_join\n", rn);
+       code = pthread_join(xstat_fs_thread, NULL);
+       if (xstat_fs_debug)
+           printf("[%s] Returned from pthread_join()\n", rn);
+       if (code) {
+           fprintf(stderr,
+                   "[%s] Error %d encountered by pthread_join()\n",
+                   rn, code);
+       }
+    } else if (sleep_secs == 0) {
+       /* Sleep forever. */
+       if (xstat_fs_debug)
+           fprintf(stderr, "[ %s ] going to sleep ...\n", rn);
+       while (1) {
+           code = select(0,    /*Num fds */
+                         0,    /*Descriptors ready for reading */
+                         0,    /*Descriptors ready for writing */
+                         0,    /*Descriptors with exceptional conditions */
+                         NULL);        /* NULL timeout means "forever" */
+           if (code < 0) {
+               fprintf(stderr, "[%s] select() error %d\n", rn, errno);
+               break;
+           }
+       }
+    } else {
+       /* Let's just fall asleep while.  */
+       if (xstat_fs_debug)
+           printf
+               ("xstat_fs service started, main thread sleeping for %d secs.\n",
+                sleep_secs);
+       tv.tv_sec = sleep_secs;
+       tv.tv_usec = 0;
+       code = select(0,        /*Num fds */
+                     0,        /*Descriptors ready for reading */
+                     0,        /*Descriptors ready for writing */
+                     0,        /*Descriptors with exceptional conditions */
+                     &tv);     /*Timeout structure */
+       if (code < 0)
+           fprintf(stderr, "[%s] select() error %d\n", rn, errno);
+    }
+    return code;
+}