root / lab4 / .minix-src / include / sys / dirent.h @ 13
History | View | Annotate | Download (4.71 KB)
1 | 13 | up20180614 | /* $NetBSD: dirent.h,v 1.29 2015/02/26 02:05:54 dholland Exp $ */
|
---|---|---|---|
2 | |||
3 | /*-
|
||
4 | * Copyright (c) 1989, 1993
|
||
5 | * The Regents of the University of California. All rights reserved.
|
||
6 | *
|
||
7 | * Redistribution and use in source and binary forms, with or without
|
||
8 | * modification, are permitted provided that the following conditions
|
||
9 | * are met:
|
||
10 | * 1. Redistributions of source code must retain the above copyright
|
||
11 | * notice, this list of conditions and the following disclaimer.
|
||
12 | * 2. Redistributions in binary form must reproduce the above copyright
|
||
13 | * notice, this list of conditions and the following disclaimer in the
|
||
14 | * documentation and/or other materials provided with the distribution.
|
||
15 | * 3. Neither the name of the University nor the names of its contributors
|
||
16 | * may be used to endorse or promote products derived from this software
|
||
17 | * without specific prior written permission.
|
||
18 | *
|
||
19 | * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
||
20 | * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||
21 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||
22 | * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
||
23 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||
24 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||
25 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||
26 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||
27 | * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||
28 | * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||
29 | * SUCH DAMAGE.
|
||
30 | *
|
||
31 | * @(#)dirent.h 8.3 (Berkeley) 8/10/94
|
||
32 | */
|
||
33 | |||
34 | #ifndef _SYS_DIRENT_H_
|
||
35 | #define _SYS_DIRENT_H_
|
||
36 | |||
37 | #include <sys/featuretest.h> |
||
38 | |||
39 | /*
|
||
40 | * The dirent structure defines the format of directory entries returned by
|
||
41 | * the getdents(2) system call.
|
||
42 | *
|
||
43 | * A directory entry has a struct dirent at the front of it, containing its
|
||
44 | * inode number, the length of the entry, and the length of the name
|
||
45 | * contained in the entry. These are followed by the name padded to
|
||
46 | * _DIRENT_ALIGN() byte boundary with null bytes. All names are guaranteed
|
||
47 | * NUL terminated. The maximum length of a name in a directory is MAXNAMLEN.
|
||
48 | */
|
||
49 | struct dirent {
|
||
50 | ino_t d_fileno; /* file number of entry */
|
||
51 | uint16_t d_reclen; /* length of this record */
|
||
52 | uint16_t d_namlen; /* length of string in d_name */
|
||
53 | uint8_t d_type; /* file type, see below */
|
||
54 | #if defined(_NETBSD_SOURCE)
|
||
55 | #define MAXNAMLEN 511 /* must be kept in sync with NAME_MAX */ |
||
56 | char d_name[MAXNAMLEN + 1]; /* name must be no longer than this */ |
||
57 | #else
|
||
58 | char d_name[511 + 1]; /* name must be no longer than this */ |
||
59 | #endif
|
||
60 | }; |
||
61 | |||
62 | #if defined(_NETBSD_SOURCE)
|
||
63 | /*
|
||
64 | * File types
|
||
65 | */
|
||
66 | #define DT_UNKNOWN 0 |
||
67 | #define DT_FIFO 1 |
||
68 | #define DT_CHR 2 |
||
69 | #define DT_DIR 4 |
||
70 | #define DT_BLK 6 |
||
71 | #define DT_REG 8 |
||
72 | #define DT_LNK 10 |
||
73 | #define DT_SOCK 12 |
||
74 | #define DT_WHT 14 |
||
75 | |||
76 | /*
|
||
77 | * Caution: the following macros are used by the ufs/ffs code on ffs's
|
||
78 | * struct direct as well as the exposed struct dirent. The two
|
||
79 | * structures are not the same, so it's important (until ufs is fixed,
|
||
80 | * XXX) that the macro definitions remain type-polymorphic.
|
||
81 | */
|
||
82 | |||
83 | /*
|
||
84 | * The _DIRENT_ALIGN macro returns the alignment of struct dirent.
|
||
85 | * struct direct and struct dirent12 used 4 byte alignment but
|
||
86 | * struct dirent uses 8.
|
||
87 | */
|
||
88 | #define _DIRENT_ALIGN(dp) (sizeof((dp)->d_fileno) - 1) |
||
89 | /*
|
||
90 | * The _DIRENT_NAMEOFF macro returns the offset of the d_name field in
|
||
91 | * struct dirent
|
||
92 | */
|
||
93 | #if __GNUC_PREREQ__(4, 0) |
||
94 | #define _DIRENT_NAMEOFF(dp) __builtin_offsetof(__typeof__(*(dp)), d_name)
|
||
95 | #else
|
||
96 | #define _DIRENT_NAMEOFF(dp) \
|
||
97 | ((char *)(void *)&(dp)->d_name - (char *)(void *)dp) |
||
98 | #endif
|
||
99 | /*
|
||
100 | * The _DIRENT_RECLEN macro gives the minimum record length which will hold
|
||
101 | * a name of size "namlen". This requires the amount of space in struct dirent
|
||
102 | * without the d_name field, plus enough space for the name with a terminating
|
||
103 | * null byte (namlen+1), rounded up to a the appropriate byte boundary.
|
||
104 | */
|
||
105 | #define _DIRENT_RECLEN(dp, namlen) \
|
||
106 | ((_DIRENT_NAMEOFF(dp) + (namlen) + 1 + _DIRENT_ALIGN(dp)) & \
|
||
107 | ~_DIRENT_ALIGN(dp)) |
||
108 | /*
|
||
109 | * The _DIRENT_SIZE macro returns the minimum record length required for
|
||
110 | * name name stored in the current record.
|
||
111 | */
|
||
112 | #define _DIRENT_SIZE(dp) _DIRENT_RECLEN(dp, (dp)->d_namlen)
|
||
113 | /*
|
||
114 | * The _DIRENT_NEXT macro advances to the next dirent record.
|
||
115 | */
|
||
116 | #define _DIRENT_NEXT(dp) ((void *)((char *)(void *)(dp) + (dp)->d_reclen)) |
||
117 | /*
|
||
118 | * The _DIRENT_MINSIZE returns the size of an empty (invalid) record.
|
||
119 | */
|
||
120 | #define _DIRENT_MINSIZE(dp) _DIRENT_RECLEN(dp, 0) |
||
121 | |||
122 | /*
|
||
123 | * Convert between stat structure types and directory types.
|
||
124 | */
|
||
125 | #define IFTODT(mode) (((mode) & 0170000) >> 12) |
||
126 | #define DTTOIF(dirtype) ((dirtype) << 12) |
||
127 | #endif
|
||
128 | |||
129 | #endif /* !_SYS_DIRENT_H_ */ |