lnet/selftest/conrpc.h

   1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
   2  * vim:expandtab:shiftwidth=8:tabstop=8:
   3  *
   4  * GPL HEADER START
   5  *
   6  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License version 2 only,
  10  * as published by the Free Software Foundation.
  11  *
  12  * This program is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * General Public License version 2 for more details (a copy is included
  16  * in the LICENSE file that accompanied this code).
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * version 2 along with this program; If not, see
  20  * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
  21  *
  22  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
  23  * CA 95054 USA or visit www.sun.com if you need additional information or
  24  * have any questions.
  25  *
  26  * GPL HEADER END
  27  */
  28 /*
  29  * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
  30  * Use is subject to license terms.
  31  */
  32 /*
  33  * This file is part of Lustre, http://www.lustre.org/
  34  * Lustre is a trademark of Sun Microsystems, Inc.
  35  *
  36  * /lnet/selftest/conrpc.h
  37  *
  38  * Console rpc
  39  *
  40  * Author: Liang Zhen <liangzhen@clusterfs.com>
  41  */
  42
  43 #ifndef __LST_CONRPC_H__
  44 #define __LST_CONRPC_H__
  45
  46 #ifdef __KERNEL__
  47 #include <libcfs/libcfs.h>
  48 #include <lnet/lnet.h>
  49 #include <lnet/lib-types.h>
  50 #include <lnet/lnetst.h>
  51 #include "rpc.h"
  52 #include "selftest.h"
  53
  54 /* Console rpc and rpc transaction */
  55 #define LST_TRANS_TIMEOUT       30
  56 #define LST_TRANS_MIN_TIMEOUT   3
  57
  58 #define LST_VALIDATE_TIMEOUT(t) MIN(MAX(t, LST_TRANS_MIN_TIMEOUT), LST_TRANS_TIMEOUT)
  59
  60 #define LST_PING_INTERVAL       8
  61
  62 struct lstcon_rpc_trans;
  63 struct lstcon_tsb_hdr;
  64 struct lstcon_test;
  65 struct lstcon_node;
  66
  67 typedef struct lstcon_rpc {
  68         cfs_list_t               crp_link;       /* chain on rpc transaction */
  69         srpc_client_rpc_t       *crp_rpc;        /* client rpc */
  70         struct lstcon_node      *crp_node;       /* destination node */
  71         struct lstcon_rpc_trans *crp_trans;     /* conrpc transaction */
  72
  73         int                      crp_posted:1;   /* rpc is posted */
  74         int                      crp_finished:1; /* rpc is finished */
  75         int                      crp_unpacked:1; /* reply is unpacked */
  76         int                      crp_static:1;   /* not from RPC buffer */
  77         int                      crp_status;     /* console rpc errors */
  78         cfs_time_t               crp_stamp;      /* replied time stamp */
  79 } lstcon_rpc_t;
  80
  81 typedef struct lstcon_rpc_trans {
  82         cfs_list_t            tas_olink;     /* link chain on owner list */
  83         cfs_list_t            tas_link;      /* link chain on global list */
  84         int                   tas_opc;       /* operation code of transaction */
  85         cfs_waitq_t           tas_waitq;     /* wait queue head */
  86         cfs_atomic_t          tas_remaining; /* # of un-scheduled rpcs */
  87         cfs_list_t            tas_rpcs_list; /* queued requests */
  88 } lstcon_rpc_trans_t;
  89
  90 #define LST_TRANS_PRIVATE       0x1000
  91
  92 #define LST_TRANS_SESNEW        (LST_TRANS_PRIVATE | 0x01)
  93 #define LST_TRANS_SESEND        (LST_TRANS_PRIVATE | 0x02)
  94 #define LST_TRANS_SESQRY        0x03
  95 #define LST_TRANS_SESPING       0x04
  96
  97 #define LST_TRANS_TSBCLIADD     (LST_TRANS_PRIVATE | 0x11)
  98 #define LST_TRANS_TSBSRVADD     (LST_TRANS_PRIVATE | 0x12)
  99 #define LST_TRANS_TSBRUN        (LST_TRANS_PRIVATE | 0x13)
 100 #define LST_TRANS_TSBSTOP       (LST_TRANS_PRIVATE | 0x14)
 101 #define LST_TRANS_TSBCLIQRY     0x15
 102 #define LST_TRANS_TSBSRVQRY     0x16
 103
 104 #define LST_TRANS_STATQRY       0x21
 105
 106 typedef int (* lstcon_rpc_cond_func_t)(int, struct lstcon_node *, void *);
 107 typedef int (* lstcon_rpc_readent_func_t)(int, srpc_msg_t *, lstcon_rpc_ent_t *);
 108
 109 int  lstcon_sesrpc_prep(struct lstcon_node *nd,
 110                         int transop, lstcon_rpc_t **crpc);
 111 int  lstcon_dbgrpc_prep(struct lstcon_node *nd, lstcon_rpc_t **crpc);
 112 int  lstcon_batrpc_prep(struct lstcon_node *nd, int transop,
 113                         struct lstcon_tsb_hdr *tsb, lstcon_rpc_t **crpc);
 114 int  lstcon_testrpc_prep(struct lstcon_node *nd, int transop,
 115                          struct lstcon_test *test, lstcon_rpc_t **crpc);
 116 int  lstcon_statrpc_prep(struct lstcon_node *nd, lstcon_rpc_t **crpc);
 117 void lstcon_rpc_put(lstcon_rpc_t *crpc);
 118 int  lstcon_rpc_trans_prep(cfs_list_t *translist,
 119                            int transop, lstcon_rpc_trans_t **transpp);
 120 int  lstcon_rpc_trans_ndlist(cfs_list_t *ndlist,
 121                              cfs_list_t *translist, int transop,
 122                              void *arg, lstcon_rpc_cond_func_t condition,
 123                              lstcon_rpc_trans_t **transpp);
 124 void lstcon_rpc_trans_stat(lstcon_rpc_trans_t *trans,
 125                            lstcon_trans_stat_t *stat);
 126 int  lstcon_rpc_trans_interpreter(lstcon_rpc_trans_t *trans,
 127                                   cfs_list_t *head_up,
 128                                   lstcon_rpc_readent_func_t readent);
 129 void lstcon_rpc_trans_abort(lstcon_rpc_trans_t *trans, int error);
 130 void lstcon_rpc_trans_destroy(lstcon_rpc_trans_t *trans);
 131 void lstcon_rpc_trans_addreq(lstcon_rpc_trans_t *trans, lstcon_rpc_t *req);
 132 int  lstcon_rpc_trans_postwait(lstcon_rpc_trans_t *trans, int timeout);
 133 int  lstcon_rpc_pinger_start(void);
 134 void lstcon_rpc_pinger_stop(void);
 135 void lstcon_rpc_cleanup_wait(void);
 136 int  lstcon_rpc_module_init(void);
 137 void lstcon_rpc_module_fini(void);
 138
 139 #endif
 140
 141 #endif