This is patch.2b1f to perl5.002beta1.
[p5sagit/p5-mst-13.2.git] / ext / POSIX / POSIX.pod
1 =head1 NAME
2
3 POSIX - Perl interface to IEEE Std 1003.1
4
5 =head1 DESCRIPTION
6
7 The POSIX module permits you to access all (or nearly all) the standard
8 POSIX 1003.1 identifiers.  Many of these identifiers have been given Perl-ish
9 interfaces.  Things which are C<#defines> in C, like EINTR or O_NDELAY, are
10 automatically exported into your namespace.  All functions are only exported
11 if you ask for them explicitly.  Most likely people will prefer to use the
12 fully-qualified function names.
13
14 This document gives a condensed list of the features available in the POSIX
15 module.  Consult your operating system's manpages for general information on
16 most features.  Consult L<perlfunc> for functions which are noted as being
17 identical to Perl's builtin functions.
18
19 The first section describes POSIX functions from the 1003.1 specification.
20 The second section describes some classes for signal objects, TTY objects,
21 and other miscellaneous objects.  The remaining sections list various
22 constants and macros in an organization which roughly follows IEEE Std
23 1003.1b-1993.
24
25 =head1 EXAMPLES
26
27     printf "EINTR is %d\n", EINTR;
28
29     $sess_id = POSIX::setsid();
30
31     $fd = POSIX::open($path, O_CREAT|O_EXCL|O_WRONLY, 0644);
32         # note: that's a filedescriptor, *NOT* a filehandle
33
34 =head1 NOTE
35
36 The POSIX module is probably the most complex Perl module supplied with
37 the standard distribution.  It incorporates autoloading, namespace games,
38 and dynamic loading of code that's in Perl, C, or both.  It's a great
39 source of wisdom.
40
41 =head1 CAVEATS 
42
43 A few functions are not implemented because they are C specific.  If you
44 attempt to call these, they will print a message telling you that they
45 aren't implemented, and suggest using the Perl equivalent should one
46 exist.  For example, trying to access the setjmp() call will elicit the
47 message "setjmp() is C-specific: use eval {} instead".
48
49 Furthermore, some evil vendors will claim 1003.1 compliance, but in fact
50 are not so: they will not pass the PCTS (POSIX Compliance Test Suites).
51 For example, one vendor may not define EDEADLK, or the semantics of the
52 errno values set by open(2) might not be quite right.  Perl does not
53 attempt to verify POSIX compliance.  That means you can currently
54 successfully say "use POSIX",  and then later in your program you find
55 that your vendor has been lax and there's no usable ICANON macro after
56 all.  This could be construed to be a bug.
57
58 =head1 FUNCTIONS
59
60 =over 8
61
62 =item _exit
63
64 This is identical to the C function C<_exit()>.
65
66 =item abort
67
68 This is identical to the C function C<abort()>.
69
70 =item abs
71
72 This is identical to Perl's builtin C<abs()> function.
73
74 =item access
75
76 Determines the accessibility of a file.
77
78         if( POSIX::access( "/", &POSIX::R_OK ) ){
79                 print "have read permission\n";
80         }
81
82 Returns C<undef> on failure.
83
84 =item acos
85
86 This is identical to the C function C<acos()>.
87
88 =item alarm
89
90 This is identical to Perl's builtin C<alarm()> function.
91
92 =item asctime
93
94 This is identical to the C function C<asctime()>.
95
96 =item asin
97
98 This is identical to the C function C<asin()>.
99
100 =item assert
101
102
103 =item atan
104
105 This is identical to the C function C<atan()>.
106
107 =item atan2
108
109 This is identical to Perl's builtin C<atan2()> function.
110
111 =item atexit
112
113 atexit() is C-specific: use END {} instead.
114
115 =item atof
116
117 atof() is C-specific.
118
119 =item atoi
120
121 atoi() is C-specific.
122
123 =item atol
124
125 atol() is C-specific.
126
127 =item bsearch
128
129 bsearch() not supplied.
130
131 =item calloc
132
133 calloc() is C-specific.
134
135 =item ceil
136
137 This is identical to the C function C<ceil()>.
138
139 =item chdir
140
141 This is identical to Perl's builtin C<chdir()> function.
142
143 =item chmod
144
145 This is identical to Perl's builtin C<chmod()> function.
146
147 =item chown
148
149 This is identical to Perl's builtin C<chown()> function.
150
151 =item clearerr
152
153 Use method C<FileHandle::clearerr()> instead.
154
155 =item clock
156
157 This is identical to the C function C<clock()>.
158
159 =item close
160
161
162 Returns C<undef> on failure.
163
164 =item closedir
165
166 This is identical to Perl's builtin C<closedir()> function.
167
168 =item cos
169
170 This is identical to Perl's builtin C<cos()> function.
171
172 =item cosh
173
174 This is identical to the C function C<cosh()>.
175
176 =item creat
177
178
179 =item ctermid
180
181 Generates the path name for controlling terminal.
182
183         $path = POSIX::ctermid();
184
185 =item ctime
186
187 This is identical to the C function C<ctime()>.
188
189 =item cuserid
190
191 Get the character login name of the user.
192
193         $name = POSIX::cuserid();
194
195 =item difftime
196
197 This is identical to the C function C<difftime()>.
198
199 =item div
200
201 div() is C-specific.
202
203 =item dup
204
205
206 Returns C<undef> on failure.
207
208 =item dup2
209
210
211 Returns C<undef> on failure.
212
213 =item errno
214
215 Returns the value of errno.
216
217         $errno = POSIX::errno();
218
219 =item execl
220
221 execl() is C-specific.
222
223 =item execle
224
225 execle() is C-specific.
226
227 =item execlp
228
229 execlp() is C-specific.
230
231 =item execv
232
233 execv() is C-specific.
234
235 =item execve
236
237 execve() is C-specific.
238
239 =item execvp
240
241 execvp() is C-specific.
242
243 =item exit
244
245 This is identical to Perl's builtin C<exit()> function.
246
247 =item exp
248
249 This is identical to Perl's builtin C<exp()> function.
250
251 =item fabs
252
253 This is identical to Perl's builtin C<abs()> function.
254
255 =item fclose
256
257 Use method C<FileHandle::close()> instead.
258
259 =item fcntl
260
261 This is identical to Perl's builtin C<fcntl()> function.
262
263 =item fdopen
264
265 Use method C<FileHandle::new_from_fd()> instead.
266
267 =item feof
268
269 Use method C<FileHandle::eof()> instead.
270
271 =item ferror
272
273 Use method C<FileHandle::error()> instead.
274
275 =item fflush
276
277 Use method C<FileHandle::flush()> instead.
278
279 =item fgetc
280
281 Use method C<FileHandle::getc()> instead.
282
283 =item fgetpos
284
285 Use method C<FileHandle::getpos()> instead.
286
287 =item fgets
288
289 Use method C<FileHandle::gets()> instead.
290
291 =item fileno
292
293 Use method C<FileHandle::fileno()> instead.
294
295 =item floor
296
297 This is identical to the C function C<floor()>.
298
299 =item fmod
300
301 This is identical to the C function C<fmod()>.
302
303 =item fopen
304
305 Use method C<FileHandle::open()> instead.
306
307 =item fork
308
309 This is identical to Perl's builtin C<fork()> function.
310
311 =item fpathconf
312
313
314 Returns C<undef> on failure.
315
316 =item fprintf
317
318 fprintf() is C-specific--use printf instead.
319
320 =item fputc
321
322 fputc() is C-specific--use print instead.
323
324 =item fputs
325
326 fputs() is C-specific--use print instead.
327
328 =item fread
329
330 fread() is C-specific--use read instead.
331
332 =item free
333
334 free() is C-specific.
335
336 =item freopen
337
338 freopen() is C-specific--use open instead.
339
340 =item frexp
341
342
343 =item fscanf
344
345 fscanf() is C-specific--use <> and regular expressions instead.
346
347 =item fseek
348
349 Use method C<FileHandle::seek()> instead.
350
351 =item fsetpos
352
353 Use method C<FileHandle::setpos()> instead.
354
355 =item fstat
356
357
358 =item ftell
359
360 Use method C<FileHandle::tell()> instead.
361
362 =item fwrite
363
364 fwrite() is C-specific--use print instead.
365
366 =item getc
367
368 This is identical to Perl's builtin C<getc()> function.
369
370 =item getchar
371
372 Returns one character from STDIN.
373
374 =item getcwd
375
376 Returns the name of the current working directory.
377
378 =item getegid
379
380 Returns the effective group id.
381
382 =item getenv
383
384 Returns the value of the specified enironment variable.
385
386 =item geteuid
387
388 Returns the effective user id.
389
390 =item getgid
391
392 Returns the user's real group id.
393
394 =item getgrgid
395
396 This is identical to Perl's builtin C<getgrgid()> function.
397
398 =item getgrnam
399
400 This is identical to Perl's builtin C<getgrnam()> function.
401
402 =item getgroups
403
404 Returns the ids of the user's supplementary groups.
405
406 =item getlogin
407
408 This is identical to Perl's builtin C<getlogin()> function.
409
410 =item getpgrp
411
412 This is identical to Perl's builtin C<getpgrp()> function.
413
414 =item getpid
415
416 Returns the process's id.
417
418 =item getppid
419
420 This is identical to Perl's builtin C<getppid()> function.
421
422 =item getpwnam
423
424 This is identical to Perl's builtin C<getpwnam()> function.
425
426 =item getpwuid
427
428 This is identical to Perl's builtin C<getpwuid()> function.
429
430 =item gets
431
432 Returns one line from STDIN.
433
434 =item getuid
435
436 Returns the user's id.
437
438 =item gmtime
439
440 This is identical to Perl's builtin C<gmtime()> function.
441
442 =item isalnum
443
444
445 =item isalpha
446
447
448 =item isatty
449
450 Returns a boolean indicating whether the specified filehandle is connected
451 to a tty.
452
453 =item iscntrl
454
455
456 =item isdigit
457
458
459 =item isgraph
460
461
462 =item islower
463
464
465 =item isprint
466
467
468 =item ispunct
469
470
471 =item isspace
472
473
474 =item isupper
475
476
477 =item isxdigit
478
479
480 =item kill
481
482 This is identical to Perl's builtin C<kill()> function.
483
484 =item labs
485
486 labs() is C-specific, use abs instead.
487
488 =item ldexp
489
490 This is identical to the C function C<ldexp()>.
491
492 =item ldiv
493
494 ldiv() is C-specific, use / and int instead.
495
496 =item link
497
498 This is identical to Perl's builtin C<link()> function.
499
500 =item localeconv
501
502
503 =item localtime
504
505 This is identical to Perl's builtin C<localtime()> function.
506
507 =item log
508
509 This is identical to Perl's builtin C<log()> function.
510
511 =item log10
512
513 This is identical to the C function C<log10()>.
514
515 =item longjmp
516
517 longjmp() is C-specific: use die instead.
518
519 =item lseek
520
521
522 Returns C<undef> on failure.
523
524 =item malloc
525
526 malloc() is C-specific.
527
528 =item mblen
529
530
531 =item mbstowcs
532
533
534 =item mbtowc
535
536
537 =item memchr
538
539 memchr() is C-specific, use index() instead.
540
541 =item memcmp
542
543 memcmp() is C-specific, use eq instead.
544
545 =item memcpy
546
547 memcpy() is C-specific, use = instead.
548
549 =item memmove
550
551 memmove() is C-specific, use = instead.
552
553 =item memset
554
555 memset() is C-specific, use x instead.
556
557 =item mkdir
558
559 This is identical to Perl's builtin C<mkdir()> function.
560
561 =item mkfifo
562
563
564 Returns C<undef> on failure.
565
566 =item mktime
567
568
569 Returns C<undef> on failure.
570
571 =item modf
572
573
574 =item nice
575
576
577 Returns C<undef> on failure.
578
579 =item offsetof
580
581 offsetof() is C-specific.
582
583 =item open
584
585
586 Returns C<undef> on failure.
587
588 =item opendir
589
590
591 =item pathconf
592
593 Retrieves the value of a configurable limit on a file or directory.
594
595 The following will determine the maximum length of the longest allowable
596 pathname on the filesystem which holds C</tmp>.
597
598         $path_max = POSIX::pathconf( "/tmp", &POSIX::_PC_PATH_MAX );
599
600 Returns C<undef> on failure.
601
602 =item pause
603
604 This is similar to the C function C<pause()>.
605
606 Returns C<undef> on failure.
607
608 =item perror
609
610 This is identical to the C function C<perror()>.
611
612 =item pipe
613
614
615 =item pow
616
617 Computes $x raised to the power $exponent.
618
619         $ret = POSIX::pow( $x, $exponent );
620
621 =item printf
622
623 Prints the specified arguments to STDOUT.
624
625 =item putc
626
627 putc() is C-specific--use print instead.
628
629 =item putchar
630
631 putchar() is C-specific--use print instead.
632
633 =item puts
634
635 puts() is C-specific--use print instead.
636
637 =item qsort
638
639 qsort() is C-specific, use sort instead.
640
641 =item raise
642
643 Sends the specified signal to the current process.
644
645 =item rand
646
647 rand() is non-portable, use Perl's rand instead.
648
649 =item read
650
651
652 Returns C<undef> on failure.
653
654 =item readdir
655
656 This is identical to Perl's builtin C<readdir()> function.
657
658 =item realloc
659
660 realloc() is C-specific.
661
662 =item remove
663
664 This is identical to Perl's builtin C<unlink()> function.
665
666 =item rename
667
668 This is identical to Perl's builtin C<rename()> function.
669
670 =item rewind
671
672 Seeks to the beginning of the file.
673
674 =item rewinddir
675
676 This is identical to Perl's builtin C<rewinddir()> function.
677
678 =item rmdir
679
680 This is identical to Perl's builtin C<rmdir()> function.
681
682 =item scanf
683
684 scanf() is C-specific--use <> and regular expressions instead.
685
686 =item setgid
687
688 Sets the real group id for this process.
689
690 =item setjmp
691
692 setjmp() is C-specific: use eval {} instead.
693
694 =item setlocale
695
696 Modifies and queries program's locale.
697
698 The following will set the traditional UNIX system locale behavior.
699
700         $loc = POSIX::setlocale( &POSIX::LC_ALL, "C" );
701
702 =item setpgid
703
704
705 Returns C<undef> on failure.
706
707 =item setsid
708
709 This is identical to the C function C<setsid()>.
710
711 =item setuid
712
713 Sets the real user id for this process.
714
715 =item sigaction
716
717
718 Returns C<undef> on failure.
719
720 =item siglongjmp
721
722 siglongjmp() is C-specific: use die instead.
723
724 =item sigpending
725
726
727 Returns C<undef> on failure.
728
729 =item sigprocmask
730
731
732 Returns C<undef> on failure.
733
734 =item sigsetjmp
735
736 sigsetjmp() is C-specific: use eval {} instead.
737
738 =item sigsuspend
739
740
741 Returns C<undef> on failure.
742
743 =item sin
744
745 This is identical to Perl's builtin C<sin()> function.
746
747 =item sinh
748
749 This is identical to the C function C<sinh()>.
750
751 =item sleep
752
753 This is identical to Perl's builtin C<sleep()> function.
754
755 =item sprintf
756
757
758 =item sqrt
759
760 This is identical to Perl's builtin C<sqrt()> function.
761
762 =item srand
763
764 srand().
765
766 =item sscanf
767
768 sscanf() is C-specific--use regular expressions instead.
769
770 =item stat
771
772 This is identical to Perl's builtin C<stat()> function.
773
774 =item strcat
775
776 strcat() is C-specific, use .= instead.
777
778 =item strchr
779
780 strchr() is C-specific, use index() instead.
781
782 =item strcmp
783
784 strcmp() is C-specific, use eq instead.
785
786 =item strcoll
787
788 This is identical to the C function C<strcoll()>.
789
790 =item strcpy
791
792 strcpy() is C-specific, use = instead.
793
794 =item strcspn
795
796 strcspn() is C-specific, use regular expressions instead.
797
798 =item strerror
799
800 Returns the error string for the specified errno.
801
802 =item strftime
803
804
805 =item strlen
806
807 strlen() is C-specific, use length instead.
808
809 =item strncat
810
811 strncat() is C-specific, use .= instead.
812
813 =item strncmp
814
815 strncmp() is C-specific, use eq instead.
816
817 =item strncpy
818
819 strncpy() is C-specific, use = instead.
820
821 =item stroul
822
823 stroul() is C-specific.
824
825 =item strpbrk
826
827 strpbrk() is C-specific.
828
829 =item strrchr
830
831 strrchr() is C-specific, use rindex() instead.
832
833 =item strspn
834
835 strspn() is C-specific.
836
837 =item strstr
838
839 This is identical to Perl's builtin C<index()> function.
840
841 =item strtod
842
843 strtod() is C-specific.
844
845 =item strtok
846
847 strtok() is C-specific.
848
849 =item strtol
850
851 strtol() is C-specific.
852
853 =item strxfrm
854
855
856 =item sysconf
857
858 Retrieves values of system configurable variables.
859
860 The following will get the machine's clock speed.
861
862         $clock_ticks = POSIX::sysconf( &POSIX::_SC_CLK_TCK );
863
864 Returns C<undef> on failure.
865
866 =item system
867
868 This is identical to Perl's builtin C<system()> function.
869
870 =item tan
871
872 This is identical to the C function C<tan()>.
873
874 =item tanh
875
876 This is identical to the C function C<tanh()>.
877
878 =item tcdrain
879
880
881 Returns C<undef> on failure.
882
883 =item tcflow
884
885
886 Returns C<undef> on failure.
887
888 =item tcflush
889
890
891 Returns C<undef> on failure.
892
893 =item tcgetpgrp
894
895 This is identical to the C function C<tcgetpgrp()>.
896
897 =item tcsendbreak
898
899
900 Returns C<undef> on failure.
901
902 =item tcsetpgrp
903
904
905 Returns C<undef> on failure.
906
907 =item time
908
909 This is identical to Perl's builtin C<time()> function.
910
911 =item times
912
913 The times() function returns elapsed realtime since some point in the past
914 (such as system startup), user and system times for this process, and user
915 and system times used by child processes.  All times are returned in clock
916 ticks.
917
918     ($realtime, $user, $system, $cuser, $csystem) = POSIX::times();
919
920 Note: Perl's builtin C<times()> function returns four values, measured in
921 seconds.
922
923 =item tmpfile
924
925 Use method C<FileHandle::new_tmpfile()> instead.
926
927 =item tmpnam
928
929 Returns a name for a temporary file.
930
931         $tmpfile = POSIX::tmpnam();
932
933 =item tolower
934
935 This is identical to Perl's builtin C<lc()> function.
936
937 =item toupper
938
939 This is identical to Perl's builtin C<uc()> function.
940
941 =item ttyname
942
943
944 =item tzname
945
946
947 =item tzset
948
949 This is identical to the C function C<tzset()>.
950
951 =item umask
952
953 This is identical to Perl's builtin C<umask()> function.
954
955 =item uname
956
957
958 =item ungetc
959
960 Use method C<FileHandle::ungetc()> instead.
961
962 =item unlink
963
964 This is identical to Perl's builtin C<unlink()> function.
965
966 =item utime
967
968 This is identical to Perl's builtin C<utime()> function.
969
970 =item vfprintf
971
972 vfprintf() is C-specific.
973
974 =item vprintf
975
976 vprintf() is C-specific.
977
978 =item vsprintf
979
980 vsprintf() is C-specific.
981
982 =item wait
983
984
985 =item waitpid
986
987
988 =item wcstombs
989
990
991 =item wctomb
992
993
994 =item write
995
996
997 Returns C<undef> on failure.
998
999 =back
1000
1001 =head1 CLASSES
1002
1003 =head2 FileHandle
1004
1005 =over 8
1006
1007 =item new
1008
1009
1010 =item clearerr
1011
1012
1013 =item close
1014
1015
1016 =item eof
1017
1018
1019 =item error
1020
1021
1022 =item fileno
1023
1024
1025 =item flush
1026
1027
1028 Returns C<undef> on failure.
1029
1030 =item getc
1031
1032
1033 =item getpos
1034
1035
1036 =item gets
1037
1038
1039 =item new_from_fd
1040
1041
1042 =item new_tmpfile
1043
1044
1045 =item seek
1046
1047
1048 =item setbuf
1049
1050
1051 =item setpos
1052
1053
1054 Returns C<undef> on failure.
1055
1056 =item setvbuf
1057
1058
1059 Returns C<undef> on failure.
1060
1061 =item tell
1062
1063
1064 =item ungetc
1065
1066
1067 =back
1068
1069 =head2 POSIX::SigAction
1070
1071 =over 8
1072
1073 =item new
1074
1075 Creates a new SigAction object.  This object will be destroyed automatically
1076 when it is no longer needed.
1077
1078 =back
1079
1080 =head2 POSIX::SigSet
1081
1082 =over 8
1083
1084 =item new
1085
1086 Create a new SigSet object.  This object will be destroyed automatically
1087 when it is no longer needed.  Arguments may be supplied to initialize the
1088 set.
1089
1090 Create an empty set.
1091
1092         $sigset = POSIX::SigSet->new;
1093
1094 Create a set with SIGUSR1.
1095
1096         $sigset = POSIX::SigSet->new( &POSIX::SIGUSR1 );
1097
1098 =item addset
1099
1100 Add a signal to a SigSet object.
1101
1102         $sigset->addset( &POSIX::SIGUSR2 );
1103
1104 Returns C<undef> on failure.
1105
1106 =item delset
1107
1108 Remove a signal from the SigSet object.
1109
1110         $sigset->delset( &POSIX::SIGUSR2 );
1111
1112 Returns C<undef> on failure.
1113
1114 =item emptyset
1115
1116 Initialize the SigSet object to be empty.
1117
1118         $sigset->emptyset();
1119
1120 Returns C<undef> on failure.
1121
1122 =item fillset
1123
1124 Initialize the SigSet object to include all signals.
1125
1126         $sigset->fillset();
1127
1128 Returns C<undef> on failure.
1129
1130 =item ismember
1131
1132 Tests the SigSet object to see if it contains a specific signal.
1133
1134         if( $sigset->ismember( &POSIX::SIGUSR1 ) ){
1135                 print "contains SIGUSR1\n";
1136         }
1137
1138 =back
1139
1140 =head2 POSIX::Termios
1141
1142 =over 8
1143
1144 =item new
1145
1146 Create a new Termios object.  This object will be destroyed automatically
1147 when it is no longer needed.
1148
1149         $termios = POSIX::Termios->new;
1150
1151 =item getattr
1152
1153
1154 Returns C<undef> on failure.
1155
1156 =item getcc
1157
1158 Retrieve a value from the c_cc field of a termios object.  The c_cc field is
1159 an array so an index must be specified.
1160
1161         $c_cc[1] = $termios->getcc(1);
1162
1163 =item getcflag
1164
1165 Retrieve the c_cflag field of a termios object.
1166
1167         $c_cflag = $termios->getcflag;
1168
1169 =item getiflag
1170
1171 Retrieve the c_iflag field of a termios object.
1172
1173         $c_iflag = $termios->getiflag;
1174
1175 =item getispeed
1176
1177 Retrieve the input baud rate.
1178
1179         $ispeed = $termios->getispeed;
1180
1181 =item getlflag
1182
1183 Retrieve the c_lflag field of a termios object.
1184
1185         $c_lflag = $termios->getlflag;
1186
1187 =item getoflag
1188
1189 Retrieve the c_oflag field of a termios object.
1190
1191         $c_oflag = $termios->getoflag;
1192
1193 =item getospeed
1194
1195 Retrieve the output baud rate.
1196
1197         $ospeed = $termios->getospeed;
1198
1199 =item setattr
1200
1201
1202 Returns C<undef> on failure.
1203
1204 =item setcc
1205
1206 Set a value in the c_cc field of a termios object.  The c_cc field is an
1207 array so an index must be specified.
1208
1209         $termios->setcc( 1, &POSIX::VEOF );
1210
1211 =item setcflag
1212
1213 Set the c_cflag field of a termios object.
1214
1215         $termios->setcflag( &POSIX::CLOCAL );
1216
1217 =item setiflag
1218
1219 Set the c_iflag field of a termios object.
1220
1221         $termios->setiflag( &POSIX::BRKINT );
1222
1223 =item setispeed
1224
1225 Set the input baud rate.
1226
1227         $termios->setispeed( &POSIX::B9600 );
1228
1229 Returns C<undef> on failure.
1230
1231 =item setlflag
1232
1233 Set the c_lflag field of a termios object.
1234
1235         $termios->setlflag( &POSIX::ECHO );
1236
1237 =item setoflag
1238
1239 Set the c_oflag field of a termios object.
1240
1241         $termios->setoflag( &POSIX::OPOST );
1242
1243 =item setospeed
1244
1245 Set the output baud rate.
1246
1247         $termios->setospeed( &POSIX::B9600 );
1248
1249 Returns C<undef> on failure.
1250
1251 =item Baud rate values
1252
1253 B38400 B75 B200 B134 B300 B1800 B150 B0 B19200 B1200 B9600 B600 B4800 B50 B2400 B110
1254
1255 =item Terminal interface values
1256
1257 TCSADRAIN TCSANOW TCOON TCIOFLUSH TCOFLUSH TCION TCIFLUSH TCSAFLUSH TCIOFF TCOOFF
1258
1259 =item c_cc field values
1260
1261 VEOF VEOL VERASE VINTR VKILL VQUIT VSUSP VSTART VSTOP VMIN VTIME NCCS
1262
1263 =item c_cflag field values
1264
1265 CLOCAL CREAD CSIZE CS5 CS6 CS7 CS8 CSTOPB HUPCL PARENB PARODD
1266
1267 =item c_iflag field values
1268
1269 BRKINT ICRNL IGNBRK IGNCR IGNPAR INLCR INPCK ISTRIP IXOFF IXON PARMRK
1270
1271 =item c_lflag field values
1272
1273 ECHO ECHOE ECHOK ECHONL ICANON IEXTEN ISIG NOFLSH TOSTOP
1274
1275 =item c_oflag field values
1276
1277 OPOST
1278
1279 =back
1280
1281 =head1 PATHNAME CONSTANTS
1282
1283 =over 8
1284
1285 =item Constants
1286
1287 _PC_CHOWN_RESTRICTED _PC_LINK_MAX _PC_MAX_CANON _PC_MAX_INPUT _PC_NAME_MAX _PC_NO_TRUNC _PC_PATH_MAX _PC_PIPE_BUF _PC_VDISABLE
1288
1289 =back
1290
1291 =head1 POSIX CONSTANTS
1292
1293 =over 8
1294
1295 =item Constants
1296
1297 _POSIX_ARG_MAX _POSIX_CHILD_MAX _POSIX_CHOWN_RESTRICTED _POSIX_JOB_CONTROL _POSIX_LINK_MAX _POSIX_MAX_CANON _POSIX_MAX_INPUT _POSIX_NAME_MAX _POSIX_NGROUPS_MAX _POSIX_NO_TRUNC _POSIX_OPEN_MAX _POSIX_PATH_MAX _POSIX_PIPE_BUF _POSIX_SAVED_IDS _POSIX_SSIZE_MAX _POSIX_STREAM_MAX _POSIX_TZNAME_MAX _POSIX_VDISABLE _POSIX_VERSION
1298
1299 =back
1300
1301 =head1 SYSTEM CONFIGURATION
1302
1303 =over 8
1304
1305 =item Constants
1306
1307 _SC_ARG_MAX _SC_CHILD_MAX _SC_CLK_TCK _SC_JOB_CONTROL _SC_NGROUPS_MAX _SC_OPEN_MAX _SC_SAVED_IDS _SC_STREAM_MAX _SC_TZNAME_MAX _SC_VERSION
1308
1309 =back
1310
1311 =head1 ERRNO
1312
1313 =over 8
1314
1315 =item Constants
1316
1317 E2BIG EACCES EAGAIN EBADF EBUSY ECHILD EDEADLK EDOM EEXIST EFAULT EFBIG EINTR EINVAL EIO EISDIR EMFILE EMLINK ENAMETOOLONG ENFILE ENODEV ENOENT ENOEXEC ENOLCK ENOMEM ENOSPC ENOSYS ENOTDIR ENOTEMPTY ENOTTY ENXIO EPERM EPIPE ERANGE EROFS ESPIPE ESRCH EXDEV
1318
1319 =back
1320
1321 =head1 FCNTL
1322
1323 =over 8
1324
1325 =item Constants
1326
1327 FD_CLOEXEC F_DUPFD F_GETFD F_GETFL F_GETLK F_OK F_RDLCK F_SETFD F_SETFL F_SETLK F_SETLKW F_UNLCK F_WRLCK O_ACCMODE O_APPEND O_CREAT O_EXCL O_NOCTTY O_NONBLOCK O_RDONLY O_RDWR O_TRUNC O_WRONLY
1328
1329 =back
1330
1331 =head1 FLOAT
1332
1333 =over 8
1334
1335 =item Constants
1336
1337 DBL_DIG DBL_EPSILON DBL_MANT_DIG DBL_MAX DBL_MAX_10_EXP DBL_MAX_EXP DBL_MIN DBL_MIN_10_EXP DBL_MIN_EXP FLT_DIG FLT_EPSILON FLT_MANT_DIG FLT_MAX FLT_MAX_10_EXP FLT_MAX_EXP FLT_MIN FLT_MIN_10_EXP FLT_MIN_EXP FLT_RADIX FLT_ROUNDS LDBL_DIG LDBL_EPSILON LDBL_MANT_DIG LDBL_MAX LDBL_MAX_10_EXP LDBL_MAX_EXP LDBL_MIN LDBL_MIN_10_EXP LDBL_MIN_EXP
1338
1339 =back
1340
1341 =head1 LIMITS
1342
1343 =over 8
1344
1345 =item Constants
1346
1347 ARG_MAX CHAR_BIT CHAR_MAX CHAR_MIN CHILD_MAX INT_MAX INT_MIN LINK_MAX LONG_MAX LONG_MIN MAX_CANON MAX_INPUT MB_LEN_MAX NAME_MAX NGROUPS_MAX OPEN_MAX PATH_MAX PIPE_BUF SCHAR_MAX SCHAR_MIN SHRT_MAX SHRT_MIN SSIZE_MAX STREAM_MAX TZNAME_MAX UCHAR_MAX UINT_MAX ULONG_MAX USHRT_MAX
1348
1349 =back
1350
1351 =head1 LOCALE
1352
1353 =over 8
1354
1355 =item Constants
1356
1357 LC_ALL LC_COLLATE LC_CTYPE LC_MONETARY LC_NUMERIC LC_TIME
1358
1359 =back
1360
1361 =head1 MATH
1362
1363 =over 8
1364
1365 =item Constants
1366
1367 HUGE_VAL
1368
1369 =back
1370
1371 =head1 SIGNAL
1372
1373 =over 8
1374
1375 =item Constants
1376
1377 SA_NOCLDSTOP SIGABRT SIGALRM SIGCHLD SIGCONT SIGFPE SIGHUP SIGILL SIGINT SIGKILL SIGPIPE SIGQUIT SIGSEGV SIGSTOP SIGTERM SIGTSTP SIGTTIN SIGTTOU SIGUSR1 SIGUSR2 SIG_BLOCK SIG_DFL SIG_ERR SIG_IGN SIG_SETMASK SIG_UNBLOCK
1378
1379 =back
1380
1381 =head1 STAT
1382
1383 =over 8
1384
1385 =item Constants
1386
1387 S_IRGRP S_IROTH S_IRUSR S_IRWXG S_IRWXO S_IRWXU S_ISGID S_ISUID S_IWGRP S_IWOTH S_IWUSR S_IXGRP S_IXOTH S_IXUSR
1388
1389 =item Macros
1390
1391 S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISREG
1392
1393 =back
1394
1395 =head1 STDLIB
1396
1397 =over 8
1398
1399 =item Constants
1400
1401 EXIT_FAILURE EXIT_SUCCESS MB_CUR_MAX RAND_MAX
1402
1403 =back
1404
1405 =head1 STDIO
1406
1407 =over 8
1408
1409 =item Constants
1410
1411 BUFSIZ EOF FILENAME_MAX L_ctermid L_cuserid L_tmpname TMP_MAX _IOFBF _IOLBF _IONBF
1412
1413 =back
1414
1415 =head1 TIME
1416
1417 =over 8
1418
1419 =item Constants
1420
1421 CLK_TCK CLOCKS_PER_SEC
1422
1423 =back
1424
1425 =head1 UNISTD
1426
1427 =over 8
1428
1429 =item Constants
1430
1431 R_OK SEEK_CUR SEEK_END SEEK_SET STDIN_FILENO STDOUT_FILENO STRERR_FILENO W_OK X_OK
1432
1433 =back
1434
1435 =head1 WAIT
1436
1437 =over 8
1438
1439 =item Constants
1440
1441 WNOHANG WUNTRACED
1442
1443 =item Macros
1444
1445 WIFEXITED WEXITSTATUS WIFSIGNALED WTERMSIG WIFSTOPPED WSTOPSIG
1446
1447 =back
1448
1449 =head1 CREATION
1450
1451 This document generated by mkposixman.PL version 951129.
1452