Whamcloud - gitweb
LU-3195 tests: Interop 2.3.0<->2.3.63 sanity-quota test_6
[fs/lustre-release.git] / lnet / selftest / selftest.h
1 /*
2  * GPL HEADER START
3  *
4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 only,
8  * as published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope that it will be useful, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * General Public License version 2 for more details (a copy is included
14  * in the LICENSE file that accompanied this code).
15  *
16  * You should have received a copy of the GNU General Public License
17  * version 2 along with this program; If not, see
18  * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
19  * copy of GPLv2].
20  *
21  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
22  * CA 95054 USA or visit www.sun.com if you need additional information or
23  * have any questions.
24  *
25  * GPL HEADER END
26  */
27 /*
28  * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
29  * Use is subject to license terms.
30  *
31  * Copyright (c) 2012, 2013, Intel Corporation.
32  */
33 /*
34  * This file is part of Lustre, http://www.lustre.org/
35  * Lustre is a trademark of Sun Microsystems, Inc.
36  *
37  * lnet/selftest/selftest.h
38  *
39  * Author: Isaac Huang <isaac@clusterfs.com>
40  */
41 #ifndef __SELFTEST_SELFTEST_H__
42 #define __SELFTEST_SELFTEST_H__
43
44 #define LNET_ONLY
45
46 #ifndef __KERNEL__
47
48 /* XXX workaround XXX */
49 #ifdef HAVE_SYS_TYPES_H
50 #include <sys/types.h>
51 #endif
52
53 #endif
54 #include <libcfs/libcfs.h>
55 #include <lnet/lnet.h>
56 #include <lnet/lib-lnet.h>
57 #include <lnet/lib-types.h>
58 #include <lnet/lnetst.h>
59
60 #include "rpc.h"
61 #include "timer.h"
62
63 #ifndef MADE_WITHOUT_COMPROMISE
64 #define MADE_WITHOUT_COMPROMISE
65 #endif
66
67
68 #define SWI_STATE_NEWBORN                  0
69 #define SWI_STATE_REPLY_SUBMITTED          1
70 #define SWI_STATE_REPLY_SENT               2
71 #define SWI_STATE_REQUEST_SUBMITTED        3
72 #define SWI_STATE_REQUEST_SENT             4
73 #define SWI_STATE_REPLY_RECEIVED           5
74 #define SWI_STATE_BULK_STARTED             6
75 #define SWI_STATE_DONE                     10
76
77 /* forward refs */
78 struct srpc_service;
79 struct srpc_service_cd;
80 struct sfw_test_unit;
81 struct sfw_test_instance;
82
83 /* services below SRPC_FRAMEWORK_SERVICE_MAX_ID are framework
84  * services, e.g. create/modify session.
85  */
86 #define SRPC_SERVICE_DEBUG              0
87 #define SRPC_SERVICE_MAKE_SESSION       1
88 #define SRPC_SERVICE_REMOVE_SESSION     2
89 #define SRPC_SERVICE_BATCH              3
90 #define SRPC_SERVICE_TEST               4
91 #define SRPC_SERVICE_QUERY_STAT         5
92 #define SRPC_SERVICE_JOIN               6
93 #define SRPC_FRAMEWORK_SERVICE_MAX_ID   10
94 /* other services start from SRPC_FRAMEWORK_SERVICE_MAX_ID+1 */
95 #define SRPC_SERVICE_BRW                11
96 #define SRPC_SERVICE_PING               12
97 #define SRPC_SERVICE_MAX_ID             12
98
99 #define SRPC_REQUEST_PORTAL             50
100 /* a lazy portal for framework RPC requests */
101 #define SRPC_FRAMEWORK_REQUEST_PORTAL   51
102 /* all reply/bulk RDMAs go to this portal */
103 #define SRPC_RDMA_PORTAL                52
104
105 static inline srpc_msg_type_t
106 srpc_service2request (int service)
107 {
108         switch (service) {
109         default:
110                 LBUG ();
111         case SRPC_SERVICE_DEBUG:
112                 return SRPC_MSG_DEBUG_REQST;
113
114         case SRPC_SERVICE_MAKE_SESSION:
115                 return SRPC_MSG_MKSN_REQST;
116
117         case SRPC_SERVICE_REMOVE_SESSION:
118                 return SRPC_MSG_RMSN_REQST;
119
120         case SRPC_SERVICE_BATCH:
121                 return SRPC_MSG_BATCH_REQST;
122
123         case SRPC_SERVICE_TEST:
124                 return SRPC_MSG_TEST_REQST;
125
126         case SRPC_SERVICE_QUERY_STAT:
127                 return SRPC_MSG_STAT_REQST;
128
129         case SRPC_SERVICE_BRW:
130                 return SRPC_MSG_BRW_REQST;
131
132         case SRPC_SERVICE_PING:
133                 return SRPC_MSG_PING_REQST;
134
135         case SRPC_SERVICE_JOIN:
136                 return SRPC_MSG_JOIN_REQST;
137         }
138 }
139
140 static inline srpc_msg_type_t
141 srpc_service2reply (int service)
142 {
143         return srpc_service2request(service) + 1;
144 }
145
146 typedef enum {
147         SRPC_BULK_REQ_RCVD   = 1, /* passive bulk request(PUT sink/GET source) received */
148         SRPC_BULK_PUT_SENT   = 2, /* active bulk PUT sent (source) */
149         SRPC_BULK_GET_RPLD   = 3, /* active bulk GET replied (sink) */
150         SRPC_REPLY_RCVD      = 4, /* incoming reply received */
151         SRPC_REPLY_SENT      = 5, /* outgoing reply sent */
152         SRPC_REQUEST_RCVD    = 6, /* incoming request received */
153         SRPC_REQUEST_SENT    = 7, /* outgoing request sent */
154 } srpc_event_type_t;
155
156 /* RPC event */
157 typedef struct {
158         srpc_event_type_t ev_type;   /* what's up */
159         lnet_event_kind_t ev_lnet;   /* LNet event type */
160         int               ev_fired;  /* LNet event fired? */
161         int               ev_status; /* LNet event status */
162         void             *ev_data;   /* owning server/client RPC */
163 } srpc_event_t;
164
165 typedef struct {
166         int              bk_len;  /* len of bulk data */
167         lnet_handle_md_t bk_mdh;
168         int              bk_sink; /* sink/source */
169         int              bk_niov; /* # iov in bk_iovs */
170 #ifdef __KERNEL__
171         lnet_kiov_t      bk_iovs[0];
172 #else
173         cfs_page_t     **bk_pages;
174         lnet_md_iovec_t  bk_iovs[0];
175 #endif
176 } srpc_bulk_t; /* bulk descriptor */
177
178 /* message buffer descriptor */
179 typedef struct srpc_buffer {
180         cfs_list_t           buf_list; /* chain on srpc_service::*_msgq */
181         srpc_msg_t           buf_msg;
182         lnet_handle_md_t     buf_mdh;
183         lnet_nid_t           buf_self;
184         lnet_process_id_t    buf_peer;
185 } srpc_buffer_t;
186
187 struct swi_workitem;
188 typedef int (*swi_action_t) (struct swi_workitem *);
189
190 typedef struct swi_workitem {
191         struct cfs_wi_sched     *swi_sched;
192         cfs_workitem_t       swi_workitem;
193         swi_action_t         swi_action;
194         int                  swi_state;
195 } swi_workitem_t;
196
197 /* server-side state of a RPC */
198 typedef struct srpc_server_rpc {
199         /* chain on srpc_service::*_rpcq */
200         cfs_list_t              srpc_list;
201         struct srpc_service_cd *srpc_scd;
202         swi_workitem_t       srpc_wi;
203         srpc_event_t         srpc_ev;      /* bulk/reply event */
204         lnet_nid_t           srpc_self;
205         lnet_process_id_t    srpc_peer;
206         srpc_msg_t           srpc_replymsg;
207         lnet_handle_md_t     srpc_replymdh;
208         srpc_buffer_t       *srpc_reqstbuf;
209         srpc_bulk_t         *srpc_bulk;
210
211         unsigned int         srpc_aborted; /* being given up */
212         int                  srpc_status;
213         void               (*srpc_done)(struct srpc_server_rpc *);
214 } srpc_server_rpc_t;
215
216 /* client-side state of a RPC */
217 typedef struct srpc_client_rpc {
218         cfs_list_t              crpc_list;      /* chain on user's lists */
219         spinlock_t              crpc_lock;      /* serialize */
220         int                  crpc_service;
221         cfs_atomic_t         crpc_refcount;
222         int                  crpc_timeout; /* # seconds to wait for reply */
223         stt_timer_t          crpc_timer;
224         swi_workitem_t       crpc_wi;
225         lnet_process_id_t    crpc_dest;
226
227         void               (*crpc_done)(struct srpc_client_rpc *);
228         void               (*crpc_fini)(struct srpc_client_rpc *);
229         int                  crpc_status;    /* completion status */
230         void                *crpc_priv;      /* caller data */
231
232         /* state flags */
233         unsigned int         crpc_aborted:1; /* being given up */
234         unsigned int         crpc_closed:1;  /* completed */
235
236         /* RPC events */
237         srpc_event_t         crpc_bulkev;    /* bulk event */
238         srpc_event_t         crpc_reqstev;   /* request event */
239         srpc_event_t         crpc_replyev;   /* reply event */
240
241         /* bulk, request(reqst), and reply exchanged on wire */
242         srpc_msg_t           crpc_reqstmsg;
243         srpc_msg_t           crpc_replymsg;
244         lnet_handle_md_t     crpc_reqstmdh;
245         lnet_handle_md_t     crpc_replymdh;
246         srpc_bulk_t          crpc_bulk;
247 } srpc_client_rpc_t;
248
249 #define srpc_client_rpc_size(rpc)                                       \
250 offsetof(srpc_client_rpc_t, crpc_bulk.bk_iovs[(rpc)->crpc_bulk.bk_niov])
251
252 #define srpc_client_rpc_addref(rpc)                                     \
253 do {                                                                    \
254         CDEBUG(D_NET, "RPC[%p] -> %s (%d)++\n",                         \
255                (rpc), libcfs_id2str((rpc)->crpc_dest),                  \
256                cfs_atomic_read(&(rpc)->crpc_refcount));                 \
257         LASSERT(cfs_atomic_read(&(rpc)->crpc_refcount) > 0);            \
258         cfs_atomic_inc(&(rpc)->crpc_refcount);                          \
259 } while (0)
260
261 #define srpc_client_rpc_decref(rpc)                                     \
262 do {                                                                    \
263         CDEBUG(D_NET, "RPC[%p] -> %s (%d)--\n",                         \
264                (rpc), libcfs_id2str((rpc)->crpc_dest),                  \
265                cfs_atomic_read(&(rpc)->crpc_refcount));                 \
266         LASSERT(cfs_atomic_read(&(rpc)->crpc_refcount) > 0);            \
267         if (cfs_atomic_dec_and_test(&(rpc)->crpc_refcount))             \
268                 srpc_destroy_client_rpc(rpc);                           \
269 } while (0)
270
271 #define srpc_event_pending(rpc)   ((rpc)->crpc_bulkev.ev_fired == 0 ||  \
272                                    (rpc)->crpc_reqstev.ev_fired == 0 || \
273                                    (rpc)->crpc_replyev.ev_fired == 0)
274
275 /* CPU partition data of srpc service */
276 struct srpc_service_cd {
277         /** serialize */
278         spinlock_t              scd_lock;
279         /** backref to service */
280         struct srpc_service     *scd_svc;
281         /** event buffer */
282         srpc_event_t            scd_ev;
283         /** free RPC descriptors */
284         cfs_list_t              scd_rpc_free;
285         /** in-flight RPCs */
286         cfs_list_t              scd_rpc_active;
287         /** workitem for posting buffer */
288         swi_workitem_t          scd_buf_wi;
289         /** CPT id */
290         int                     scd_cpt;
291         /** error code for scd_buf_wi */
292         int                     scd_buf_err;
293         /** timestamp for scd_buf_err */
294         unsigned long           scd_buf_err_stamp;
295         /** total # request buffers */
296         int                     scd_buf_total;
297         /** # posted request buffers */
298         int                     scd_buf_nposted;
299         /** in progress of buffer posting */
300         int                     scd_buf_posting;
301         /** allocate more buffers if scd_buf_nposted < scd_buf_low */
302         int                     scd_buf_low;
303         /** increase/decrease some buffers */
304         int                     scd_buf_adjust;
305         /** posted message buffers */
306         cfs_list_t              scd_buf_posted;
307         /** blocked for RPC descriptor */
308         cfs_list_t              scd_buf_blocked;
309 };
310
311 /* number of server workitems (mini-thread) for testing service */
312 #define SFW_TEST_WI_MIN         256
313 #define SFW_TEST_WI_MAX         2048
314 /* extra buffers for tolerating buggy peers, or unbalanced number
315  * of peers between partitions  */
316 #define SFW_TEST_WI_EXTRA       64
317
318 /* number of server workitems (mini-thread) for framework service */
319 #define SFW_FRWK_WI_MIN         16
320 #define SFW_FRWK_WI_MAX         256
321
322 typedef struct srpc_service {
323         int                     sv_id;          /* service id */
324         const char              *sv_name;       /* human readable name */
325         int                     sv_wi_total;    /* total server workitems */
326         int                     sv_shuttingdown;
327         int                     sv_ncpts;
328         /* percpt data for srpc_service */
329         struct srpc_service_cd  **sv_cpt_data;
330         /* Service callbacks:
331          * - sv_handler: process incoming RPC request
332          * - sv_bulk_ready: notify bulk data
333          */
334         int              (*sv_handler) (srpc_server_rpc_t *);
335         int              (*sv_bulk_ready) (srpc_server_rpc_t *, int);
336 } srpc_service_t;
337
338 typedef struct {
339         cfs_list_t        sn_list;    /* chain on fw_zombie_sessions */
340         lst_sid_t         sn_id;      /* unique identifier */
341         unsigned int      sn_timeout; /* # seconds' inactivity to expire */
342         int               sn_timer_active;
343         unsigned int      sn_features;
344         stt_timer_t       sn_timer;
345         cfs_list_t        sn_batches; /* list of batches */
346         char              sn_name[LST_NAME_SIZE];
347         cfs_atomic_t      sn_refcount;
348         cfs_atomic_t      sn_brw_errors;
349         cfs_atomic_t      sn_ping_errors;
350         cfs_time_t        sn_started;
351 } sfw_session_t;
352
353 #define sfw_sid_equal(sid0, sid1)     ((sid0).ses_nid == (sid1).ses_nid && \
354                                        (sid0).ses_stamp == (sid1).ses_stamp)
355
356 typedef struct {
357         cfs_list_t        bat_list;      /* chain on sn_batches */
358         lst_bid_t         bat_id;        /* batch id */
359         int               bat_error;     /* error code of batch */
360         sfw_session_t    *bat_session;   /* batch's session */
361         cfs_atomic_t      bat_nactive;   /* # of active tests */
362         cfs_list_t        bat_tests;     /* test instances */
363 } sfw_batch_t;
364
365 typedef struct {
366         int  (*tso_init)(struct sfw_test_instance *tsi); /* intialize test client */
367         void (*tso_fini)(struct sfw_test_instance *tsi); /* finalize test client */
368         int  (*tso_prep_rpc)(struct sfw_test_unit *tsu,
369                              lnet_process_id_t dest,
370                              srpc_client_rpc_t **rpc);   /* prep a tests rpc */
371         void (*tso_done_rpc)(struct sfw_test_unit *tsu,
372                              srpc_client_rpc_t *rpc);    /* done a test rpc */
373 } sfw_test_client_ops_t;
374
375 typedef struct sfw_test_instance {
376         cfs_list_t              tsi_list;         /* chain on batch */
377         int                     tsi_service;      /* test type */
378         sfw_batch_t            *tsi_batch;        /* batch */
379         sfw_test_client_ops_t  *tsi_ops;          /* test client operations */
380
381         /* public parameter for all test units */
382         unsigned int            tsi_is_client:1;     /* is test client */
383         unsigned int            tsi_stoptsu_onerr:1; /* stop tsu on error */
384         int                     tsi_concur;          /* concurrency */
385         int                     tsi_loop;            /* loop count */
386
387         /* status of test instance */
388         spinlock_t              tsi_lock;         /* serialize */
389         unsigned int            tsi_stopping:1;   /* test is stopping */
390         cfs_atomic_t            tsi_nactive;      /* # of active test unit */
391         cfs_list_t              tsi_units;        /* test units */
392         cfs_list_t              tsi_free_rpcs;    /* free rpcs */
393         cfs_list_t              tsi_active_rpcs;  /* active rpcs */
394
395         union {
396                 test_ping_req_t         ping;     /* ping parameter */
397                 test_bulk_req_t         bulk_v0;  /* bulk parameter */
398                 test_bulk_req_v1_t      bulk_v1;  /* bulk v1 parameter */
399         } tsi_u;
400 } sfw_test_instance_t;
401
402 /* XXX: trailing (CFS_PAGE_SIZE % sizeof(lnet_process_id_t)) bytes at
403  * the end of pages are not used */
404 #define SFW_MAX_CONCUR     LST_MAX_CONCUR
405 #define SFW_ID_PER_PAGE    (CFS_PAGE_SIZE / sizeof(lnet_process_id_packed_t))
406 #define SFW_MAX_NDESTS     (LNET_MAX_IOV * SFW_ID_PER_PAGE)
407 #define sfw_id_pages(n)    (((n) + SFW_ID_PER_PAGE - 1) / SFW_ID_PER_PAGE)
408
409 typedef struct sfw_test_unit {
410         cfs_list_t            tsu_list;         /* chain on lst_test_instance */
411         lnet_process_id_t     tsu_dest;         /* id of dest node */
412         int                   tsu_loop;         /* loop count of the test */
413         sfw_test_instance_t  *tsu_instance;     /* pointer to test instance */
414         void                 *tsu_private;      /* private data */
415         swi_workitem_t        tsu_worker;       /* workitem of the test unit */
416 } sfw_test_unit_t;
417
418 typedef struct sfw_test_case {
419         cfs_list_t              tsc_list;         /* chain on fw_tests */
420         srpc_service_t         *tsc_srv_service;  /* test service */
421         sfw_test_client_ops_t  *tsc_cli_ops;      /* ops of test client */
422 } sfw_test_case_t;
423
424 srpc_client_rpc_t *
425 sfw_create_rpc(lnet_process_id_t peer, int service,
426                unsigned features, int nbulkiov, int bulklen,
427                void (*done) (srpc_client_rpc_t *), void *priv);
428 int sfw_create_test_rpc(sfw_test_unit_t *tsu,
429                         lnet_process_id_t peer, unsigned features,
430                         int nblk, int blklen, srpc_client_rpc_t **rpc);
431 void sfw_abort_rpc(srpc_client_rpc_t *rpc);
432 void sfw_post_rpc(srpc_client_rpc_t *rpc);
433 void sfw_client_rpc_done(srpc_client_rpc_t *rpc);
434 void sfw_unpack_message(srpc_msg_t *msg);
435 void sfw_free_pages(srpc_server_rpc_t *rpc);
436 void sfw_add_bulk_page(srpc_bulk_t *bk, cfs_page_t *pg, int i);
437 int sfw_alloc_pages(srpc_server_rpc_t *rpc, int cpt, int npages, int len,
438                     int sink);
439 int sfw_make_session (srpc_mksn_reqst_t *request, srpc_mksn_reply_t *reply);
440
441 srpc_client_rpc_t *
442 srpc_create_client_rpc(lnet_process_id_t peer, int service,
443                        int nbulkiov, int bulklen,
444                        void (*rpc_done)(srpc_client_rpc_t *),
445                        void (*rpc_fini)(srpc_client_rpc_t *), void *priv);
446 void srpc_post_rpc(srpc_client_rpc_t *rpc);
447 void srpc_abort_rpc(srpc_client_rpc_t *rpc, int why);
448 void srpc_free_bulk(srpc_bulk_t *bk);
449 srpc_bulk_t *srpc_alloc_bulk(int cpt, unsigned bulk_npg, unsigned bulk_len,
450                              int sink);
451 int srpc_send_rpc(swi_workitem_t *wi);
452 int srpc_send_reply(srpc_server_rpc_t *rpc);
453 int srpc_add_service(srpc_service_t *sv);
454 int srpc_remove_service(srpc_service_t *sv);
455 void srpc_shutdown_service(srpc_service_t *sv);
456 void srpc_abort_service(srpc_service_t *sv);
457 int srpc_finish_service(srpc_service_t *sv);
458 int srpc_service_add_buffers(srpc_service_t *sv, int nbuffer);
459 void srpc_service_remove_buffers(srpc_service_t *sv, int nbuffer);
460 void srpc_get_counters(srpc_counters_t *cnt);
461 void srpc_set_counters(const srpc_counters_t *cnt);
462
463 extern struct cfs_wi_sched *lst_sched_serial;
464 extern struct cfs_wi_sched **lst_sched_test;
465
466 static inline int
467 srpc_serv_is_framework(struct srpc_service *svc)
468 {
469         return svc->sv_id < SRPC_FRAMEWORK_SERVICE_MAX_ID;
470 }
471
472 static inline int
473 swi_wi_action(cfs_workitem_t *wi)
474 {
475         swi_workitem_t *swi = container_of(wi, swi_workitem_t, swi_workitem);
476
477         return swi->swi_action(swi);
478 }
479
480 static inline void
481 swi_init_workitem(swi_workitem_t *swi, void *data,
482                   swi_action_t action, struct cfs_wi_sched *sched)
483 {
484         swi->swi_sched  = sched;
485         swi->swi_action = action;
486         swi->swi_state  = SWI_STATE_NEWBORN;
487         cfs_wi_init(&swi->swi_workitem, data, swi_wi_action);
488 }
489
490 static inline void
491 swi_schedule_workitem(swi_workitem_t *wi)
492 {
493         cfs_wi_schedule(wi->swi_sched, &wi->swi_workitem);
494 }
495
496 static inline void
497 swi_exit_workitem(swi_workitem_t *swi)
498 {
499         cfs_wi_exit(swi->swi_sched, &swi->swi_workitem);
500 }
501
502 static inline int
503 swi_deschedule_workitem(swi_workitem_t *swi)
504 {
505         return cfs_wi_deschedule(swi->swi_sched, &swi->swi_workitem);
506 }
507
508 #ifndef __KERNEL__
509 static inline int
510 swi_check_events(void)
511 {
512         return cfs_wi_check_events();
513 }
514 #endif
515
516 int sfw_startup(void);
517 int srpc_startup(void);
518 void sfw_shutdown(void);
519 void srpc_shutdown(void);
520
521 static inline void
522 srpc_destroy_client_rpc (srpc_client_rpc_t *rpc)
523 {
524         LASSERT (rpc != NULL);
525         LASSERT (!srpc_event_pending(rpc));
526         LASSERT (cfs_atomic_read(&rpc->crpc_refcount) == 0);
527 #ifndef __KERNEL__
528         LASSERT (rpc->crpc_bulk.bk_pages == NULL);
529 #endif
530
531         if (rpc->crpc_fini == NULL) {
532                 LIBCFS_FREE(rpc, srpc_client_rpc_size(rpc));
533         } else {
534                 (*rpc->crpc_fini) (rpc);
535         }
536
537         return;
538 }
539
540 static inline void
541 srpc_init_client_rpc (srpc_client_rpc_t *rpc, lnet_process_id_t peer,
542                       int service, int nbulkiov, int bulklen,
543                       void (*rpc_done)(srpc_client_rpc_t *),
544                       void (*rpc_fini)(srpc_client_rpc_t *), void *priv)
545 {
546         LASSERT (nbulkiov <= LNET_MAX_IOV);
547
548         memset(rpc, 0, offsetof(srpc_client_rpc_t,
549                                 crpc_bulk.bk_iovs[nbulkiov]));
550
551         CFS_INIT_LIST_HEAD(&rpc->crpc_list);
552         swi_init_workitem(&rpc->crpc_wi, rpc, srpc_send_rpc,
553                           lst_sched_test[lnet_cpt_of_nid(peer.nid)]);
554         spin_lock_init(&rpc->crpc_lock);
555         cfs_atomic_set(&rpc->crpc_refcount, 1); /* 1 ref for caller */
556
557         rpc->crpc_dest         = peer;
558         rpc->crpc_priv         = priv;
559         rpc->crpc_service      = service;
560         rpc->crpc_bulk.bk_len  = bulklen;
561         rpc->crpc_bulk.bk_niov = nbulkiov;
562         rpc->crpc_done         = rpc_done;
563         rpc->crpc_fini         = rpc_fini;
564         LNetInvalidateHandle(&rpc->crpc_reqstmdh);
565         LNetInvalidateHandle(&rpc->crpc_replymdh);
566         LNetInvalidateHandle(&rpc->crpc_bulk.bk_mdh);
567
568         /* no event is expected at this point */
569         rpc->crpc_bulkev.ev_fired  =
570         rpc->crpc_reqstev.ev_fired =
571         rpc->crpc_replyev.ev_fired = 1;
572
573         rpc->crpc_reqstmsg.msg_magic   = SRPC_MSG_MAGIC;
574         rpc->crpc_reqstmsg.msg_version = SRPC_MSG_VERSION;
575         rpc->crpc_reqstmsg.msg_type    = srpc_service2request(service);
576         return;
577 }
578
579 static inline const char *
580 swi_state2str (int state)
581 {
582 #define STATE2STR(x) case x: return #x
583         switch(state) {
584                 default:
585                         LBUG();
586                 STATE2STR(SWI_STATE_NEWBORN);
587                 STATE2STR(SWI_STATE_REPLY_SUBMITTED);
588                 STATE2STR(SWI_STATE_REPLY_SENT);
589                 STATE2STR(SWI_STATE_REQUEST_SUBMITTED);
590                 STATE2STR(SWI_STATE_REQUEST_SENT);
591                 STATE2STR(SWI_STATE_REPLY_RECEIVED);
592                 STATE2STR(SWI_STATE_BULK_STARTED);
593                 STATE2STR(SWI_STATE_DONE);
594         }
595 #undef STATE2STR
596 }
597
598 #define UNUSED(x)       ( (void)(x) )
599
600 #ifndef __KERNEL__
601
602 int stt_poll_interval(void);
603 int sfw_session_removed(void);
604
605 int stt_check_events(void);
606 int srpc_check_event(int timeout);
607
608 int lnet_selftest_init(void);
609 void lnet_selftest_fini(void);
610 int selftest_wait_events(void);
611
612 #else
613
614 #define selftest_wait_events()  cfs_pause(cfs_time_seconds(1) / 10)
615
616 #endif
617
618 #define lst_wait_until(cond, lock, fmt, ...)                            \
619 do {                                                                    \
620         int __I = 2;                                                    \
621         while (!(cond)) {                                               \
622                 CDEBUG(IS_PO2(++__I) ? D_WARNING : D_NET,               \
623                        fmt, ## __VA_ARGS__);                            \
624                 spin_unlock(&(lock));                                   \
625                                                                         \
626                 selftest_wait_events();                                 \
627                                                                         \
628                 spin_lock(&(lock));                                     \
629         }                                                               \
630 } while (0)
631
632 static inline void
633 srpc_wait_service_shutdown(srpc_service_t *sv)
634 {
635         int i = 2;
636
637         LASSERT(sv->sv_shuttingdown);
638
639         while (srpc_finish_service(sv) == 0) {
640                 i++;
641                 CDEBUG (((i & -i) == i) ? D_WARNING : D_NET,
642                         "Waiting for %s service to shutdown...\n",
643                         sv->sv_name);
644                 selftest_wait_events();
645         }
646 }
647
648 #endif /* __SELFTEST_SELFTEST_H__ */