NAME

POSIX::1003::Proc - POSIX handling processes

SYNOPSIS

use POSIX::1003::Proc qw/abort setpgid/;

abort();
setpgid($pid, $pgid);

DESCRIPTION

Functions which are bound to each separate process.

FUNCTIONS

Standard POSIX functions from stdlib.h

abort()

Abnormal process exit.

Standard POSIX functions from sys/wait.h

These functions have captial names because in C they are implemented as macro's (which are capitalized by convension)

WEXITSTATUS($?)

Returns the normal exit status of the child process. Only meaningful if WIFEXITED($?) is true.

WIFEXITED($?)

Returns true if the child process exited normally: "exit()" or by falling off the end of "main()".

WIFSIGNALED($?)

Returns true if the child process terminated because of a signal.

WIFSTOPPED($?)

Returns true if the child process is currently stopped. Can happen only if you specified the WUNTRACED flag to waitpid().

WSTOPSIG($?)

Returns the signal the child process was stopped for. Only meaningful if WIFSTOPPED($?) is true.

WTERMSIG($?)

Returns the signal the child process terminated for. Only meaningful if WIFSIGNALED($?) is true.

wait()

Simply "wait" in perlfunc.

waitpid(PID, FLAGS)

Simply "waitpid" in perlfunc.

Standard POSIX functions from unistd.h

_exit(CODE)

Leave the program without calling handlers registered with atexit (which is not available in Perl)

ctermid()

Generates the path name for the controlling terminal of this process. my $path = ctermid();

cuserid()

Get the login name of the effective user of the current process. See also perldoc -f getlogin my $name = cuserid();

getcwd()

Returns the name of the current working directory. See also Cwd.

nice(INTEGER)

use POSIX::1003::Proc 'nice';
$new_prio = nice($increment);

pause()

setpgid(PID, PPID)

setsid()

tcgetpgrp(FD)

tcsetpgrp(FD, PID)

times5()

The CORE times() function returns four values, conveniently converted into seconds (float). The POSIX times() returns five values in clock tics. To disambique those two, we offer the POSIX function under a slightly different name.

Be warned that the clock ticks will overflow which the count of clock tics does not fit in a clock_t type anymore. That will happen in 49.7 days, when a tick is a millisecond and clock_t an uint32.

         ($user, $sys, $cuser, $csys) = CORE::times();
($elapse, $user, $sys, $cuser, $csys) = POSIX::times();
($elapse, $user, $sys, $cuser, $csys) = times5();

CONSTANTS

Constants from stdlib.h

EXIT_FAILURE
EXIT_SUCCESS

Constants from limits.h

CHILD_MAX

SEE ALSO

This module is part of POSIX-1003 distribution version 0.95.1, built on August 26, 2013. Website: http://perl.overmeer.net. The code is based on POSIX, which is released with Perl itself. See also POSIX::Util for additional functionality.

COPYRIGHTS

Copyrights 2011-2013 on the perl code and the related documentation by [Mark Overmeer]. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://www.perl.com/perl/misc/Artistic.html