4 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
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.
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).
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
20 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
21 * CA 95054 USA or visit www.sun.com if you need additional information or
27 * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
28 * Use is subject to license terms.
30 * Copyright (c) 2011, Intel Corporation.
33 * This file is part of Lustre, http://www.lustre.org/
34 * Lustre is a trademark of Sun Microsystems, Inc.
36 * /lnet/selftest/conrpc.h
40 * Author: Liang Zhen <liang@whamcloud.com>
43 #ifndef __LST_CONRPC_H__
44 #define __LST_CONRPC_H__
46 #include "../../include/linux/libcfs/libcfs.h"
47 #include "../../include/linux/lnet/lnet.h"
48 #include "../../include/linux/lnet/lib-types.h"
49 #include "../../include/linux/lnet/lnetst.h"
53 /* Console rpc and rpc transaction */
54 #define LST_TRANS_TIMEOUT 30
55 #define LST_TRANS_MIN_TIMEOUT 3
57 #define LST_VALIDATE_TIMEOUT(t) min(max(t, LST_TRANS_MIN_TIMEOUT), LST_TRANS_TIMEOUT)
59 #define LST_PING_INTERVAL 8
61 struct lstcon_rpc_trans;
62 struct lstcon_tsb_hdr;
66 typedef struct lstcon_rpc {
67 struct list_head crp_link; /* chain on rpc transaction */
68 srpc_client_rpc_t *crp_rpc; /* client rpc */
69 struct lstcon_node *crp_node; /* destination node */
70 struct lstcon_rpc_trans *crp_trans; /* conrpc transaction */
72 unsigned int crp_posted:1; /* rpc is posted */
73 unsigned int crp_finished:1; /* rpc is finished */
74 unsigned int crp_unpacked:1; /* reply is unpacked */
75 /** RPC is embedded in other structure and can't free it */
76 unsigned int crp_embedded:1;
77 int crp_status; /* console rpc errors */
78 unsigned long crp_stamp; /* replied time stamp */
81 typedef struct lstcon_rpc_trans {
82 struct list_head tas_olink; /* link chain on owner list */
83 struct list_head tas_link; /* link chain on global list */
84 int tas_opc; /* operation code of transaction */
85 /* features mask is uptodate */
86 unsigned tas_feats_updated;
87 /* test features mask */
88 unsigned tas_features;
89 wait_queue_head_t tas_waitq; /* wait queue head */
90 atomic_t tas_remaining; /* # of un-scheduled rpcs */
91 struct list_head tas_rpcs_list; /* queued requests */
94 #define LST_TRANS_PRIVATE 0x1000
96 #define LST_TRANS_SESNEW (LST_TRANS_PRIVATE | 0x01)
97 #define LST_TRANS_SESEND (LST_TRANS_PRIVATE | 0x02)
98 #define LST_TRANS_SESQRY 0x03
99 #define LST_TRANS_SESPING 0x04
101 #define LST_TRANS_TSBCLIADD (LST_TRANS_PRIVATE | 0x11)
102 #define LST_TRANS_TSBSRVADD (LST_TRANS_PRIVATE | 0x12)
103 #define LST_TRANS_TSBRUN (LST_TRANS_PRIVATE | 0x13)
104 #define LST_TRANS_TSBSTOP (LST_TRANS_PRIVATE | 0x14)
105 #define LST_TRANS_TSBCLIQRY 0x15
106 #define LST_TRANS_TSBSRVQRY 0x16
108 #define LST_TRANS_STATQRY 0x21
110 typedef int (* lstcon_rpc_cond_func_t)(int, struct lstcon_node *, void *);
111 typedef int (* lstcon_rpc_readent_func_t)(int, srpc_msg_t *, lstcon_rpc_ent_t *);
113 int lstcon_sesrpc_prep(struct lstcon_node *nd, int transop,
114 unsigned version, lstcon_rpc_t **crpc);
115 int lstcon_dbgrpc_prep(struct lstcon_node *nd,
116 unsigned version, lstcon_rpc_t **crpc);
117 int lstcon_batrpc_prep(struct lstcon_node *nd, int transop, unsigned version,
118 struct lstcon_tsb_hdr *tsb, lstcon_rpc_t **crpc);
119 int lstcon_testrpc_prep(struct lstcon_node *nd, int transop, unsigned version,
120 struct lstcon_test *test, lstcon_rpc_t **crpc);
121 int lstcon_statrpc_prep(struct lstcon_node *nd, unsigned version,
122 lstcon_rpc_t **crpc);
123 void lstcon_rpc_put(lstcon_rpc_t *crpc);
124 int lstcon_rpc_trans_prep(struct list_head *translist,
125 int transop, lstcon_rpc_trans_t **transpp);
126 int lstcon_rpc_trans_ndlist(struct list_head *ndlist,
127 struct list_head *translist, int transop,
128 void *arg, lstcon_rpc_cond_func_t condition,
129 lstcon_rpc_trans_t **transpp);
130 void lstcon_rpc_trans_stat(lstcon_rpc_trans_t *trans,
131 lstcon_trans_stat_t *stat);
132 int lstcon_rpc_trans_interpreter(lstcon_rpc_trans_t *trans,
133 struct list_head *head_up,
134 lstcon_rpc_readent_func_t readent);
135 void lstcon_rpc_trans_abort(lstcon_rpc_trans_t *trans, int error);
136 void lstcon_rpc_trans_destroy(lstcon_rpc_trans_t *trans);
137 void lstcon_rpc_trans_addreq(lstcon_rpc_trans_t *trans, lstcon_rpc_t *req);
138 int lstcon_rpc_trans_postwait(lstcon_rpc_trans_t *trans, int timeout);
139 int lstcon_rpc_pinger_start(void);
140 void lstcon_rpc_pinger_stop(void);
141 void lstcon_rpc_cleanup_wait(void);
142 int lstcon_rpc_module_init(void);
143 void lstcon_rpc_module_fini(void);