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