
![]() | ![]() |
8.177. POSIX
Provides access
to standard POSIX 1003.1 identifiers: functions, classes, and
constants. Can be use d to import one or multiple
symbols:
use POSIX; # Import all symbols
use POSIX qw(setsid); # Import one symbol
use POSIX qw(:errno_h :fcntl_h); # Import sets of symbols
Functions listed as C-specific are not implemented.
Function | Description |
---|---|
_exit | Identical to C function _exit(2) |
abort | Identical to C function abort(3) |
abs | Identical to Perl's abs function |
access | Determines accessibility of a file; returns undef on failure |
acos | Identical to C function acos(3) |
alarm | Identical to Perl's alarm function |
asctime | Identical to C function asctime(3) |
asin | Identical to C function asin(3) |
assert | Similar to C macro assert(3) |
atan | Identical to C function atan(3) |
atan2 | Identical to Perl's atan2 function |
atexit | C-specific; use END {} |
atof | C-specific |
atoi | C-specific |
atol | C-specific |
bsearch | Not supplied |
calloc | C-specific |
ceil | Identical to C function ceil(3) |
chdir | Identical to Perl's chdir function |
chmod | Identical to Perl's chmod function |
chown | Identical to Perl's chown function |
clearerr | Uses method FileHandle::clearerr |
clock | Identical to C function clock(3) |
close | Closes a file; returns undef on failure |
closedir | Identical to Perl's closedir function |
cos | Identical to Perl's cos function |
cosh | Identical to C function cosh(3) |
creat | Creates a new file |
ctermid | Generates pathname for the controlling terminal |
ctime | Identical to C function ctime(3) |
cuserid | Gets user's login name |
difftime | Identical to C function difftime(3) |
div | C-specific |
dup | Similar to C function dup(2); returns undef on failure |
dup2 | Similar to C function dup2(2); returns undef on failure |
errno | Returns the value of errno |
execl | C-specific; use Perl's exec |
execle | C-specific; use Perl's exec |
execlp | C-specific; use Perl's exec |
execv | C-specific; use Perl's exec |
execve | C-specific; use Perl's exec |
execvp | C-specific; use Perl's exec |
exit | Identical to Perl's exit function |
exp | Identical to Perl's exp function |
fabs | Identical to Perl's abs function |
fclose | Uses method FileHandle::close |
fcntl | Identical to Perl's fcntl function |
fdopen | Uses method FileHandle::new_from_fd |
feof | Uses method FileHandle::eof |
ferror | Uses method FileHandle::error |
fflush | Uses method FileHandle::flush |
fgetc | Uses method FileHandle::getc |
fgetpos | Uses method FileHandle::getpos |
fgets | Uses method FileHandle::gets |
fileno | Uses method FileHandle::fileno |
floor | Identical to C function floor(3) |
fmod | Identical to C function fmod(3) |
fopen | Uses method FileHandle::open |
fork | Identical to Perl's fork function |
fpathconf | Returns value of a configurable limit on a file or directory, or undef on failure |
fprintf | C-specific; use Perl's printf function |
fputc | C-specific; use Perl's print function |
fputs | C-specific; use Perl's print function |
fread | C-specific; use Perl's read function |
free | C-specific |
freopen | C-specific; use Perl's open function |
frexp | Returns mantissa and exponent of a floating-point number |
fscanf | C-specific; use <> and regular expressions |
fseek | Uses method FileHandle::seek |
fsetpos | Uses method FileHandle::setpos |
fstat | Gets file status |
ftell | Uses method FileHandle::tell |
fwrite | C-specific; use Perl's print function |
getc | Identical to Perl's etc function |
getchar | Returns one character from STDIN |
getcwd | Returns name of current working directory |
getegid | Returns effective group ID (gid) |
getenv | Returns value of the specified environment variable |
geteuid | Returns the effective user ID (uid) |
getgid | Returns the user's real group ID (gid) |
getgrgid | Identical to Perl's getgrgid function |
getgrnam | Identical to Perl's getgrnam function |
getgroups | Returns IDs of the user's supplementary groups |
getlogin | Identical to Perl's getlogin function |
getpgrp | Identical to Perl's getpgrp function |
getpid | Returns ID of the process (pid) |
getppid | Identical to Perl's getppid function |
getpwnam | Identical to Perl's getpwnam function |
getpwuid | Identical to Perl's getpwuid function |
gets | Returns one line from STDIN |
getuid | Returns user's ID (uid) |
gmtime | Identical to Perl's gmtime function |
isalnum | Identical to C function, but can apply to one character or a whole string |
isalpha | Identical to C function, but can apply to one character or a whole string |
isatty | Returns Boolean indicating whether the specified filehandle is connected to a TTY |
iscntrl | Identical to C function, but can apply to one character or a whole string |
isdigit | Identical to C function, but can apply to one character or a whole string |
isgraph | Identical to C function, but can apply to one character or a whole string |
islower | Identical to C function, but can apply to one character or a whole string |
isprint | Identical to C function, but can apply to one character or a whole string |
ispunct | Identical to C function, but can apply to one character or a whole string |
isspace | Identical to C function, but can apply to one character or a whole string |
isupper | Identical to C function, but can apply to one character or a whole string |
isxdigit | Identical to C function, but can apply to one character or a whole string |
kill | Identical to Perl's kill function |
labs | C-specific; use Perl's abs function |
ldexp | Identical to C function ldexp(3) |
ldiv | C-specific; use division operator (/) and Perl's int function |
link | Identical to Perl's link function |
localeconv | Gets numeric formatting information; returns reference to a hash containing the current locale formatting values |
localtime | Identical to Perl's localtime function |
log | Identical to Perl's log function |
log10 | Identical to C function log10(3) |
longjmp | C-specific; use Perl's die function |
lseek | Moves the read/write file pointer; returns undef on failure |
malloc | C-specific |
mblen | Identical to C function mblen(3) |
mbstowcs | Identical to C function mbstowcs(3) |
mbtowc | Identical to C function mbtowc(3) |
memchr | C-specific; use Perl's index |
memcmp | C-specific; use eq |
memcpy | C-specific; use = |
memmove | C-specific; use = |
memset | C-specific; use x |
mkdir | Identical to Perl's mkdir function |
mkfifo | Similar to C function mkfifo(2); returns undef on failure |
mktime | Converts date/time information to a calendar time; returns undef on failure |
modf | Returns integral and fractional parts of a floating-point number |
nice | Similar to C function nice(3); returns undef on failure |
offsetof | C-specific |
open | Opens file for reading or writing; returns undef on failure |
opendir | Opens directory for reading; returns undef on failure |
pathconf | Retrieves value of a configurable limit on a file or directory; returns undef on failure |
pause | Similar to C function pause(3); returns undef on failure |
perror | Identical to C function perror(3) |
pipe | Creates an interprocess channel |
pow | Computes $x raised to the power $exponent |
printf | Prints specified arguments to STDOUT |
putc | C-specific; use Perl's print function |
putchar | C-specific; use Perl's print function |
puts | C-specific; use Perl's print function |
qsort | C-specific; use Perl's sort function |
raise | Sends specified signal to current process |
rand | Nonportable; use Perl's rand function |
read | Reads from a file; returns undef on failure |
readdir | Identical to Perl's readdir function |
realloc | C-specific |
remove | Identical to Perl's unlink function |
rename | Identical to Perl's rename function |
rewind | Seeks to beginning of file |
rewinddir | Identical to Perl's rewinddir function |
rmdir | Identical to Perl's rmdir function |
scanf | C-specific; use <> and regular expressions |
setgid | Sets real group ID for this process |
setjmp | C-specific; use eval {} |
setlocale | Modifies and queries program's locale |
setpgid | Similar to C function setpgid(2); returns undef on failure |
setsid | Identical to C function setsid(8) |
setuid | Sets real user ID for this process |
sigaction | Detailed signal management; returns undef on failure |
siglongjmp | C-specific; use Perl's die function |
sigpending | Examines blocked, pending signals; returns undef on failure |
sigprocmask | Changes and/or examines this process's signal mask; returns undef on failure |
sigsetjmp | C-specific; use eval {} |
sigsuspend | Installs signal mask and suspends process until signal arrives; returns undef on failure |
sin | Identical to Perl's sin function |
sinh | Identical to C function sinh(3) |
sleep | Identical to Perl's sleep function |
sprintf | Identical to Perl's sprintf function |
sqrt | Identical to Perl's sqrt function |
srand | Identical to Perl's srand function |
sscanf | C-specific; use regular expressions |
stat | Identical to Perl's stat function |
strcat | C-specific; use .= |
strchr | C-specific; use index |
strcmp | C-specific; use eq |
strcoll | Identical to C function strcoll(3) |
strcpy | C-specific; use = |
strcspn | C-specific; use regular expressions |
strerror | Returns error string for the specified errno |
strftime | Converts date and time to string and returns the string |
strlen | C-specific; use length |
strncat | C-specific; use .= and/or substr |
strncmp | C-specific; use eq and/or substr |
strncpy | C-specific; use = and/or substr |
stroul | C-specific |
strpbrk | C-specific |
strrchr | C-specific; use rindex and/or substr |
strspn | C-specific |
strstr | Identical to Perl's index function |
strtod | C-specific |
strtok | C-specific |
strtol | C-specific |
strtoul | C-specific |
strxfrm | String transformation; returns the transformed string |
sysconf | Retrieves values of system configurable variables; returns undef on failure |
system | Identical to Perl's system function |
tan | Identical to C function tan(3) |
tanh | Identical to C function tanh(3) |
tcdrain | Similar to C function tcdrain(3); returns undef on failure |
tcflow | Similar to C function tcflow(3); returns undef on failure |
tcflush | Similar to C function tcflush(3); returns undef on failure |
tcgetpgrp | Identical to C function tcgetpgrp(3) |
tcsendbreak | Similar to C function tcsendbreak(3); returns undef on failure |
tcsetpgrp | Similar to C function tcsetpgrp(3); returns undef on failure |
time | Identical to Perl's time function |
times | Returns, in clock ticks, elapsed realtime since a point in the past, user and system times for this process, and user and system times for child processes |
tmpfile | Uses method FileHandle::new_tmpfile |
tmpnam | Returns a name for a temporary file |
tolower | Identical to Perl's lc function |
toupper | Identical to Perl's uc function |
ttyname | Identical to C function ttyname(3) |
tzname | Retrieves time conversion information from the tzname variable |
tzset | Identical to C function tzset(3) |
umask | Identical to Perl's umask function |
uname | Gets name of current operating system |
ungetc | Uses method FileHandle::ungetc |
unlink | Identical to Perl's unlink function |
utime | Identical to Perl's utime function |
vfprintf | C-specific |
vprintf | C-specific |
vsprintf | C-specific |
wait | Identical to Perl's wait function |
waitpid | Waits for child process to change state; identical to Perl's waitpid function |
wcstombs | Identical to C function wcstombs(3) |
wctomb | Identical to C function wctomb(3) |
write | Writes to file; returns undef on failure |
methods.
8.177.1. POSIX::SigAction
new |
$sigaction = POSIX::SigAction->new(sigsub, sigset, flags)
Constructor. Creates a new POSIX::SigAction object. Takes the
following arguments:
sigsub
The fully qualified name of a signal-handler subroutinesigset
A POSIX::SigSet objectflags
The sa_flags
8.177.2. POSIX::SigSet
new |
$sigset = POSIX::SigSet->new[( )]
Constructor. Creates new SigSet object. Optional arguments are used
to initialize the set.
addset |
$sigset->addset(sig)
Adds signal sig to SigSet object; returns
undef on failure.
delset |
$sigset->delset(sig)
Removes signal sig from SigSet object;
returns undef on failure.
emptyset |
$sigset->emptyset( )
Initializes SigSet object to empty; returns undef
on failure.
fillset |
$sigset->fillset( )
Initializes SigSet object to include all signals; returns
undef on failure.
ismember |
$sigset->ismember(sig)
Tests SigSet object for a specific signal
sig.
8.177.3. POSIX::Termios
new |
$termios = POSIX::Termios->new
Constructor. Creates new Termios object.
getattr |
$termios->getattr([fd])
Gets terminal control attributes for a given
fd (default is 0 for
STDIN); returns undef on failure.
getcc |
$c_cc[ind] = $termios->getcc(ind)
Retrieves value from the c_cc field of a
Termios object. Takes index ind since
@c_cc is an array.
getcflag |
$c_cflag = $termios->getcflag
Retrieves c_cflag field of a Termios
object.
getiflag |
$c_iflag = $termios->getiflag
Retrieves c_iflag field of a Termios
object.
getispeed |
$ispeed = $termios->getispeed
Retrieves input baud rate.
getlflag |
getlflag $c_lflag = $termios->getlflag
Retrieves c_lflag field of a Termios
object.
getoflag |
$c_oflag = $termios->getoflag
Retrieves c_oflag field of a Termios
object.
getospeed |
$ospeed = $termios->getospeed
Retrieves output baud rate.
setattr |
$termios->setattr(fd, option)
Sets terminal control attributes for a given
fd; returns undef on
failure. option tells when to set the
attributes and is one of TCSADRAIN,
TCSAFLUSH, or TCSANOW.
setcc |
$termios->setcc(ind, value)
Sets value in the
c_cc field, indexed by
ind, of a Termios object.
setcflag |
$termios->setcflag(flag)
Sets flag in the
c_cflag field of a Termios object.
setiflag |
$termios->setiflag(flag)
Sets flag in the
c_iflag field of a Termios object.
setispeed |
$termios->setispeed(value)
Sets input baud rate to value; returns
undef on failure.
setlflag |
$termios->setlflag(flag)
Sets flag in the
c_lflag field of a Termios object.
setoflag |
$termios->setoflag(flag)
Sets flag in the
c_oflag field of a Termios object.
setospeed |
$termios->setospeed(value)
Sets the output baud rate to value;
returns undef on failure.
8.177.4. Constants
The following constants are associated with the Termios class:Baud rate values
B0 B75 B134 B200 B600 B1800 B4800 B19200
B50 B110 B150 B300 B1200 B2400 B9600 B38400
c_cc index values
VEOF VERASE VKILL VSUSP VSTOP VTIME
VEOL VINTR VQUIT VSTART VMIN NCCS
c_cflag field values
CLOCAL CSIZE CS6 CS8 HUPCL PARODD
CREAD CS5 CS7 CSTOPS PARENB
c_iflag field values
BRKINT IGNBRK IGNPAR INPCK IXOFF PARMRK
ICRNL IGNCR INLCR ISTRIP IXON
c_lflag field values
ECHO ECHONL ISIG
ECHOE ICANON NOFLSH
ECHOK IEXTEN TOSTOP
c_oflag field values
OPOST
Terminal interface values
TCSADRAIN TCIOFLUSH TCIFLUSH
TCSANOW TCOFLUSH TCSAFLUSH
TCOON TCION TCIOFF
The following are other constants defined in the POSIX module:Pathname constants
_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
POSIX constants
_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
System configuration
_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
Error constants
E2BIG EACCES EAGAIN EBADF EBUSY ECHILD EDEADLK
EDOM EEXIST EFAUL EFBIG EINTR EINVAL
EIO EISDIR EMFILE EMLINK ENAMETOOLONG ENFILE
ENODE ENOENT ENOEXEC ENOLCK ENOMEM ENOSPC
ENOSYS ENOTDIR ENOTEMPTY ENOTTY ENXIO EPERM
EPIPE ERANGE EROFS ESPIPE ESRCH EXDEV
File control constants
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
Floating-point constants
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
Limit constants
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
Locale constants
LC_ALL LC_COLLATE LC_CTYPE LC_MONETARY LC_NUMERIC LC_TIME
Math constants
HUGE_VAL
Signal constants
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
Stat constants
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
Stat macros
S_ISBLK S_ISCHR S_ISDIR S_ISFIFO S_ISREG
Stdlib constants
EXIT_FAILURE EXIT_SUCCESS MB_CUR_MAX RAND_MAX
Stdio constants
BUFSIZ EOF FILENAME_MAX L_ctermid L_cuserid L_tmpname TMP_MAX
Time constants
CLK_TCK CLOCKS_PER_SEC
Unistd constants
R_OK SEEK_CUR SEEK_END SEEK_SET STDIN_FILENO
STDOUT_FILENO STRERR_FILENO W_OK X_OK
Wait constants
WNOHANG WUNTRACED
Wait macros
WIFEXITED WEXITSTATUS WIFSIGNALED WTERMSIG WIFSTOPPED WSTOPSIG
![]() | ![]() | ![]() |
8.176. Pod::Text | ![]() | 8.178. re |

Copyright © 2002 O'Reilly & Associates. All rights reserved.