1 | package Fcntl;
|
---|
2 |
|
---|
3 | =head1 NAME
|
---|
4 |
|
---|
5 | Fcntl - load the C Fcntl.h defines
|
---|
6 |
|
---|
7 | =head1 SYNOPSIS
|
---|
8 |
|
---|
9 | use Fcntl;
|
---|
10 | use Fcntl qw(:DEFAULT :flock);
|
---|
11 |
|
---|
12 | =head1 DESCRIPTION
|
---|
13 |
|
---|
14 | This module is just a translation of the C F<fcntl.h> file.
|
---|
15 | Unlike the old mechanism of requiring a translated F<fcntl.ph>
|
---|
16 | file, this uses the B<h2xs> program (see the Perl source distribution)
|
---|
17 | and your native C compiler. This means that it has a
|
---|
18 | far more likely chance of getting the numbers right.
|
---|
19 |
|
---|
20 | =head1 NOTE
|
---|
21 |
|
---|
22 | Only C<#define> symbols get translated; you must still correctly
|
---|
23 | pack up your own arguments to pass as args for locking functions, etc.
|
---|
24 |
|
---|
25 | =head1 EXPORTED SYMBOLS
|
---|
26 |
|
---|
27 | By default your system's F_* and O_* constants (eg, F_DUPFD and
|
---|
28 | O_CREAT) and the FD_CLOEXEC constant are exported into your namespace.
|
---|
29 |
|
---|
30 | You can request that the flock() constants (LOCK_SH, LOCK_EX, LOCK_NB
|
---|
31 | and LOCK_UN) be provided by using the tag C<:flock>. See L<Exporter>.
|
---|
32 |
|
---|
33 | You can request that the old constants (FAPPEND, FASYNC, FCREAT,
|
---|
34 | FDEFER, FEXCL, FNDELAY, FNONBLOCK, FSYNC, FTRUNC) be provided for
|
---|
35 | compatibility reasons by using the tag C<:Fcompat>. For new
|
---|
36 | applications the newer versions of these constants are suggested
|
---|
37 | (O_APPEND, O_ASYNC, O_CREAT, O_DEFER, O_EXCL, O_NDELAY, O_NONBLOCK,
|
---|
38 | O_SYNC, O_TRUNC).
|
---|
39 |
|
---|
40 | For ease of use also the SEEK_* constants (for seek() and sysseek(),
|
---|
41 | e.g. SEEK_END) and the S_I* constants (for chmod() and stat()) are
|
---|
42 | available for import. They can be imported either separately or using
|
---|
43 | the tags C<:seek> and C<:mode>.
|
---|
44 |
|
---|
45 | Please refer to your native fcntl(2), open(2), fseek(3), lseek(2)
|
---|
46 | (equal to Perl's seek() and sysseek(), respectively), and chmod(2)
|
---|
47 | documentation to see what constants are implemented in your system.
|
---|
48 |
|
---|
49 | See L<perlopentut> to learn about the uses of the O_* constants
|
---|
50 | with sysopen().
|
---|
51 |
|
---|
52 | See L<perlfunc/seek> and L<perlfunc/sysseek> about the SEEK_* constants.
|
---|
53 |
|
---|
54 | See L<perlfunc/stat> about the S_I* constants.
|
---|
55 |
|
---|
56 | =cut
|
---|
57 |
|
---|
58 | our($VERSION, @ISA, @EXPORT, @EXPORT_OK, %EXPORT_TAGS, $AUTOLOAD);
|
---|
59 |
|
---|
60 | require Exporter;
|
---|
61 | use XSLoader ();
|
---|
62 | @ISA = qw(Exporter);
|
---|
63 | $VERSION = "1.05";
|
---|
64 | # Items to export into callers namespace by default
|
---|
65 | # (move infrequently used names to @EXPORT_OK below)
|
---|
66 | @EXPORT =
|
---|
67 | qw(
|
---|
68 | FD_CLOEXEC
|
---|
69 | F_ALLOCSP
|
---|
70 | F_ALLOCSP64
|
---|
71 | F_COMPAT
|
---|
72 | F_DUP2FD
|
---|
73 | F_DUPFD
|
---|
74 | F_EXLCK
|
---|
75 | F_FREESP
|
---|
76 | F_FREESP64
|
---|
77 | F_FSYNC
|
---|
78 | F_FSYNC64
|
---|
79 | F_GETFD
|
---|
80 | F_GETFL
|
---|
81 | F_GETLK
|
---|
82 | F_GETLK64
|
---|
83 | F_GETOWN
|
---|
84 | F_NODNY
|
---|
85 | F_POSIX
|
---|
86 | F_RDACC
|
---|
87 | F_RDDNY
|
---|
88 | F_RDLCK
|
---|
89 | F_RWACC
|
---|
90 | F_RWDNY
|
---|
91 | F_SETFD
|
---|
92 | F_SETFL
|
---|
93 | F_SETLK
|
---|
94 | F_SETLK64
|
---|
95 | F_SETLKW
|
---|
96 | F_SETLKW64
|
---|
97 | F_SETOWN
|
---|
98 | F_SHARE
|
---|
99 | F_SHLCK
|
---|
100 | F_UNLCK
|
---|
101 | F_UNSHARE
|
---|
102 | F_WRACC
|
---|
103 | F_WRDNY
|
---|
104 | F_WRLCK
|
---|
105 | O_ACCMODE
|
---|
106 | O_ALIAS
|
---|
107 | O_APPEND
|
---|
108 | O_ASYNC
|
---|
109 | O_BINARY
|
---|
110 | O_CREAT
|
---|
111 | O_DEFER
|
---|
112 | O_DIRECT
|
---|
113 | O_DIRECTORY
|
---|
114 | O_DSYNC
|
---|
115 | O_EXCL
|
---|
116 | O_EXLOCK
|
---|
117 | O_LARGEFILE
|
---|
118 | O_NDELAY
|
---|
119 | O_NOCTTY
|
---|
120 | O_NOFOLLOW
|
---|
121 | O_NOINHERIT
|
---|
122 | O_NONBLOCK
|
---|
123 | O_RANDOM
|
---|
124 | O_RAW
|
---|
125 | O_RDONLY
|
---|
126 | O_RDWR
|
---|
127 | O_RSRC
|
---|
128 | O_RSYNC
|
---|
129 | O_SEQUENTIAL
|
---|
130 | O_SHLOCK
|
---|
131 | O_SYNC
|
---|
132 | O_TEMPORARY
|
---|
133 | O_TEXT
|
---|
134 | O_TRUNC
|
---|
135 | O_WRONLY
|
---|
136 | );
|
---|
137 |
|
---|
138 | # Other items we are prepared to export if requested
|
---|
139 | @EXPORT_OK = qw(
|
---|
140 | DN_ACCESS
|
---|
141 | DN_ATTRIB
|
---|
142 | DN_CREATE
|
---|
143 | DN_DELETE
|
---|
144 | DN_MODIFY
|
---|
145 | DN_MULTISHOT
|
---|
146 | DN_RENAME
|
---|
147 | FAPPEND
|
---|
148 | FASYNC
|
---|
149 | FCREAT
|
---|
150 | FDEFER
|
---|
151 | FDSYNC
|
---|
152 | FEXCL
|
---|
153 | FLARGEFILE
|
---|
154 | FNDELAY
|
---|
155 | FNONBLOCK
|
---|
156 | FRSYNC
|
---|
157 | FSYNC
|
---|
158 | FTRUNC
|
---|
159 | F_GETLEASE
|
---|
160 | F_GETSIG
|
---|
161 | F_NOTIFY
|
---|
162 | F_SETLEASE
|
---|
163 | F_SETSIG
|
---|
164 | LOCK_EX
|
---|
165 | LOCK_MAND
|
---|
166 | LOCK_NB
|
---|
167 | LOCK_READ
|
---|
168 | LOCK_RW
|
---|
169 | LOCK_SH
|
---|
170 | LOCK_UN
|
---|
171 | LOCK_WRITE
|
---|
172 | O_IGNORE_CTTY
|
---|
173 | O_NOATIME
|
---|
174 | O_NOLINK
|
---|
175 | O_NOTRANS
|
---|
176 | SEEK_CUR
|
---|
177 | SEEK_END
|
---|
178 | SEEK_SET
|
---|
179 | S_IFSOCK S_IFBLK S_IFCHR S_IFIFO S_IFWHT S_ENFMT
|
---|
180 | S_IREAD S_IWRITE S_IEXEC
|
---|
181 | S_IRGRP S_IWGRP S_IXGRP S_IRWXG
|
---|
182 | S_IROTH S_IWOTH S_IXOTH S_IRWXO
|
---|
183 | S_IRUSR S_IWUSR S_IXUSR S_IRWXU
|
---|
184 | S_ISUID S_ISGID S_ISVTX S_ISTXT
|
---|
185 | _S_IFMT S_IFREG S_IFDIR S_IFLNK
|
---|
186 | &S_ISREG &S_ISDIR &S_ISLNK &S_ISSOCK &S_ISBLK &S_ISCHR &S_ISFIFO
|
---|
187 | &S_ISWHT &S_ISENFMT &S_IFMT &S_IMODE
|
---|
188 | );
|
---|
189 | # Named groups of exports
|
---|
190 | %EXPORT_TAGS = (
|
---|
191 | 'flock' => [qw(LOCK_SH LOCK_EX LOCK_NB LOCK_UN)],
|
---|
192 | 'Fcompat' => [qw(FAPPEND FASYNC FCREAT FDEFER FDSYNC FEXCL FLARGEFILE
|
---|
193 | FNDELAY FNONBLOCK FRSYNC FSYNC FTRUNC)],
|
---|
194 | 'seek' => [qw(SEEK_SET SEEK_CUR SEEK_END)],
|
---|
195 | 'mode' => [qw(S_ISUID S_ISGID S_ISVTX S_ISTXT
|
---|
196 | _S_IFMT S_IFREG S_IFDIR S_IFLNK
|
---|
197 | S_IFSOCK S_IFBLK S_IFCHR S_IFIFO S_IFWHT S_ENFMT
|
---|
198 | S_IRUSR S_IWUSR S_IXUSR S_IRWXU
|
---|
199 | S_IRGRP S_IWGRP S_IXGRP S_IRWXG
|
---|
200 | S_IROTH S_IWOTH S_IXOTH S_IRWXO
|
---|
201 | S_IREAD S_IWRITE S_IEXEC
|
---|
202 | S_ISREG S_ISDIR S_ISLNK S_ISSOCK
|
---|
203 | S_ISBLK S_ISCHR S_ISFIFO
|
---|
204 | S_ISWHT S_ISENFMT
|
---|
205 | S_IFMT S_IMODE
|
---|
206 | )],
|
---|
207 | );
|
---|
208 |
|
---|
209 | sub S_IFMT { @_ ? ( $_[0] & _S_IFMT() ) : _S_IFMT() }
|
---|
210 | sub S_IMODE { $_[0] & 07777 }
|
---|
211 |
|
---|
212 | sub S_ISREG { ( $_[0] & _S_IFMT() ) == S_IFREG() }
|
---|
213 | sub S_ISDIR { ( $_[0] & _S_IFMT() ) == S_IFDIR() }
|
---|
214 | sub S_ISLNK { ( $_[0] & _S_IFMT() ) == S_IFLNK() }
|
---|
215 | sub S_ISSOCK { ( $_[0] & _S_IFMT() ) == S_IFSOCK() }
|
---|
216 | sub S_ISBLK { ( $_[0] & _S_IFMT() ) == S_IFBLK() }
|
---|
217 | sub S_ISCHR { ( $_[0] & _S_IFMT() ) == S_IFCHR() }
|
---|
218 | sub S_ISFIFO { ( $_[0] & _S_IFMT() ) == S_IFIFO() }
|
---|
219 | sub S_ISWHT { ( $_[0] & _S_IFMT() ) == S_IFWHT() }
|
---|
220 | sub S_ISENFMT { ( $_[0] & _S_IFMT() ) == S_IFENFMT() }
|
---|
221 |
|
---|
222 | sub AUTOLOAD {
|
---|
223 | (my $constname = $AUTOLOAD) =~ s/.*:://;
|
---|
224 | die "&Fcntl::constant not defined" if $constname eq 'constant';
|
---|
225 | my ($error, $val) = constant($constname);
|
---|
226 | if ($error) {
|
---|
227 | my (undef,$file,$line) = caller;
|
---|
228 | die "$error at $file line $line.\n";
|
---|
229 | }
|
---|
230 | *$AUTOLOAD = sub { $val };
|
---|
231 | goto &$AUTOLOAD;
|
---|
232 | }
|
---|
233 |
|
---|
234 | XSLoader::load 'Fcntl', $VERSION;
|
---|
235 |
|
---|
236 | 1;
|
---|