viced ihandle boost
[openafs.git] / src / vol / ihandle.h
1 /*
2  * Copyright 2000, International Business Machines Corporation and others.
3  * All Rights Reserved.
4  * 
5  * This software has been released under the terms of the IBM Public
6  * License.  For details, see the LICENSE file in the top-level source
7  * directory or online at http://www.openafs.org/dl/license10.html
8  */
9
10 /* An IHandle_t is an abstraction allowing the file and volume operations to
11  * pass the elements required to identify a file to the underlying file
12  * systen. For the usual Vice inode operations, this is no more than the
13  * usual device and inode numbers. For the user space file system used on NT
14  * we also need the volume id to identify the file. 
15  *
16  * An FdHandle_t is an abstraction used to associate file descroptors
17  * with Inode handles. IH_OPEN is used to get a file descriptor that
18  * can be used in subsequent I/O operations. File descriptor handles are
19  * cached by IO_CLOSE. To make sure a file descriptor is really closed call
20  * IH_REALLYCLOSE.
21  *
22  * The IHandle_t also provides a place to do other optimizations. In the
23  * NT user space file system, we keep a separate special file for the
24  * link counts and using the IHandle_t allows keeping the details of
25  * that at a lower level than the IDEC and IINC calls.
26  *
27  * To use the IHandle_t there are a new set of IH_xxxx/FDH_XXXX operations.
28  * Each takes a pointer to an IHandle_t or an FdHandle_t as the first
29  * argument. This pointer is  considered an in/out variable. In particular,
30  * the open file descriptors for a given Inode are stored in a linked list
31  * of FdHandle_t hanging off of each IHandle_t. IH_OPEN returns NULL on error,
32  * and a valid FdHandle_t otherwise. All other IH_xxxx/FDH_xxxx macros return
33  * -1 on error and 0 on success.
34  *
35  * Inode handle operations:
36  * IH_INIT - Initialize the Inode handle with the device, volume id, and ino
37  * IH_COPY - Copy Inode handle info to a new handle with no open descriptors.
38  * IH_REALLYCLOSE - Close all cached file descriptors for Inode handle
39  * IH_RELEASE - release a Inode handle, close all cached file descriptors
40  * IH_CONDSYNC -  snyc the Inode if it has any open file descriptors
41  *
42  * Inode operation replacements:
43  * IH_CREATE - create a file in the underlying filesystem and setup the
44  *      information needed to reference this file in the IHandle_t.
45  * IH_OPEN - open the file belonging to the associated inode and set the
46  *      file descriptor.
47  * IH_IREAD/IH_IWRITE - read/write an Inode.
48  * IH_INC/IH_DEC - increment/decrement the link count.
49  *
50  * Replacements for C runtime file operations
51  * FDH_READ/FDH_WRITE - read/write using the file descriptor.
52  * FDH_READV/FDH_WRITEV - readv/writev (Unix only)
53  * FDH_SEEK - set file handle's read/write position
54  * FDH_CLOSE - return a file descriptor to the cache
55  * FDH_REALLYCLOSE - Close a file descriptor, do not return to the cache
56  * FDH_SYNC - Unconditionally sync an open file.
57  * FDH_TRUNC - Truncate a file
58  *
59  * status information:
60  * FDH_SIZE - returns the size of the file.
61  * FDH_NLINK - returns the link count of the file.
62  *
63  * Miscellaneous:
64  * FDH_FDOPEN - create a descriptor for buffered I/O
65  * STREAM_READ/STREAM_WRITE - buffered file I/O
66  */
67
68 #ifndef _IHANDLE_H_
69 #define _IHANDLE_H_
70
71 #ifdef AFS_PTHREAD_ENV
72 #include <assert.h>
73 #include <pthread.h>
74 extern pthread_once_t ih_glock_once;
75 extern pthread_mutex_t ih_glock_mutex;
76 extern void ih_glock_init(void);
77 #define IH_LOCK \
78     assert(pthread_once(&ih_glock_once, ih_glock_init) == 0 && \
79            pthread_mutex_lock(&ih_glock_mutex) == 0)
80 #define IH_UNLOCK \
81     assert(pthread_mutex_unlock(&ih_glock_mutex) == 0)
82 #else /* AFS_PTHREAD_ENV */
83 #define IH_LOCK
84 #define IH_UNLOCK
85 #endif /* AFS_PTHREAD_ENV */
86
87 #ifndef DLL_INIT_LIST
88 /*
89  * Macro to initialize a doubly linked list, lifted from Encina
90  */
91 #define DLL_INIT_LIST(head, tail)       \
92     do {                                \
93         (head) = NULL;                  \
94         (tail) = NULL;                  \
95     } while(0)
96
97 /*
98  * Macro to remove an element from a doubly linked list
99  */
100 #define DLL_DELETE(ptr,head,tail,next,prev)     \
101     do {                                        \
102         if ((ptr)->next)                        \
103             (ptr)->next->prev = (ptr)->prev;    \
104         else                                    \
105             (tail) = (ptr)->prev;               \
106         if ((ptr)->prev)                        \
107             (ptr)->prev->next = (ptr)->next;    \
108         else                                    \
109             (head) = (ptr)->next;               \
110         (ptr)->next = (ptr)->prev = NULL;       \
111         assert(!(head) || !((head)->prev)); \
112     } while(0)
113
114 /*
115  * Macro to insert an element at the tail of a doubly linked list
116  */
117 #define DLL_INSERT_TAIL(ptr,head,tail,next,prev) \
118     do {                                         \
119         (ptr)->next = NULL;                      \
120         (ptr)->prev = (tail);                    \
121         (tail) = (ptr);                          \
122         if ((ptr)->prev)                         \
123             (ptr)->prev->next = (ptr);           \
124         else                                     \
125             (head) = (ptr);                      \
126         assert((head) && ((head)->prev == NULL)); \
127     } while(0)
128
129 #endif /* DLL_INIT_LIST */
130
131 #ifdef AFS_NT40_ENV
132 typedef __int64 Inode;
133 #else
134 #include <afs/afssyscalls.h>
135 #endif
136
137 /* The dir package's page hashing function is dependent upon the layout of
138  * IHandle_t as well as the containing DirHandle in viced/viced.h. Make
139  * Sure the volume id is still used as the hash after any changes to either
140  * structure.
141  */
142
143 /* forward declaration */
144 struct IHandle_s;
145
146 /* File descriptors are HANDLE's on NT. The following typedef helps catch
147  * type errors. duplicated in libadmin/vos/afs_vosAdmin.c
148  */
149 #ifdef AFS_NT40_ENV
150 typedef HANDLE FD_t;
151 #else
152 typedef int FD_t;
153 #endif
154 #define INVALID_FD ((FD_t)-1)
155
156 /* file descriptor handle */
157 typedef struct FdHandle_s {
158     int fd_status;              /* status flags */
159     FD_t fd_fd;                 /* file descriptor */
160     struct IHandle_s *fd_ih;    /* Pointer to Inode handle */
161     struct FdHandle_s *fd_next; /* LRU/Avail list pointers */
162     struct FdHandle_s *fd_prev;
163     struct FdHandle_s *fd_ihnext;       /* Inode handle's list of file descriptors */
164     struct FdHandle_s *fd_ihprev;
165 } FdHandle_t;
166
167 /* File descriptor status values */
168 #define FD_HANDLE_AVAIL         1       /* handle is not open and available */
169 #define FD_HANDLE_OPEN          2       /* handle is open and not in use */
170 #define FD_HANDLE_INUSE         3       /* handle is open and in use */
171
172 /* buffered file descriptor handle */
173 #define STREAM_HANDLE_BUFSIZE   2048    /* buffer size for STR_READ/STR_WRITE */
174 typedef struct StreamHandle_s {
175     FD_t str_fd;                /* file descriptor */
176     int str_direction;          /* current read/write direction */
177     afs_sfsize_t str_buflen;    /* bytes remaining in buffer */
178     afs_foff_t str_bufoff;      /* current offset into buffer */
179     int str_error;              /* error code */
180     int str_eof;                /* end of file flag */
181     struct StreamHandle_s *str_next;    /* Avail list pointers */
182     struct StreamHandle_s *str_prev;
183     char str_buffer[STREAM_HANDLE_BUFSIZE];     /* data buffer */
184 } StreamHandle_t;
185
186 #define STREAM_DIRECTION_NONE   1       /* stream is in initial mode */
187 #define STREAM_DIRECTION_READ   2       /* stream is in input mode */
188 #define STREAM_DIRECTION_WRITE  3       /* stream is in output mode */
189
190 /* number handles allocated at a shot */
191 #define I_HANDLE_MALLOCSIZE     ((size_t)((4096/sizeof(IHandle_t))))
192 #define FD_HANDLE_MALLOCSIZE    ((size_t)((4096/sizeof(FdHandle_t))))
193 #define STREAM_HANDLE_MALLOCSIZE 1
194
195
196 /* READ THIS.
197  *
198  * On modern platforms tuned for I/O intensive workloads, there may be
199  * thousands of file descriptors available (64K on 32-bit Solaris 7,
200  * for example), and threading in Solaris 9 and Linux 2.6 (NPTL) are
201  * tuned for (many) thousands of concurrent threads at peak.
202  *
203  * On these platforms, it makes sense to allow administrators to set
204  * appropriate limits for their hardware.  Clients may now set desired
205  * values in the exported vol_io_params, of type ih_init_params.
206  */
207
208 typedef struct ih_init_params
209 {
210     afs_uint32 fd_handle_setaside; /* for non-cached i/o, trad. was 128 */
211     afs_uint32 fd_initial_cachesize; /* what was 'default' */
212     afs_uint32 fd_max_cachesize; /* max open files if large-cache activated */
213 } ih_init_params;
214
215
216 /* Number of file descriptors needed for non-cached I/O */
217 #define FD_HANDLE_SETASIDE      128 /* Match to MAX_FILESERVER_THREAD */
218
219 /* Which systems have 8-bit fileno?  On GNU/Linux systems, the
220  * fileno member of FILE is an int.  On NetBSD 5, it's a short.
221  * Ditto for OpenBSD 4.5. Through Solaris 10 8/07 it's unsigned char.
222  */
223
224 /* Don't try to have more than 256 files open at once if you are planning
225  * to use fopen or fdopen. The FILE structure has an eight bit field for
226  * the file descriptor.  */
227 #define FD_DEFAULT_CACHESIZE (255-FD_HANDLE_SETASIDE)
228
229 /* We need some limit on the number of files open at once. Some systems
230  * say we can open lots of files, but when we do they run out of slots
231  * in the file table.
232  */
233 #define FD_MAX_CACHESIZE (2000 - FD_HANDLE_SETASIDE)
234
235 /* On modern platforms, this is sized higher than the note implies.
236  * For HP, see http://forums11.itrc.hp.com/service/forums/questionanswer.do?admit=109447626+1242508538748+28353475&threadId=302950
237  * On AIX, it's said to be self-tuning (sar -v)
238  * On Solaris, http://www.princeton.edu/~unix/Solaris/troubleshoot/kerntune.html
239  * says stdio limit (FILE) may exist, but then backtracks and says the 64bit
240  * solaris and POLL (rather than select) io avoid the issue.  Solaris Internals
241  * states that Solaris 7 and above deal with up to 64K on 32bit.
242  * However, extended FILE must be enabled to use this. See
243  * enable_extended_FILE_stdio(3C)
244  */
245
246 /* Inode handle */
247 typedef struct IHandle_s {
248     afs_uint32 ih_vid;          /* Parent volume id. */
249     int ih_dev;                 /* device id. */
250     int ih_flags;               /* Flags */
251     int ih_synced;              /* should be synced next time */
252     Inode ih_ino;               /* Inode number */
253     int ih_refcnt;              /* reference count */
254     struct FdHandle_s *ih_fdhead;       /* List of open file desciptors */
255     struct FdHandle_s *ih_fdtail;
256     struct IHandle_s *ih_next;  /* Links for avail list/hash chains */
257     struct IHandle_s *ih_prev;
258 } IHandle_t;
259
260 /* Flags for the Inode handle */
261 #define IH_REALLY_CLOSED                1
262
263 /* Hash function for inode handles */
264 #define I_HANDLE_HASH_SIZE      2048    /* power of 2 */
265
266 /* The casts to int's ensure NT gets the xor operation correct. */
267 #define IH_HASH(D, V, I) ((int)(((D)^(V)^((int)(I)))&(I_HANDLE_HASH_SIZE-1)))
268
269 /*
270  * Hash buckets for inode handles
271  */
272 typedef struct IHashBucket_s {
273     IHandle_t *ihash_head;
274     IHandle_t *ihash_tail;
275 } IHashBucket_t;
276
277 /* Prototypes for handle support routines. */
278 #ifdef AFS_NAMEI_ENV
279 #ifdef AFS_NT40_ENV
280 #include "ntops.h"
281 #else
282 #include "namei_ops.h"
283 #endif
284 extern void ih_clear(IHandle_t * h);
285 extern Inode ih_create(IHandle_t * h, int dev, char *part, Inode nI, int p1,
286                        int p2, int p3, int p4);
287 extern FILE *ih_fdopen(FdHandle_t * h, char *fdperms);
288 #endif /* AFS_NAMEI_ENV */
289
290 /*
291  * Prototypes for file descriptor cache routines
292  */
293 extern void ih_PkgDefaults(void);
294 extern void ih_Initialize(void);
295 extern void ih_UseLargeCache(void);
296 extern IHandle_t *ih_init(int /*@alt Device@ */ dev, int /*@alt VolId@ */ vid,
297                           Inode ino);
298 extern IHandle_t *ih_copy(IHandle_t * ihP);
299 extern FdHandle_t *ih_open(IHandle_t * ihP);
300 extern int fd_close(FdHandle_t * fdP);
301 extern int fd_reallyclose(FdHandle_t * fdP);
302 extern StreamHandle_t *stream_fdopen(FD_t fd);
303 extern StreamHandle_t *stream_open(const char *file, const char *mode);
304 extern afs_sfsize_t stream_read(void *ptr, afs_fsize_t size,
305                                 afs_fsize_t nitems, StreamHandle_t * streamP);
306 extern afs_sfsize_t stream_write(void *ptr, afs_fsize_t size,
307                                  afs_fsize_t nitems,
308                                  StreamHandle_t * streamP);
309 extern int stream_seek(StreamHandle_t * streamP, afs_foff_t offset,
310                        int whence);
311 extern int stream_flush(StreamHandle_t * streamP);
312 extern int stream_close(StreamHandle_t * streamP, int reallyClose);
313 extern int ih_reallyclose(IHandle_t * ihP);
314 extern int ih_release(IHandle_t * ihP);
315 extern int ih_condsync(IHandle_t * ihP);
316
317 /* Macros common to user space and inode API's. */
318 #define IH_INIT(H, D, V, I) ((H) = ih_init((D), (V), (I)))
319
320 #define IH_COPY(D, S) ((D) = ih_copy(S))
321
322 #define IH_NLINK(H) ih_nlink(H)
323
324 #define IH_OPEN(H) ih_open(H)
325
326 #define FDH_CLOSE(H) (fd_close(H), (H)=NULL, 0)
327
328 #define FDH_REALLYCLOSE(H) (fd_reallyclose(H), (H)=NULL, 0)
329
330 #define FDH_FDOPEN(H, A) stream_fdopen((H)->fd_fd)
331
332 #define STREAM_FDOPEN(A, B) stream_fdopen(A)
333
334 #define STREAM_OPEN(A, B) stream_open(A, B)
335
336 #define STREAM_READ(A, B, C, H) stream_read(A, B, C, H)
337
338 #define STREAM_WRITE(A, B, C, H) stream_write(A, B, C, H)
339
340 #define STREAM_SEEK(H, A, B) stream_seek(H, A, B)
341
342 #define STREAM_FLUSH(H) stream_flush(H)
343
344 #define STREAM_ERROR(H) ((H)->str_error)
345
346 #define STREAM_EOF(H) ((H)->str_eof)
347
348 #define STREAM_CLOSE(H) stream_close(H, 0)
349
350 #define STREAM_REALLYCLOSE(H) stream_close(H, 1)
351
352 #define IH_RELEASE(H) (ih_release(H), (H)=NULL, 0)
353
354 #define IH_REALLYCLOSE(H) ih_reallyclose(H)
355
356 #define IH_CONDSYNC(H) ih_condsync(H)
357
358 #ifdef AFS_NAMEI_ENV
359
360 #ifdef AFS_NT40_ENV
361 #define IH_CREATE(H, D, P, N, P1, P2, P3, P4) \
362         nt_icreate(H, P, P1, P2, P3, P4)
363
364 #define OS_IOPEN(H) nt_iopen(H)
365 #define OS_OPEN(F, M, P) nt_open(F, M, P)
366 #define OS_CLOSE(FD) nt_close(FD)
367
368 #define OS_READ(FD, B, S) nt_read(FD, B, S)
369 #define OS_WRITE(FD, B, S) nt_write(FD, B, S)
370 #define OS_SEEK(FD, O, F) nt_seek(FD, O, F)
371
372 #define OS_SYNC(FD) nt_fsync(FD)
373 #define OS_TRUNC(FD, L) nt_ftruncate(FD, L)
374 #define OS_SIZE(FD) nt_size(FD)
375
376 #define IH_INC(H, I, P) nt_inc(H, I, P)
377 #define IH_DEC(H, I, P) nt_dec(H, I, P)
378 #define IH_IREAD(H, O, B, S) nt_iread(H, O, B, S)
379 #define IH_IWRITE(H, O, B, S) nt_iwrite(H, O, B, S)
380
381 #else /* AFS_NT40_ENV */
382
383 /*@+fcnmacros +macrofcndecl@*/
384 #ifdef S_SPLINT_S
385 extern Inode IH_CREATE(IHandle_t * H, int /*@alt Device @ */ D,
386                        char *P, Inode N, int /*@alt VolumeId @ */ P1,
387                        int /*@alt VnodeId @ */ P2,
388                        int /*@alt Unique @ */ P3,
389                        int /*@alt unsigned @ */ P4);
390 extern FD_t OS_IOPEN(IHandle_t * H);
391 extern int OS_OPEN(const char *F, int M, mode_t P);
392 extern int OS_CLOSE(int FD);
393 extern ssize_t OS_READ(int FD, void *B, size_t S);
394 extern ssize_t OS_WRITE(int FD, void *B, size_t S);
395 extern int OS_SYNC(int FD);
396 extern afs_sfsize_t OS_SIZE(int FD);
397 extern int IH_INC(IHandle_t * H, Inode I, int /*@alt VolId, VolumeId @ */ P);
398 extern int IH_DEC(IHandle_t * H, Inode I, int /*@alt VolId, VolumeId @ */ P);
399 extern afs_sfsize_t IH_IREAD(IHandle_t * H, afs_foff_t O, void *B,
400                              afs_fsize_t S);
401 extern afs_sfsize_t IH_IWRITE(IHandle_t * H, afs_foff_t O, void *B,
402                               afs_fsize_t S);
403 #ifdef O_LARGEFILE
404 extern off64_t OS_SEEK(int FD, off64_t O, int F);
405 extern int OS_TRUNC(int FD, off64_t L);
406 #else /* !O_LARGEFILE */
407 extern off_t OS_SEEK(int FD, off_t O, int F);
408 extern int OS_TRUNC(int FD, off_t L);
409 #endif /* !O_LARGEFILE */
410 #endif /*S_SPLINT_S */
411
412 #define IH_CREATE(H, D, P, N, P1, P2, P3, P4) \
413         namei_icreate(H, P, P1, P2, P3, P4)
414
415 #define OS_IOPEN(H) namei_iopen(H)
416 #ifdef O_LARGEFILE
417 #define OS_OPEN(F, M, P) open64(F, M, P)
418 #else /* !O_LARGEFILE */
419 #define OS_OPEN(F, M, P) open(F, M, P)
420 #endif /* !O_LARGEFILE */
421 #define OS_CLOSE(FD) close(FD)
422
423 #define OS_READ(FD, B, S) read(FD, B, S)
424 #define OS_WRITE(FD, B, S) write(FD, B, S)
425 #ifdef O_LARGEFILE
426 #define OS_SEEK(FD, O, F) lseek64(FD, (off64_t) (O), F)
427 #else /* !O_LARGEFILE */
428 #define OS_SEEK(FD, O, F) lseek(FD, (off_t) (O), F)
429 #endif /* !O_LARGEFILE */
430
431 #define OS_SYNC(FD) fsync(FD)
432 #ifdef O_LARGEFILE
433 #define OS_TRUNC(FD, L) ftruncate64(FD, (off64_t) (L))
434 #else /* !O_LARGEFILE */
435 #define OS_TRUNC(FD, L) ftruncate(FD, (off_t) (L))
436 #endif /* !O_LARGEFILE */
437 #define OS_SIZE(FD) ih_size(FD)
438 extern afs_sfsize_t ih_size(int fd);
439
440 #define IH_INC(H, I, P) namei_inc(H, I, P)
441 #define IH_DEC(H, I, P) namei_dec(H, I, P)
442 #define IH_IREAD(H, O, B, S) namei_iread(H, O, B, S)
443 #define IH_IWRITE(H, O, B, S) namei_iwrite(H, O, B, S)
444 /*@=fcnmacros =macrofcndecl@*/
445 #endif /* AFS_NT40_ENV */
446
447 #else /* AFS_NAMEI_ENV */
448 extern Inode ih_icreate(IHandle_t * ih, int dev, char *part, Inode nI, int p1,
449                         int p2, int p3, int p4);
450
451 #define IH_CREATE(H, D, P, N, P1, P2, P3, P4) \
452         ih_icreate(H, D, P, N, P1, P2, P3, P4)
453
454 #ifdef AFS_LINUX22_ENV
455 #define OS_IOPEN(H) -1
456 #else
457 #ifdef O_LARGEFILE
458 #define OS_IOPEN(H) (IOPEN((H)->ih_dev, (H)->ih_ino, O_RDWR|O_LARGEFILE))
459 #else
460 #define OS_IOPEN(H) (IOPEN((H)->ih_dev, (H)->ih_ino, O_RDWR))
461 #endif
462 #endif
463 #define OS_OPEN(F, M, P) open(F, M, P)
464 #define OS_CLOSE(FD) close(FD)
465
466 #define OS_READ(FD, B, S) read(FD, B, S)
467 #define OS_WRITE(FD, B, S) write(FD, B, S)
468 #ifdef O_LARGEFILE
469 #define OS_SEEK(FD, O, F) lseek64(FD, (off64_t) (O), F)
470 #else /* !O_LARGEFILE */
471 #define OS_SEEK(FD, O, F) lseek(FD, (off_t) (O), F)
472 #endif /* !O_LARGEFILE */
473
474 #define OS_SYNC(FD) fsync(FD)
475 #ifdef O_LARGEFILE
476 #define OS_TRUNC(FD, L) ftruncate64(FD, (off64_t) (L))
477 #else /* !O_LARGEFILE */
478 #define OS_TRUNC(FD, L) ftruncate(FD, (off_t) (L))
479 #endif /* !O_LARGEFILE */
480 #define OS_SIZE(FD) ih_size(FD)
481 extern afs_sfsize_t ih_size(int fd);
482
483 #ifdef AFS_LINUX22_ENV
484 #define IH_INC(H, I, P) -1
485 #define IH_DEC(H, I, P) -1
486 #define IH_IREAD(H, O, B, S) -1
487 #define IH_IWRITE(H, O, B, S) -1
488 #else
489 #define IH_INC(H, I, P) IINC((H)->ih_dev, I, P)
490 #define IH_DEC(H, I, P) IDEC((H)->ih_dev, I, P)
491 #define IH_IREAD(H, O, B, S) inode_read((H)->ih_dev, (H)->ih_ino, (H)->ih_vid,\
492                                         O, B, S)
493 #define IH_IWRITE(H, O, B, S) \
494         inode_write((H)->ih_dev, (H)->ih_ino, (H)->ih_vid, O, B, S)
495 #endif /* AFS_LINUX22_ENV */
496
497
498 #endif /* AFS_NAMEI_ENV */
499
500 #ifndef AFS_NT40_ENV
501 #define FDH_READV(H, I, N) readv((H)->fd_fd, I, N)
502 #define FDH_WRITEV(H, I, N) writev((H)->fd_fd, I, N)
503 #endif
504
505 #define FDH_READ(H, B, S) OS_READ((H)->fd_fd, B, S)
506 #define FDH_WRITE(H, B, S) OS_WRITE((H)->fd_fd, B, S)
507 #define FDH_SEEK(H, O, F) OS_SEEK((H)->fd_fd, O, F)
508
509 #define FDH_SYNC(H) ((H->fd_ih!=NULL) ? ( H->fd_ih->ih_synced = 1) - 1 : 1)
510 #define FDH_TRUNC(H, L) OS_TRUNC((H)->fd_fd, L)
511 #define FDH_SIZE(H) OS_SIZE((H)->fd_fd)
512
513 #endif /* _IHANDLE_H_ */