drivers/staging/lustre/lnet/selftest/conrpc.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) 2011, Intel Corporation.
  27  */
  28 /*
  29  * This file is part of Lustre, http://www.lustre.org/
  30  * Lustre is a trademark of Sun Microsystems, Inc.
  31  *
  32  * /lnet/selftest/conrpc.h
  33  *
  34  * Console rpc
  35  *
  36  * Author: Liang Zhen <liang@whamcloud.com>
  37  */
  38
  39 #ifndef __LST_CONRPC_H__
  40 #define __LST_CONRPC_H__
  41
  42 #include <linux/libcfs/libcfs.h>
  43 #include <linux/lnet/lib-types.h>
  44 #include <uapi/linux/lnet/lnetst.h>
  45 #include "rpc.h"
  46 #include "selftest.h"
  47
  48 /* Console rpc and rpc transaction */
  49 #define LST_TRANS_TIMEOUT       30
  50 #define LST_TRANS_MIN_TIMEOUT   3
  51
  52 #define LST_VALIDATE_TIMEOUT(t) min(max(t, LST_TRANS_MIN_TIMEOUT), LST_TRANS_TIMEOUT)
  53
  54 #define LST_PING_INTERVAL       8
  55
  56 struct lstcon_rpc_trans;
  57 struct lstcon_tsb_hdr;
  58 struct lstcon_test;
  59 struct lstcon_node;
  60
  61 struct lstcon_rpc {
  62         struct list_head         crp_link;      /* chain on rpc transaction */
  63         struct srpc_client_rpc  *crp_rpc;       /* client rpc */
  64         struct lstcon_node      *crp_node;      /* destination node */
  65         struct lstcon_rpc_trans *crp_trans;     /* conrpc transaction */
  66
  67         unsigned int             crp_posted:1;  /* rpc is posted */
  68         unsigned int             crp_finished:1; /* rpc is finished */
  69         unsigned int             crp_unpacked:1; /* reply is unpacked */
  70         /** RPC is embedded in other structure and can't free it */
  71         unsigned int             crp_embedded:1;
  72         int                      crp_status;    /* console rpc errors */
  73         unsigned long            crp_stamp;     /* replied time stamp */
  74 };
  75
  76 struct lstcon_rpc_trans {
  77         struct list_head  tas_olink;         /* link chain on owner list */
  78         struct list_head  tas_link;          /* link chain on global list */
  79         int               tas_opc;           /* operation code of transaction */
  80         unsigned int      tas_feats_updated; /* features mask is uptodate */
  81         unsigned int      tas_features;      /* test features mask */
  82         wait_queue_head_t tas_waitq;         /* wait queue head */
  83         atomic_t          tas_remaining;     /* # of un-scheduled rpcs */
  84         struct list_head  tas_rpcs_list;     /* queued requests */
  85 };
  86
  87 #define LST_TRANS_PRIVATE       0x1000
  88
  89 #define LST_TRANS_SESNEW        (LST_TRANS_PRIVATE | 0x01)
  90 #define LST_TRANS_SESEND        (LST_TRANS_PRIVATE | 0x02)
  91 #define LST_TRANS_SESQRY        0x03
  92 #define LST_TRANS_SESPING       0x04
  93
  94 #define LST_TRANS_TSBCLIADD     (LST_TRANS_PRIVATE | 0x11)
  95 #define LST_TRANS_TSBSRVADD     (LST_TRANS_PRIVATE | 0x12)
  96 #define LST_TRANS_TSBRUN        (LST_TRANS_PRIVATE | 0x13)
  97 #define LST_TRANS_TSBSTOP       (LST_TRANS_PRIVATE | 0x14)
  98 #define LST_TRANS_TSBCLIQRY     0x15
  99 #define LST_TRANS_TSBSRVQRY     0x16
 100
 101 #define LST_TRANS_STATQRY       0x21
 102
 103 typedef int (*lstcon_rpc_cond_func_t)(int, struct lstcon_node *, void *);
 104 typedef int (*lstcon_rpc_readent_func_t)(int, struct srpc_msg *,
 105                                          struct lstcon_rpc_ent __user *);
 106
 107 int  lstcon_sesrpc_prep(struct lstcon_node *nd, int transop,
 108                         unsigned int version, struct lstcon_rpc **crpc);
 109 int  lstcon_dbgrpc_prep(struct lstcon_node *nd,
 110                         unsigned int version, struct lstcon_rpc **crpc);
 111 int  lstcon_batrpc_prep(struct lstcon_node *nd, int transop,
 112                         unsigned int version, struct lstcon_tsb_hdr *tsb,
 113                         struct lstcon_rpc **crpc);
 114 int  lstcon_testrpc_prep(struct lstcon_node *nd, int transop,
 115                          unsigned int version, struct lstcon_test *test,
 116                          struct lstcon_rpc **crpc);
 117 int  lstcon_statrpc_prep(struct lstcon_node *nd, unsigned int version,
 118                          struct lstcon_rpc **crpc);
 119 void lstcon_rpc_put(struct lstcon_rpc *crpc);
 120 int  lstcon_rpc_trans_prep(struct list_head *translist,
 121                            int transop, struct lstcon_rpc_trans **transpp);
 122 int  lstcon_rpc_trans_ndlist(struct list_head *ndlist,
 123                              struct list_head *translist, int transop,
 124                              void *arg, lstcon_rpc_cond_func_t condition,
 125                              struct lstcon_rpc_trans **transpp);
 126 void lstcon_rpc_trans_stat(struct lstcon_rpc_trans *trans,
 127                            struct lstcon_trans_stat *stat);
 128 int  lstcon_rpc_trans_interpreter(struct lstcon_rpc_trans *trans,
 129                                   struct list_head __user *head_up,
 130                                   lstcon_rpc_readent_func_t readent);
 131 void lstcon_rpc_trans_abort(struct lstcon_rpc_trans *trans, int error);
 132 void lstcon_rpc_trans_destroy(struct lstcon_rpc_trans *trans);
 133 void lstcon_rpc_trans_addreq(struct lstcon_rpc_trans *trans,
 134                              struct lstcon_rpc *req);
 135 int  lstcon_rpc_trans_postwait(struct lstcon_rpc_trans *trans, int timeout);
 136 int  lstcon_rpc_pinger_start(void);
 137 void lstcon_rpc_pinger_stop(void);
 138 void lstcon_rpc_cleanup_wait(void);
 139 int  lstcon_rpc_module_init(void);
 140 void lstcon_rpc_module_fini(void);
 141
 142 #endif