Whamcloud - gitweb
LU-1716 ptlrpc: Race in updating of connection flags on client.
[fs/lustre-release.git] / lustre / include / obd_support.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.sun.com/software/products/lustre/docs/GPLv2.pdf
19  *
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
22  * have any questions.
23  *
24  * GPL HEADER END
25  */
26 /*
27  * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
28  * Use is subject to license terms.
29  *
30  * Copyright (c) 2011, 2012, Whamcloud, Inc.
31  */
32 /*
33  * This file is part of Lustre, http://www.lustre.org/
34  * Lustre is a trademark of Sun Microsystems, Inc.
35  */
36
37 #ifndef _OBD_SUPPORT
38 #define _OBD_SUPPORT
39
40 #include <libcfs/libcfs.h>
41 #include <lvfs.h>
42 #include <lprocfs_status.h>
43
44 #if defined(__linux__)
45 #include <linux/obd_support.h>
46 #elif defined(__APPLE__)
47 #include <darwin/obd_support.h>
48 #elif defined(__WINNT__)
49 #include <winnt/obd_support.h>
50 #else
51 #error Unsupported operating system.
52 #endif
53
54 /* global variables */
55 extern struct lprocfs_stats *obd_memory;
56 enum {
57         OBD_MEMORY_STAT = 0,
58         OBD_MEMORY_PAGES_STAT = 1,
59         OBD_STATS_NUM,
60 };
61
62 extern unsigned int obd_debug_peer_on_timeout;
63 extern unsigned int obd_dump_on_timeout;
64 extern unsigned int obd_dump_on_eviction;
65 /* obd_timeout should only be used for recovery, not for
66    networking / disk / timings affected by load (use Adaptive Timeouts) */
67 extern unsigned int obd_timeout;          /* seconds */
68 extern unsigned int ldlm_timeout;         /* seconds */
69 extern unsigned int obd_timeout_set;
70 extern unsigned int ldlm_timeout_set;
71 extern unsigned int at_min;
72 extern unsigned int at_max;
73 extern unsigned int at_history;
74 extern int at_early_margin;
75 extern int at_extra;
76 extern unsigned int obd_sync_filter;
77 extern unsigned int obd_max_dirty_pages;
78 extern cfs_atomic_t obd_dirty_pages;
79 extern cfs_atomic_t obd_dirty_transit_pages;
80 extern unsigned int obd_alloc_fail_rate;
81 extern char obd_jobid_var[];
82
83 /* lvfs.c */
84 int obd_alloc_fail(const void *ptr, const char *name, const char *type,
85                    size_t size, const char *file, int line);
86
87 /* Some hash init argument constants */
88 #define HASH_POOLS_BKT_BITS 3
89 #define HASH_POOLS_CUR_BITS 3
90 #define HASH_POOLS_MAX_BITS 7
91 #define HASH_UUID_BKT_BITS 5
92 #define HASH_UUID_CUR_BITS 7
93 #define HASH_UUID_MAX_BITS 12
94 #define HASH_NID_BKT_BITS 5
95 #define HASH_NID_CUR_BITS 7
96 #define HASH_NID_MAX_BITS 12
97 #define HASH_NID_STATS_BKT_BITS 5
98 #define HASH_NID_STATS_CUR_BITS 7
99 #define HASH_NID_STATS_MAX_BITS 12
100 #define HASH_LQS_BKT_BITS 5
101 #define HASH_LQS_CUR_BITS 7
102 #define HASH_LQS_MAX_BITS 12
103 #define HASH_CONN_BKT_BITS 5
104 #define HASH_CONN_CUR_BITS 5
105 #define HASH_CONN_MAX_BITS 15
106 #define HASH_EXP_LOCK_BKT_BITS  5
107 #define HASH_EXP_LOCK_CUR_BITS  7
108 #define HASH_EXP_LOCK_MAX_BITS  16
109 #define HASH_CL_ENV_BKT_BITS    5
110 #define HASH_CL_ENV_BITS        10
111 #define HASH_JOB_STATS_BKT_BITS 5
112 #define HASH_JOB_STATS_CUR_BITS 7
113 #define HASH_JOB_STATS_MAX_BITS 12
114
115 /* Timeout definitions */
116 #define OBD_TIMEOUT_DEFAULT             100
117 #define LDLM_TIMEOUT_DEFAULT            20
118 #define MDS_LDLM_TIMEOUT_DEFAULT        6
119 /* Time to wait for all clients to reconnect during recovery (hard limit) */
120 #define OBD_RECOVERY_TIME_HARD          (obd_timeout * 9)
121 /* Time to wait for all clients to reconnect during recovery (soft limit) */
122 /* Should be very conservative; must catch the first reconnect after reboot */
123 #define OBD_RECOVERY_TIME_SOFT          (obd_timeout * 3)
124 /* Change recovery-small 26b time if you change this */
125 #define PING_INTERVAL max(obd_timeout / 4, 1U)
126 /* a bit more than maximal journal commit time in seconds */
127 #define PING_INTERVAL_SHORT min(PING_INTERVAL, 7U)
128 /* Client may skip 1 ping; we must wait at least 2.5. But for multiple
129  * failover targets the client only pings one server at a time, and pings
130  * can be lost on a loaded network. Since eviction has serious consequences,
131  * and there's no urgent need to evict a client just because it's idle, we
132  * should be very conservative here. */
133 #define PING_EVICT_TIMEOUT (PING_INTERVAL * 6)
134 #define DISK_TIMEOUT 50          /* Beyond this we warn about disk speed */
135 #define CONNECTION_SWITCH_MIN 5U /* Connection switching rate limiter */
136  /* Max connect interval for nonresponsive servers; ~50s to avoid building up
137     connect requests in the LND queues, but within obd_timeout so we don't
138     miss the recovery window */
139 #define CONNECTION_SWITCH_MAX min(50U, max(CONNECTION_SWITCH_MIN,obd_timeout))
140 #define CONNECTION_SWITCH_INC 5  /* Connection timeout backoff */
141 /* In general this should be low to have quick detection of a system
142    running on a backup server. (If it's too low, import_select_connection
143    will increase the timeout anyhow.)  */
144 #define INITIAL_CONNECT_TIMEOUT max(CONNECTION_SWITCH_MIN,obd_timeout/20)
145 /* The max delay between connects is SWITCH_MAX + SWITCH_INC + INITIAL */
146 #define RECONNECT_DELAY_MAX (CONNECTION_SWITCH_MAX + CONNECTION_SWITCH_INC + \
147                              INITIAL_CONNECT_TIMEOUT)
148 /* The min time a target should wait for clients to reconnect in recovery */
149 #define OBD_RECOVERY_TIME_MIN    (2*RECONNECT_DELAY_MAX)
150 #define OBD_IR_FACTOR_MIN         1
151 #define OBD_IR_FACTOR_MAX         10
152 #define OBD_IR_FACTOR_DEFAULT    (OBD_IR_FACTOR_MAX/2)
153 /* default timeout for the MGS to become IR_FULL */
154 #define OBD_IR_MGS_TIMEOUT       (4*obd_timeout)
155 #define LONG_UNLINK 300          /* Unlink should happen before now */
156
157 /**
158  * Time interval of shrink, if the client is "idle" more than this interval,
159  * then the ll_grant thread will return the requested grant space to filter
160  */
161 #define GRANT_SHRINK_INTERVAL            1200/*20 minutes*/
162
163 #define OBD_FAIL_MDS                     0x100
164 #define OBD_FAIL_MDS_HANDLE_UNPACK       0x101
165 #define OBD_FAIL_MDS_GETATTR_NET         0x102
166 #define OBD_FAIL_MDS_GETATTR_PACK        0x103
167 #define OBD_FAIL_MDS_READPAGE_NET        0x104
168 #define OBD_FAIL_MDS_READPAGE_PACK       0x105
169 #define OBD_FAIL_MDS_SENDPAGE            0x106
170 #define OBD_FAIL_MDS_REINT_NET           0x107
171 #define OBD_FAIL_MDS_REINT_UNPACK        0x108
172 #define OBD_FAIL_MDS_REINT_SETATTR       0x109
173 #define OBD_FAIL_MDS_REINT_SETATTR_WRITE 0x10a
174 #define OBD_FAIL_MDS_REINT_CREATE        0x10b
175 #define OBD_FAIL_MDS_REINT_CREATE_WRITE  0x10c
176 #define OBD_FAIL_MDS_REINT_UNLINK        0x10d
177 #define OBD_FAIL_MDS_REINT_UNLINK_WRITE  0x10e
178 #define OBD_FAIL_MDS_REINT_LINK          0x10f
179 #define OBD_FAIL_MDS_REINT_LINK_WRITE    0x110
180 #define OBD_FAIL_MDS_REINT_RENAME        0x111
181 #define OBD_FAIL_MDS_REINT_RENAME_WRITE  0x112
182 #define OBD_FAIL_MDS_OPEN_NET            0x113
183 #define OBD_FAIL_MDS_OPEN_PACK           0x114
184 #define OBD_FAIL_MDS_CLOSE_NET           0x115
185 #define OBD_FAIL_MDS_CLOSE_PACK          0x116
186 #define OBD_FAIL_MDS_CONNECT_NET         0x117
187 #define OBD_FAIL_MDS_CONNECT_PACK        0x118
188 #define OBD_FAIL_MDS_REINT_NET_REP       0x119
189 #define OBD_FAIL_MDS_DISCONNECT_NET      0x11a
190 #define OBD_FAIL_MDS_GETSTATUS_NET       0x11b
191 #define OBD_FAIL_MDS_GETSTATUS_PACK      0x11c
192 #define OBD_FAIL_MDS_STATFS_PACK         0x11d
193 #define OBD_FAIL_MDS_STATFS_NET          0x11e
194 #define OBD_FAIL_MDS_GETATTR_NAME_NET    0x11f
195 #define OBD_FAIL_MDS_PIN_NET             0x120
196 #define OBD_FAIL_MDS_UNPIN_NET           0x121
197 #define OBD_FAIL_MDS_ALL_REPLY_NET       0x122
198 #define OBD_FAIL_MDS_ALL_REQUEST_NET     0x123
199 #define OBD_FAIL_MDS_SYNC_NET            0x124
200 #define OBD_FAIL_MDS_SYNC_PACK           0x125
201 #define OBD_FAIL_MDS_DONE_WRITING_NET    0x126
202 #define OBD_FAIL_MDS_DONE_WRITING_PACK   0x127
203 #define OBD_FAIL_MDS_ALLOC_OBDO          0x128
204 #define OBD_FAIL_MDS_PAUSE_OPEN          0x129
205 #define OBD_FAIL_MDS_STATFS_LCW_SLEEP    0x12a
206 #define OBD_FAIL_MDS_OPEN_CREATE         0x12b
207 #define OBD_FAIL_MDS_OST_SETATTR         0x12c
208 #define OBD_FAIL_MDS_QUOTACHECK_NET      0x12d
209 #define OBD_FAIL_MDS_QUOTACTL_NET        0x12e
210 #define OBD_FAIL_MDS_CLIENT_ADD          0x12f
211 #define OBD_FAIL_MDS_GETXATTR_NET        0x130
212 #define OBD_FAIL_MDS_GETXATTR_PACK       0x131
213 #define OBD_FAIL_MDS_SETXATTR_NET        0x132
214 #define OBD_FAIL_MDS_SETXATTR            0x133
215 #define OBD_FAIL_MDS_SETXATTR_WRITE      0x134
216 #define OBD_FAIL_MDS_FS_SETUP            0x135
217 #define OBD_FAIL_MDS_RESEND              0x136
218 #define OBD_FAIL_MDS_LLOG_CREATE_FAILED  0x137
219 #define OBD_FAIL_MDS_LOV_SYNC_RACE       0x138
220 #define OBD_FAIL_MDS_OSC_PRECREATE       0x139
221 #define OBD_FAIL_MDS_LLOG_SYNC_TIMEOUT   0x13a
222 #define OBD_FAIL_MDS_CLOSE_NET_REP       0x13b
223 #define OBD_FAIL_MDS_BLOCK_QUOTA_REQ     0x13c
224 #define OBD_FAIL_MDS_DROP_QUOTA_REQ      0x13d
225 #define OBD_FAIL_MDS_REMOVE_COMMON_EA    0x13e
226 #define OBD_FAIL_MDS_ALLOW_COMMON_EA_SETTING   0x13f
227 #define OBD_FAIL_MDS_FAIL_LOV_LOG_ADD    0x140
228 #define OBD_FAIL_MDS_LOV_PREP_CREATE     0x141
229 #define OBD_FAIL_MDS_REINT_DELAY         0x142
230 #define OBD_FAIL_MDS_READLINK_EPROTO     0x143
231 #define OBD_FAIL_MDS_OPEN_WAIT_CREATE    0x144
232 #define OBD_FAIL_MDS_PDO_LOCK            0x145
233 #define OBD_FAIL_MDS_PDO_LOCK2           0x146
234 #define OBD_FAIL_MDS_OSC_CREATE_FAIL     0x147
235
236 /* CMD */
237 #define OBD_FAIL_MDS_IS_SUBDIR_NET       0x180
238 #define OBD_FAIL_MDS_IS_SUBDIR_PACK      0x181
239 #define OBD_FAIL_MDS_SET_INFO_NET        0x182
240 #define OBD_FAIL_MDS_WRITEPAGE_NET       0x183
241 #define OBD_FAIL_MDS_WRITEPAGE_PACK      0x184
242 #define OBD_FAIL_MDS_RECOVERY_ACCEPTS_GAPS 0x185
243 #define OBD_FAIL_MDS_GET_INFO_NET        0x186
244 #define OBD_FAIL_MDS_DQACQ_NET           0x187
245
246 /* OI scrub */
247 #define OBD_FAIL_OSD_SCRUB_DELAY         0x190
248 #define OBD_FAIL_OSD_SCRUB_CRASH         0x191
249 #define OBD_FAIL_OSD_SCRUB_FATAL         0x192
250
251 #define OBD_FAIL_OST                     0x200
252 #define OBD_FAIL_OST_CONNECT_NET         0x201
253 #define OBD_FAIL_OST_DISCONNECT_NET      0x202
254 #define OBD_FAIL_OST_GET_INFO_NET        0x203
255 #define OBD_FAIL_OST_CREATE_NET          0x204
256 #define OBD_FAIL_OST_DESTROY_NET         0x205
257 #define OBD_FAIL_OST_GETATTR_NET         0x206
258 #define OBD_FAIL_OST_SETATTR_NET         0x207
259 #define OBD_FAIL_OST_OPEN_NET            0x208
260 #define OBD_FAIL_OST_CLOSE_NET           0x209
261 #define OBD_FAIL_OST_BRW_NET             0x20a
262 #define OBD_FAIL_OST_PUNCH_NET           0x20b
263 #define OBD_FAIL_OST_STATFS_NET          0x20c
264 #define OBD_FAIL_OST_HANDLE_UNPACK       0x20d
265 #define OBD_FAIL_OST_BRW_WRITE_BULK      0x20e
266 #define OBD_FAIL_OST_BRW_READ_BULK       0x20f
267 #define OBD_FAIL_OST_SYNC_NET            0x210
268 #define OBD_FAIL_OST_ALL_REPLY_NET       0x211
269 #define OBD_FAIL_OST_ALL_REQUEST_NET     0x212
270 #define OBD_FAIL_OST_LDLM_REPLY_NET      0x213
271 #define OBD_FAIL_OST_BRW_PAUSE_BULK      0x214
272 #define OBD_FAIL_OST_ENOSPC              0x215
273 #define OBD_FAIL_OST_EROFS               0x216
274 #define OBD_FAIL_OST_ENOENT              0x217
275 #define OBD_FAIL_OST_QUOTACHECK_NET      0x218
276 #define OBD_FAIL_OST_QUOTACTL_NET        0x219
277 #define OBD_FAIL_OST_CHECKSUM_RECEIVE    0x21a
278 #define OBD_FAIL_OST_CHECKSUM_SEND       0x21b
279 #define OBD_FAIL_OST_BRW_SIZE            0x21c
280 #define OBD_FAIL_OST_DROP_REQ            0x21d
281 #define OBD_FAIL_OST_SETATTR_CREDITS     0x21e
282 #define OBD_FAIL_OST_HOLD_WRITE_RPC      0x21f
283 #define OBD_FAIL_OST_BRW_WRITE_BULK2     0x220
284 #define OBD_FAIL_OST_LLOG_RECOVERY_TIMEOUT 0x221
285 #define OBD_FAIL_OST_CANCEL_COOKIE_TIMEOUT 0x222
286 #define OBD_FAIL_OST_PAUSE_CREATE        0x223
287 #define OBD_FAIL_OST_BRW_PAUSE_PACK      0x224
288 #define OBD_FAIL_OST_CONNECT_NET2        0x225
289 #define OBD_FAIL_OST_NOMEM               0x226
290 #define OBD_FAIL_OST_BRW_PAUSE_BULK2     0x227
291 #define OBD_FAIL_OST_MAPBLK_ENOSPC       0x228
292 #define OBD_FAIL_OST_ENOINO              0x229
293 #define OBD_FAIL_OST_DQACQ_NET           0x230
294 #define OBD_FAIL_OST_STATFS_EINPROGRESS  0x231
295
296 #define OBD_FAIL_LDLM                    0x300
297 #define OBD_FAIL_LDLM_NAMESPACE_NEW      0x301
298 #define OBD_FAIL_LDLM_ENQUEUE            0x302
299 #define OBD_FAIL_LDLM_CONVERT            0x303
300 #define OBD_FAIL_LDLM_CANCEL             0x304
301 #define OBD_FAIL_LDLM_BL_CALLBACK        0x305
302 #define OBD_FAIL_LDLM_CP_CALLBACK        0x306
303 #define OBD_FAIL_LDLM_GL_CALLBACK        0x307
304 #define OBD_FAIL_LDLM_ENQUEUE_EXTENT_ERR 0x308
305 #define OBD_FAIL_LDLM_ENQUEUE_INTENT_ERR 0x309
306 #define OBD_FAIL_LDLM_CREATE_RESOURCE    0x30a
307 #define OBD_FAIL_LDLM_ENQUEUE_BLOCKED    0x30b
308 #define OBD_FAIL_LDLM_REPLY              0x30c
309 #define OBD_FAIL_LDLM_RECOV_CLIENTS      0x30d
310 #define OBD_FAIL_LDLM_ENQUEUE_OLD_EXPORT 0x30e
311 #define OBD_FAIL_LDLM_GLIMPSE            0x30f
312 #define OBD_FAIL_LDLM_CANCEL_RACE        0x310
313 #define OBD_FAIL_LDLM_CANCEL_EVICT_RACE  0x311
314 #define OBD_FAIL_LDLM_PAUSE_CANCEL       0x312
315 #define OBD_FAIL_LDLM_CLOSE_THREAD       0x313
316 #define OBD_FAIL_LDLM_CANCEL_BL_CB_RACE  0x314
317 #define OBD_FAIL_LDLM_CP_CB_WAIT         0x315
318 #define OBD_FAIL_LDLM_OST_FAIL_RACE      0x316
319 #define OBD_FAIL_LDLM_INTR_CP_AST        0x317
320 #define OBD_FAIL_LDLM_CP_BL_RACE         0x318
321 #define OBD_FAIL_LDLM_NEW_LOCK           0x319
322 #define OBD_FAIL_LDLM_AGL_DELAY          0x31a
323 #define OBD_FAIL_LDLM_AGL_NOLOCK         0x31b
324
325 /* LOCKLESS IO */
326 #define OBD_FAIL_LDLM_SET_CONTENTION     0x385
327
328 #define OBD_FAIL_OSC                     0x400
329 #define OBD_FAIL_OSC_BRW_READ_BULK       0x401
330 #define OBD_FAIL_OSC_BRW_WRITE_BULK      0x402
331 #define OBD_FAIL_OSC_LOCK_BL_AST         0x403
332 #define OBD_FAIL_OSC_LOCK_CP_AST         0x404
333 #define OBD_FAIL_OSC_MATCH               0x405
334 #define OBD_FAIL_OSC_BRW_PREP_REQ        0x406
335 #define OBD_FAIL_OSC_SHUTDOWN            0x407
336 #define OBD_FAIL_OSC_CHECKSUM_RECEIVE    0x408
337 #define OBD_FAIL_OSC_CHECKSUM_SEND       0x409
338 #define OBD_FAIL_OSC_BRW_PREP_REQ2       0x40a
339 #define OBD_FAIL_OSC_CONNECT_CKSUM       0x40b
340 #define OBD_FAIL_OSC_CKSUM_ADLER_ONLY    0x40c
341 #define OBD_FAIL_OSC_DIO_PAUSE           0x40d
342 #define OBD_FAIL_OSC_OBJECT_CONTENTION   0x40e
343 #define OBD_FAIL_OSC_CP_CANCEL_RACE      0x40f
344 #define OBD_FAIL_OSC_CP_ENQ_RACE         0x410
345 #define OBD_FAIL_OSC_NO_GRANT            0x411
346 #define OBD_FAIL_OSC_DELAY_SETTIME       0x412
347
348 #define OBD_FAIL_PTLRPC                  0x500
349 #define OBD_FAIL_PTLRPC_ACK              0x501
350 #define OBD_FAIL_PTLRPC_RQBD             0x502
351 #define OBD_FAIL_PTLRPC_BULK_GET_NET     0x503
352 #define OBD_FAIL_PTLRPC_BULK_PUT_NET     0x504
353 #define OBD_FAIL_PTLRPC_DROP_RPC         0x505
354 #define OBD_FAIL_PTLRPC_DELAY_SEND       0x506
355 #define OBD_FAIL_PTLRPC_DELAY_RECOV      0x507
356 #define OBD_FAIL_PTLRPC_CLIENT_BULK_CB   0x508
357 #define OBD_FAIL_PTLRPC_PAUSE_REQ        0x50a
358 #define OBD_FAIL_PTLRPC_PAUSE_REP        0x50c
359 #define OBD_FAIL_PTLRPC_IMP_DEACTIVE     0x50d
360 #define OBD_FAIL_PTLRPC_DUMP_LOG         0x50e
361 #define OBD_FAIL_PTLRPC_LONG_REPL_UNLINK 0x50f
362 #define OBD_FAIL_PTLRPC_LONG_BULK_UNLINK 0x510
363 #define OBD_FAIL_PTLRPC_HPREQ_TIMEOUT    0x511
364 #define OBD_FAIL_PTLRPC_HPREQ_NOTIMEOUT  0x512
365 #define OBD_FAIL_PTLRPC_DROP_REQ_OPC     0x513
366 #define OBD_FAIL_PTLRPC_FINISH_REPLAY    0x514
367 #define OBD_FAIL_PTLRPC_CLIENT_BULK_CB2  0x515
368 #define OBD_FAIL_PTLRPC_DELAY_IMP_FULL   0x516
369
370 #define OBD_FAIL_OBD_PING_NET            0x600
371 #define OBD_FAIL_OBD_LOG_CANCEL_NET      0x601
372 #define OBD_FAIL_OBD_LOGD_NET            0x602
373 #define OBD_FAIL_OBD_QC_CALLBACK_NET     0x603
374 #define OBD_FAIL_OBD_DQACQ               0x604
375 #define OBD_FAIL_OBD_LLOG_SETUP          0x605
376 #define OBD_FAIL_OBD_LOG_CANCEL_REP      0x606
377
378 #define OBD_FAIL_TGT_REPLY_NET           0x700
379 #define OBD_FAIL_TGT_CONN_RACE           0x701
380 #define OBD_FAIL_TGT_FORCE_RECONNECT     0x702
381 #define OBD_FAIL_TGT_DELAY_CONNECT       0x703
382 #define OBD_FAIL_TGT_DELAY_RECONNECT     0x704
383 #define OBD_FAIL_TGT_DELAY_PRECREATE     0x705
384 #define OBD_FAIL_TGT_TOOMANY_THREADS     0x706
385 #define OBD_FAIL_TGT_REPLAY_DROP         0x707
386 #define OBD_FAIL_TGT_FAKE_EXP            0x708
387 #define OBD_FAIL_TGT_REPLAY_DELAY        0x709
388 #define OBD_FAIL_TGT_LAST_REPLAY         0x710
389 #define OBD_FAIL_TGT_CLIENT_ADD          0x711
390 #define OBD_FAIL_TGT_RCVG_FLAG           0x712
391
392 #define OBD_FAIL_MDC_REVALIDATE_PAUSE    0x800
393 #define OBD_FAIL_MDC_ENQUEUE_PAUSE       0x801
394 #define OBD_FAIL_MDC_OLD_EXT_FLAGS       0x802
395 #define OBD_FAIL_MDC_GETATTR_ENQUEUE     0x803
396 #define OBD_FAIL_MDC_RPCS_SEM            0x804
397
398 #define OBD_FAIL_MGS                     0x900
399 #define OBD_FAIL_MGS_ALL_REQUEST_NET     0x901
400 #define OBD_FAIL_MGS_ALL_REPLY_NET       0x902
401 #define OBD_FAIL_MGC_PAUSE_PROCESS_LOG   0x903
402 #define OBD_FAIL_MGS_PAUSE_REQ           0x904
403 #define OBD_FAIL_MGS_PAUSE_TARGET_REG    0x905
404
405 #define OBD_FAIL_QUOTA_RET_QDATA         0xA02
406 #define OBD_FAIL_QUOTA_DELAY_REL         0xA03
407 #define OBD_FAIL_QUOTA_DELAY_SD          0xA04
408
409 #define OBD_FAIL_LPROC_REMOVE            0xB00
410
411 #define OBD_FAIL_GENERAL_ALLOC           0xC00
412
413 #define OBD_FAIL_SEQ                     0x1000
414 #define OBD_FAIL_SEQ_QUERY_NET           0x1001
415
416 #define OBD_FAIL_FLD                     0x1100
417 #define OBD_FAIL_FLD_QUERY_NET           0x1101
418
419 #define OBD_FAIL_SEC_CTX                 0x1200
420 #define OBD_FAIL_SEC_CTX_INIT_NET        0x1201
421 #define OBD_FAIL_SEC_CTX_INIT_CONT_NET   0x1202
422 #define OBD_FAIL_SEC_CTX_FINI_NET        0x1203
423 #define OBD_FAIL_SEC_CTX_HDL_PAUSE       0x1204
424
425 #define OBD_FAIL_LLOG                               0x1300
426 #define OBD_FAIL_LLOG_ORIGIN_CONNECT_NET            0x1301
427 #define OBD_FAIL_LLOG_ORIGIN_HANDLE_CREATE_NET      0x1302
428 #define OBD_FAIL_LLOG_ORIGIN_HANDLE_DESTROY_NET     0x1303
429 #define OBD_FAIL_LLOG_ORIGIN_HANDLE_READ_HEADER_NET 0x1304
430 #define OBD_FAIL_LLOG_ORIGIN_HANDLE_NEXT_BLOCK_NET  0x1305
431 #define OBD_FAIL_LLOG_ORIGIN_HANDLE_PREV_BLOCK_NET  0x1306
432 #define OBD_FAIL_LLOG_ORIGIN_HANDLE_WRITE_REC_NET   0x1307
433 #define OBD_FAIL_LLOG_ORIGIN_HANDLE_CLOSE_NET       0x1308
434 #define OBD_FAIL_LLOG_CATINFO_NET                   0x1309
435 #define OBD_FAIL_MDS_SYNC_CAPA_SL                   0x1310
436 #define OBD_FAIL_SEQ_ALLOC                          0x1311
437
438 #define OBD_FAIL_LLITE                              0x1400
439 #define OBD_FAIL_LLITE_FAULT_TRUNC_RACE             0x1401
440 #define OBD_FAIL_LOCK_STATE_WAIT_INTR               0x1402
441 #define OBD_FAIL_LOV_INIT                           0x1403
442
443 /* Assign references to moved code to reduce code changes */
444 #define OBD_FAIL_PRECHECK(id)                   CFS_FAIL_PRECHECK(id)
445 #define OBD_FAIL_CHECK(id)                      CFS_FAIL_CHECK(id)
446 #define OBD_FAIL_CHECK_VALUE(id, value)         CFS_FAIL_CHECK_VALUE(id, value)
447 #define OBD_FAIL_CHECK_ORSET(id, value)         CFS_FAIL_CHECK_ORSET(id, value)
448 #define OBD_FAIL_CHECK_RESET(id, value)         CFS_FAIL_CHECK_RESET(id, value)
449 #define OBD_FAIL_RETURN(id, ret)                CFS_FAIL_RETURN(id, ret)
450 #define OBD_FAIL_TIMEOUT(id, secs)              CFS_FAIL_TIMEOUT(id, secs)
451 #define OBD_FAIL_TIMEOUT_MS(id, ms)             CFS_FAIL_TIMEOUT_MS(id, ms)
452 #define OBD_FAIL_TIMEOUT_ORSET(id, value, secs) CFS_FAIL_TIMEOUT_ORSET(id, value, secs)
453 #define OBD_RACE(id)                            CFS_RACE(id)
454 #define OBD_FAIL_ONCE                           CFS_FAIL_ONCE
455 #define OBD_FAILED                              CFS_FAILED
456
457 extern cfs_atomic_t libcfs_kmemory;
458
459 #ifdef LPROCFS
460 #define obd_memory_add(size)                                                  \
461         lprocfs_counter_add(obd_memory, OBD_MEMORY_STAT, (long)(size))
462 #define obd_memory_sub(size)                                                  \
463         lprocfs_counter_sub(obd_memory, OBD_MEMORY_STAT, (long)(size))
464 #define obd_memory_sum()                                                      \
465         lprocfs_stats_collector(obd_memory, OBD_MEMORY_STAT,                  \
466                                 LPROCFS_FIELDS_FLAGS_SUM)
467 #define obd_pages_add(order)                                                  \
468         lprocfs_counter_add(obd_memory, OBD_MEMORY_PAGES_STAT,                \
469                             (long)(1 << (order)))
470 #define obd_pages_sub(order)                                                  \
471         lprocfs_counter_sub(obd_memory, OBD_MEMORY_PAGES_STAT,                \
472                             (long)(1 << (order)))
473 #define obd_pages_sum()                                                       \
474         lprocfs_stats_collector(obd_memory, OBD_MEMORY_PAGES_STAT,            \
475                                 LPROCFS_FIELDS_FLAGS_SUM)
476
477 extern void obd_update_maxusage(void);
478 extern __u64 obd_memory_max(void);
479 extern __u64 obd_pages_max(void);
480
481 #else
482
483 extern __u64 obd_alloc;
484 extern __u64 obd_pages;
485
486 extern __u64 obd_max_alloc;
487 extern __u64 obd_max_pages;
488
489 static inline void obd_memory_add(long size)
490 {
491         obd_alloc += size;
492         if (obd_alloc > obd_max_alloc)
493                 obd_max_alloc = obd_alloc;
494 }
495
496 static inline void obd_memory_sub(long size)
497 {
498         obd_alloc -= size;
499 }
500
501 static inline void obd_pages_add(int order)
502 {
503         obd_pages += 1<< order;
504         if (obd_pages > obd_max_pages)
505                 obd_max_pages = obd_pages;
506 }
507
508 static inline void obd_pages_sub(int order)
509 {
510         obd_pages -= 1<< order;
511 }
512
513 #define obd_memory_sum() (obd_alloc)
514 #define obd_pages_sum()  (obd_pages)
515
516 #define obd_memory_max() (obd_max_alloc)
517 #define obd_pages_max() (obd_max_pages)
518
519 #endif
520
521 #define OBD_DEBUG_MEMUSAGE (1)
522
523 #if OBD_DEBUG_MEMUSAGE
524 #define OBD_ALLOC_POST(ptr, size, name)                                 \
525                 obd_memory_add(size);                                   \
526                 CDEBUG(D_MALLOC, name " '" #ptr "': %d at %p.\n",       \
527                        (int)(size), ptr)
528
529 #define OBD_FREE_PRE(ptr, size, name)                                   \
530         LASSERT(ptr);                                                   \
531         obd_memory_sub(size);                                           \
532         CDEBUG(D_MALLOC, name " '" #ptr "': %d at %p.\n",               \
533                (int)(size), ptr);                                       \
534         POISON(ptr, 0x5a, size)
535
536 #else /* !OBD_DEBUG_MEMUSAGE */
537
538 #define OBD_ALLOC_POST(ptr, size, name) ((void)0)
539 #define OBD_FREE_PRE(ptr, size, name)   ((void)0)
540
541 #endif /* !OBD_DEBUG_MEMUSAGE */
542
543 #ifdef RANDOM_FAIL_ALLOC
544 #define HAS_FAIL_ALLOC_FLAG OBD_FAIL_CHECK(OBD_FAIL_GENERAL_ALLOC)
545 #else
546 #define HAS_FAIL_ALLOC_FLAG 0
547 #endif
548
549 #define OBD_ALLOC_FAIL_BITS 24
550 #define OBD_ALLOC_FAIL_MASK ((1 << OBD_ALLOC_FAIL_BITS) - 1)
551 #define OBD_ALLOC_FAIL_MULT (OBD_ALLOC_FAIL_MASK / 100)
552
553 #if defined(LUSTRE_UTILS) /* this version is for utils only */
554 #define __OBD_MALLOC_VERBOSE(ptr, cptab, cpt, size, flags)                    \
555 do {                                                                          \
556         (ptr) = (cptab) == NULL ?                                             \
557                 cfs_alloc(size, flags) :                                      \
558                 cfs_cpt_malloc(cptab, cpt, size, flags);                      \
559         if (unlikely((ptr) == NULL)) {                                        \
560                 CERROR("kmalloc of '" #ptr "' (%d bytes) failed at %s:%d\n",  \
561                        (int)(size), __FILE__, __LINE__);                      \
562         } else {                                                              \
563                 memset(ptr, 0, size);                                         \
564                 CDEBUG(D_MALLOC, "kmalloced '" #ptr "': %d at %p\n",          \
565                        (int)(size), ptr);                                     \
566         }                                                                     \
567 } while (0)
568
569 #else /* this version is for the kernel and liblustre */
570 #define OBD_FREE_RTN0(ptr)                                                    \
571 ({                                                                            \
572         cfs_free(ptr);                                                        \
573         (ptr) = NULL;                                                         \
574         0;                                                                    \
575 })
576
577 #define __OBD_MALLOC_VERBOSE(ptr, cptab, cpt, size, flags)                    \
578 do {                                                                          \
579         (ptr) = (cptab) == NULL ?                                             \
580                 cfs_alloc(size, flags) :                                      \
581                 cfs_cpt_malloc(cptab, cpt, size, flags);                      \
582         if (likely((ptr) != NULL &&                                           \
583                    (!HAS_FAIL_ALLOC_FLAG || obd_alloc_fail_rate == 0 ||       \
584                     !obd_alloc_fail(ptr, #ptr, "km", size,                    \
585                                     __FILE__, __LINE__) ||                    \
586                     OBD_FREE_RTN0(ptr)))){                                    \
587                 memset(ptr, 0, size);                                         \
588                 OBD_ALLOC_POST(ptr, size, "kmalloced");                       \
589         }                                                                     \
590 } while (0)
591 #endif
592
593 #define OBD_ALLOC_GFP(ptr, size, gfp_mask)                                    \
594         __OBD_MALLOC_VERBOSE(ptr, NULL, 0, size, gfp_mask)
595
596 #define OBD_ALLOC(ptr, size) OBD_ALLOC_GFP(ptr, size, CFS_ALLOC_IO)
597 #define OBD_ALLOC_WAIT(ptr, size) OBD_ALLOC_GFP(ptr, size, CFS_ALLOC_STD)
598 #define OBD_ALLOC_PTR(ptr) OBD_ALLOC(ptr, sizeof *(ptr))
599 #define OBD_ALLOC_PTR_WAIT(ptr) OBD_ALLOC_WAIT(ptr, sizeof *(ptr))
600
601 #define OBD_CPT_ALLOC_GFP(ptr, cptab, cpt, size, gfp_mask)                    \
602         __OBD_MALLOC_VERBOSE(ptr, cptab, cpt, size, gfp_mask)
603
604 #define OBD_CPT_ALLOC(ptr, cptab, cpt, size)                                  \
605         OBD_CPT_ALLOC_GFP(ptr, cptab, cpt, size, CFS_ALLOC_IO)
606
607 #define OBD_CPT_ALLOC_PTR(ptr, cptab, cpt)                                    \
608         OBD_CPT_ALLOC(ptr, cptab, cpt, sizeof *(ptr))
609
610 #ifdef __arch_um__
611
612 # define OBD_VMALLOC(ptr, size)                                               \
613          OBD_ALLOC(ptr, size)
614 # define OBD_CPT_VMALLOC(ptr, cptab, cpt, size)                               \
615          OBD_CPT_ALLOC(ptr, cptab, cpt, size)
616
617 #else /* !__arch_um__ */
618
619 # define __OBD_VMALLOC_VEROBSE(ptr, cptab, cpt, size)                         \
620 do {                                                                          \
621         (ptr) = cptab == NULL ?                                               \
622                 cfs_alloc_large(size) :                                       \
623                 cfs_cpt_vmalloc(cptab, cpt, size);                            \
624         if (unlikely((ptr) == NULL)) {                                        \
625                 CERROR("vmalloc of '" #ptr "' (%d bytes) failed\n",           \
626                        (int)(size));                                          \
627                 CERROR(LPU64" total bytes allocated by Lustre, %d by LNET\n", \
628                        obd_memory_sum(), cfs_atomic_read(&libcfs_kmemory));   \
629         } else {                                                              \
630                 memset(ptr, 0, size);                                         \
631                 OBD_ALLOC_POST(ptr, size, "vmalloced");                       \
632         }                                                                     \
633 } while(0)
634
635 # define OBD_VMALLOC(ptr, size)                                               \
636          __OBD_VMALLOC_VEROBSE(ptr, NULL, 0, size)
637 # define OBD_CPT_VMALLOC(ptr, cptab, cpt, size)                               \
638          __OBD_VMALLOC_VEROBSE(ptr, cptab, cpt, size)
639
640 #endif
641
642 #ifdef __KERNEL__
643
644 /* Allocations above this size are considered too big and could not be done
645  * atomically.
646  *
647  * Be very careful when changing this value, especially when decreasing it,
648  * since vmalloc in Linux doesn't perform well on multi-cores system, calling
649  * vmalloc in critical path would hurt peformance badly. See LU-66.
650  */
651 #define OBD_ALLOC_BIG (4 * CFS_PAGE_SIZE)
652
653 #define OBD_ALLOC_LARGE(ptr, size)                                            \
654 do {                                                                          \
655         if (size > OBD_ALLOC_BIG)                                             \
656                 OBD_VMALLOC(ptr, size);                                       \
657         else                                                                  \
658                 OBD_ALLOC(ptr, size);                                         \
659 } while (0)
660
661 #define OBD_CPT_ALLOC_LARGE(ptr, cptab, cpt, size)                            \
662 do {                                                                          \
663         if (size > OBD_ALLOC_BIG)                                             \
664                 OBD_CPT_VMALLOC(ptr, cptab, cpt, size);                       \
665         else                                                                  \
666                 OBD_CPT_ALLOC(ptr, cptab, cpt, size);                         \
667 } while (0)
668
669 #define OBD_FREE_LARGE(ptr, size)                                             \
670 do {                                                                          \
671         if (size > OBD_ALLOC_BIG)                                             \
672                 OBD_VFREE(ptr, size);                                         \
673         else                                                                  \
674                 OBD_FREE(ptr, size);                                          \
675 } while (0)
676
677 #else /* !__KERNEL__ */
678
679 #define OBD_ALLOC_LARGE(ptr, size)                                            \
680         OBD_ALLOC(ptr, size)
681 #define OBD_CPT_ALLOC_LARGE(ptr, cptab, cpt, size)                            \
682         OBD_ALLOC(ptr, size)
683 #define OBD_FREE_LARGE(ptr, size)                                             \
684         OBD_FREE(ptr, size)
685
686 #endif /* __KERNEL__ */
687
688 #ifdef CONFIG_DEBUG_SLAB
689 #define POISON(ptr, c, s) do {} while (0)
690 #define POISON_PTR(ptr)  ((void)0)
691 #else
692 #define POISON(ptr, c, s) memset(ptr, c, s)
693 #define POISON_PTR(ptr)  (ptr) = (void *)0xdeadbeef
694 #endif
695
696 #ifdef POISON_BULK
697 #define POISON_PAGE(page, val) do { memset(kmap(page), val, CFS_PAGE_SIZE);   \
698                                     kunmap(page); } while (0)
699 #else
700 #define POISON_PAGE(page, val) do { } while (0)
701 #endif
702
703 #ifdef __KERNEL__
704 #define OBD_FREE(ptr, size)                                                   \
705 do {                                                                          \
706         OBD_FREE_PRE(ptr, size, "kfreed");                                    \
707         cfs_free(ptr);                                                        \
708         POISON_PTR(ptr);                                                      \
709 } while(0)
710
711
712 #define OBD_FREE_RCU(ptr, size, handle)                                       \
713 do {                                                                          \
714         struct portals_handle *__h = (handle);                                \
715                                                                               \
716         LASSERT(handle != NULL);                                              \
717         __h->h_cookie = (unsigned long)(ptr);                                 \
718         __h->h_size = (size);                                                 \
719         call_rcu(&__h->h_rcu, class_handle_free_cb);                          \
720         POISON_PTR(ptr);                                                      \
721 } while(0)
722
723 #else
724 #define OBD_FREE(ptr, size) ((void)(size), free((ptr)))
725 #define OBD_FREE_RCU(ptr, size, handle) (OBD_FREE(ptr, size))
726 #endif /* ifdef __KERNEL__ */
727
728 #ifdef __arch_um__
729 # define OBD_VFREE(ptr, size) OBD_FREE(ptr, size)
730 #else
731 # define OBD_VFREE(ptr, size)                                                 \
732 do {                                                                          \
733         OBD_FREE_PRE(ptr, size, "vfreed");                                    \
734         cfs_free_large(ptr);                                                  \
735         POISON_PTR(ptr);                                                      \
736 } while(0)
737 #endif
738
739 /* we memset() the slab object to 0 when allocation succeeds, so DO NOT
740  * HAVE A CTOR THAT DOES ANYTHING.  its work will be cleared here.  we'd
741  * love to assert on that, but slab.c keeps kmem_cache_s all to itself. */
742 #define OBD_SLAB_FREE_RTN0(ptr, slab)                                         \
743 ({                                                                            \
744         cfs_mem_cache_free((slab), (ptr));                                    \
745         (ptr) = NULL;                                                         \
746         0;                                                                    \
747 })
748
749 #define __OBD_SLAB_ALLOC_VERBOSE(ptr, slab, cptab, cpt, size, type)           \
750 do {                                                                          \
751         LASSERT(ergo(type != CFS_ALLOC_ATOMIC, !cfs_in_interrupt()));         \
752         (ptr) = (cptab) == NULL ?                                             \
753                 cfs_mem_cache_alloc(slab, type) :                             \
754                 cfs_mem_cache_cpt_alloc(slab, cptab, cpt, type);              \
755         if (likely((ptr) != NULL &&                                           \
756                    (!HAS_FAIL_ALLOC_FLAG || obd_alloc_fail_rate == 0 ||       \
757                     !obd_alloc_fail(ptr, #ptr, "slab-", size,                 \
758                                     __FILE__, __LINE__) ||                    \
759                     OBD_SLAB_FREE_RTN0(ptr, slab)))) {                        \
760                 memset(ptr, 0, size);                                         \
761                 OBD_ALLOC_POST(ptr, size, "slab-alloced");                    \
762         }                                                                     \
763 } while(0)
764
765 #define OBD_SLAB_ALLOC_GFP(ptr, slab, size, flags)                            \
766         __OBD_SLAB_ALLOC_VERBOSE(ptr, slab, NULL, 0, size, flags)
767 #define OBD_SLAB_CPT_ALLOC_GFP(ptr, slab, cptab, cpt, size, flags)            \
768         __OBD_SLAB_ALLOC_VERBOSE(ptr, slab, cptab, cpt, size, flags)
769
770 #define OBD_FREE_PTR(ptr) OBD_FREE(ptr, sizeof *(ptr))
771
772 #define OBD_SLAB_FREE(ptr, slab, size)                                        \
773 do {                                                                          \
774         OBD_FREE_PRE(ptr, size, "slab-freed");                                \
775         cfs_mem_cache_free(slab, ptr);                                        \
776         POISON_PTR(ptr);                                                      \
777 } while(0)
778
779 #define OBD_SLAB_ALLOC(ptr, slab, size)                                       \
780         OBD_SLAB_ALLOC_GFP(ptr, slab, size, CFS_ALLOC_IO)
781
782 #define OBD_SLAB_CPT_ALLOC(ptr, slab, cptab, cpt, size)                       \
783         OBD_SLAB_CPT_ALLOC_GFP(ptr, slab, cptab, cpt, size, CFS_ALLOC_IO)
784
785 #define OBD_SLAB_ALLOC_PTR(ptr, slab)                                         \
786         OBD_SLAB_ALLOC(ptr, slab, sizeof *(ptr))
787
788 #define OBD_SLAB_CPT_ALLOC_PTR(ptr, slab, cptab, cpt)                         \
789         OBD_SLAB_CPT_ALLOC(ptr, slab, cptab, cpt, sizeof *(ptr))
790
791 #define OBD_SLAB_ALLOC_PTR_GFP(ptr, slab, flags)                              \
792         OBD_SLAB_ALLOC_GFP(ptr, slab, sizeof *(ptr), flags)
793
794 #define OBD_SLAB_CPT_ALLOC_PTR_GFP(ptr, slab, ctab, cpt, flags)               \
795         OBD_SLAB_CPT_ALLOC_GFP(ptr, slab, cptab, cpt, sizeof *(ptr), flags)
796
797 #define OBD_SLAB_FREE_PTR(ptr, slab)                                          \
798         OBD_SLAB_FREE((ptr), (slab), sizeof *(ptr))
799
800 #define KEY_IS(str) \
801         (keylen >= (sizeof(str)-1) && memcmp(key, str, (sizeof(str)-1)) == 0)
802
803 /* Wrapper for contiguous page frame allocation */
804 #define __OBD_PAGE_ALLOC_VERBOSE(ptr, cptab, cpt, gfp_mask)                   \
805 do {                                                                          \
806         (ptr) = (cptab) == NULL ?                                             \
807                 cfs_alloc_page(gfp_mask) :                                    \
808                 cfs_page_cpt_alloc(cptab, cpt, gfp_mask);                     \
809         if (unlikely((ptr) == NULL)) {                                        \
810                 CERROR("alloc_pages of '" #ptr "' %d page(s) / "LPU64" bytes "\
811                        "failed\n", (int)1,                                    \
812                        (__u64)(1 << CFS_PAGE_SHIFT));                         \
813                 CERROR(LPU64" total bytes and "LPU64" total pages "           \
814                        "("LPU64" bytes) allocated by Lustre, "                \
815                        "%d total bytes by LNET\n",                            \
816                        obd_memory_sum(),                                      \
817                        obd_pages_sum() << CFS_PAGE_SHIFT,                     \
818                        obd_pages_sum(),                                       \
819                        cfs_atomic_read(&libcfs_kmemory));                     \
820         } else {                                                              \
821                 obd_pages_add(0);                                             \
822                 CDEBUG(D_MALLOC, "alloc_pages '" #ptr "': %d page(s) / "      \
823                        LPU64" bytes at %p.\n",                                \
824                        (int)1,                                                \
825                        (__u64)(1 << CFS_PAGE_SHIFT), ptr);                    \
826         }                                                                     \
827 } while (0)
828
829 #define OBD_PAGE_ALLOC(ptr, gfp_mask)                                         \
830         __OBD_PAGE_ALLOC_VERBOSE(ptr, NULL, 0, gfp_mask)
831 #define OBD_PAGE_CPT_ALLOC(ptr, cptab, cpt, gfp_mask)                         \
832         __OBD_PAGE_ALLOC_VERBOSE(ptr, cptab, cpt, gfp_mask)
833
834 #define OBD_PAGE_FREE(ptr)                                                    \
835 do {                                                                          \
836         LASSERT(ptr);                                                         \
837         obd_pages_sub(0);                                                     \
838         CDEBUG(D_MALLOC, "free_pages '" #ptr "': %d page(s) / "LPU64" bytes " \
839                "at %p.\n",                                                    \
840                (int)1, (__u64)(1 << CFS_PAGE_SHIFT),                          \
841                ptr);                                                          \
842         cfs_free_page(ptr);                                                   \
843         (ptr) = (void *)0xdeadbeef;                                           \
844 } while (0)
845
846 #endif