1 /* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
2 * vim:expandtab:shiftwidth=8:tabstop=8:
6 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
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.
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).
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
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
29 * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
30 * Use is subject to license terms.
33 * This file is part of Lustre, http://www.lustre.org/
34 * Lustre is a trademark of Sun Microsystems, Inc.
36 * lnet/selftest/console.h
38 * kernel structure for LST console
40 * Author: Liang Zhen <liangzhen@clusterfs.com>
43 #ifndef __LST_CONSOLE_H__
44 #define __LST_CONSOLE_H__
48 #include <libcfs/libcfs.h>
49 #include <lnet/lnet.h>
50 #include <lnet/lib-types.h>
51 #include <lnet/lnetst.h>
55 typedef struct lstcon_node {
56 lnet_process_id_t nd_id; /* id of the node */
57 int nd_ref; /* reference count */
58 int nd_state; /* state of the node */
59 int nd_timeout; /* session timeout */
60 cfs_time_t nd_stamp; /* timestamp of last replied RPC */
61 struct lstcon_rpc nd_ping; /* ping rpc */
62 } lstcon_node_t; /*** node descriptor */
65 cfs_list_t ndl_link; /* chain on list */
66 cfs_list_t ndl_hlink; /* chain on hash */
67 lstcon_node_t *ndl_node; /* pointer to node */
68 } lstcon_ndlink_t; /*** node link descriptor */
71 cfs_list_t grp_link; /* chain on global group list */
72 int grp_ref; /* reference count */
73 int grp_userland; /* has userland nodes */
74 int grp_nnode; /* # of nodes */
75 char grp_name[LST_NAME_SIZE]; /* group name */
77 cfs_list_t grp_trans_list; /* transaction list */
78 cfs_list_t grp_ndl_list; /* nodes list */
79 cfs_list_t grp_ndl_hash[0];/* hash table for nodes */
80 } lstcon_group_t; /*** (alias of nodes) group descriptor */
82 #define LST_BATCH_IDLE 0xB0 /* idle batch */
83 #define LST_BATCH_RUNNING 0xB1 /* running batch */
85 typedef struct lstcon_tsb_hdr {
86 lst_bid_t tsb_id; /* batch ID */
87 int tsb_index; /* test index */
91 lstcon_tsb_hdr_t bat_hdr; /* test_batch header */
92 cfs_list_t bat_link; /* chain on session's batches list */
93 int bat_ntest; /* # of test */
94 int bat_state; /* state of the batch */
95 int bat_arg; /* parameter for run|stop, timeout for run, force for stop */
96 char bat_name[LST_NAME_SIZE]; /* name of batch */
98 cfs_list_t bat_test_list; /* list head of tests (lstcon_test_t) */
99 cfs_list_t bat_trans_list; /* list head of transaction */
100 cfs_list_t bat_cli_list; /* list head of client nodes (lstcon_node_t) */
101 cfs_list_t *bat_cli_hash; /* hash table of client nodes */
102 cfs_list_t bat_srv_list; /* list head of server nodes */
103 cfs_list_t *bat_srv_hash; /* hash table of server nodes */
104 } lstcon_batch_t; /*** (tests ) batch descritptor */
106 typedef struct lstcon_test {
107 lstcon_tsb_hdr_t tes_hdr; /* test batch header */
108 cfs_list_t tes_link; /* chain on batch's tests list */
109 lstcon_batch_t *tes_batch; /* pointer to batch */
111 int tes_type; /* type of the test, i.e: bulk, ping */
112 int tes_stop_onerr; /* stop on error */
113 int tes_oneside; /* one-sided test */
114 int tes_concur; /* concurrency */
115 int tes_loop; /* loop count */
116 int tes_dist; /* nodes distribution of target group */
117 int tes_span; /* nodes span of target group */
118 int tes_cliidx; /* client index, used for RPC creating */
120 cfs_list_t tes_trans_list; /* transaction list */
121 lstcon_group_t *tes_src_grp; /* group run the test */
122 lstcon_group_t *tes_dst_grp; /* target group */
124 int tes_paramlen; /* test parameter length */
125 char tes_param[0]; /* test parameter */
126 } lstcon_test_t; /*** a single test descriptor */
128 #define LST_GLOBAL_HASHSIZE 503 /* global nodes hash table size */
129 #define LST_NODE_HASHSIZE 239 /* node hash table (for batch or group) */
131 #define LST_SESSION_NONE 0x0 /* no session */
132 #define LST_SESSION_ACTIVE 0x1 /* working session */
134 #define LST_CONSOLE_TIMEOUT 300 /* default console timeout */
137 cfs_semaphore_t ses_mutex; /* lock for session, only one thread can enter session */
138 lst_sid_t ses_id; /* global session id */
139 int ses_key; /* local session key */
140 int ses_state; /* state of session */
141 int ses_timeout; /* timeout in seconds */
142 time_t ses_laststamp; /* last operation stamp (seconds) */
143 int ses_force:1; /* force creating */
144 int ses_shutdown:1; /* session is shutting down */
145 int ses_expired:1; /* console is timedout */
146 __u64 ses_id_cookie; /* batch id cookie */
147 char ses_name[LST_NAME_SIZE]; /* session name */
148 lstcon_rpc_trans_t *ses_ping; /* session pinger */
149 stt_timer_t ses_ping_timer; /* timer for pinger */
150 lstcon_trans_stat_t ses_trans_stat; /* transaction stats */
152 cfs_list_t ses_trans_list; /* global list of transaction */
153 cfs_list_t ses_grp_list; /* global list of groups */
154 cfs_list_t ses_bat_list; /* global list of batches */
155 cfs_list_t ses_ndl_list; /* global list of nodes */
156 cfs_list_t *ses_ndl_hash; /* hash table of nodes */
158 cfs_spinlock_t ses_rpc_lock; /* serialize */
159 cfs_atomic_t ses_rpc_counter;/* # of initialized RPCs */
160 cfs_list_t ses_rpc_freelist; /* idle console rpc */
161 } lstcon_session_t; /*** session descriptor */
163 extern lstcon_session_t console_session;
164 static inline lstcon_trans_stat_t *
165 lstcon_trans_stat(void)
167 return &console_session.ses_trans_stat;
170 static inline cfs_list_t *
171 lstcon_id2hash (lnet_process_id_t id, cfs_list_t *hash)
173 unsigned int idx = LNET_NIDADDR(id.nid) % LST_NODE_HASHSIZE;
178 extern int lstcon_session_match(lst_sid_t sid);
179 extern int lstcon_session_new(char *name, int key,
180 int timeout, int flags, lst_sid_t *sid_up);
181 extern int lstcon_session_info(lst_sid_t *sid_up, int *key,
182 lstcon_ndlist_ent_t *entp, char *name_up, int len);
183 extern int lstcon_session_end(void);
184 extern int lstcon_session_debug(int timeout, cfs_list_t *result_up);
185 extern int lstcon_batch_debug(int timeout, char *name,
186 int client, cfs_list_t *result_up);
187 extern int lstcon_group_debug(int timeout, char *name,
188 cfs_list_t *result_up);
189 extern int lstcon_nodes_debug(int timeout, int nnd, lnet_process_id_t *nds_up,
190 cfs_list_t *result_up);
191 extern int lstcon_group_add(char *name);
192 extern int lstcon_group_del(char *name);
193 extern int lstcon_group_clean(char *name, int args);
194 extern int lstcon_group_refresh(char *name, cfs_list_t *result_up);
195 extern int lstcon_nodes_add(char *name, int nnd, lnet_process_id_t *nds_up,
196 cfs_list_t *result_up);
197 extern int lstcon_nodes_remove(char *name, int nnd, lnet_process_id_t *nds_up,
198 cfs_list_t *result_up);
199 extern int lstcon_group_info(char *name, lstcon_ndlist_ent_t *gent_up,
200 int *index_p, int *ndent_p, lstcon_node_ent_t *ndents_up);
201 extern int lstcon_group_list(int idx, int len, char *name_up);
202 extern int lstcon_batch_add(char *name);
203 extern int lstcon_batch_run(char *name, int timeout,
204 cfs_list_t *result_up);
205 extern int lstcon_batch_stop(char *name, int force,
206 cfs_list_t *result_up);
207 extern int lstcon_test_batch_query(char *name, int testidx,
208 int client, int timeout,
209 cfs_list_t *result_up);
210 extern int lstcon_batch_del(char *name);
211 extern int lstcon_batch_list(int idx, int namelen, char *name_up);
212 extern int lstcon_batch_info(char *name, lstcon_test_batch_ent_t *ent_up,
213 int server, int testidx, int *index_p,
214 int *ndent_p, lstcon_node_ent_t *dents_up);
215 extern int lstcon_group_stat(char *grp_name, int timeout,
216 cfs_list_t *result_up);
217 extern int lstcon_nodes_stat(int count, lnet_process_id_t *ids_up,
218 int timeout, cfs_list_t *result_up);
219 extern int lstcon_test_add(char *name, int type, int loop, int concur,
220 int dist, int span, char *src_name, char * dst_name,
221 void *param, int paramlen, int *retp,
222 cfs_list_t *result_up);