This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
infnan: Notes on the nan payload.
[perl5.git] / ext / POSIX / lib / POSIX.pm
CommitLineData
a0d0e21e 1package POSIX;
e9b37efe
NC
2use strict;
3use warnings;
a0d0e21e 4
122efcc9 5our ($AUTOLOAD, %SIGRT);
73c78b0a 6
42c07143 7our $VERSION = '1.54';
d5a0d2f9 8
da4061d3 9require XSLoader;
a0d0e21e 10
33fb14dc
NC
11use Fcntl qw(FD_CLOEXEC F_DUPFD F_GETFD F_GETFL F_GETLK F_RDLCK F_SETFD
12 F_SETFL F_SETLK F_SETLKW F_UNLCK F_WRLCK O_ACCMODE O_APPEND
13 O_CREAT O_EXCL O_NOCTTY O_NONBLOCK O_RDONLY O_RDWR O_TRUNC
a5d75221 14 O_WRONLY SEEK_CUR SEEK_END SEEK_SET
9b68a132 15 S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISREG
a5d75221
NC
16 S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU S_ISGID S_ISUID
17 S_IWGRP S_IWOTH S_IWUSR S_IXGRP S_IXOTH S_IXUSR);
33fb14dc 18
66fbe9e2
GS
19my $loaded;
20
a0d0e21e 21sub import {
8fe37eed
AP
22 my $pkg = shift;
23
66fbe9e2 24 load_imports() unless $loaded++;
8fe37eed
AP
25
26 # Grandfather old foo_h form to new :foo_h form
27 s/^(?=\w+_h$)/:/ for my @list = @_;
28
a0d0e21e 29 local $Exporter::ExportLevel = 1;
8fe37eed 30 Exporter::import($pkg,@list);
a0d0e21e
LW
31}
32
66fbe9e2 33sub croak { require Carp; goto &Carp::croak }
122efcc9 34sub usage { croak "Usage: POSIX::$_[0]" }
4633a7c4 35
da4061d3 36XSLoader::load();
4633a7c4 37
8fe37eed
AP
38my %replacement = (
39 atexit => 'END {}',
40 atof => undef,
41 atoi => undef,
42 atol => undef,
43 bsearch => \'not supplied',
44 calloc => undef,
45 clearerr => 'IO::Handle::clearerr',
46 div => '/, % and int',
47 execl => undef,
48 execle => undef,
49 execlp => undef,
50 execv => undef,
51 execve => undef,
52 execvp => undef,
53 fclose => 'IO::Handle::close',
54 fdopen => 'IO::Handle::new_from_fd',
55 feof => 'IO::Handle::eof',
56 ferror => 'IO::Handle::error',
57 fflush => 'IO::Handle::flush',
58 fgetc => 'IO::Handle::getc',
59 fgetpos => 'IO::Seekable::getpos',
60 fgets => 'IO::Handle::gets',
61 fileno => 'IO::Handle::fileno',
62 fopen => 'IO::File::open',
63 fprintf => 'printf',
64 fputc => 'print',
65 fputs => 'print',
66 fread => 'read',
67 free => undef,
68 freopen => 'open',
69 fscanf => '<> and regular expressions',
70 fseek => 'IO::Seekable::seek',
71 fsetpos => 'IO::Seekable::setpos',
72 fsync => 'IO::Handle::sync',
73 ftell => 'IO::Seekable::tell',
74 fwrite => 'print',
75 labs => 'abs',
76 ldiv => '/, % and int',
77 longjmp => 'die',
78 malloc => undef,
79 memchr => 'index()',
80 memcmp => 'eq',
81 memcpy => '=',
82 memmove => '=',
83 memset => 'x',
84 offsetof => undef,
85 putc => 'print',
86 putchar => 'print',
87 puts => 'print',
88 qsort => 'sort',
89 rand => \'non-portable, use Perl\'s rand instead',
90 realloc => undef,
91 scanf => '<> and regular expressions',
92 setbuf => 'IO::Handle::setbuf',
93 setjmp => 'eval {}',
94 setvbuf => 'IO::Handle::setvbuf',
95 siglongjmp => 'die',
96 sigsetjmp => 'eval {}',
96927498 97 srand => \'not supplied; refer to Perl\'s srand documentation',
8fe37eed
AP
98 sscanf => 'regular expressions',
99 strcat => '.=',
100 strchr => 'index()',
101 strcmp => 'eq',
102 strcpy => '=',
103 strcspn => 'regular expressions',
104 strlen => 'length',
105 strncat => '.=',
106 strncmp => 'eq',
107 strncpy => '=',
108 strpbrk => undef,
109 strrchr => 'rindex()',
110 strspn => undef,
111 strtok => undef,
112 tmpfile => 'IO::File::new_tmpfile',
113 ungetc => 'IO::Handle::ungetc',
114 vfprintf => undef,
115 vprintf => undef,
116 vsprintf => undef,
117);
118
122efcc9
AP
119my %reimpl = (
120 assert => 'expr => croak "Assertion failed" if !$_[0]',
121 tolower => 'string => lc($_[0])',
122 toupper => 'string => uc($_[0])',
123 closedir => 'dirhandle => CORE::closedir($_[0])',
124 opendir => 'directory => my $dh; CORE::opendir($dh, $_[0]) ? $dh : undef',
125 readdir => 'dirhandle => CORE::readdir($_[0])',
126 rewinddir => 'dirhandle => CORE::rewinddir($_[0])',
127 errno => '$! + 0',
128 creat => 'filename, mode => &open($_[0], &O_WRONLY | &O_CREAT | &O_TRUNC, $_[1])',
129 fcntl => 'filehandle, cmd, arg => CORE::fcntl($_[0], $_[1], $_[2])',
130 getgrgid => 'gid => CORE::getgrgid($_[0])',
131 getgrnam => 'name => CORE::getgrnam($_[0])',
132 atan2 => 'x, y => CORE::atan2($_[0], $_[1])',
133 cos => 'x => CORE::cos($_[0])',
134 exp => 'x => CORE::exp($_[0])',
135 fabs => 'x => CORE::abs($_[0])',
136 log => 'x => CORE::log($_[0])',
137 pow => 'x, exponent => $_[0] ** $_[1]',
138 sin => 'x => CORE::sin($_[0])',
139 sqrt => 'x => CORE::sqrt($_[0])',
140 getpwnam => 'name => CORE::getpwnam($_[0])',
141 getpwuid => 'uid => CORE::getpwuid($_[0])',
142 kill => 'pid, sig => CORE::kill $_[1], $_[0]',
143 raise => 'sig => CORE::kill $_[0], $$; # Is this good enough',
144 getc => 'handle => CORE::getc($_[0])',
145 getchar => 'CORE::getc(STDIN)',
146 gets => 'scalar <STDIN>',
147 remove => 'filename => (-d $_[0]) ? CORE::rmdir($_[0]) : CORE::unlink($_[0])',
148 rename => 'oldfilename, newfilename => CORE::rename($_[0], $_[1])',
149 rewind => 'filehandle => CORE::seek($_[0],0,0)',
150 abs => 'x => CORE::abs($_[0])',
151 exit => 'status => CORE::exit($_[0])',
152 getenv => 'name => $ENV{$_[0]}',
153 system => 'command => CORE::system($_[0])',
ec064ab7 154 strerror => 'errno => BEGIN { local $!; require locale; locale->import} local $! = $_[0]; "$!"',
122efcc9
AP
155 strstr => 'big, little => CORE::index($_[0], $_[1])',
156 chmod => 'mode, filename => CORE::chmod($_[0], $_[1])',
157 fstat => 'fd => CORE::open my $dup, "<&", $_[0]; CORE::stat($dup)', # Gross.
158 mkdir => 'directoryname, mode => CORE::mkdir($_[0], $_[1])',
159 stat => 'filename => CORE::stat($_[0])',
160 umask => 'mask => CORE::umask($_[0])',
161 wait => 'CORE::wait()',
162 waitpid => 'pid, options => CORE::waitpid($_[0], $_[1])',
163 gmtime => 'time => CORE::gmtime($_[0])',
164 localtime => 'time => CORE::localtime($_[0])',
165 time => 'CORE::time',
166 alarm => 'seconds => CORE::alarm($_[0])',
167 chdir => 'directory => CORE::chdir($_[0])',
168 chown => 'uid, gid, filename => CORE::chown($_[0], $_[1], $_[2])',
169 fork => 'CORE::fork',
170 getegid => '$) + 0',
171 geteuid => '$> + 0',
172 getgid => '$( + 0',
173 getgroups => 'my %seen; grep !$seen{$_}++, split " ", $)',
174 getlogin => 'CORE::getlogin()',
175 getpgrp => 'CORE::getpgrp',
176 getpid => '$$',
177 getppid => 'CORE::getppid',
178 getuid => '$<',
179 isatty => 'filehandle => -t $_[0]',
180 link => 'oldfilename, newfilename => CORE::link($_[0], $_[1])',
181 rmdir => 'directoryname => CORE::rmdir($_[0])',
122efcc9
AP
182 unlink => 'filename => CORE::unlink($_[0])',
183 utime => 'filename, atime, mtime => CORE::utime($_[1], $_[2], $_[0])',
184);
8fe37eed 185
122efcc9 186eval join ';', map "sub $_", keys %replacement, keys %reimpl;
8fe37eed 187
122efcc9 188sub AUTOLOAD {
8fe37eed
AP
189 my ($func) = ($AUTOLOAD =~ /.*::(.*)/);
190
c448c124
AP
191 die "POSIX.xs has failed to load\n" if $func eq 'constant';
192
8dad66f8 193 if (my $code = $reimpl{$func}) {
122efcc9
AP
194 my ($num, $arg) = (0, '');
195 if ($code =~ s/^(.*?) *=> *//) {
196 $arg = $1;
197 $num = 1 + $arg =~ tr/,//;
198 }
199 # no warnings to be consistent with the old implementation, where each
200 # function was in its own little AutoSplit world:
201 eval qq{ sub $func {
202 no warnings;
203 usage "$func($arg)" if \@_ != $num;
204 $code
205 } };
206 no strict;
207 goto &$AUTOLOAD;
208 }
8fe37eed
AP
209 if (exists $replacement{$func}) {
210 my $how = $replacement{$func};
211 croak "Unimplemented: POSIX::$func() is C-specific, stopped"
212 unless defined $how;
213 croak "Unimplemented: POSIX::$func() is $$how" if ref $how;
11e7c26f 214 croak "Use method $how() instead of POSIX::$func()" if $how =~ /::/;
96927498 215 croak "Unimplemented: POSIX::$func() is C-specific: use $how instead";
8fe37eed
AP
216 }
217
8fe37eed 218 constant($func);
a0d0e21e
LW
219}
220
a0d0e21e
LW
221sub perror {
222 print STDERR "@_: " if @_;
223 print STDERR $!,"\n";
224}
225
226sub printf {
227 usage "printf(pattern, args...)" if @_ < 1;
b56ec344 228 CORE::printf STDOUT @_;
a0d0e21e
LW
229}
230
a0d0e21e 231sub sprintf {
c43a6b96 232 usage "sprintf(pattern, args...)" if @_ == 0;
b56ec344 233 CORE::sprintf(shift,@_);
a0d0e21e
LW
234}
235
66fbe9e2 236sub load_imports {
7658eeca 237my %default_export_tags = (
66fbe9e2
GS
238
239 assert_h => [qw(assert NDEBUG)],
240
241 ctype_h => [qw(isalnum isalpha iscntrl isdigit isgraph islower
242 isprint ispunct isspace isupper isxdigit tolower toupper)],
243
d4742b2c 244 dirent_h => [],
66fbe9e2 245
c3fa0c84
SH
246 errno_h => [qw(E2BIG EACCES EADDRINUSE EADDRNOTAVAIL EAFNOSUPPORT EAGAIN
247 EALREADY EBADF EBADMSG EBUSY ECANCELED ECHILD ECONNABORTED
248 ECONNREFUSED ECONNRESET EDEADLK EDESTADDRREQ EDOM EDQUOT EEXIST
249 EFAULT EFBIG EHOSTDOWN EHOSTUNREACH EIDRM EILSEQ EINPROGRESS
250 EINTR EINVAL EIO EISCONN EISDIR ELOOP EMFILE EMLINK EMSGSIZE
251 ENAMETOOLONG ENETDOWN ENETRESET ENETUNREACH ENFILE ENOBUFS
252 ENODATA ENODEV ENOENT ENOEXEC ENOLCK ENOLINK ENOMEM ENOMSG
253 ENOPROTOOPT ENOSPC ENOSR ENOSTR ENOSYS ENOTBLK ENOTCONN ENOTDIR
254 ENOTEMPTY ENOTRECOVERABLE ENOTSOCK ENOTSUP ENOTTY ENXIO
255 EOPNOTSUPP EOTHER EOVERFLOW EOWNERDEAD EPERM EPFNOSUPPORT EPIPE
256 EPROCLIM EPROTO EPROTONOSUPPORT EPROTOTYPE ERANGE EREMOTE
257 ERESTART EROFS ESHUTDOWN ESOCKTNOSUPPORT ESPIPE ESRCH ESTALE
258 ETIME ETIMEDOUT ETOOMANYREFS ETXTBSY EUSERS EWOULDBLOCK EXDEV
259 errno)],
66fbe9e2
GS
260
261 fcntl_h => [qw(FD_CLOEXEC F_DUPFD F_GETFD F_GETFL F_GETLK F_RDLCK
262 F_SETFD F_SETFL F_SETLK F_SETLKW F_UNLCK F_WRLCK
263 O_ACCMODE O_APPEND O_CREAT O_EXCL O_NOCTTY O_NONBLOCK
264 O_RDONLY O_RDWR O_TRUNC O_WRONLY
265 creat
266 SEEK_CUR SEEK_END SEEK_SET
267 S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU
268 S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISGID S_ISREG S_ISUID
269 S_IWGRP S_IWOTH S_IWUSR)],
270
271 float_h => [qw(DBL_DIG DBL_EPSILON DBL_MANT_DIG
272 DBL_MAX DBL_MAX_10_EXP DBL_MAX_EXP
273 DBL_MIN DBL_MIN_10_EXP DBL_MIN_EXP
274 FLT_DIG FLT_EPSILON FLT_MANT_DIG
275 FLT_MAX FLT_MAX_10_EXP FLT_MAX_EXP
276 FLT_MIN FLT_MIN_10_EXP FLT_MIN_EXP
277 FLT_RADIX FLT_ROUNDS
278 LDBL_DIG LDBL_EPSILON LDBL_MANT_DIG
279 LDBL_MAX LDBL_MAX_10_EXP LDBL_MAX_EXP
280 LDBL_MIN LDBL_MIN_10_EXP LDBL_MIN_EXP)],
281
d4742b2c 282 grp_h => [],
66fbe9e2
GS
283
284 limits_h => [qw( ARG_MAX CHAR_BIT CHAR_MAX CHAR_MIN CHILD_MAX
285 INT_MAX INT_MIN LINK_MAX LONG_MAX LONG_MIN MAX_CANON
286 MAX_INPUT MB_LEN_MAX NAME_MAX NGROUPS_MAX OPEN_MAX
287 PATH_MAX PIPE_BUF SCHAR_MAX SCHAR_MIN SHRT_MAX SHRT_MIN
288 SSIZE_MAX STREAM_MAX TZNAME_MAX UCHAR_MAX UINT_MAX
289 ULONG_MAX USHRT_MAX _POSIX_ARG_MAX _POSIX_CHILD_MAX
290 _POSIX_LINK_MAX _POSIX_MAX_CANON _POSIX_MAX_INPUT
291 _POSIX_NAME_MAX _POSIX_NGROUPS_MAX _POSIX_OPEN_MAX
292 _POSIX_PATH_MAX _POSIX_PIPE_BUF _POSIX_SSIZE_MAX
293 _POSIX_STREAM_MAX _POSIX_TZNAME_MAX)],
294
83f427f7
JH
295 locale_h => [qw(LC_ALL LC_COLLATE LC_CTYPE LC_MESSAGES
296 LC_MONETARY LC_NUMERIC LC_TIME NULL
297 localeconv setlocale)],
66fbe9e2 298
7658eeca
AP
299 math_h => [qw(FP_ILOGB0 FP_ILOGBNAN FP_INFINITE FP_NAN FP_NORMAL
300 FP_SUBNORMAL FP_ZERO
301 M_1_PI M_2_PI M_2_SQRTPI M_E M_LN10 M_LN2 M_LOG10E M_LOG2E
302 M_PI M_PI_2 M_PI_4 M_SQRT1_2 M_SQRT2
303 HUGE_VAL INFINITY NAN
304 acos asin atan ceil cosh fabs floor fmod
305 frexp ldexp log10 modf pow sinh tan tanh)],
66fbe9e2 306
d4742b2c 307 pwd_h => [],
66fbe9e2
GS
308
309 setjmp_h => [qw(longjmp setjmp siglongjmp sigsetjmp)],
310
311 signal_h => [qw(SA_NOCLDSTOP SA_NOCLDWAIT SA_NODEFER SA_ONSTACK
312 SA_RESETHAND SA_RESTART SA_SIGINFO SIGABRT SIGALRM
313 SIGCHLD SIGCONT SIGFPE SIGHUP SIGILL SIGINT SIGKILL
3609ea0d 314 SIGPIPE %SIGRT SIGRTMIN SIGRTMAX SIGQUIT SIGSEGV SIGSTOP
ee25ad77
FR
315 SIGTERM SIGTSTP SIGTTIN SIGTTOU SIGUSR1 SIGUSR2 SIGBUS
316 SIGPOLL SIGPROF SIGSYS SIGTRAP SIGURG SIGVTALRM SIGXCPU SIGXFSZ
3609ea0d
JH
317 SIG_BLOCK SIG_DFL SIG_ERR SIG_IGN SIG_SETMASK SIG_UNBLOCK
318 raise sigaction signal sigpending sigprocmask sigsuspend)],
66fbe9e2 319
d4742b2c 320 stdarg_h => [],
66fbe9e2
GS
321
322 stddef_h => [qw(NULL offsetof)],
323
324 stdio_h => [qw(BUFSIZ EOF FILENAME_MAX L_ctermid L_cuserid
325 L_tmpname NULL SEEK_CUR SEEK_END SEEK_SET
326 STREAM_MAX TMP_MAX stderr stdin stdout
327 clearerr fclose fdopen feof ferror fflush fgetc fgetpos
328 fgets fopen fprintf fputc fputs fread freopen
329 fscanf fseek fsetpos ftell fwrite getchar gets
330 perror putc putchar puts remove rewind
331 scanf setbuf setvbuf sscanf tmpfile tmpnam
332 ungetc vfprintf vprintf vsprintf)],
333
334 stdlib_h => [qw(EXIT_FAILURE EXIT_SUCCESS MB_CUR_MAX NULL RAND_MAX
335 abort atexit atof atoi atol bsearch calloc div
336 free getenv labs ldiv malloc mblen mbstowcs mbtowc
7658eeca 337 qsort realloc strtod strtol strtoul wcstombs wctomb)],
66fbe9e2
GS
338
339 string_h => [qw(NULL memchr memcmp memcpy memmove memset strcat
340 strchr strcmp strcoll strcpy strcspn strerror strlen
341 strncat strncmp strncpy strpbrk strrchr strspn strstr
342 strtok strxfrm)],
343
344 sys_stat_h => [qw(S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU
345 S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISGID S_ISREG
346 S_ISUID S_IWGRP S_IWOTH S_IWUSR S_IXGRP S_IXOTH S_IXUSR
347 fstat mkfifo)],
348
d4742b2c 349 sys_times_h => [],
66fbe9e2 350
d4742b2c 351 sys_types_h => [],
66fbe9e2
GS
352
353 sys_utsname_h => [qw(uname)],
354
355 sys_wait_h => [qw(WEXITSTATUS WIFEXITED WIFSIGNALED WIFSTOPPED
356 WNOHANG WSTOPSIG WTERMSIG WUNTRACED)],
357
358 termios_h => [qw( B0 B110 B1200 B134 B150 B1800 B19200 B200 B2400
359 B300 B38400 B4800 B50 B600 B75 B9600 BRKINT CLOCAL
360 CREAD CS5 CS6 CS7 CS8 CSIZE CSTOPB ECHO ECHOE ECHOK
361 ECHONL HUPCL ICANON ICRNL IEXTEN IGNBRK IGNCR IGNPAR
362 INLCR INPCK ISIG ISTRIP IXOFF IXON NCCS NOFLSH OPOST
363 PARENB PARMRK PARODD TCIFLUSH TCIOFF TCIOFLUSH TCION
364 TCOFLUSH TCOOFF TCOON TCSADRAIN TCSAFLUSH TCSANOW
365 TOSTOP VEOF VEOL VERASE VINTR VKILL VMIN VQUIT VSTART
366 VSTOP VSUSP VTIME
367 cfgetispeed cfgetospeed cfsetispeed cfsetospeed tcdrain
368 tcflow tcflush tcgetattr tcsendbreak tcsetattr )],
369
370 time_h => [qw(CLK_TCK CLOCKS_PER_SEC NULL asctime clock ctime
ce0afe25 371 difftime mktime strftime tzset tzname)],
66fbe9e2
GS
372
373 unistd_h => [qw(F_OK NULL R_OK SEEK_CUR SEEK_END SEEK_SET
b250498f 374 STDERR_FILENO STDIN_FILENO STDOUT_FILENO W_OK X_OK
66fbe9e2
GS
375 _PC_CHOWN_RESTRICTED _PC_LINK_MAX _PC_MAX_CANON
376 _PC_MAX_INPUT _PC_NAME_MAX _PC_NO_TRUNC _PC_PATH_MAX
377 _PC_PIPE_BUF _PC_VDISABLE _POSIX_CHOWN_RESTRICTED
378 _POSIX_JOB_CONTROL _POSIX_NO_TRUNC _POSIX_SAVED_IDS
379 _POSIX_VDISABLE _POSIX_VERSION _SC_ARG_MAX
380 _SC_CHILD_MAX _SC_CLK_TCK _SC_JOB_CONTROL
d61b6859 381 _SC_NGROUPS_MAX _SC_OPEN_MAX _SC_PAGESIZE _SC_SAVED_IDS
66fbe9e2
GS
382 _SC_STREAM_MAX _SC_TZNAME_MAX _SC_VERSION
383 _exit access ctermid cuserid
384 dup2 dup execl execle execlp execv execve execvp
f0709b24 385 fpathconf fsync getcwd getegid geteuid getgid getgroups
66fbe9e2
GS
386 getpid getuid isatty lseek pathconf pause setgid setpgid
387 setsid setuid sysconf tcgetpgrp tcsetpgrp ttyname)],
388
d4742b2c 389 utime_h => [],
66fbe9e2
GS
390);
391
7658eeca
AP
392my %other_export_tags = (
393 fenv_h => [qw(
394 FE_DOWNWARD FE_TONEAREST FE_TOWARDZERO FE_UPWARD fegetround fesetround
395 )],
396
397 math_h_c99 => [ @{$default_export_tags{math_h}}, qw(
398 Inf NaN acosh asinh atanh cbrt copysign erf erfc exp2 expm1 fdim fma
399 fmax fmin fpclassify hypot ilogb isfinite isgreater isgreaterequal
400 isinf isless islessequal islessgreater isnan isnormal isunordered j0 j1
401 jn lgamma log1p log2 logb lrint nan nearbyint nextafter nexttoward
402 remainder remquo rint round scalbn signbit tgamma trunc y0 y1 yn
403 )],
404
405 stdlib_h_c99 => [ @{$default_export_tags{stdlib_h}}, 'strtold' ],
406);
407
85a5de57
NC
408{
409 # De-duplicate the export list:
7658eeca
AP
410 my ( %export, %export_ok );
411 @export {map {@$_} values %default_export_tags} = ();
412 @export_ok{map {@$_} values %other_export_tags} = ();
ce0afe25
AB
413 # Doing the de-dup with a temporary hash has the advantage that the SVs in
414 # @EXPORT are actually shared hash key scalars, which will save some memory.
415 our @EXPORT = keys %export;
66fbe9e2 416
a387c53a 417 our @EXPORT_OK = (qw(close lchown nice open pipe read sleep times write
8dad66f8 418 printf sprintf),
7658eeca
AP
419 grep {!exists $export{$_}} keys %reimpl, keys %replacement, keys %export_ok);
420
421 our %EXPORT_TAGS = ( %default_export_tags, %other_export_tags );
8dad66f8 422}
66fbe9e2
GS
423
424require Exporter;
425}
557c0de7
BD
426
427package POSIX::SigAction;
428
fc8b6fe2 429sub new { bless {HANDLER => $_[1], MASK => $_[2], FLAGS => $_[3] || 0, SAFE => 0}, $_[0] }
557c0de7
BD
430sub handler { $_[0]->{HANDLER} = $_[1] if @_ > 1; $_[0]->{HANDLER} };
431sub mask { $_[0]->{MASK} = $_[1] if @_ > 1; $_[0]->{MASK} };
432sub flags { $_[0]->{FLAGS} = $_[1] if @_ > 1; $_[0]->{FLAGS} };
d36b6582 433sub safe { $_[0]->{SAFE} = $_[1] if @_ > 1; $_[0]->{SAFE} };
3609ea0d 434
0e9a7888
RS
435{
436package POSIX::SigSet;
437# This package is here entirely to make sure that POSIX::SigSet is seen by the
438# PAUSE indexer, so that it will always be clearly indexed in core. This is to
439# prevent the accidental case where a third-party distribution can accidentally
440# claim the POSIX::SigSet package, as occurred in 2011-12. -- rjbs, 2011-12-30
441}
442
983cc415
NC
443package POSIX::SigRt;
444
122efcc9
AP
445require Tie::Hash;
446
447our @ISA = 'Tie::StdHash';
448
449our ($_SIGRTMIN, $_SIGRTMAX, $_sigrtn);
450
451our $SIGACTION_FLAGS = 0;
452
983cc415
NC
453sub _init {
454 $_SIGRTMIN = &POSIX::SIGRTMIN;
455 $_SIGRTMAX = &POSIX::SIGRTMAX;
456 $_sigrtn = $_SIGRTMAX - $_SIGRTMIN;
457}
458
459sub _croak {
460 &_init unless defined $_sigrtn;
461 die "POSIX::SigRt not available" unless defined $_sigrtn && $_sigrtn > 0;
462}
463
464sub _getsig {
465 &_croak;
466 my $rtsig = $_[0];
467 # Allow (SIGRT)?MIN( + n)?, a common idiom when doing these things in C.
468 $rtsig = $_SIGRTMIN + ($1 || 0)
469 if $rtsig =~ /^(?:(?:SIG)?RT)?MIN(\s*\+\s*(\d+))?$/;
470 return $rtsig;
471}
472
473sub _exist {
474 my $rtsig = _getsig($_[1]);
475 my $ok = $rtsig >= $_SIGRTMIN && $rtsig <= $_SIGRTMAX;
476 ($rtsig, $ok);
477}
478
479sub _check {
480 my ($rtsig, $ok) = &_exist;
481 die "No POSIX::SigRt signal $_[1] (valid range SIGRTMIN..SIGRTMAX, or $_SIGRTMIN..$_SIGRTMAX)"
482 unless $ok;
483 return $rtsig;
484}
485
486sub new {
487 my ($rtsig, $handler, $flags) = @_;
488 my $sigset = POSIX::SigSet->new($rtsig);
b0ac411b 489 my $sigact = POSIX::SigAction->new($handler, $sigset, $flags);
983cc415
NC
490 POSIX::sigaction($rtsig, $sigact);
491}
492
493sub EXISTS { &_exist }
494sub FETCH { my $rtsig = &_check;
495 my $oa = POSIX::SigAction->new();
496 POSIX::sigaction($rtsig, undef, $oa);
497 return $oa->{HANDLER} }
498sub STORE { my $rtsig = &_check; new($rtsig, $_[2], $SIGACTION_FLAGS) }
499sub DELETE { delete $SIG{ &_check } }
500sub CLEAR { &_exist; delete @SIG{ &POSIX::SIGRTMIN .. &POSIX::SIGRTMAX } }
501sub SCALAR { &_croak; $_sigrtn + 1 }
122efcc9
AP
502
503tie %POSIX::SIGRT, 'POSIX::SigRt';
504# and the expression on the line above is true, so we return true.