5 Fcntl - load the C Fcntl.h defines
10 use Fcntl qw(:DEFAULT :flock);
14 This module is just a translation of the C F<fnctl.h> file.
15 Unlike the old mechanism of requiring a translated F<fnctl.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.
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.
25 =head1 EXPORTED SYMBOLS
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.
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>.
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,
40 Please refer to your native fcntl() and open() documentation to see
41 what constants are implemented in your system.
45 use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS $AUTOLOAD);
49 @ISA = qw(Exporter DynaLoader);
51 # Items to export into callers namespace by default
52 # (move infrequently used names to @EXPORT_OK below)
55 F_DUPFD F_GETFD F_GETLK F_SETFD F_GETFL F_SETFL F_SETLK F_SETLKW
56 FD_CLOEXEC F_RDLCK F_UNLCK F_WRLCK F_POSIX
57 O_CREAT O_EXCL O_NOCTTY O_TRUNC
60 O_RDONLY O_RDWR O_WRONLY
62 O_EXLOCK O_SHLOCK O_ASYNC O_DSYNC O_RSYNC O_SYNC
66 # Other items we are prepared to export if requested
68 LOCK_SH LOCK_EX LOCK_NB LOCK_UN
69 FAPPEND FASYNC FCREAT FDEFER FEXCL FNDELAY FNONBLOCK FSYNC FTRUNC
71 # Named groups of exports
73 'flock' => [qw(LOCK_SH LOCK_EX LOCK_NB LOCK_UN)],
74 'Fcompat' => [qw(FAPPEND FASYNC FCREAT FDEFER FEXCL
75 FNDELAY FNONBLOCK FSYNC FTRUNC)],
80 ($constname = $AUTOLOAD) =~ s/.*:://;
81 my $val = constant($constname, (@_ && (caller(0))[4]) ? $_[0] : 0);
83 if ($! =~ /Invalid/) {
84 $AutoLoader::AUTOLOAD = $AUTOLOAD;
85 goto &AutoLoader::AUTOLOAD;
88 my ($pack,$file,$line) = caller;
89 die "Your vendor has not defined Fcntl macro $constname, used at $file line $line.
93 eval "sub $AUTOLOAD { $val }";
97 bootstrap Fcntl $VERSION;